Function parseEnv

parseEnv<T extends EnvConfig>(
config: T,
source?: Record<string, string | undefined>,
): InferEnvConfig<T>
Parses environment variables into a validated, typed config object.

Every leaf field in the config descriptor must be wrapped with env() — this is enforced at the TypeScript level.

The function:
1. Walks the descriptor tree, reading raw values from source (defaults to process.env).
2. Assembles a @cleverbrush/schema object schema from the leaf schemas.
3. Validates and coerces the raw values via schema.validate().
4. Returns the typed result or throws an EnvValidationError listing all missing and invalid variables.
Type Parameters
- T extends EnvConfig
Parameters
- config: T
  A descriptor tree where leaves are EnvFields and branches are plain objects.
- Optionalsource: Record<string, string | undefined>
  The environment variable source. Defaults to process.env.
Returns InferEnvConfig<T>
Example
```
const config = parseEnv({
  db: {
    host: env('DB_HOST', string().default('localhost')),
    port: env('DB_PORT', number().coerce().default(5432)),
  },
  debug: env('DEBUG', boolean().coerce().default(false)),
});
```
- Defined in libs/env/src/parseEnv.ts:133
parseEnv<T extends EnvConfig, C extends Record<string, unknown>>(
    config: T,
    compute: (base: InferEnvConfig<T>) => C,
    source?: Record<string, string | undefined>,
): MergeTwo<InferEnvConfig<T>>
Parses environment variables into a validated, typed config object.

Every leaf field in the config descriptor must be wrapped with env() — this is enforced at the TypeScript level.

The function:
1. Walks the descriptor tree, reading raw values from source (defaults to process.env).
2. Assembles a @cleverbrush/schema object schema from the leaf schemas.
3. Validates and coerces the raw values via schema.validate().
4. Returns the typed result or throws an EnvValidationError listing all missing and invalid variables.
Type Parameters
- T extends EnvConfig
- C extends Record<string, unknown>
Parameters
- config: T
  A descriptor tree where leaves are EnvFields and branches are plain objects.
- compute: (base: InferEnvConfig<T>) => C
- Optionalsource: Record<string, string | undefined>
  The environment variable source. Defaults to process.env.
Returns MergeTwo<InferEnvConfig<T>>
Example
```
const config = parseEnv({
  db: {
    host: env('DB_HOST', string().default('localhost')),
    port: env('DB_PORT', number().coerce().default(5432)),
  },
  debug: env('DEBUG', boolean().coerce().default(false)),
});
```
- Defined in libs/env/src/parseEnv.ts:137

Function parseEnv

Type Parameters

Parameters

Returns InferEnvConfig<T>

Example

Type Parameters

Parameters

Returns MergeTwo<InferEnvConfig<T>>

Example

Settings