@rtorcato/api-config

Load and validate environment variables with dotenv

• zod — you supply the schema, you get a typed, validated env.

import { loadEnv } from '@rtorcato/api-config'
import { z } from 'zod'

export const env = loadEnv(
	z.object({
		NODE_ENV: z.string().default('development'),
		PORT: z.coerce.number().default(3000),
		DATABASE_URL: z.string().url(),
	}),
)

API

loadEnv(schema, options?)

Loads a .env file (.env.test when NODE_ENV === 'test') via dotenv + dotenv-expand, then validates process.env against schema and returns the typed result.

• options.path — explicit .env path.
• options.skipDotenv — validate process.env without reading a file.

On failure it throws an Error with the formatted field errors. Unlike the common copy-paste pattern, it does not call process.exit — the caller decides how to handle invalid config.

Peer dependencies

zod ^3.23.

License

MIT