@geekmidas/envkit 1.0.4 → 1.0.6

package/src/__tests__/SnifferEnvironmentParser.spec.ts

@@ -343,6 +343,135 @@ describe('SnifferEnvironmentParser', () => {
 		});
 	});
 
+	describe('Optional variable tracking', () => {
+		it('should track variables accessed with .optional() as optional', () => {
+			const sniffer = new SnifferEnvironmentParser();
+
+			sniffer.create((get) => ({
+				required: get('REQUIRED_VAR').string(),
+				optional: get('OPTIONAL_VAR').string().optional(),
+			}));
+
+			expect(sniffer.getOptionalVariables()).toEqual(['OPTIONAL_VAR']);
+		});
+
+		it('should track variables accessed with .default() as optional', () => {
+			const sniffer = new SnifferEnvironmentParser();
+
+			sniffer.create((get) => ({
+				required: get('REQUIRED_VAR').string(),
+				withDefault: get('DEFAULT_VAR').string().default('fallback'),
+			}));
+
+			expect(sniffer.getOptionalVariables()).toEqual(['DEFAULT_VAR']);
+		});
+
+		it('should track variables with .default() after .transform() as optional', () => {
+			const sniffer = new SnifferEnvironmentParser();
+
+			sniffer.create((get) => ({
+				port: get('PORT').string().transform(Number).default(3000),
+			}));
+
+			expect(sniffer.getOptionalVariables()).toEqual(['PORT']);
+		});
+
+		it('should not include required variables in getOptionalVariables()', () => {
+			const sniffer = new SnifferEnvironmentParser();
+
+			sniffer.create((get) => ({
+				required: get('DATABASE_URL').string(),
+				optional: get('LOG_LEVEL').string().optional(),
+			}));
+
+			expect(sniffer.getOptionalVariables()).toEqual(['LOG_LEVEL']);
+			expect(sniffer.getOptionalVariables()).not.toContain('DATABASE_URL');
+		});
+
+		it('getEnvironmentVariables({ markOptional: true }) suffixes optional vars with ?', () => {
+			const sniffer = new SnifferEnvironmentParser();
+
+			sniffer.create((get) => ({
+				required: get('DATABASE_URL').string(),
+				apiKey: get('API_KEY').string(),
+				logLevel: get('LOG_LEVEL').string().optional(),
+				port: get('PORT').string().default('3000'),
+			}));
+
+			expect(sniffer.getEnvironmentVariables({ markOptional: true })).toEqual([
+				'API_KEY',
+				'DATABASE_URL',
+				'LOG_LEVEL?',
+				'PORT?',
+			]);
+		});
+
+		it('getEnvironmentVariables() without option returns plain names', () => {
+			const sniffer = new SnifferEnvironmentParser();
+
+			sniffer.create((get) => ({
+				required: get('DATABASE_URL').string(),
+				optional: get('PORT').string().default('3000'),
+			}));
+
+			expect(sniffer.getEnvironmentVariables()).toEqual([
+				'DATABASE_URL',
+				'PORT',
+			]);
+		});
+
+		it('getEnvironmentVariables({ markOptional: false }) returns plain names', () => {
+			const sniffer = new SnifferEnvironmentParser();
+
+			sniffer.create((get) => ({
+				required: get('DATABASE_URL').string(),
+				optional: get('PORT').string().default('3000'),
+			}));
+
+			expect(sniffer.getEnvironmentVariables({ markOptional: false })).toEqual([
+				'DATABASE_URL',
+				'PORT',
+			]);
+		});
+
+		it('should return empty getOptionalVariables() when all vars are required', () => {
+			const sniffer = new SnifferEnvironmentParser();
+
+			sniffer.create((get) => ({
+				url: get('DATABASE_URL').string(),
+				key: get('API_KEY').string(),
+			}));
+
+			expect(sniffer.getOptionalVariables()).toEqual([]);
+		});
+
+		it('should handle mix of optional and default across nested config', () => {
+			const sniffer = new SnifferEnvironmentParser();
+
+			sniffer.create((get) => ({
+				database: {
+					url: get('DATABASE_URL').string(),
+					poolSize: get('DB_POOL_SIZE').string().transform(Number).default(10),
+				},
+				cache: {
+					url: get('REDIS_URL').string().optional(),
+					ttl: get('CACHE_TTL').string(),
+				},
+			}));
+
+			expect(sniffer.getOptionalVariables().sort()).toEqual([
+				'DB_POOL_SIZE',
+				'REDIS_URL',
+			]);
+			expect(sniffer.getEnvironmentVariables({ markOptional: true })).toEqual([
+				'CACHE_TTL',
+				'DATABASE_URL',
+				'DB_POOL_SIZE?',
+				'REDIS_URL?',
+			]);
+		});
+	});
+
 	describe('Edge cases', () => {
 		it('should return empty array when no variables accessed', () => {
 			const sniffer = new SnifferEnvironmentParser();
@@ -483,4 +612,33 @@ describe('sniffWithFireAndForget', () => {
 		expect(result.error).toBeUndefined();
 		expect(result.unhandledRejections).toEqual([]);
 	});
+
+	it('should include optionalEnvVars in result', async () => {
+		const sniffer = new SnifferEnvironmentParser();
+
+		const result = await sniffWithFireAndForget(sniffer, () => {
+			sniffer.create((get) => ({
+				required: get('DATABASE_URL').string(),
+				optional: get('PORT').string().default('3000'),
+				alsoOptional: get('LOG_LEVEL').string().optional(),
+			}));
+		});
+
+		expect(result.envVars).toEqual(['DATABASE_URL', 'LOG_LEVEL', 'PORT']);
+		expect(result.optionalEnvVars).toEqual(['LOG_LEVEL', 'PORT']);
+		expect(result.error).toBeUndefined();
+	});
+
+	it('should return empty optionalEnvVars when all vars are required', async () => {
+		const sniffer = new SnifferEnvironmentParser();
+
+		const result = await sniffWithFireAndForget(sniffer, () => {
+			sniffer.create((get) => ({
+				url: get('DATABASE_URL').string(),
+				key: get('API_KEY').string(),
+			}));
+		});
+
+		expect(result.optionalEnvVars).toEqual([]);
+	});
 });

package/src/__tests__/SstEnvironmentBuilder.spec.ts

@@ -84,6 +84,7 @@ describe('SstEnvironmentBuilder', () => {
 				DATABASE_PASSWORD: 'password123',
 				DATABASE_PORT: 5432,
 				DATABASE_USERNAME: 'postgres',
+				DATABASE_URL: 'postgresql://postgres:password123@localhost:5432/myapp',
 			});
 		});
 
@@ -107,6 +108,8 @@ describe('SstEnvironmentBuilder', () => {
 				MAIN_DB_PASSWORD: 'prod-password',
 				MAIN_DB_PORT: 5433,
 				MAIN_DB_USERNAME: 'prod_user',
+				MAIN_DB_URL:
+					'postgresql://prod_user:prod-password@prod.example.com:5433/prod_db',
 			});
 		});
 	});
@@ -271,6 +274,8 @@ describe('SstEnvironmentBuilder', () => {
 				DATABASE_PASSWORD: 'db-pass',
 				DATABASE_PORT: 5432,
 				DATABASE_USERNAME: 'app_user',
+				DATABASE_URL:
+					'postgresql://app_user:db-pass@db.example.com:5432/app_db',
 				JWT_SECRET: 'jwt-secret',
 				UPLOADS_NAME: 'uploads-bucket',
 				EVENTS_ARN: 'arn:aws:sns:us-east-1:123456789:events',

package/src/__tests__/sst.spec.ts

@@ -140,6 +140,8 @@ describe('sst', () => {
 					DATABASE_PASSWORD: 'password123',
 					DATABASE_PORT: 5432,
 					DATABASE_USERNAME: 'postgres',
+					DATABASE_URL:
+						'postgresql://postgres:password123@localhost:5432/myapp',
 				});
 			});
 
@@ -162,6 +164,8 @@ describe('sst', () => {
 					MAIN_DB_HOST: 'prod.example.com',
 					MAIN_DB_PASSWORD: 'prod-password',
 					MAIN_DB_PORT: 5433,
+					MAIN_DB_URL:
+						'postgresql://prod_user:prod-password@prod.example.com:5433/prod_db',
 					MAIN_DB_USERNAME: 'prod_user',
 				});
 			});
@@ -296,6 +300,8 @@ describe('sst', () => {
 					DATABASE_HOST: 'db.example.com',
 					DATABASE_PASSWORD: 'db-pass',
 					DATABASE_PORT: 5432,
+					DATABASE_URL:
+						'postgresql://app_user:db-pass@db.example.com:5432/app_db',
 					DATABASE_USERNAME: 'app_user',
 					JWT_SECRET: 'jwt-secret',
 					UPLOADS_NAME: 'uploads-bucket',

package/tsdown.config.ts

@@ -1,3 +1,18 @@
 import { defineConfig } from 'tsdown';
 
-export default defineConfig({});
+export default defineConfig({
+	entry: [
+		'src/index.ts',
+		'src/sst.ts',
+		'src/SnifferEnvironmentParser.ts',
+		'src/credentials.ts',
+	],
+	clean: true,
+	outDir: 'dist',
+	format: ['cjs', 'esm'],
+	sourcemap: true,
+	dts: true,
+	outExtensions: (ctx) => ({
+		js: ctx.format === 'es' ? '.mjs' : '.cjs',
+	}),
+});

package/dist/EnvironmentBuilder.cjs

@@ -1,4 +0,0 @@
-const require_EnvironmentBuilder = require('./EnvironmentBuilder-Djr1VsWM.cjs');
-
-exports.EnvironmentBuilder = require_EnvironmentBuilder.EnvironmentBuilder;
-exports.environmentCase = require_EnvironmentBuilder.environmentCase;

package/dist/EnvironmentBuilder.d.cts

@@ -1,2 +0,0 @@
-import { EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase } from "./EnvironmentBuilder-Xuf2Dd9u.cjs";
-export { EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase };

package/dist/EnvironmentBuilder.d.mts

@@ -1,2 +0,0 @@
-import { EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase } from "./EnvironmentBuilder-jF-b7WQg.mjs";
-export { EnvRecord, EnvValue, EnvironmentBuilder, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers, TypedInputValue, TypedResolvers, environmentCase };

package/dist/EnvironmentBuilder.mjs

@@ -1,3 +0,0 @@
-import { EnvironmentBuilder, environmentCase } from "./EnvironmentBuilder-BSuHZm0y.mjs";
-
-export { EnvironmentBuilder, environmentCase };

package/dist/EnvironmentParser-CkLfmn4Y.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EnvironmentParser-CkLfmn4Y.d.mts","names":[],"sources":["../src/EnvironmentParser.ts"],"sourcesContent":[],"mappings":";;;;;;AAWA;;;;AAS4B,cATf,YASe,CAAA,kBATgB,WAShB,CAAA,CAAA;EAAG,iBAMT,MAAA;EAAS,iBAArB,OAAA;EAAW;AA2FrB;;;;;EAiJmC,WAClB,CAAA,MAAA,EApPU,SAoPV,EAAA,OAAA,CAAA,EAnPW,GAmPX,CAAA,MAAA,CAAA;EAAU;;;AACX;EA6BJ,KAAA,CAAA,CAAA,EA3QF,WA2Qa,CA3QD,SA2QC,CAAA;EAAA;;;;;;;;;;;;;;;;EAKjB,uBAAC,CAAA,CAAA,EAAA,MAAA,EAAA;AAAC;AAWR;;;;AAEa;AAUb;;;;;AAEc;AAMd;;;;;;;;cApNa,4BAA4B;;;;;;;;;;;sBAWH;;;;;;;;;;;;;;;;;;;;;;;;yBAsId,4BACP,eAAe,UAC5B,aAAa;;;;;;;;;;;;;;;;;;;;;;KA6BL,sBAAsB,6BACrB,IAAI,EAAE,WAAW,CAAA,CAAE,YAC5B,CAAA,CAAE,MAAM,EAAE,MACV,EAAE,WAAW,0BACZ,YAAY,EAAE,MACd,EAAE;;;;;;;;;KAWK,mDACL,iBACK;;;;;;;;;KAUA,qCAAqC,qBAC3C,eACD;;;;;KAMO,WAAA,GAAc"}

package/dist/EnvironmentParser-DJdW7vOL.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"EnvironmentParser-DJdW7vOL.cjs","names":["config: TResponse","envVars: Set<string>","errors: z.core.$ZodIssue[]","config: T","path: string[]","result: EmptyObject","z","schema: z.ZodType","name: string","issue: z.core.$ZodIssue","builder: (get: EnvFetcher) => TReturn"],"sources":["../src/EnvironmentParser.ts"],"sourcesContent":["import get from 'lodash.get';\nimport set from 'lodash.set';\nimport { z } from 'zod/v4';\nimport { formatParseError, isDevelopment } from './formatter.js';\n\n/**\n * Parses and validates configuration objects against Zod schemas.\n * Handles nested configurations and aggregates validation errors.\n *\n * @template TResponse - The shape of the configuration object\n */\nexport class ConfigParser<TResponse extends EmptyObject> {\n\t/**\n\t * Creates a new ConfigParser instance.\n\t *\n\t * @param config - The configuration object to parse\n\t * @param envVars - Set of environment variable names that were accessed\n\t */\n\tconstructor(\n\t\tprivate readonly config: TResponse,\n\t\tprivate readonly envVars: Set<string> = new Set(),\n\t) {}\n\t/**\n\t * Parses the config object and validates it against the Zod schemas\n\t * @returns The parsed config object\n\t */\n\tparse(): InferConfig<TResponse> {\n\t\tconst errors: z.core.$ZodIssue[] = [];\n\n\t\tconst parseDeep = <T>(config: T, path: string[] = []) => {\n\t\t\tconst result: EmptyObject = {};\n\n\t\t\tif (config && typeof config !== 'object') {\n\t\t\t\treturn config;\n\t\t\t}\n\n\t\t\tfor (const key in config) {\n\t\t\t\tconst schema = config[key];\n\t\t\t\tconst currentPath = [...path, key];\n\n\t\t\t\tif (schema instanceof z.ZodType) {\n\t\t\t\t\tconst parsed = schema.safeParse(undefined);\n\t\t\t\t\tif (parsed.success) {\n\t\t\t\t\t\tset(result, key, parsed.data);\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// If the schema is invalid, assign the error\n\t\t\t\t\t\terrors.push(\n\t\t\t\t\t\t\t...parsed.error.issues.map((issue) => ({\n\t\t\t\t\t\t\t\t...issue,\n\t\t\t\t\t\t\t\tpath: [...currentPath, ...(issue.path as string[])],\n\t\t\t\t\t\t\t})),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} else if (schema) {\n\t\t\t\t\tset(result, key, parseDeep(schema as EmptyObject, currentPath));\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn result;\n\t\t};\n\n\t\tconst parsedConfig = parseDeep(\n\t\t\tthis.config,\n\t\t) as unknown as InferConfig<TResponse>;\n\n\t\tif (errors.length > 0) {\n\t\t\tconst zodError = new z.ZodError(errors);\n\t\t\t// In development, log a formatted error message before throwing\n\t\t\tif (isDevelopment()) {\n\t\t\t\tconsole.error(formatParseError(zodError));\n\t\t\t}\n\t\t\tthrow zodError;\n\t\t}\n\n\t\treturn parsedConfig;\n\t}\n\n\t/**\n\t * Returns an array of environment variable names that were accessed during config creation.\n\t * This is useful for deployment and configuration management to know which env vars are required.\n\t *\n\t * @returns Array of environment variable names, sorted alphabetically\n\t *\n\t * @example\n\t * ```typescript\n\t * const config = envParser.create((get) => ({\n\t *   dbUrl: get('DATABASE_URL').string(),\n\t *   port: get('PORT').number()\n\t * }));\n\t *\n\t * config.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']\n\t * ```\n\t */\n\tgetEnvironmentVariables(): string[] {\n\t\treturn Array.from(this.envVars).sort();\n\t}\n}\n\n/**\n * Parses environment variables with type-safe validation using Zod schemas.\n * Provides a fluent API for defining environment variable schemas with automatic\n * error context enrichment.\n *\n * @template T - The type of the configuration object (typically process.env)\n *\n * @example\n * ```typescript\n * const config = new EnvironmentParser(process.env)\n *   .create((get) => ({\n *     port: get('PORT').string().transform(Number).default(3000),\n *     database: {\n *       url: get('DATABASE_URL').string().url()\n *     }\n *   }))\n *   .parse();\n * ```\n */\nexport class EnvironmentParser<T extends EmptyObject> {\n\t/**\n\t * Set to track which environment variable names have been accessed\n\t */\n\tprivate readonly accessedVars: Set<string> = new Set();\n\n\t/**\n\t * Creates a new EnvironmentParser instance.\n\t *\n\t * @param config - The configuration object to parse (typically process.env)\n\t */\n\tconstructor(private readonly config: T) {}\n\n\t/**\n\t * Wraps a Zod schema to intercept parse/safeParse calls and enrich error messages\n\t * with environment variable context.\n\t *\n\t * @param schema - The Zod schema to wrap\n\t * @param name - The environment variable name for error context\n\t * @returns A wrapped Zod schema with enhanced error reporting\n\t */\n\tprivate wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\n\t\t// Create a proxy that intercepts all method calls on the schema\n\t\treturn new Proxy(schema, {\n\t\t\tget: (target, prop) => {\n\t\t\t\tif (prop === 'parse') {\n\t\t\t\t\treturn () => {\n\t\t\t\t\t\tconst value = get(this.config, name);\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\treturn target.parse(value);\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tif (error instanceof z.ZodError) {\n\t\t\t\t\t\t\t\t// Modify the error to include the environment variable name\n\t\t\t\t\t\t\t\tconst modifiedIssues = error.issues.map((issue) => ({\n\t\t\t\t\t\t\t\t\t...issue,\n\t\t\t\t\t\t\t\t\tmessage: `Environment variable \"${name}\": ${issue.message}`,\n\t\t\t\t\t\t\t\t\tpath: [name, ...issue.path],\n\t\t\t\t\t\t\t\t}));\n\t\t\t\t\t\t\t\tthrow new z.ZodError(modifiedIssues);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t}\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tif (prop === 'safeParse') {\n\t\t\t\t\treturn () => {\n\t\t\t\t\t\tconst value = get(this.config, name);\n\t\t\t\t\t\tconst result = target.safeParse(value);\n\n\t\t\t\t\t\tif (!result.success) {\n\t\t\t\t\t\t\t// Modify the error to include the environment variable name\n\t\t\t\t\t\t\tconst modifiedIssues = result.error.issues.map(\n\t\t\t\t\t\t\t\t(issue: z.core.$ZodIssue) => ({\n\t\t\t\t\t\t\t\t\t...issue,\n\t\t\t\t\t\t\t\t\tmessage: `Environment variable \"${name}\": ${issue.message}`,\n\t\t\t\t\t\t\t\t\tpath: [name, ...issue.path],\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tsuccess: false as const,\n\t\t\t\t\t\t\t\terror: new z.ZodError(modifiedIssues),\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\treturn result;\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\t// For any method that returns a new schema (like transform, optional, etc.),\n\t\t\t\t// wrap the result as well\n\t\t\t\tconst originalProp = target[prop as keyof typeof target];\n\t\t\t\tif (typeof originalProp === 'function') {\n\t\t\t\t\treturn (...args: any[]) => {\n\t\t\t\t\t\tconst result = originalProp.apply(target, args);\n\t\t\t\t\t\t// If the result is a ZodType, wrap it too\n\t\t\t\t\t\tif (result && typeof result === 'object' && 'parse' in result) {\n\t\t\t\t\t\t\treturn this.wrapSchema(result, name);\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn result;\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\treturn originalProp;\n\t\t\t},\n\t\t});\n\t};\n\n\t/**\n\t * Creates a proxied version of the Zod object that wraps all schema creators\n\t * to provide enhanced error messages with environment variable context.\n\t *\n\t * @param name - The environment variable name\n\t * @returns A proxied Zod object with wrapped schema creators\n\t */\n\tprivate getZodGetter = (name: string) => {\n\t\t// Track that this environment variable was accessed\n\t\tthis.accessedVars.add(name);\n\n\t\t// Return an object that has all Zod schemas but with our wrapper\n\t\treturn new Proxy(\n\t\t\t{ ...z },\n\t\t\t{\n\t\t\t\tget: (target, prop) => {\n\t\t\t\t\t// deno-lint-ignore ban-ts-comment\n\t\t\t\t\t// @ts-expect-error\n\t\t\t\t\tconst value = target[prop];\n\n\t\t\t\t\tif (typeof value === 'function') {\n\t\t\t\t\t\t// Return a wrapper around each Zod schema creator\n\t\t\t\t\t\treturn (...args: any[]) => {\n\t\t\t\t\t\t\tconst schema = value(...args);\n\t\t\t\t\t\t\treturn this.wrapSchema(schema, name);\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\n\t\t\t\t\t// Handle objects like z.coerce\n\t\t\t\t\tif (value && typeof value === 'object') {\n\t\t\t\t\t\treturn new Proxy(value, {\n\t\t\t\t\t\t\tget: (nestedTarget, nestedProp) => {\n\t\t\t\t\t\t\t\tconst nestedValue =\n\t\t\t\t\t\t\t\t\tnestedTarget[nestedProp as keyof typeof nestedTarget];\n\t\t\t\t\t\t\t\tif (typeof nestedValue === 'function') {\n\t\t\t\t\t\t\t\t\treturn (...args: any[]) => {\n\t\t\t\t\t\t\t\t\t\tconst schema = nestedValue(...args);\n\t\t\t\t\t\t\t\t\t\treturn this.wrapSchema(schema, name);\n\t\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\treturn nestedValue;\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\n\t\t\t\t\treturn value;\n\t\t\t\t},\n\t\t\t},\n\t\t);\n\t};\n\n\t/**\n\t * Creates a new ConfigParser object that can be used to parse the config object\n\t *\n\t * @param builder - A function that takes a getter function and returns a config object\n\t * @returns A ConfigParser object that can be used to parse the config object\n\t */\n\tcreate<TReturn extends EmptyObject>(\n\t\tbuilder: (get: EnvFetcher) => TReturn,\n\t): ConfigParser<TReturn> {\n\t\tconst config = builder(this.getZodGetter);\n\t\treturn new ConfigParser(config, this.accessedVars);\n\t}\n\n\t/**\n\t * Returns an array of environment variable names that were accessed via the getter.\n\t * This is useful for build-time analysis to determine which env vars a service needs.\n\t *\n\t * @returns Array of environment variable names, sorted alphabetically\n\t *\n\t * @example\n\t * ```typescript\n\t * const sniffer = new EnvironmentParser({});\n\t * service.register(sniffer);\n\t * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']\n\t * ```\n\t */\n\tgetEnvironmentVariables(): string[] {\n\t\treturn Array.from(this.accessedVars).sort();\n\t}\n}\n\n/**\n * Infers the TypeScript type of a configuration object based on its Zod schemas.\n * Recursively processes nested objects and extracts types from Zod schemas.\n *\n * @template T - The configuration object type\n */\nexport type InferConfig<T extends EmptyObject> = {\n\t[K in keyof T]: T[K] extends z.ZodSchema\n\t\t? z.infer<T[K]>\n\t\t: T[K] extends Record<string, unknown>\n\t\t\t? InferConfig<T[K]>\n\t\t\t: T[K];\n};\n\n/**\n * Function type for fetching environment variables with Zod validation.\n * Returns a Zod object scoped to a specific environment variable.\n *\n * @template TPath - The environment variable path type\n * @param name - The environment variable name\n * @returns A Zod object for defining the schema\n */\nexport type EnvFetcher<TPath extends string = string> = (\n\tname: TPath,\n) => typeof z;\n\n/**\n * Function type for building environment configuration objects.\n * Takes an EnvFetcher and returns a configuration object with Zod schemas.\n *\n * @template TResponse - The response configuration object type\n * @param get - The environment variable fetcher function\n * @returns The configuration object with Zod schemas\n */\nexport type EnvironmentBuilder<TResponse extends EmptyObject> = (\n\tget: EnvFetcher,\n) => TResponse;\n\n/**\n * Type alias for a generic object with unknown values.\n * Used as a constraint for configuration objects.\n */\nexport type EmptyObject = Record<string | number | symbol, unknown>;\n"],"mappings":"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"}

package/dist/EnvironmentParser-DtOL86NU.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EnvironmentParser-DtOL86NU.d.cts","names":[],"sources":["../src/EnvironmentParser.ts"],"sourcesContent":[],"mappings":";;;;;;AAWA;;;;AAS4B,cATf,YASe,CAAA,kBATgB,WAShB,CAAA,CAAA;EAAG,iBAMT,MAAA;EAAS,iBAArB,OAAA;EAAW;AA2FrB;;;;;EAiJmC,WAClB,CAAA,MAAA,EApPU,SAoPV,EAAA,OAAA,CAAA,EAnPW,GAmPX,CAAA,MAAA,CAAA;EAAU;;;AACX;EA6BJ,KAAA,CAAA,CAAA,EA3QF,WA2Qa,CA3QD,SA2QC,CAAA;EAAA;;;;;;;;;;;;;;;;EAKjB,uBAAC,CAAA,CAAA,EAAA,MAAA,EAAA;AAAC;AAWR;;;;AAEa;AAUb;;;;;AAEc;AAMd;;;;;;;;cApNa,4BAA4B;;;;;;;;;;;sBAWH;;;;;;;;;;;;;;;;;;;;;;;;yBAsId,4BACP,eAAe,UAC5B,aAAa;;;;;;;;;;;;;;;;;;;;;;KA6BL,sBAAsB,6BACrB,IAAI,EAAE,WAAW,CAAA,CAAE,YAC5B,CAAA,CAAE,MAAM,EAAE,MACV,EAAE,WAAW,0BACZ,YAAY,EAAE,MACd,EAAE;;;;;;;;;KAWK,mDACL,iBACK;;;;;;;;;KAUA,qCAAqC,qBAC3C,eACD;;;;;KAMO,WAAA,GAAc"}

package/dist/EnvironmentParser-zMblItla.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"EnvironmentParser-zMblItla.mjs","names":["config: TResponse","envVars: Set<string>","errors: z.core.$ZodIssue[]","config: T","path: string[]","result: EmptyObject","schema: z.ZodType","name: string","issue: z.core.$ZodIssue","builder: (get: EnvFetcher) => TReturn"],"sources":["../src/EnvironmentParser.ts"],"sourcesContent":["import get from 'lodash.get';\nimport set from 'lodash.set';\nimport { z } from 'zod/v4';\nimport { formatParseError, isDevelopment } from './formatter.js';\n\n/**\n * Parses and validates configuration objects against Zod schemas.\n * Handles nested configurations and aggregates validation errors.\n *\n * @template TResponse - The shape of the configuration object\n */\nexport class ConfigParser<TResponse extends EmptyObject> {\n\t/**\n\t * Creates a new ConfigParser instance.\n\t *\n\t * @param config - The configuration object to parse\n\t * @param envVars - Set of environment variable names that were accessed\n\t */\n\tconstructor(\n\t\tprivate readonly config: TResponse,\n\t\tprivate readonly envVars: Set<string> = new Set(),\n\t) {}\n\t/**\n\t * Parses the config object and validates it against the Zod schemas\n\t * @returns The parsed config object\n\t */\n\tparse(): InferConfig<TResponse> {\n\t\tconst errors: z.core.$ZodIssue[] = [];\n\n\t\tconst parseDeep = <T>(config: T, path: string[] = []) => {\n\t\t\tconst result: EmptyObject = {};\n\n\t\t\tif (config && typeof config !== 'object') {\n\t\t\t\treturn config;\n\t\t\t}\n\n\t\t\tfor (const key in config) {\n\t\t\t\tconst schema = config[key];\n\t\t\t\tconst currentPath = [...path, key];\n\n\t\t\t\tif (schema instanceof z.ZodType) {\n\t\t\t\t\tconst parsed = schema.safeParse(undefined);\n\t\t\t\t\tif (parsed.success) {\n\t\t\t\t\t\tset(result, key, parsed.data);\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// If the schema is invalid, assign the error\n\t\t\t\t\t\terrors.push(\n\t\t\t\t\t\t\t...parsed.error.issues.map((issue) => ({\n\t\t\t\t\t\t\t\t...issue,\n\t\t\t\t\t\t\t\tpath: [...currentPath, ...(issue.path as string[])],\n\t\t\t\t\t\t\t})),\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t} else if (schema) {\n\t\t\t\t\tset(result, key, parseDeep(schema as EmptyObject, currentPath));\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn result;\n\t\t};\n\n\t\tconst parsedConfig = parseDeep(\n\t\t\tthis.config,\n\t\t) as unknown as InferConfig<TResponse>;\n\n\t\tif (errors.length > 0) {\n\t\t\tconst zodError = new z.ZodError(errors);\n\t\t\t// In development, log a formatted error message before throwing\n\t\t\tif (isDevelopment()) {\n\t\t\t\tconsole.error(formatParseError(zodError));\n\t\t\t}\n\t\t\tthrow zodError;\n\t\t}\n\n\t\treturn parsedConfig;\n\t}\n\n\t/**\n\t * Returns an array of environment variable names that were accessed during config creation.\n\t * This is useful for deployment and configuration management to know which env vars are required.\n\t *\n\t * @returns Array of environment variable names, sorted alphabetically\n\t *\n\t * @example\n\t * ```typescript\n\t * const config = envParser.create((get) => ({\n\t *   dbUrl: get('DATABASE_URL').string(),\n\t *   port: get('PORT').number()\n\t * }));\n\t *\n\t * config.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']\n\t * ```\n\t */\n\tgetEnvironmentVariables(): string[] {\n\t\treturn Array.from(this.envVars).sort();\n\t}\n}\n\n/**\n * Parses environment variables with type-safe validation using Zod schemas.\n * Provides a fluent API for defining environment variable schemas with automatic\n * error context enrichment.\n *\n * @template T - The type of the configuration object (typically process.env)\n *\n * @example\n * ```typescript\n * const config = new EnvironmentParser(process.env)\n *   .create((get) => ({\n *     port: get('PORT').string().transform(Number).default(3000),\n *     database: {\n *       url: get('DATABASE_URL').string().url()\n *     }\n *   }))\n *   .parse();\n * ```\n */\nexport class EnvironmentParser<T extends EmptyObject> {\n\t/**\n\t * Set to track which environment variable names have been accessed\n\t */\n\tprivate readonly accessedVars: Set<string> = new Set();\n\n\t/**\n\t * Creates a new EnvironmentParser instance.\n\t *\n\t * @param config - The configuration object to parse (typically process.env)\n\t */\n\tconstructor(private readonly config: T) {}\n\n\t/**\n\t * Wraps a Zod schema to intercept parse/safeParse calls and enrich error messages\n\t * with environment variable context.\n\t *\n\t * @param schema - The Zod schema to wrap\n\t * @param name - The environment variable name for error context\n\t * @returns A wrapped Zod schema with enhanced error reporting\n\t */\n\tprivate wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\n\t\t// Create a proxy that intercepts all method calls on the schema\n\t\treturn new Proxy(schema, {\n\t\t\tget: (target, prop) => {\n\t\t\t\tif (prop === 'parse') {\n\t\t\t\t\treturn () => {\n\t\t\t\t\t\tconst value = get(this.config, name);\n\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\treturn target.parse(value);\n\t\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\t\tif (error instanceof z.ZodError) {\n\t\t\t\t\t\t\t\t// Modify the error to include the environment variable name\n\t\t\t\t\t\t\t\tconst modifiedIssues = error.issues.map((issue) => ({\n\t\t\t\t\t\t\t\t\t...issue,\n\t\t\t\t\t\t\t\t\tmessage: `Environment variable \"${name}\": ${issue.message}`,\n\t\t\t\t\t\t\t\t\tpath: [name, ...issue.path],\n\t\t\t\t\t\t\t\t}));\n\t\t\t\t\t\t\t\tthrow new z.ZodError(modifiedIssues);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tthrow error;\n\t\t\t\t\t\t}\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tif (prop === 'safeParse') {\n\t\t\t\t\treturn () => {\n\t\t\t\t\t\tconst value = get(this.config, name);\n\t\t\t\t\t\tconst result = target.safeParse(value);\n\n\t\t\t\t\t\tif (!result.success) {\n\t\t\t\t\t\t\t// Modify the error to include the environment variable name\n\t\t\t\t\t\t\tconst modifiedIssues = result.error.issues.map(\n\t\t\t\t\t\t\t\t(issue: z.core.$ZodIssue) => ({\n\t\t\t\t\t\t\t\t\t...issue,\n\t\t\t\t\t\t\t\t\tmessage: `Environment variable \"${name}\": ${issue.message}`,\n\t\t\t\t\t\t\t\t\tpath: [name, ...issue.path],\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\tsuccess: false as const,\n\t\t\t\t\t\t\t\terror: new z.ZodError(modifiedIssues),\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\treturn result;\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\t// For any method that returns a new schema (like transform, optional, etc.),\n\t\t\t\t// wrap the result as well\n\t\t\t\tconst originalProp = target[prop as keyof typeof target];\n\t\t\t\tif (typeof originalProp === 'function') {\n\t\t\t\t\treturn (...args: any[]) => {\n\t\t\t\t\t\tconst result = originalProp.apply(target, args);\n\t\t\t\t\t\t// If the result is a ZodType, wrap it too\n\t\t\t\t\t\tif (result && typeof result === 'object' && 'parse' in result) {\n\t\t\t\t\t\t\treturn this.wrapSchema(result, name);\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn result;\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\treturn originalProp;\n\t\t\t},\n\t\t});\n\t};\n\n\t/**\n\t * Creates a proxied version of the Zod object that wraps all schema creators\n\t * to provide enhanced error messages with environment variable context.\n\t *\n\t * @param name - The environment variable name\n\t * @returns A proxied Zod object with wrapped schema creators\n\t */\n\tprivate getZodGetter = (name: string) => {\n\t\t// Track that this environment variable was accessed\n\t\tthis.accessedVars.add(name);\n\n\t\t// Return an object that has all Zod schemas but with our wrapper\n\t\treturn new Proxy(\n\t\t\t{ ...z },\n\t\t\t{\n\t\t\t\tget: (target, prop) => {\n\t\t\t\t\t// deno-lint-ignore ban-ts-comment\n\t\t\t\t\t// @ts-expect-error\n\t\t\t\t\tconst value = target[prop];\n\n\t\t\t\t\tif (typeof value === 'function') {\n\t\t\t\t\t\t// Return a wrapper around each Zod schema creator\n\t\t\t\t\t\treturn (...args: any[]) => {\n\t\t\t\t\t\t\tconst schema = value(...args);\n\t\t\t\t\t\t\treturn this.wrapSchema(schema, name);\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\n\t\t\t\t\t// Handle objects like z.coerce\n\t\t\t\t\tif (value && typeof value === 'object') {\n\t\t\t\t\t\treturn new Proxy(value, {\n\t\t\t\t\t\t\tget: (nestedTarget, nestedProp) => {\n\t\t\t\t\t\t\t\tconst nestedValue =\n\t\t\t\t\t\t\t\t\tnestedTarget[nestedProp as keyof typeof nestedTarget];\n\t\t\t\t\t\t\t\tif (typeof nestedValue === 'function') {\n\t\t\t\t\t\t\t\t\treturn (...args: any[]) => {\n\t\t\t\t\t\t\t\t\t\tconst schema = nestedValue(...args);\n\t\t\t\t\t\t\t\t\t\treturn this.wrapSchema(schema, name);\n\t\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\treturn nestedValue;\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\n\t\t\t\t\treturn value;\n\t\t\t\t},\n\t\t\t},\n\t\t);\n\t};\n\n\t/**\n\t * Creates a new ConfigParser object that can be used to parse the config object\n\t *\n\t * @param builder - A function that takes a getter function and returns a config object\n\t * @returns A ConfigParser object that can be used to parse the config object\n\t */\n\tcreate<TReturn extends EmptyObject>(\n\t\tbuilder: (get: EnvFetcher) => TReturn,\n\t): ConfigParser<TReturn> {\n\t\tconst config = builder(this.getZodGetter);\n\t\treturn new ConfigParser(config, this.accessedVars);\n\t}\n\n\t/**\n\t * Returns an array of environment variable names that were accessed via the getter.\n\t * This is useful for build-time analysis to determine which env vars a service needs.\n\t *\n\t * @returns Array of environment variable names, sorted alphabetically\n\t *\n\t * @example\n\t * ```typescript\n\t * const sniffer = new EnvironmentParser({});\n\t * service.register(sniffer);\n\t * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']\n\t * ```\n\t */\n\tgetEnvironmentVariables(): string[] {\n\t\treturn Array.from(this.accessedVars).sort();\n\t}\n}\n\n/**\n * Infers the TypeScript type of a configuration object based on its Zod schemas.\n * Recursively processes nested objects and extracts types from Zod schemas.\n *\n * @template T - The configuration object type\n */\nexport type InferConfig<T extends EmptyObject> = {\n\t[K in keyof T]: T[K] extends z.ZodSchema\n\t\t? z.infer<T[K]>\n\t\t: T[K] extends Record<string, unknown>\n\t\t\t? InferConfig<T[K]>\n\t\t\t: T[K];\n};\n\n/**\n * Function type for fetching environment variables with Zod validation.\n * Returns a Zod object scoped to a specific environment variable.\n *\n * @template TPath - The environment variable path type\n * @param name - The environment variable name\n * @returns A Zod object for defining the schema\n */\nexport type EnvFetcher<TPath extends string = string> = (\n\tname: TPath,\n) => typeof z;\n\n/**\n * Function type for building environment configuration objects.\n * Takes an EnvFetcher and returns a configuration object with Zod schemas.\n *\n * @template TResponse - The response configuration object type\n * @param get - The environment variable fetcher function\n * @returns The configuration object with Zod schemas\n */\nexport type EnvironmentBuilder<TResponse extends EmptyObject> = (\n\tget: EnvFetcher,\n) => TResponse;\n\n/**\n * Type alias for a generic object with unknown values.\n * Used as a constraint for configuration objects.\n */\nexport type EmptyObject = Record<string | number | symbol, unknown>;\n"],"mappings":"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"}

package/dist/EnvironmentParser.cjs

@@ -1,5 +0,0 @@
-require('./formatter-HxePpSy2.cjs');
-const require_EnvironmentParser = require('./EnvironmentParser-DJdW7vOL.cjs');
-
-exports.ConfigParser = require_EnvironmentParser.ConfigParser;
-exports.EnvironmentParser = require_EnvironmentParser.EnvironmentParser;

package/dist/EnvironmentParser.d.cts

@@ -1,2 +0,0 @@
-import { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig } from "./EnvironmentParser-DtOL86NU.cjs";
-export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };

package/dist/EnvironmentParser.d.mts

@@ -1,2 +0,0 @@
-import { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig } from "./EnvironmentParser-CkLfmn4Y.mjs";
-export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };

package/dist/EnvironmentParser.mjs

@@ -1,4 +0,0 @@
-import "./formatter-BRRrxQi3.mjs";
-import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-zMblItla.mjs";
-
-export { ConfigParser, EnvironmentParser };

package/dist/SstEnvironmentBuilder-BRAcRQp2.d.mts

@@ -1,186 +0,0 @@
-import { EnvRecord, EnvironmentBuilderOptions, EnvironmentResolver, InputValue, Resolvers } from "./EnvironmentBuilder-jF-b7WQg.mjs";
-
-//#region src/SstEnvironmentBuilder.d.ts
-
-/**
- * Enumeration of supported SST (Serverless Stack Toolkit) resource types.
- * Used to identify and process different AWS and SST resources.
- */
-declare enum ResourceType {
-  ApiGatewayV2 = "sst.aws.ApiGatewayV2",
-  Postgres = "sst.aws.Postgres",
-  Function = "sst.aws.Function",
-  Bucket = "sst.aws.Bucket",
-  Vpc = "sst.aws.Vpc",
-  Secret = "sst.sst.Secret",
-  Dynamo = "sst.aws.Dynamo",
-  SSTSecret = "sst:sst:Secret",
-  SSTFunction = "sst:sst:Function",
-  SSTApiGatewayV2 = "sst:aws:ApiGatewayV2",
-  SSTPostgres = "sst:aws:Postgres",
-  SSTBucket = "sst:aws:Bucket",
-  SnsTopic = "sst:aws:SnsTopic",
-  SSTDynamo = "sst:aws:Dynamo",
-}
-/**
- * AWS API Gateway V2 resource type.
- * Represents an HTTP/WebSocket API.
- */
-type ApiGatewayV2 = {
-  type: ResourceType.ApiGatewayV2 | ResourceType.SSTApiGatewayV2;
-  url: string;
-};
-/**
- * PostgreSQL database resource type.
- * Contains all connection details needed to connect to the database.
- */
-type Postgres = {
-  type: ResourceType.Postgres | ResourceType.SSTPostgres;
-  database: string;
-  host: string;
-  password: string;
-  port: number;
-  username: string;
-};
-/**
- * AWS Lambda Function resource type.
- */
-type Function = {
-  type: ResourceType.Function | ResourceType.SSTFunction;
-  name: string;
-};
-/**
- * AWS S3 Bucket resource type.
- */
-type Bucket = {
-  type: ResourceType.Bucket | ResourceType.SSTBucket;
-  name: string;
-};
-/**
- * AWS VPC (Virtual Private Cloud) resource type.
- */
-type Vpc = {
-  type: ResourceType.Vpc;
-  bastion: string;
-};
-/**
- * Secret resource type for storing sensitive values.
- */
-type Secret = {
-  type: ResourceType.Secret | ResourceType.SSTSecret;
-  value: string;
-};
-/**
- * AWS SNS Topic resource type.
- */
-type SnsTopic = {
-  type: ResourceType.SnsTopic;
-  arn: string;
-};
-/**
- * AWS DynamoDB Table resource type.
- */
-type Dynamo = {
-  type: ResourceType.Dynamo | ResourceType.SSTDynamo;
-  name: string;
-};
-/**
- * Union type of all supported SST resource types.
- */
-type SstResource = ApiGatewayV2 | Postgres | Function | Bucket | Vpc | Secret | SnsTopic | Dynamo;
-/**
- * Function type for processing a specific resource type into environment variables.
- *
- * @template K - The specific resource type (without `type` key)
- * @param name - The resource name
- * @param value - The resource value (without `type` key)
- * @returns Object mapping environment variable names to values
- */
-type ResourceProcessor<K> = (name: string, value: K) => EnvRecord;
-/**
- * Pre-configured resolvers for all SST resource types.
- */
-declare const sstResolvers: Resolvers;
-/**
- * All known SST resource type strings.
- */
-type SstResourceTypeString = `${ResourceType}`;
-/**
- * Extracts the `type` string value from an input value.
- */
-type ExtractType<T> = T extends {
-  type: infer U extends string;
-} ? U : never;
-/**
- * Removes the `type` key from an object type.
- */
-type OmitType<T> = T extends {
-  type: string;
-} ? Omit<T, 'type'> : never;
-/**
- * Extracts all unique `type` values from a record (excluding plain strings).
- */
-type AllTypeValues<TRecord extends Record<string, InputValue>> = { [K in keyof TRecord]: ExtractType<TRecord[K]> }[keyof TRecord];
-/**
- * Extracts only the custom (non-SST) type values from a record.
- */
-type CustomTypeValues<TRecord extends Record<string, InputValue>> = Exclude<AllTypeValues<TRecord>, SstResourceTypeString>;
-/**
- * For a given type value, finds the corresponding value type (without `type` key).
- */
-type ValueForType<TRecord extends Record<string, InputValue>, TType extends string> = { [K in keyof TRecord]: TRecord[K] extends {
-  type: TType;
-} ? OmitType<TRecord[K]> : never }[keyof TRecord];
-/**
- * Generates typed resolvers for custom (non-SST) types in the input record.
- */
-type CustomResolvers<TRecord extends Record<string, InputValue>> = CustomTypeValues<TRecord> extends never ? Resolvers | undefined : { [TType in CustomTypeValues<TRecord>]: EnvironmentResolver<ValueForType<TRecord, TType>> };
-/**
- * SST-specific environment builder with built-in resolvers for all known
- * SST resource types.
- *
- * Wraps the generic EnvironmentBuilder with pre-configured SST resolvers.
- *
- * @template TRecord - The input record type for type inference
- *
- * @example
- * ```typescript
- * const env = new SstEnvironmentBuilder({
- *   database: { type: 'sst:aws:Postgres', host: '...', ... },
- *   apiKey: { type: 'sst:sst:Secret', value: 'secret' },
- *   appName: 'my-app',
- * }).build();
- *
- * // With custom resolvers (typed based on input)
- * const env = new SstEnvironmentBuilder(
- *   {
- *     database: postgresResource,
- *     custom: { type: 'my-custom' as const, data: 'foo' },
- *   },
- *   {
- *     // TypeScript requires 'my-custom' resolver with typed value
- *     'my-custom': (key, value) => ({ [`${key}Data`]: value.data }),
- *   }
- * ).build();
- * ```
- */
-declare class SstEnvironmentBuilder<TRecord extends Record<string, SstResource | InputValue | string>> {
-  private readonly builder;
-  /**
-   * Create a new SST environment builder.
-   *
-   * @param record - Object containing SST resources, custom resources, and/or string values
-   * @param additionalResolvers - Optional custom resolvers (typed based on custom types in record)
-   * @param options - Optional configuration options
-   */
-  constructor(record: TRecord, additionalResolvers?: CustomResolvers<TRecord>, options?: EnvironmentBuilderOptions);
-  /**
-   * Build environment variables from the input record.
-   *
-   * @returns A record of environment variables
-   */
-  build(): EnvRecord;
-}
-//#endregion
-export { ApiGatewayV2, Bucket, Dynamo, Function, Postgres, ResourceProcessor, ResourceType, Secret, SnsTopic, SstEnvironmentBuilder, SstResource, Vpc, sstResolvers };
-//# sourceMappingURL=SstEnvironmentBuilder-BRAcRQp2.d.mts.map

package/dist/SstEnvironmentBuilder-BRAcRQp2.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SstEnvironmentBuilder-BRAcRQp2.d.mts","names":[],"sources":["../src/SstEnvironmentBuilder.ts"],"sourcesContent":[],"mappings":"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"}