@geekmidas/envkit 0.0.6 → 0.0.8

package/dist/{EnvironmentParser-C-arQEHQ.d.mts → EnvironmentParser-B8--woiB.d.cts}

@@ -10,17 +10,36 @@ import { z } from "zod/v4";
  */
 declare class ConfigParser<TResponse extends EmptyObject> {
   private readonly config;
+  private readonly envVars;
   /**
    * Creates a new ConfigParser instance.
    *
    * @param config - The configuration object to parse
+   * @param envVars - Set of environment variable names that were accessed
    */
-  constructor(config: TResponse);
+  constructor(config: TResponse, envVars?: Set<string>);
   /**
    * Parses the config object and validates it against the Zod schemas
    * @returns The parsed config object
    */
   parse(): InferConfig<TResponse>;
+  /**
+   * Returns an array of environment variable names that were accessed during config creation.
+   * This is useful for deployment and configuration management to know which env vars are required.
+   *
+   * @returns Array of environment variable names, sorted alphabetically
+   *
+   * @example
+   * ```typescript
+   * const config = envParser.create((get) => ({
+   *   dbUrl: get('DATABASE_URL').string(),
+   *   port: get('PORT').number()
+   * }));
+   *
+   * config.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']
+   * ```
+   */
+  getEnvironmentVariables(): string[];
 }
 /**
  * Parses environment variables with type-safe validation using Zod schemas.
@@ -43,6 +62,10 @@ declare class ConfigParser<TResponse extends EmptyObject> {
  */
 declare class EnvironmentParser<T extends EmptyObject> {
   private readonly config;
+  /**
+   * Set to track which environment variable names have been accessed
+   */
+  private readonly accessedVars;
   /**
    * Creates a new EnvironmentParser instance.
    *
@@ -73,6 +96,20 @@ declare class EnvironmentParser<T extends EmptyObject> {
    * @returns A ConfigParser object that can be used to parse the config object
    */
   create<TReturn extends EmptyObject>(builder: (get: EnvFetcher) => TReturn): ConfigParser<TReturn>;
+  /**
+   * Returns an array of environment variable names that were accessed via the getter.
+   * This is useful for build-time analysis to determine which env vars a service needs.
+   *
+   * @returns Array of environment variable names, sorted alphabetically
+   *
+   * @example
+   * ```typescript
+   * const sniffer = new EnvironmentParser({});
+   * service.register(sniffer);
+   * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']
+   * ```
+   */
+  getEnvironmentVariables(): string[];
 }
 /**
  * Infers the TypeScript type of a configuration object based on its Zod schemas.
@@ -105,4 +142,5 @@ type EnvironmentBuilder<TResponse extends EmptyObject> = (get: EnvFetcher) => TR
  */
 type EmptyObject = Record<string | number | symbol, unknown>;
 //#endregion
-export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };
+export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };
+//# sourceMappingURL=EnvironmentParser-B8--woiB.d.cts.map

package/dist/{EnvironmentParser-X4h2Vp4r.d.cts → EnvironmentParser-C_9v2BDw.d.mts}

@@ -10,17 +10,36 @@ import { z } from "zod/v4";
  */
 declare class ConfigParser<TResponse extends EmptyObject> {
   private readonly config;
+  private readonly envVars;
   /**
    * Creates a new ConfigParser instance.
    *
    * @param config - The configuration object to parse
+   * @param envVars - Set of environment variable names that were accessed
    */
-  constructor(config: TResponse);
+  constructor(config: TResponse, envVars?: Set<string>);
   /**
    * Parses the config object and validates it against the Zod schemas
    * @returns The parsed config object
    */
   parse(): InferConfig<TResponse>;
+  /**
+   * Returns an array of environment variable names that were accessed during config creation.
+   * This is useful for deployment and configuration management to know which env vars are required.
+   *
+   * @returns Array of environment variable names, sorted alphabetically
+   *
+   * @example
+   * ```typescript
+   * const config = envParser.create((get) => ({
+   *   dbUrl: get('DATABASE_URL').string(),
+   *   port: get('PORT').number()
+   * }));
+   *
+   * config.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']
+   * ```
+   */
+  getEnvironmentVariables(): string[];
 }
 /**
  * Parses environment variables with type-safe validation using Zod schemas.
@@ -43,6 +62,10 @@ declare class ConfigParser<TResponse extends EmptyObject> {
  */
 declare class EnvironmentParser<T extends EmptyObject> {
   private readonly config;
+  /**
+   * Set to track which environment variable names have been accessed
+   */
+  private readonly accessedVars;
   /**
    * Creates a new EnvironmentParser instance.
    *
@@ -73,6 +96,20 @@ declare class EnvironmentParser<T extends EmptyObject> {
    * @returns A ConfigParser object that can be used to parse the config object
    */
   create<TReturn extends EmptyObject>(builder: (get: EnvFetcher) => TReturn): ConfigParser<TReturn>;
+  /**
+   * Returns an array of environment variable names that were accessed via the getter.
+   * This is useful for build-time analysis to determine which env vars a service needs.
+   *
+   * @returns Array of environment variable names, sorted alphabetically
+   *
+   * @example
+   * ```typescript
+   * const sniffer = new EnvironmentParser({});
+   * service.register(sniffer);
+   * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']
+   * ```
+   */
+  getEnvironmentVariables(): string[];
 }
 /**
  * Infers the TypeScript type of a configuration object based on its Zod schemas.
@@ -105,4 +142,5 @@ type EnvironmentBuilder<TResponse extends EmptyObject> = (get: EnvFetcher) => TR
  */
 type EmptyObject = Record<string | number | symbol, unknown>;
 //#endregion
-export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };
+export { ConfigParser, EmptyObject, EnvFetcher, EnvironmentBuilder, EnvironmentParser, InferConfig };
+//# sourceMappingURL=EnvironmentParser-C_9v2BDw.d.mts.map

package/dist/{EnvironmentParser-CQUOGqc0.mjs → EnvironmentParser-STvN_RCc.mjs}

@@ -14,9 +14,11 @@ var ConfigParser = class {
 	* Creates a new ConfigParser instance.
 	*
 	* @param config - The configuration object to parse
+	* @param envVars - Set of environment variable names that were accessed
 	*/
-	constructor(config) {
+	constructor(config, envVars = /* @__PURE__ */ new Set()) {
 		this.config = config;
+		this.envVars = envVars;
 	}
 	/**
 	* Parses the config object and validates it against the Zod schemas
@@ -45,6 +47,25 @@ var ConfigParser = class {
 		if (errors.length > 0) throw new z.ZodError(errors);
 		return parsedConfig;
 	}
+	/**
+	* Returns an array of environment variable names that were accessed during config creation.
+	* This is useful for deployment and configuration management to know which env vars are required.
+	*
+	* @returns Array of environment variable names, sorted alphabetically
+	*
+	* @example
+	* ```typescript
+	* const config = envParser.create((get) => ({
+	*   dbUrl: get('DATABASE_URL').string(),
+	*   port: get('PORT').number()
+	* }));
+	*
+	* config.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']
+	* ```
+	*/
+	getEnvironmentVariables() {
+		return Array.from(this.envVars).sort();
+	}
 };
 /**
 * Parses environment variables with type-safe validation using Zod schemas.
@@ -66,6 +87,10 @@ var ConfigParser = class {
 * ```
 */
 var EnvironmentParser = class {
+	/**
+	* Set to track which environment variable names have been accessed
+	*/
+	accessedVars = /* @__PURE__ */ new Set();
 	/**
 	* Creates a new EnvironmentParser instance.
 	*
@@ -133,6 +158,7 @@ var EnvironmentParser = class {
 	* @returns A proxied Zod object with wrapped schema creators
 	*/
 	getZodGetter = (name) => {
+		this.accessedVars.add(name);
 		return new Proxy({ ...z }, { get: (target, prop) => {
 			const value = target[prop];
 			if (typeof value === "function") return (...args) => {
@@ -158,9 +184,26 @@ var EnvironmentParser = class {
 	*/
 	create(builder) {
 		const config = builder(this.getZodGetter);
-		return new ConfigParser(config);
+		return new ConfigParser(config, this.accessedVars);
+	}
+	/**
+	* Returns an array of environment variable names that were accessed via the getter.
+	* This is useful for build-time analysis to determine which env vars a service needs.
+	*
+	* @returns Array of environment variable names, sorted alphabetically
+	*
+	* @example
+	* ```typescript
+	* const sniffer = new EnvironmentParser({});
+	* service.register(sniffer);
+	* const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']
+	* ```
+	*/
+	getEnvironmentVariables() {
+		return Array.from(this.accessedVars).sort();
 	}
 };
 
 //#endregion
-export { ConfigParser, EnvironmentParser };
+export { ConfigParser, EnvironmentParser };
+//# sourceMappingURL=EnvironmentParser-STvN_RCc.mjs.map

package/dist/EnvironmentParser-STvN_RCc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentParser-STvN_RCc.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';\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  /**\n   * Creates a new ConfigParser instance.\n   *\n   * @param config - The configuration object to parse\n   * @param envVars - Set of environment variable names that were accessed\n   */\n  constructor(\n    private readonly config: TResponse,\n    private readonly envVars: Set<string> = new Set(),\n  ) {}\n  /**\n   * Parses the config object and validates it against the Zod schemas\n   * @returns The parsed config object\n   */\n  parse(): InferConfig<TResponse> {\n    const errors: z.core.$ZodIssue[] = [];\n\n    const parseDeep = <T>(config: T, path: string[] = []) => {\n      const result: EmptyObject = {};\n\n      if (config && typeof config !== 'object') {\n        return config;\n      }\n\n      for (const key in config) {\n        const schema = config[key];\n        const currentPath = [...path, key];\n\n        if (schema instanceof z.ZodType) {\n          const parsed = schema.safeParse(undefined);\n          if (parsed.success) {\n            set(result, key, parsed.data);\n          } else {\n            // If the schema is invalid, assign the error\n            errors.push(\n              ...parsed.error.issues.map((issue) => ({\n                ...issue,\n                path: [...currentPath, ...(issue.path as string[])],\n              })),\n            );\n          }\n        } else if (schema) {\n          set(result, key, parseDeep(schema as EmptyObject, currentPath));\n        }\n      }\n\n      return result;\n    };\n\n    const parsedConfig = parseDeep(\n      this.config,\n    ) as unknown as InferConfig<TResponse>;\n\n    if (errors.length > 0) {\n      // If there are errors, throw them\n      throw new z.ZodError(errors);\n    }\n\n    return parsedConfig;\n  }\n\n  /**\n   * Returns an array of environment variable names that were accessed during config creation.\n   * This is useful for deployment and configuration management to know which env vars are required.\n   *\n   * @returns Array of environment variable names, sorted alphabetically\n   *\n   * @example\n   * ```typescript\n   * const config = envParser.create((get) => ({\n   *   dbUrl: get('DATABASE_URL').string(),\n   *   port: get('PORT').number()\n   * }));\n   *\n   * config.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']\n   * ```\n   */\n  getEnvironmentVariables(): string[] {\n    return Array.from(this.envVars).sort();\n  }\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  /**\n   * Set to track which environment variable names have been accessed\n   */\n  private readonly accessedVars: Set<string> = new Set();\n\n  /**\n   * Creates a new EnvironmentParser instance.\n   *\n   * @param config - The configuration object to parse (typically process.env)\n   */\n  constructor(private readonly config: T) {}\n\n  /**\n   * Wraps a Zod schema to intercept parse/safeParse calls and enrich error messages\n   * with environment variable context.\n   *\n   * @param schema - The Zod schema to wrap\n   * @param name - The environment variable name for error context\n   * @returns A wrapped Zod schema with enhanced error reporting\n   */\n  private wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\n    // Create a proxy that intercepts all method calls on the schema\n    return new Proxy(schema, {\n      get: (target, prop) => {\n        if (prop === 'parse') {\n          return () => {\n            const value = get(this.config, name);\n            try {\n              return target.parse(value);\n            } catch (error) {\n              if (error instanceof z.ZodError) {\n                // Modify the error to include the environment variable name\n                const modifiedIssues = error.issues.map((issue) => ({\n                  ...issue,\n                  message: `Environment variable \"${name}\": ${issue.message}`,\n                  path: [name, ...issue.path],\n                }));\n                throw new z.ZodError(modifiedIssues);\n              }\n              throw error;\n            }\n          };\n        }\n\n        if (prop === 'safeParse') {\n          return () => {\n            const value = get(this.config, name);\n            const result = target.safeParse(value);\n\n            if (!result.success) {\n              // Modify the error to include the environment variable name\n              const modifiedIssues = result.error.issues.map(\n                (issue: z.core.$ZodIssue) => ({\n                  ...issue,\n                  message: `Environment variable \"${name}\": ${issue.message}`,\n                  path: [name, ...issue.path],\n                }),\n              );\n              return {\n                success: false as const,\n                error: new z.ZodError(modifiedIssues),\n              };\n            }\n\n            return result;\n          };\n        }\n\n        // For any method that returns a new schema (like transform, optional, etc.),\n        // wrap the result as well\n        const originalProp = target[prop as keyof typeof target];\n        if (typeof originalProp === 'function') {\n          return (...args: any[]) => {\n            const result = originalProp.apply(target, args);\n            // If the result is a ZodType, wrap it too\n            if (result && typeof result === 'object' && 'parse' in result) {\n              return this.wrapSchema(result, name);\n            }\n            return result;\n          };\n        }\n\n        return originalProp;\n      },\n    });\n  };\n\n  /**\n   * Creates a proxied version of the Zod object that wraps all schema creators\n   * to provide enhanced error messages with environment variable context.\n   *\n   * @param name - The environment variable name\n   * @returns A proxied Zod object with wrapped schema creators\n   */\n  private getZodGetter = (name: string) => {\n    // Track that this environment variable was accessed\n    this.accessedVars.add(name);\n\n    // Return an object that has all Zod schemas but with our wrapper\n    return new Proxy(\n      { ...z },\n      {\n        get: (target, prop) => {\n          // deno-lint-ignore ban-ts-comment\n          // @ts-ignore\n          const value = target[prop];\n\n          if (typeof value === 'function') {\n            // Return a wrapper around each Zod schema creator\n            return (...args: any[]) => {\n              const schema = value(...args);\n              return this.wrapSchema(schema, name);\n            };\n          }\n\n          // Handle objects like z.coerce\n          if (value && typeof value === 'object') {\n            return new Proxy(value, {\n              get: (nestedTarget, nestedProp) => {\n                const nestedValue =\n                  nestedTarget[nestedProp as keyof typeof nestedTarget];\n                if (typeof nestedValue === 'function') {\n                  return (...args: any[]) => {\n                    const schema = nestedValue(...args);\n                    return this.wrapSchema(schema, name);\n                  };\n                }\n                return nestedValue;\n              },\n            });\n          }\n\n          return value;\n        },\n      },\n    );\n  };\n\n  /**\n   * Creates a new ConfigParser object that can be used to parse the config object\n   *\n   * @param builder - A function that takes a getter function and returns a config object\n   * @returns A ConfigParser object that can be used to parse the config object\n   */\n  create<TReturn extends EmptyObject>(\n    builder: (get: EnvFetcher) => TReturn,\n  ): ConfigParser<TReturn> {\n    const config = builder(this.getZodGetter);\n    return new ConfigParser(config, this.accessedVars);\n  }\n\n  /**\n   * Returns an array of environment variable names that were accessed via the getter.\n   * This is useful for build-time analysis to determine which env vars a service needs.\n   *\n   * @returns Array of environment variable names, sorted alphabetically\n   *\n   * @example\n   * ```typescript\n   * const sniffer = new EnvironmentParser({});\n   * service.register(sniffer);\n   * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']\n   * ```\n   */\n  getEnvironmentVariables(): string[] {\n    return Array.from(this.accessedVars).sort();\n  }\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  [K in keyof T]: T[K] extends z.ZodSchema\n    ? z.infer<T[K]>\n    : T[K] extends Record<string, unknown>\n      ? InferConfig<T[K]>\n      : 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  name: 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  get: 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-BDPDLv6i.cjs → EnvironmentParser-cnxuy7lw.cjs}

@@ -15,9 +15,11 @@ var ConfigParser = class {
 	* Creates a new ConfigParser instance.
 	*
 	* @param config - The configuration object to parse
+	* @param envVars - Set of environment variable names that were accessed
 	*/
-	constructor(config) {
+	constructor(config, envVars = /* @__PURE__ */ new Set()) {
 		this.config = config;
+		this.envVars = envVars;
 	}
 	/**
 	* Parses the config object and validates it against the Zod schemas
@@ -46,6 +48,25 @@ var ConfigParser = class {
 		if (errors.length > 0) throw new zod_v4.z.ZodError(errors);
 		return parsedConfig;
 	}
+	/**
+	* Returns an array of environment variable names that were accessed during config creation.
+	* This is useful for deployment and configuration management to know which env vars are required.
+	*
+	* @returns Array of environment variable names, sorted alphabetically
+	*
+	* @example
+	* ```typescript
+	* const config = envParser.create((get) => ({
+	*   dbUrl: get('DATABASE_URL').string(),
+	*   port: get('PORT').number()
+	* }));
+	*
+	* config.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']
+	* ```
+	*/
+	getEnvironmentVariables() {
+		return Array.from(this.envVars).sort();
+	}
 };
 /**
 * Parses environment variables with type-safe validation using Zod schemas.
@@ -67,6 +88,10 @@ var ConfigParser = class {
 * ```
 */
 var EnvironmentParser = class {
+	/**
+	* Set to track which environment variable names have been accessed
+	*/
+	accessedVars = /* @__PURE__ */ new Set();
 	/**
 	* Creates a new EnvironmentParser instance.
 	*
@@ -134,6 +159,7 @@ var EnvironmentParser = class {
 	* @returns A proxied Zod object with wrapped schema creators
 	*/
 	getZodGetter = (name) => {
+		this.accessedVars.add(name);
 		return new Proxy({ ...zod_v4.z }, { get: (target, prop) => {
 			const value = target[prop];
 			if (typeof value === "function") return (...args) => {
@@ -159,7 +185,23 @@ var EnvironmentParser = class {
 	*/
 	create(builder) {
 		const config = builder(this.getZodGetter);
-		return new ConfigParser(config);
+		return new ConfigParser(config, this.accessedVars);
+	}
+	/**
+	* Returns an array of environment variable names that were accessed via the getter.
+	* This is useful for build-time analysis to determine which env vars a service needs.
+	*
+	* @returns Array of environment variable names, sorted alphabetically
+	*
+	* @example
+	* ```typescript
+	* const sniffer = new EnvironmentParser({});
+	* service.register(sniffer);
+	* const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']
+	* ```
+	*/
+	getEnvironmentVariables() {
+		return Array.from(this.accessedVars).sort();
 	}
 };
 
@@ -175,4 +217,5 @@ Object.defineProperty(exports, 'EnvironmentParser', {
   get: function () {
     return EnvironmentParser;
   }
-});
+});
+//# sourceMappingURL=EnvironmentParser-cnxuy7lw.cjs.map

package/dist/EnvironmentParser-cnxuy7lw.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentParser-cnxuy7lw.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';\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  /**\n   * Creates a new ConfigParser instance.\n   *\n   * @param config - The configuration object to parse\n   * @param envVars - Set of environment variable names that were accessed\n   */\n  constructor(\n    private readonly config: TResponse,\n    private readonly envVars: Set<string> = new Set(),\n  ) {}\n  /**\n   * Parses the config object and validates it against the Zod schemas\n   * @returns The parsed config object\n   */\n  parse(): InferConfig<TResponse> {\n    const errors: z.core.$ZodIssue[] = [];\n\n    const parseDeep = <T>(config: T, path: string[] = []) => {\n      const result: EmptyObject = {};\n\n      if (config && typeof config !== 'object') {\n        return config;\n      }\n\n      for (const key in config) {\n        const schema = config[key];\n        const currentPath = [...path, key];\n\n        if (schema instanceof z.ZodType) {\n          const parsed = schema.safeParse(undefined);\n          if (parsed.success) {\n            set(result, key, parsed.data);\n          } else {\n            // If the schema is invalid, assign the error\n            errors.push(\n              ...parsed.error.issues.map((issue) => ({\n                ...issue,\n                path: [...currentPath, ...(issue.path as string[])],\n              })),\n            );\n          }\n        } else if (schema) {\n          set(result, key, parseDeep(schema as EmptyObject, currentPath));\n        }\n      }\n\n      return result;\n    };\n\n    const parsedConfig = parseDeep(\n      this.config,\n    ) as unknown as InferConfig<TResponse>;\n\n    if (errors.length > 0) {\n      // If there are errors, throw them\n      throw new z.ZodError(errors);\n    }\n\n    return parsedConfig;\n  }\n\n  /**\n   * Returns an array of environment variable names that were accessed during config creation.\n   * This is useful for deployment and configuration management to know which env vars are required.\n   *\n   * @returns Array of environment variable names, sorted alphabetically\n   *\n   * @example\n   * ```typescript\n   * const config = envParser.create((get) => ({\n   *   dbUrl: get('DATABASE_URL').string(),\n   *   port: get('PORT').number()\n   * }));\n   *\n   * config.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']\n   * ```\n   */\n  getEnvironmentVariables(): string[] {\n    return Array.from(this.envVars).sort();\n  }\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  /**\n   * Set to track which environment variable names have been accessed\n   */\n  private readonly accessedVars: Set<string> = new Set();\n\n  /**\n   * Creates a new EnvironmentParser instance.\n   *\n   * @param config - The configuration object to parse (typically process.env)\n   */\n  constructor(private readonly config: T) {}\n\n  /**\n   * Wraps a Zod schema to intercept parse/safeParse calls and enrich error messages\n   * with environment variable context.\n   *\n   * @param schema - The Zod schema to wrap\n   * @param name - The environment variable name for error context\n   * @returns A wrapped Zod schema with enhanced error reporting\n   */\n  private wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\n    // Create a proxy that intercepts all method calls on the schema\n    return new Proxy(schema, {\n      get: (target, prop) => {\n        if (prop === 'parse') {\n          return () => {\n            const value = get(this.config, name);\n            try {\n              return target.parse(value);\n            } catch (error) {\n              if (error instanceof z.ZodError) {\n                // Modify the error to include the environment variable name\n                const modifiedIssues = error.issues.map((issue) => ({\n                  ...issue,\n                  message: `Environment variable \"${name}\": ${issue.message}`,\n                  path: [name, ...issue.path],\n                }));\n                throw new z.ZodError(modifiedIssues);\n              }\n              throw error;\n            }\n          };\n        }\n\n        if (prop === 'safeParse') {\n          return () => {\n            const value = get(this.config, name);\n            const result = target.safeParse(value);\n\n            if (!result.success) {\n              // Modify the error to include the environment variable name\n              const modifiedIssues = result.error.issues.map(\n                (issue: z.core.$ZodIssue) => ({\n                  ...issue,\n                  message: `Environment variable \"${name}\": ${issue.message}`,\n                  path: [name, ...issue.path],\n                }),\n              );\n              return {\n                success: false as const,\n                error: new z.ZodError(modifiedIssues),\n              };\n            }\n\n            return result;\n          };\n        }\n\n        // For any method that returns a new schema (like transform, optional, etc.),\n        // wrap the result as well\n        const originalProp = target[prop as keyof typeof target];\n        if (typeof originalProp === 'function') {\n          return (...args: any[]) => {\n            const result = originalProp.apply(target, args);\n            // If the result is a ZodType, wrap it too\n            if (result && typeof result === 'object' && 'parse' in result) {\n              return this.wrapSchema(result, name);\n            }\n            return result;\n          };\n        }\n\n        return originalProp;\n      },\n    });\n  };\n\n  /**\n   * Creates a proxied version of the Zod object that wraps all schema creators\n   * to provide enhanced error messages with environment variable context.\n   *\n   * @param name - The environment variable name\n   * @returns A proxied Zod object with wrapped schema creators\n   */\n  private getZodGetter = (name: string) => {\n    // Track that this environment variable was accessed\n    this.accessedVars.add(name);\n\n    // Return an object that has all Zod schemas but with our wrapper\n    return new Proxy(\n      { ...z },\n      {\n        get: (target, prop) => {\n          // deno-lint-ignore ban-ts-comment\n          // @ts-ignore\n          const value = target[prop];\n\n          if (typeof value === 'function') {\n            // Return a wrapper around each Zod schema creator\n            return (...args: any[]) => {\n              const schema = value(...args);\n              return this.wrapSchema(schema, name);\n            };\n          }\n\n          // Handle objects like z.coerce\n          if (value && typeof value === 'object') {\n            return new Proxy(value, {\n              get: (nestedTarget, nestedProp) => {\n                const nestedValue =\n                  nestedTarget[nestedProp as keyof typeof nestedTarget];\n                if (typeof nestedValue === 'function') {\n                  return (...args: any[]) => {\n                    const schema = nestedValue(...args);\n                    return this.wrapSchema(schema, name);\n                  };\n                }\n                return nestedValue;\n              },\n            });\n          }\n\n          return value;\n        },\n      },\n    );\n  };\n\n  /**\n   * Creates a new ConfigParser object that can be used to parse the config object\n   *\n   * @param builder - A function that takes a getter function and returns a config object\n   * @returns A ConfigParser object that can be used to parse the config object\n   */\n  create<TReturn extends EmptyObject>(\n    builder: (get: EnvFetcher) => TReturn,\n  ): ConfigParser<TReturn> {\n    const config = builder(this.getZodGetter);\n    return new ConfigParser(config, this.accessedVars);\n  }\n\n  /**\n   * Returns an array of environment variable names that were accessed via the getter.\n   * This is useful for build-time analysis to determine which env vars a service needs.\n   *\n   * @returns Array of environment variable names, sorted alphabetically\n   *\n   * @example\n   * ```typescript\n   * const sniffer = new EnvironmentParser({});\n   * service.register(sniffer);\n   * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'PORT']\n   * ```\n   */\n  getEnvironmentVariables(): string[] {\n    return Array.from(this.accessedVars).sort();\n  }\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  [K in keyof T]: T[K] extends z.ZodSchema\n    ? z.infer<T[K]>\n    : T[K] extends Record<string, unknown>\n      ? InferConfig<T[K]>\n      : 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  name: 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  get: 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,4 +1,4 @@
-const require_EnvironmentParser = require('./EnvironmentParser-BDPDLv6i.cjs');
+const require_EnvironmentParser = require('./EnvironmentParser-cnxuy7lw.cjs');
 
 exports.ConfigParser = require_EnvironmentParser.ConfigParser;
 exports.EnvironmentParser = require_EnvironmentParser.EnvironmentParser;

package/dist/EnvironmentParser.d.cts

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

package/dist/EnvironmentParser.d.mts

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

package/dist/EnvironmentParser.mjs

@@ -1,3 +1,3 @@
-import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-CQUOGqc0.mjs";
+import { ConfigParser, EnvironmentParser } from "./EnvironmentParser-STvN_RCc.mjs";
 
 export { ConfigParser, EnvironmentParser };

package/dist/SnifferEnvironmentParser.cjs

@@ -0,0 +1,140 @@
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const require_EnvironmentParser = require('./EnvironmentParser-cnxuy7lw.cjs');
+const zod_v4 = require_chunk.__toESM(require("zod/v4"));
+
+//#region src/SnifferEnvironmentParser.ts
+/**
+* A specialized EnvironmentParser for build-time analysis that tracks
+* which environment variables are accessed without requiring actual values.
+*
+* Unlike the regular EnvironmentParser, the sniffer:
+* - Always returns mock values from .parse() and .safeParse()
+* - Never throws validation errors
+* - Tracks all accessed environment variable names
+*
+* This allows service registration to succeed during build-time analysis
+* even when environment variables are not set.
+*
+* @example
+* ```typescript
+* const sniffer = new SnifferEnvironmentParser();
+* await service.register(sniffer); // Always succeeds
+* const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'API_KEY']
+* ```
+*/
+var SnifferEnvironmentParser = class {
+	accessedVars = /* @__PURE__ */ new Set();
+	/**
+	* Wraps a Zod schema to always return mock values.
+	* This ensures .parse() and .safeParse() never fail.
+	*/
+	wrapSchema = (schema, name) => {
+		return new Proxy(schema, { get: (target, prop) => {
+			if (prop === "parse") return () => this.getMockValue(target);
+			if (prop === "safeParse") return () => ({
+				success: true,
+				data: this.getMockValue(target)
+			});
+			const originalProp = target[prop];
+			if (typeof originalProp === "function") return (...args) => {
+				const result = originalProp.apply(target, args);
+				if (result && typeof result === "object" && "parse" in result) return this.wrapSchema(result, name);
+				return result;
+			};
+			return originalProp;
+		} });
+	};
+	/**
+	* Returns a mock value based on the Zod schema type.
+	*/
+	getMockValue(schema) {
+		if (schema instanceof zod_v4.z.ZodString) return "";
+		if (schema instanceof zod_v4.z.ZodNumber) return 0;
+		if (schema instanceof zod_v4.z.ZodBoolean) return false;
+		if (schema instanceof zod_v4.z.ZodArray) return [];
+		if (schema instanceof zod_v4.z.ZodOptional) return void 0;
+		if (schema instanceof zod_v4.z.ZodNullable) return null;
+		if (schema instanceof zod_v4.z.ZodObject && schema.shape) {
+			const result = {};
+			for (const [key, value] of Object.entries(schema.shape)) if (value instanceof zod_v4.z.ZodType) result[key] = this.getMockValue(value);
+			return result;
+		}
+		return "";
+	}
+	/**
+	* Creates a proxied Zod getter that tracks environment variable access.
+	*/
+	getZodGetter = (name) => {
+		this.accessedVars.add(name);
+		return new Proxy({ ...zod_v4.z }, { get: (target, prop) => {
+			const value = target[prop];
+			if (typeof value === "function") return (...args) => {
+				const schema = value(...args);
+				return this.wrapSchema(schema, name);
+			};
+			if (value && typeof value === "object") return new Proxy(value, { get: (nestedTarget, nestedProp) => {
+				const nestedValue = nestedTarget[nestedProp];
+				if (typeof nestedValue === "function") return (...args) => {
+					const schema = nestedValue(...args);
+					return this.wrapSchema(schema, name);
+				};
+				return nestedValue;
+			} });
+			return value;
+		} });
+	};
+	/**
+	* Creates a ConfigParser that will return mock values when parsed.
+	*/
+	create(builder) {
+		const config = builder(this.getZodGetter);
+		return new SnifferConfigParser(config, this.accessedVars);
+	}
+	/**
+	* Returns all environment variable names that were accessed.
+	*/
+	getEnvironmentVariables() {
+		return Array.from(this.accessedVars).sort();
+	}
+};
+/**
+* A ConfigParser that always succeeds with mock values.
+*/
+var SnifferConfigParser = class extends require_EnvironmentParser.ConfigParser {
+	parse() {
+		return this.parseWithMocks(this.getConfig());
+	}
+	getConfig() {
+		return this.config;
+	}
+	parseWithMocks(config) {
+		const result = {};
+		if (config && typeof config !== "object") return config;
+		for (const key in config) {
+			const schema = config[key];
+			if (schema instanceof zod_v4.z.ZodType) {
+				const parsed = schema.safeParse(void 0);
+				result[key] = parsed.success ? parsed.data : this.getDefaultForSchema(schema);
+			} else if (schema && typeof schema === "object") result[key] = this.parseWithMocks(schema);
+		}
+		return result;
+	}
+	getDefaultForSchema(schema) {
+		if (schema instanceof zod_v4.z.ZodString) return "";
+		if (schema instanceof zod_v4.z.ZodNumber) return 0;
+		if (schema instanceof zod_v4.z.ZodBoolean) return false;
+		if (schema instanceof zod_v4.z.ZodArray) return [];
+		if (schema instanceof zod_v4.z.ZodOptional) return void 0;
+		if (schema instanceof zod_v4.z.ZodNullable) return null;
+		if (schema instanceof zod_v4.z.ZodObject && schema.shape) {
+			const result = {};
+			for (const [key, value] of Object.entries(schema.shape)) if (value instanceof zod_v4.z.ZodType) result[key] = this.getDefaultForSchema(value);
+			return result;
+		}
+		return "";
+	}
+};
+
+//#endregion
+exports.SnifferEnvironmentParser = SnifferEnvironmentParser;
+//# sourceMappingURL=SnifferEnvironmentParser.cjs.map

package/dist/SnifferEnvironmentParser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnifferEnvironmentParser.cjs","names":["schema: z.ZodType","name: string","z","result: Record<string, unknown>","builder: (get: EnvFetcher) => TReturn","ConfigParser","config: T","result: EmptyObject"],"sources":["../src/SnifferEnvironmentParser.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport {\n  ConfigParser,\n  type EmptyObject,\n  type EnvFetcher,\n} from './EnvironmentParser';\n\n/**\n * A specialized EnvironmentParser for build-time analysis that tracks\n * which environment variables are accessed without requiring actual values.\n *\n * Unlike the regular EnvironmentParser, the sniffer:\n * - Always returns mock values from .parse() and .safeParse()\n * - Never throws validation errors\n * - Tracks all accessed environment variable names\n *\n * This allows service registration to succeed during build-time analysis\n * even when environment variables are not set.\n *\n * @example\n * ```typescript\n * const sniffer = new SnifferEnvironmentParser();\n * await service.register(sniffer); // Always succeeds\n * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'API_KEY']\n * ```\n */\nexport class SnifferEnvironmentParser<\n  T extends EmptyObject = EmptyObject,\n> {\n  private readonly accessedVars: Set<string> = new Set();\n\n  /**\n   * Wraps a Zod schema to always return mock values.\n   * This ensures .parse() and .safeParse() never fail.\n   */\n  private wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\n    return new Proxy(schema, {\n      get: (target, prop) => {\n        if (prop === 'parse') {\n          return () => this.getMockValue(target);\n        }\n\n        if (prop === 'safeParse') {\n          return () => ({\n            success: true as const,\n            data: this.getMockValue(target),\n          });\n        }\n\n        const originalProp = target[prop as keyof typeof target];\n        if (typeof originalProp === 'function') {\n          return (...args: any[]) => {\n            const result = originalProp.apply(target, args);\n            if (result && typeof result === 'object' && 'parse' in result) {\n              return this.wrapSchema(result, name);\n            }\n            return result;\n          };\n        }\n\n        return originalProp;\n      },\n    });\n  };\n\n  /**\n   * Returns a mock value based on the Zod schema type.\n   */\n  private getMockValue(schema: z.ZodType): unknown {\n    // Return type-appropriate mock values\n    if (schema instanceof z.ZodString) return '';\n    if (schema instanceof z.ZodNumber) return 0;\n    if (schema instanceof z.ZodBoolean) return false;\n    if (schema instanceof z.ZodArray) return [];\n    if (schema instanceof z.ZodOptional) return undefined;\n    if (schema instanceof z.ZodNullable) return null;\n\n    // For object schemas, build mock object from shape\n    if (schema instanceof z.ZodObject && schema.shape) {\n      const result: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(schema.shape)) {\n        if (value instanceof z.ZodType) {\n          result[key] = this.getMockValue(value);\n        }\n      }\n      return result;\n    }\n\n    return '';\n  }\n\n  /**\n   * Creates a proxied Zod getter that tracks environment variable access.\n   */\n  private getZodGetter = (name: string) => {\n    this.accessedVars.add(name);\n\n    return new Proxy(\n      { ...z },\n      {\n        get: (target, prop) => {\n          // @ts-ignore\n          const value = target[prop];\n\n          if (typeof value === 'function') {\n            return (...args: any[]) => {\n              const schema = value(...args);\n              return this.wrapSchema(schema, name);\n            };\n          }\n\n          if (value && typeof value === 'object') {\n            return new Proxy(value, {\n              get: (nestedTarget, nestedProp) => {\n                const nestedValue =\n                  nestedTarget[nestedProp as keyof typeof nestedTarget];\n                if (typeof nestedValue === 'function') {\n                  return (...args: any[]) => {\n                    const schema = nestedValue(...args);\n                    return this.wrapSchema(schema, name);\n                  };\n                }\n                return nestedValue;\n              },\n            });\n          }\n\n          return value;\n        },\n      },\n    );\n  };\n\n  /**\n   * Creates a ConfigParser that will return mock values when parsed.\n   */\n  create<TReturn extends EmptyObject>(\n    builder: (get: EnvFetcher) => TReturn,\n  ): ConfigParser<TReturn> {\n    const config = builder(this.getZodGetter);\n    return new SnifferConfigParser(config, this.accessedVars);\n  }\n\n  /**\n   * Returns all environment variable names that were accessed.\n   */\n  getEnvironmentVariables(): string[] {\n    return Array.from(this.accessedVars).sort();\n  }\n}\n\n/**\n * A ConfigParser that always succeeds with mock values.\n */\nclass SnifferConfigParser<TResponse extends EmptyObject> extends ConfigParser<TResponse> {\n  parse(): any {\n    return this.parseWithMocks(this.getConfig());\n  }\n\n  private getConfig(): TResponse {\n    // Access the private config via any cast\n    return (this as any).config;\n  }\n\n  private parseWithMocks<T>(config: T): any {\n    const result: EmptyObject = {};\n\n    if (config && typeof config !== 'object') {\n      return config;\n    }\n\n    for (const key in config) {\n      const schema = config[key];\n\n      if (schema instanceof z.ZodType) {\n        // Use safeParse which will return mock values from our wrapped schema\n        const parsed = schema.safeParse(undefined);\n        result[key] = parsed.success ? parsed.data : this.getDefaultForSchema(schema);\n      } else if (schema && typeof schema === 'object') {\n        result[key] = this.parseWithMocks(schema as EmptyObject);\n      }\n    }\n\n    return result;\n  }\n\n  private getDefaultForSchema(schema: z.ZodType): unknown {\n    if (schema instanceof z.ZodString) return '';\n    if (schema instanceof z.ZodNumber) return 0;\n    if (schema instanceof z.ZodBoolean) return false;\n    if (schema instanceof z.ZodArray) return [];\n    if (schema instanceof z.ZodOptional) return undefined;\n    if (schema instanceof z.ZodNullable) return null;\n\n    if (schema instanceof z.ZodObject && schema.shape) {\n      const result: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(schema.shape)) {\n        if (value instanceof z.ZodType) {\n          result[key] = this.getDefaultForSchema(value);\n        }\n      }\n      return result;\n    }\n\n    return '';\n  }\n}\n"],"mappings":"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"}

package/dist/SnifferEnvironmentParser.d.cts

@@ -0,0 +1,50 @@
+import { ConfigParser, EmptyObject, EnvFetcher } from "./EnvironmentParser-B8--woiB.cjs";
+
+//#region src/SnifferEnvironmentParser.d.ts
+
+/**
+ * A specialized EnvironmentParser for build-time analysis that tracks
+ * which environment variables are accessed without requiring actual values.
+ *
+ * Unlike the regular EnvironmentParser, the sniffer:
+ * - Always returns mock values from .parse() and .safeParse()
+ * - Never throws validation errors
+ * - Tracks all accessed environment variable names
+ *
+ * This allows service registration to succeed during build-time analysis
+ * even when environment variables are not set.
+ *
+ * @example
+ * ```typescript
+ * const sniffer = new SnifferEnvironmentParser();
+ * await service.register(sniffer); // Always succeeds
+ * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'API_KEY']
+ * ```
+ */
+declare class SnifferEnvironmentParser<T extends EmptyObject = EmptyObject> {
+  private readonly accessedVars;
+  /**
+   * Wraps a Zod schema to always return mock values.
+   * This ensures .parse() and .safeParse() never fail.
+   */
+  private wrapSchema;
+  /**
+   * Returns a mock value based on the Zod schema type.
+   */
+  private getMockValue;
+  /**
+   * Creates a proxied Zod getter that tracks environment variable access.
+   */
+  private getZodGetter;
+  /**
+   * Creates a ConfigParser that will return mock values when parsed.
+   */
+  create<TReturn extends EmptyObject>(builder: (get: EnvFetcher) => TReturn): ConfigParser<TReturn>;
+  /**
+   * Returns all environment variable names that were accessed.
+   */
+  getEnvironmentVariables(): string[];
+}
+//#endregion
+export { SnifferEnvironmentParser };
+//# sourceMappingURL=SnifferEnvironmentParser.d.cts.map