env

4 modules

• env/dotenv.ts

  Dotenv file parsing and loading.

  Provides parse_dotenv for parsing dotenv-format strings and load_env_file for reading and parsing env files from disk.

• env/load.ts

  Generic environment loading from Zod schemas.

  Provides load_env which iterates Zod schema keys, gets env values, and validates. Apps handle error messages themselves (they're always app-specific).

• env/mask.ts

  Environment value display formatting with secret masking.

  Provides utilities for safely displaying env values in logs and startup summaries, masking secrets with a placeholder.

• env/resolve.ts

  Environment variable $$VAR$$ resolution suite.

  Resolves $$VAR$$ references in strings and object trees, scans configs for references, and validates/formats missing vars.

  The double-dollar bookending syntax is: - Visually distinct from shell $VAR syntax - Unambiguous about variable boundaries - Easy to grep: grep '\$\$' - Fails loud if accidentally shell-processed ($$=PID in shell)