@geekmidas/envkit 10.0.0-alpha.99 → 10.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/CHANGELOG.md +117 -0
  2. package/README.md +2 -2
  3. package/dist/{EnvironmentBuilder-Rxq657gm.mjs → EnvironmentBuilder-CFen3oIg.mjs} +6 -5
  4. package/dist/EnvironmentBuilder-CFen3oIg.mjs.map +1 -0
  5. package/dist/{EnvironmentBuilder-DTZ8o3se.d.cts → EnvironmentBuilder-CNgcdzSR.d.cts} +6 -6
  6. package/dist/EnvironmentBuilder-CNgcdzSR.d.cts.map +1 -0
  7. package/dist/{EnvironmentBuilder-wJH3EBbJ.cjs → EnvironmentBuilder-DDgLJAAo.cjs} +17 -17
  8. package/dist/EnvironmentBuilder-DDgLJAAo.cjs.map +1 -0
  9. package/dist/{EnvironmentBuilder-DTZ8o3se.d.mts → EnvironmentBuilder-DHfDXJUm.d.mts} +6 -6
  10. package/dist/EnvironmentBuilder-DHfDXJUm.d.mts.map +1 -0
  11. package/dist/{EnvironmentParser-BmJLlm5_.d.cts → EnvironmentParser-BY1oCUsc.d.mts} +15 -3
  12. package/dist/EnvironmentParser-BY1oCUsc.d.mts.map +1 -0
  13. package/dist/{EnvironmentParser-CmhDxs77.cjs → EnvironmentParser-Bzg5yXG2.cjs} +34 -34
  14. package/dist/EnvironmentParser-Bzg5yXG2.cjs.map +1 -0
  15. package/dist/{EnvironmentParser-BmJLlm5_.d.mts → EnvironmentParser-DoooZm8n.d.cts} +15 -3
  16. package/dist/EnvironmentParser-DoooZm8n.d.cts.map +1 -0
  17. package/dist/{EnvironmentParser-X6Z-jryw.mjs → EnvironmentParser-taAKfzT7.mjs} +12 -10
  18. package/dist/EnvironmentParser-taAKfzT7.mjs.map +1 -0
  19. package/dist/SnifferEnvironmentParser.cjs +7 -5
  20. package/dist/SnifferEnvironmentParser.cjs.map +1 -1
  21. package/dist/SnifferEnvironmentParser.d.cts +9 -5
  22. package/dist/SnifferEnvironmentParser.d.cts.map +1 -1
  23. package/dist/SnifferEnvironmentParser.d.mts +9 -5
  24. package/dist/SnifferEnvironmentParser.d.mts.map +1 -1
  25. package/dist/SnifferEnvironmentParser.mjs +5 -3
  26. package/dist/SnifferEnvironmentParser.mjs.map +1 -1
  27. package/dist/{rolldown-runtime-VH7oDXx4.cjs → chunk-CUT6urMc.cjs} +10 -8
  28. package/dist/credentials.cjs +11 -9
  29. package/dist/credentials.cjs.map +1 -1
  30. package/dist/credentials.d.cts +3 -3
  31. package/dist/credentials.d.cts.map +1 -1
  32. package/dist/credentials.d.mts +3 -3
  33. package/dist/credentials.d.mts.map +1 -1
  34. package/dist/credentials.mjs +8 -4
  35. package/dist/credentials.mjs.map +1 -1
  36. package/dist/index.cjs +4 -4
  37. package/dist/index.d.cts +7 -5
  38. package/dist/index.d.cts.map +1 -1
  39. package/dist/index.d.mts +7 -5
  40. package/dist/index.d.mts.map +1 -1
  41. package/dist/index.mjs +4 -3
  42. package/dist/sst.cjs +48 -59
  43. package/dist/sst.cjs.map +1 -1
  44. package/dist/sst.d.cts +26 -35
  45. package/dist/sst.d.cts.map +1 -1
  46. package/dist/sst.d.mts +26 -35
  47. package/dist/sst.d.mts.map +1 -1
  48. package/dist/sst.mjs +48 -58
  49. package/dist/sst.mjs.map +1 -1
  50. package/docs/api-reference.md +302 -0
  51. package/docs/async-secrets-design.md +355 -0
  52. package/examples/basic-usage.ts +386 -0
  53. package/package.json +2 -9
  54. package/src/EnvironmentBuilder.ts +192 -0
  55. package/src/EnvironmentParser.ts +330 -0
  56. package/src/SnifferEnvironmentParser.ts +334 -0
  57. package/src/SstEnvValidator.ts +369 -0
  58. package/src/SstEnvironmentBuilder.ts +343 -0
  59. package/src/__tests__/ConfigParser.spec.ts +394 -0
  60. package/src/__tests__/EnvironmentBuilder.spec.ts +254 -0
  61. package/src/__tests__/EnvironmentParser.spec.ts +839 -0
  62. package/src/__tests__/SnifferEnvironmentParser.spec.ts +644 -0
  63. package/src/__tests__/SstEnvValidator.spec.ts +236 -0
  64. package/src/__tests__/SstEnvironmentBuilder.spec.ts +397 -0
  65. package/src/__tests__/credentials.integration.spec.ts +239 -0
  66. package/src/__tests__/credentials.spec.ts +136 -0
  67. package/src/__tests__/formatter.spec.ts +268 -0
  68. package/src/__tests__/sst.spec.ts +437 -0
  69. package/src/credentials.ts +112 -0
  70. package/src/formatter.ts +146 -0
  71. package/src/index.ts +24 -0
  72. package/src/sst.ts +76 -0
  73. package/sst-env.d.ts +8 -0
  74. package/tsconfig.json +9 -0
  75. package/tsdown.config.ts +18 -0
  76. package/dist/EnvironmentBuilder-DTZ8o3se.d.cts.map +0 -1
  77. package/dist/EnvironmentBuilder-DTZ8o3se.d.mts.map +0 -1
  78. package/dist/EnvironmentBuilder-Rxq657gm.mjs.map +0 -1
  79. package/dist/EnvironmentBuilder-wJH3EBbJ.cjs.map +0 -1
  80. package/dist/EnvironmentParser-BmJLlm5_.d.cts.map +0 -1
  81. package/dist/EnvironmentParser-BmJLlm5_.d.mts.map +0 -1
  82. package/dist/EnvironmentParser-CmhDxs77.cjs.map +0 -1
  83. package/dist/EnvironmentParser-X6Z-jryw.mjs.map +0 -1
@@ -1,6 +1,7 @@
1
+ import { z } from "zod/v4";
1
2
  import get from "lodash.get";
2
3
  import set from "lodash.set";
3
- import { z } from "zod/v4";
4
+
4
5
  //#region src/formatter.ts
5
6
  /**
6
7
  * ANSI color codes for terminal output.
@@ -45,7 +46,8 @@ const colors = {
45
46
  * ```
46
47
  */
47
48
  function formatParseError(error, options = {}) {
48
- const c = options.colors ?? (process.stdout?.isTTY && process.env.NO_COLOR == null) ? colors : {
49
+ const useColors = options.colors ?? (process.stdout?.isTTY && process.env.NO_COLOR == null);
50
+ const c = useColors ? colors : {
49
51
  reset: "",
50
52
  red: "",
51
53
  yellow: "",
@@ -63,7 +65,8 @@ function formatParseError(error, options = {}) {
63
65
  if (match?.[1]) envName = match[1];
64
66
  }
65
67
  const received = "received" in issue ? issue.received : void 0;
66
- if (issue.code === "invalid_type" && (received === "undefined" || received === "null")) missingVars.push({
68
+ const isMissing = issue.code === "invalid_type" && (received === "undefined" || received === "null");
69
+ if (isMissing) missingVars.push({
67
70
  name: envName || "Unknown",
68
71
  message: cleanMessage(issue.message)
69
72
  });
@@ -106,6 +109,7 @@ function isDevelopment() {
106
109
  const nodeEnv = process.env.NODE_ENV?.toLowerCase();
107
110
  return nodeEnv == null || nodeEnv === "development" || nodeEnv === "dev";
108
111
  }
112
+
109
113
  //#endregion
110
114
  //#region src/EnvironmentParser.ts
111
115
  /**
@@ -115,8 +119,6 @@ function isDevelopment() {
115
119
  * @template TResponse - The shape of the configuration object
116
120
  */
117
121
  var ConfigParser = class {
118
- config;
119
- envVars;
120
122
  /**
121
123
  * Creates a new ConfigParser instance.
122
124
  *
@@ -198,7 +200,6 @@ var ConfigParser = class {
198
200
  * ```
199
201
  */
200
202
  var EnvironmentParser = class {
201
- config;
202
203
  /**
203
204
  * Set to track which environment variable names have been accessed
204
205
  */
@@ -295,7 +296,8 @@ var EnvironmentParser = class {
295
296
  * @returns A ConfigParser object that can be used to parse the config object
296
297
  */
297
298
  create(builder) {
298
- return new ConfigParser(builder(this.getZodGetter), this.accessedVars);
299
+ const config = builder(this.getZodGetter);
300
+ return new ConfigParser(config, this.accessedVars);
299
301
  }
300
302
  /**
301
303
  * Returns an array of environment variable names that were accessed via the getter.
@@ -314,7 +316,7 @@ var EnvironmentParser = class {
314
316
  return Array.from(this.accessedVars).sort();
315
317
  }
316
318
  };
317
- //#endregion
318
- export { isDevelopment as i, EnvironmentParser as n, formatParseError as r, ConfigParser as t };
319
319
 
320
- //# sourceMappingURL=EnvironmentParser-X6Z-jryw.mjs.map
320
+ //#endregion
321
+ export { ConfigParser, EnvironmentParser, formatParseError, isDevelopment };
322
+ //# sourceMappingURL=EnvironmentParser-taAKfzT7.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EnvironmentParser-taAKfzT7.mjs","names":["error: z.ZodError","options: FormatOptions","missingVars: Array<{ name: string; message: string }>","invalidVars: Array<{ name: string; value: unknown; message: string }>","lines: string[]","message: string","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/formatter.ts","../src/EnvironmentParser.ts"],"sourcesContent":["import type { z } from 'zod/v4';\n\n/**\n * Options for formatting parse errors.\n */\nexport interface FormatOptions {\n\t/** Whether to use colors in output. Defaults to auto-detect TTY. */\n\tcolors?: boolean;\n}\n\n/**\n * ANSI color codes for terminal output.\n */\nconst colors = {\n\treset: '\\x1b[0m',\n\tred: '\\x1b[31m',\n\tyellow: '\\x1b[33m',\n\tcyan: '\\x1b[36m',\n\tdim: '\\x1b[2m',\n\tbold: '\\x1b[1m',\n};\n\n/**\n * Formats a ZodError into a user-friendly string for development.\n *\n * @param error - The ZodError to format\n * @param options - Formatting options\n * @returns Formatted error message\n *\n * @example\n * ```typescript\n * try {\n * config.parse();\n * } catch (error) {\n * if (error instanceof ZodError) {\n * console.error(formatParseError(error));\n * }\n * }\n * ```\n *\n * Output:\n * ```\n * Environment Configuration Failed\n *\n * Missing Variables:\n * DATABASE_URL - Required\n * JWT_SECRET - Required\n *\n * Invalid Values:\n * NODE_ENV = \"invalid\"\n * Expected: \"development\" | \"staging\" | \"production\"\n * ```\n */\nexport function formatParseError(\n\terror: z.ZodError,\n\toptions: FormatOptions = {},\n): string {\n\tconst useColors =\n\t\toptions.colors ?? (process.stdout?.isTTY && process.env.NO_COLOR == null);\n\n\tconst c = useColors\n\t\t? colors\n\t\t: { reset: '', red: '', yellow: '', cyan: '', dim: '', bold: '' };\n\n\tconst missingVars: Array<{ name: string; message: string }> = [];\n\tconst invalidVars: Array<{ name: string; value: unknown; message: string }> =\n\t\t[];\n\n\tfor (const issue of error.issues) {\n\t\t// Extract environment variable name from path or message\n\t\tlet envName = '';\n\t\tif (issue.path.length > 0) {\n\t\t\t// Join the full path with '.' to show nested config keys and env var name\n\t\t\tenvName = issue.path.map(String).join('.');\n\t\t} else {\n\t\t\t// Try to extract from message like 'Environment variable \"NAME\": ...'\n\t\t\tconst match = issue.message.match(/Environment variable \"([^\"]+)\"/);\n\t\t\tif (match?.[1]) {\n\t\t\t\tenvName = match[1];\n\t\t\t}\n\t\t}\n\n\t\t// Determine if this is a missing or invalid value\n\t\t// Use type guard for received property\n\t\tconst received = 'received' in issue ? issue.received : undefined;\n\t\tconst isMissing =\n\t\t\tissue.code === 'invalid_type' &&\n\t\t\t(received === 'undefined' || received === 'null');\n\n\t\tif (isMissing) {\n\t\t\tmissingVars.push({\n\t\t\t\tname: envName || 'Unknown',\n\t\t\t\tmessage: cleanMessage(issue.message),\n\t\t\t});\n\t\t} else {\n\t\t\tinvalidVars.push({\n\t\t\t\tname: envName || 'Unknown',\n\t\t\t\tvalue: received,\n\t\t\t\tmessage: cleanMessage(issue.message),\n\t\t\t});\n\t\t}\n\t}\n\n\tconst lines: string[] = [];\n\n\tlines.push('');\n\tlines.push(`${c.red}${c.bold}Environment Configuration Failed${c.reset}`);\n\tlines.push('');\n\n\tif (missingVars.length > 0) {\n\t\tlines.push(`${c.yellow}Missing Variables:${c.reset}`);\n\t\tfor (const v of missingVars) {\n\t\t\tlines.push(` ${c.cyan}${v.name}${c.reset} ${c.dim}- Required${c.reset}`);\n\t\t}\n\t\tlines.push('');\n\t}\n\n\tif (invalidVars.length > 0) {\n\t\tlines.push(`${c.yellow}Invalid Values:${c.reset}`);\n\t\tfor (const v of invalidVars) {\n\t\t\tconst valueStr =\n\t\t\t\tv.value !== undefined ? ` = ${JSON.stringify(v.value)}` : '';\n\t\t\tlines.push(` ${c.cyan}${v.name}${c.reset}${valueStr}`);\n\t\t\tlines.push(` ${c.dim}${v.message}${c.reset}`);\n\t\t}\n\t\tlines.push('');\n\t}\n\n\treturn lines.join('\\n');\n}\n\n/**\n * Cleans up a Zod error message by removing redundant prefixes.\n */\nfunction cleanMessage(message: string): string {\n\t// Remove \"Environment variable \"NAME\": \" prefix if present\n\treturn message.replace(/^Environment variable \"[^\"]+\": /, '');\n}\n\n/**\n * Checks if the current environment is development.\n */\nexport function isDevelopment(): boolean {\n\tconst nodeEnv = process.env.NODE_ENV?.toLowerCase();\n\treturn nodeEnv == null || nodeEnv === 'development' || nodeEnv === 'dev';\n}\n","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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"}
@@ -1,6 +1,7 @@
1
- Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_EnvironmentParser = require("./EnvironmentParser-CmhDxs77.cjs");
3
- let zod_v4 = require("zod/v4");
1
+ const require_chunk = require('./chunk-CUT6urMc.cjs');
2
+ const require_EnvironmentParser = require('./EnvironmentParser-Bzg5yXG2.cjs');
3
+ const zod_v4 = require_chunk.__toESM(require("zod/v4"));
4
+
4
5
  //#region src/SnifferEnvironmentParser.ts
5
6
  /**
6
7
  * A specialized EnvironmentParser for build-time analysis that tracks
@@ -89,7 +90,8 @@ var SnifferEnvironmentParser = class {
89
90
  * Creates a ConfigParser that will return mock values when parsed.
90
91
  */
91
92
  create(builder) {
92
- return new SnifferConfigParser(builder(this.getZodGetter), this.accessedVars);
93
+ const config = builder(this.getZodGetter);
94
+ return new SnifferConfigParser(config, this.accessedVars);
93
95
  }
94
96
  /**
95
97
  * Returns all environment variable names that were accessed.
@@ -203,8 +205,8 @@ async function sniffWithFireAndForget(sniffer, operation, options = {}) {
203
205
  unhandledRejections
204
206
  };
205
207
  }
208
+
206
209
  //#endregion
207
210
  exports.SnifferEnvironmentParser = SnifferEnvironmentParser;
208
211
  exports.sniffWithFireAndForget = sniffWithFireAndForget;
209
-
210
212
  //# sourceMappingURL=SnifferEnvironmentParser.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"SnifferEnvironmentParser.cjs","names":["z","ConfigParser"],"sources":["../src/SnifferEnvironmentParser.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport {\n\tConfigParser,\n\ttype EmptyObject,\n\ttype 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<_T extends EmptyObject = EmptyObject> {\n\tprivate readonly accessedVars: Set<string> = new Set();\n\tprivate readonly optionalVars: Set<string> = new Set();\n\n\t/**\n\t * Wraps a Zod schema to always return mock values.\n\t * This ensures .parse() and .safeParse() never fail.\n\t * Also detects when .optional() or .default() is called to track optional vars.\n\t */\n\tprivate wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\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 () => this.getMockValue(target);\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\tsuccess: true as const,\n\t\t\t\t\t\tdata: this.getMockValue(target),\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\t// Detect .optional() or .default() — mark the variable as optional\n\t\t\t\tif (prop === 'optional' || prop === 'default') {\n\t\t\t\t\tthis.optionalVars.add(name);\n\t\t\t\t}\n\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\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 * Returns a mock value based on the Zod schema type.\n\t */\n\tprivate getMockValue(schema: z.ZodType): unknown {\n\t\t// Return type-appropriate mock values\n\t\tif (schema instanceof z.ZodString) return '';\n\t\tif (schema instanceof z.ZodNumber) return 0;\n\t\tif (schema instanceof z.ZodBoolean) return false;\n\t\tif (schema instanceof z.ZodArray) return [];\n\t\tif (schema instanceof z.ZodOptional) return undefined;\n\t\tif (schema instanceof z.ZodNullable) return null;\n\n\t\t// For object schemas, build mock object from shape\n\t\tif (schema instanceof z.ZodObject && schema.shape) {\n\t\t\tconst result: Record<string, unknown> = {};\n\t\t\tfor (const [key, value] of Object.entries(schema.shape)) {\n\t\t\t\tif (value instanceof z.ZodType) {\n\t\t\t\t\tresult[key] = this.getMockValue(value);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\treturn '';\n\t}\n\n\t/**\n\t * Creates a proxied Zod getter that tracks environment variable access.\n\t */\n\tprivate getZodGetter = (name: string) => {\n\t\tthis.accessedVars.add(name);\n\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// @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\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\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 ConfigParser that will return mock values when parsed.\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 SnifferConfigParser(config, this.accessedVars);\n\t}\n\n\t/**\n\t * Returns all environment variable names that were accessed.\n\t *\n\t * @param opts.markOptional - When true, optional variables (those accessed\n\t * via `.optional()` or `.default()`) are suffixed with `?` (e.g. `PORT?`).\n\t */\n\tgetEnvironmentVariables(opts?: { markOptional?: boolean }): string[] {\n\t\tconst vars = Array.from(this.accessedVars).sort();\n\t\tif (!opts?.markOptional) return vars;\n\t\treturn vars.map((name) =>\n\t\t\tthis.optionalVars.has(name) ? `${name}?` : name,\n\t\t);\n\t}\n\n\t/**\n\t * Returns all environment variable names that were accessed via\n\t * `.optional()` or `.default()` — i.e. variables that are not required.\n\t */\n\tgetOptionalVariables(): string[] {\n\t\treturn Array.from(this.optionalVars).sort();\n\t}\n}\n\n/**\n * A ConfigParser that always succeeds with mock values.\n */\nclass SnifferConfigParser<\n\tTResponse extends EmptyObject,\n> extends ConfigParser<TResponse> {\n\toverride parse(): any {\n\t\treturn this.parseWithMocks(this.getConfig());\n\t}\n\n\tprivate getConfig(): TResponse {\n\t\t// Access the private config via any cast\n\t\treturn (this as any).config;\n\t}\n\n\tprivate parseWithMocks<T>(config: T): any {\n\t\tconst result: EmptyObject = {};\n\n\t\tif (config && typeof config !== 'object') {\n\t\t\treturn config;\n\t\t}\n\n\t\tfor (const key in config) {\n\t\t\tconst schema = config[key];\n\n\t\t\tif (schema instanceof z.ZodType) {\n\t\t\t\t// Use safeParse which will return mock values from our wrapped schema\n\t\t\t\tconst parsed = schema.safeParse(undefined);\n\t\t\t\tresult[key] = parsed.success\n\t\t\t\t\t? parsed.data\n\t\t\t\t\t: this.getDefaultForSchema(schema);\n\t\t\t} else if (schema && typeof schema === 'object') {\n\t\t\t\tresult[key] = this.parseWithMocks(schema as EmptyObject);\n\t\t\t}\n\t\t}\n\n\t\treturn result;\n\t}\n\n\tprivate getDefaultForSchema(schema: z.ZodType): unknown {\n\t\tif (schema instanceof z.ZodString) return '';\n\t\tif (schema instanceof z.ZodNumber) return 0;\n\t\tif (schema instanceof z.ZodBoolean) return false;\n\t\tif (schema instanceof z.ZodArray) return [];\n\t\tif (schema instanceof z.ZodOptional) return undefined;\n\t\tif (schema instanceof z.ZodNullable) return null;\n\n\t\tif (schema instanceof z.ZodObject && schema.shape) {\n\t\t\tconst result: Record<string, unknown> = {};\n\t\t\tfor (const [key, value] of Object.entries(schema.shape)) {\n\t\t\t\tif (value instanceof z.ZodType) {\n\t\t\t\t\tresult[key] = this.getDefaultForSchema(value);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\treturn '';\n\t}\n}\n\n/**\n * Result of sniffing with fire-and-forget handling.\n */\nexport interface SniffResult {\n\t/** All environment variable names that were accessed during sniffing */\n\tenvVars: string[];\n\t/**\n\t * Subset of envVars that are optional (accessed via `.optional()` or\n\t * `.default()`). These do not need to be present for the app to start.\n\t */\n\toptionalEnvVars: string[];\n\t/** Error thrown during sniffing (env vars may still be captured) */\n\terror?: Error;\n\t/** Unhandled promise rejections captured during sniffing */\n\tunhandledRejections: Error[];\n}\n\n/**\n * Options for sniffing with fire-and-forget handling.\n */\nexport interface SniffOptions {\n\t/**\n\t * Time in milliseconds to wait for fire-and-forget promises to settle.\n\t * Some libraries like better-auth create async operations that may reject\n\t * after the initial event loop tick.\n\t * @default 100\n\t */\n\tsettleTimeMs?: number;\n}\n\n/**\n * Executes a sniffing operation with fire-and-forget handling.\n *\n * This function:\n * 1. Captures unhandled promise rejections during the operation\n * 2. Waits for async operations to settle before returning\n * 3. Gracefully handles errors without throwing\n *\n * Use this when sniffing environment variables from code that may:\n * - Throw synchronous errors\n * - Create fire-and-forget promises that reject\n * - Have async initialization that may fail\n *\n * @param sniffer - The SnifferEnvironmentParser instance to use\n * @param operation - The async operation to execute (e.g., service.register)\n * @param options - Optional configuration\n * @returns SniffResult with env vars and any errors encountered\n *\n * @example\n * ```typescript\n * const sniffer = new SnifferEnvironmentParser();\n * const result = await sniffWithFireAndForget(sniffer, async () => {\n * await service.register({ envParser: sniffer });\n * });\n * console.log('Env vars:', result.envVars);\n * console.log('Error:', result.error);\n * console.log('Unhandled rejections:', result.unhandledRejections);\n * ```\n */\nexport async function sniffWithFireAndForget(\n\tsniffer: SnifferEnvironmentParser,\n\toperation: () => unknown | Promise<unknown>,\n\toptions: SniffOptions = {},\n): Promise<SniffResult> {\n\tconst { settleTimeMs = 100 } = options;\n\tconst unhandledRejections: Error[] = [];\n\n\t// Capture unhandled rejections during sniffing (fire-and-forget promises)\n\t// Libraries like better-auth create async operations that may reject after\n\t// the initial event loop tick\n\tconst captureRejection = (reason: unknown) => {\n\t\tconst err = reason instanceof Error ? reason : new Error(String(reason));\n\t\tunhandledRejections.push(err);\n\t};\n\tprocess.on('unhandledRejection', captureRejection);\n\n\tlet error: Error | undefined;\n\n\ttry {\n\t\tconst result = operation();\n\n\t\t// Handle async result\n\t\tif (result && typeof result === 'object' && 'then' in result) {\n\t\t\tawait Promise.resolve(result).catch((e) => {\n\t\t\t\terror = e instanceof Error ? e : new Error(String(e));\n\t\t\t});\n\t\t}\n\t} catch (e) {\n\t\terror = e instanceof Error ? e : new Error(String(e));\n\t} finally {\n\t\t// Wait for fire-and-forget promises to settle\n\t\tawait new Promise((resolve) => setTimeout(resolve, settleTimeMs));\n\t\tprocess.off('unhandledRejection', captureRejection);\n\t}\n\n\treturn {\n\t\tenvVars: sniffer.getEnvironmentVariables(),\n\t\toptionalEnvVars: sniffer.getOptionalVariables(),\n\t\terror,\n\t\tunhandledRejections,\n\t};\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"SnifferEnvironmentParser.cjs","names":["schema: z.ZodType","name: string","z","result: Record<string, unknown>","builder: (get: EnvFetcher) => TReturn","opts?: { markOptional?: boolean }","ConfigParser","config: T","result: EmptyObject","sniffer: SnifferEnvironmentParser","operation: () => unknown | Promise<unknown>","options: SniffOptions","unhandledRejections: Error[]","reason: unknown","error: Error | undefined"],"sources":["../src/SnifferEnvironmentParser.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport {\n\tConfigParser,\n\ttype EmptyObject,\n\ttype 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<_T extends EmptyObject = EmptyObject> {\n\tprivate readonly accessedVars: Set<string> = new Set();\n\tprivate readonly optionalVars: Set<string> = new Set();\n\n\t/**\n\t * Wraps a Zod schema to always return mock values.\n\t * This ensures .parse() and .safeParse() never fail.\n\t * Also detects when .optional() or .default() is called to track optional vars.\n\t */\n\tprivate wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\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 () => this.getMockValue(target);\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\tsuccess: true as const,\n\t\t\t\t\t\tdata: this.getMockValue(target),\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\t// Detect .optional() or .default() — mark the variable as optional\n\t\t\t\tif (prop === 'optional' || prop === 'default') {\n\t\t\t\t\tthis.optionalVars.add(name);\n\t\t\t\t}\n\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\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 * Returns a mock value based on the Zod schema type.\n\t */\n\tprivate getMockValue(schema: z.ZodType): unknown {\n\t\t// Return type-appropriate mock values\n\t\tif (schema instanceof z.ZodString) return '';\n\t\tif (schema instanceof z.ZodNumber) return 0;\n\t\tif (schema instanceof z.ZodBoolean) return false;\n\t\tif (schema instanceof z.ZodArray) return [];\n\t\tif (schema instanceof z.ZodOptional) return undefined;\n\t\tif (schema instanceof z.ZodNullable) return null;\n\n\t\t// For object schemas, build mock object from shape\n\t\tif (schema instanceof z.ZodObject && schema.shape) {\n\t\t\tconst result: Record<string, unknown> = {};\n\t\t\tfor (const [key, value] of Object.entries(schema.shape)) {\n\t\t\t\tif (value instanceof z.ZodType) {\n\t\t\t\t\tresult[key] = this.getMockValue(value);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\treturn '';\n\t}\n\n\t/**\n\t * Creates a proxied Zod getter that tracks environment variable access.\n\t */\n\tprivate getZodGetter = (name: string) => {\n\t\tthis.accessedVars.add(name);\n\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// @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\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\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 ConfigParser that will return mock values when parsed.\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 SnifferConfigParser(config, this.accessedVars);\n\t}\n\n\t/**\n\t * Returns all environment variable names that were accessed.\n\t *\n\t * @param opts.markOptional - When true, optional variables (those accessed\n\t * via `.optional()` or `.default()`) are suffixed with `?` (e.g. `PORT?`).\n\t */\n\tgetEnvironmentVariables(opts?: { markOptional?: boolean }): string[] {\n\t\tconst vars = Array.from(this.accessedVars).sort();\n\t\tif (!opts?.markOptional) return vars;\n\t\treturn vars.map((name) =>\n\t\t\tthis.optionalVars.has(name) ? `${name}?` : name,\n\t\t);\n\t}\n\n\t/**\n\t * Returns all environment variable names that were accessed via\n\t * `.optional()` or `.default()` — i.e. variables that are not required.\n\t */\n\tgetOptionalVariables(): string[] {\n\t\treturn Array.from(this.optionalVars).sort();\n\t}\n}\n\n/**\n * A ConfigParser that always succeeds with mock values.\n */\nclass SnifferConfigParser<\n\tTResponse extends EmptyObject,\n> extends ConfigParser<TResponse> {\n\toverride parse(): any {\n\t\treturn this.parseWithMocks(this.getConfig());\n\t}\n\n\tprivate getConfig(): TResponse {\n\t\t// Access the private config via any cast\n\t\treturn (this as any).config;\n\t}\n\n\tprivate parseWithMocks<T>(config: T): any {\n\t\tconst result: EmptyObject = {};\n\n\t\tif (config && typeof config !== 'object') {\n\t\t\treturn config;\n\t\t}\n\n\t\tfor (const key in config) {\n\t\t\tconst schema = config[key];\n\n\t\t\tif (schema instanceof z.ZodType) {\n\t\t\t\t// Use safeParse which will return mock values from our wrapped schema\n\t\t\t\tconst parsed = schema.safeParse(undefined);\n\t\t\t\tresult[key] = parsed.success\n\t\t\t\t\t? parsed.data\n\t\t\t\t\t: this.getDefaultForSchema(schema);\n\t\t\t} else if (schema && typeof schema === 'object') {\n\t\t\t\tresult[key] = this.parseWithMocks(schema as EmptyObject);\n\t\t\t}\n\t\t}\n\n\t\treturn result;\n\t}\n\n\tprivate getDefaultForSchema(schema: z.ZodType): unknown {\n\t\tif (schema instanceof z.ZodString) return '';\n\t\tif (schema instanceof z.ZodNumber) return 0;\n\t\tif (schema instanceof z.ZodBoolean) return false;\n\t\tif (schema instanceof z.ZodArray) return [];\n\t\tif (schema instanceof z.ZodOptional) return undefined;\n\t\tif (schema instanceof z.ZodNullable) return null;\n\n\t\tif (schema instanceof z.ZodObject && schema.shape) {\n\t\t\tconst result: Record<string, unknown> = {};\n\t\t\tfor (const [key, value] of Object.entries(schema.shape)) {\n\t\t\t\tif (value instanceof z.ZodType) {\n\t\t\t\t\tresult[key] = this.getDefaultForSchema(value);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\treturn '';\n\t}\n}\n\n/**\n * Result of sniffing with fire-and-forget handling.\n */\nexport interface SniffResult {\n\t/** All environment variable names that were accessed during sniffing */\n\tenvVars: string[];\n\t/**\n\t * Subset of envVars that are optional (accessed via `.optional()` or\n\t * `.default()`). These do not need to be present for the app to start.\n\t */\n\toptionalEnvVars: string[];\n\t/** Error thrown during sniffing (env vars may still be captured) */\n\terror?: Error;\n\t/** Unhandled promise rejections captured during sniffing */\n\tunhandledRejections: Error[];\n}\n\n/**\n * Options for sniffing with fire-and-forget handling.\n */\nexport interface SniffOptions {\n\t/**\n\t * Time in milliseconds to wait for fire-and-forget promises to settle.\n\t * Some libraries like better-auth create async operations that may reject\n\t * after the initial event loop tick.\n\t * @default 100\n\t */\n\tsettleTimeMs?: number;\n}\n\n/**\n * Executes a sniffing operation with fire-and-forget handling.\n *\n * This function:\n * 1. Captures unhandled promise rejections during the operation\n * 2. Waits for async operations to settle before returning\n * 3. Gracefully handles errors without throwing\n *\n * Use this when sniffing environment variables from code that may:\n * - Throw synchronous errors\n * - Create fire-and-forget promises that reject\n * - Have async initialization that may fail\n *\n * @param sniffer - The SnifferEnvironmentParser instance to use\n * @param operation - The async operation to execute (e.g., service.register)\n * @param options - Optional configuration\n * @returns SniffResult with env vars and any errors encountered\n *\n * @example\n * ```typescript\n * const sniffer = new SnifferEnvironmentParser();\n * const result = await sniffWithFireAndForget(sniffer, async () => {\n * await service.register({ envParser: sniffer });\n * });\n * console.log('Env vars:', result.envVars);\n * console.log('Error:', result.error);\n * console.log('Unhandled rejections:', result.unhandledRejections);\n * ```\n */\nexport async function sniffWithFireAndForget(\n\tsniffer: SnifferEnvironmentParser,\n\toperation: () => unknown | Promise<unknown>,\n\toptions: SniffOptions = {},\n): Promise<SniffResult> {\n\tconst { settleTimeMs = 100 } = options;\n\tconst unhandledRejections: Error[] = [];\n\n\t// Capture unhandled rejections during sniffing (fire-and-forget promises)\n\t// Libraries like better-auth create async operations that may reject after\n\t// the initial event loop tick\n\tconst captureRejection = (reason: unknown) => {\n\t\tconst err = reason instanceof Error ? reason : new Error(String(reason));\n\t\tunhandledRejections.push(err);\n\t};\n\tprocess.on('unhandledRejection', captureRejection);\n\n\tlet error: Error | undefined;\n\n\ttry {\n\t\tconst result = operation();\n\n\t\t// Handle async result\n\t\tif (result && typeof result === 'object' && 'then' in result) {\n\t\t\tawait Promise.resolve(result).catch((e) => {\n\t\t\t\terror = e instanceof Error ? e : new Error(String(e));\n\t\t\t});\n\t\t}\n\t} catch (e) {\n\t\terror = e instanceof Error ? e : new Error(String(e));\n\t} finally {\n\t\t// Wait for fire-and-forget promises to settle\n\t\tawait new Promise((resolve) => setTimeout(resolve, settleTimeMs));\n\t\tprocess.off('unhandledRejection', captureRejection);\n\t}\n\n\treturn {\n\t\tenvVars: sniffer.getEnvironmentVariables(),\n\t\toptionalEnvVars: sniffer.getOptionalVariables(),\n\t\terror,\n\t\tunhandledRejections,\n\t};\n}\n"],"mappings":"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"}
@@ -1,5 +1,7 @@
1
- import { n as EmptyObject, r as EnvFetcher, t as ConfigParser } from "./EnvironmentParser-BmJLlm5_.cjs";
1
+ import { ConfigParser, EmptyObject, EnvFetcher } from "./EnvironmentParser-DoooZm8n.cjs";
2
+
2
3
  //#region src/SnifferEnvironmentParser.d.ts
4
+
3
5
  /**
4
6
  * A specialized EnvironmentParser for build-time analysis that tracks
5
7
  * which environment variables are accessed without requiring actual values.
@@ -19,7 +21,7 @@ import { n as EmptyObject, r as EnvFetcher, t as ConfigParser } from "./Environm
19
21
  * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'API_KEY']
20
22
  * ```
21
23
  */
22
- export declare class SnifferEnvironmentParser<_T extends EmptyObject = EmptyObject> {
24
+ declare class SnifferEnvironmentParser<_T extends EmptyObject = EmptyObject> {
23
25
  private readonly accessedVars;
24
26
  private readonly optionalVars;
25
27
  /**
@@ -58,7 +60,7 @@ export declare class SnifferEnvironmentParser<_T extends EmptyObject = EmptyObje
58
60
  /**
59
61
  * Result of sniffing with fire-and-forget handling.
60
62
  */
61
- export interface SniffResult {
63
+ interface SniffResult {
62
64
  /** All environment variable names that were accessed during sniffing */
63
65
  envVars: string[];
64
66
  /**
@@ -74,7 +76,7 @@ export interface SniffResult {
74
76
  /**
75
77
  * Options for sniffing with fire-and-forget handling.
76
78
  */
77
- export interface SniffOptions {
79
+ interface SniffOptions {
78
80
  /**
79
81
  * Time in milliseconds to wait for fire-and-forget promises to settle.
80
82
  * Some libraries like better-auth create async operations that may reject
@@ -112,6 +114,8 @@ export interface SniffOptions {
112
114
  * console.log('Unhandled rejections:', result.unhandledRejections);
113
115
  * ```
114
116
  */
115
- export declare function sniffWithFireAndForget(sniffer: SnifferEnvironmentParser, operation: () => unknown | Promise<unknown>, options?: SniffOptions): Promise<SniffResult>;
117
+ declare function sniffWithFireAndForget(sniffer: SnifferEnvironmentParser, operation: () => unknown | Promise<unknown>, options?: SniffOptions): Promise<SniffResult>;
118
+ //# sourceMappingURL=SnifferEnvironmentParser.d.ts.map
116
119
  //#endregion
120
+ export { SniffOptions, SniffResult, SnifferEnvironmentParser, sniffWithFireAndForget };
117
121
  //# sourceMappingURL=SnifferEnvironmentParser.d.cts.map
@@ -1 +1 @@
1
- {"version":3,"file":"SnifferEnvironmentParser.d.cts","names":[],"sources":["../src/SnifferEnvironmentParser.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;qBA0Ba,yBAAyB,WAAW,cAAc;mBAC7C;mBACA;;;;;;UAOT;;;;UAsCA;;;;UA0BA;;;;EA0CR,OAAO,gBAAgB,aACtB,UAAU,KAAK,eAAe,UAC5B,aAAa;;;;;;;EAWhB,wBAAwB;IAAS;;;;;;EAYjC;;;;;iBAqEgB;;EAEhB;;;;;EAKA;;EAEA,QAAQ;;EAER,qBAAqB;;;;;iBAML;;;;;;;EAOhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAgCqB,uBACrB,SAAS,0BACT,2BAA2B,kBAC3B,UAAS,eACP,QAAQ"}
1
+ {"version":3,"file":"SnifferEnvironmentParser.d.cts","names":[],"sources":["../src/SnifferEnvironmentParser.ts"],"sourcesContent":[],"mappings":";;;;;;AA0BA;;;;;;;;;AAqHgB;AA4FhB;;;;AAW2B;AAM3B;AAuCA;AAA4C,cAzQ/B,wBAyQ+B,CAAA,WAzQK,WAyQL,GAzQmB,WAyQnB,CAAA,CAAA;EAAA,iBAClC,YAAA;EAAwB,iBACN,YAAA;EAAO;;;AAEzB;;;;;;;;;;;;;;yBA1Jc,4BACP,eAAe,UAC5B,aAAa;;;;;;;;;;;;;;;;;;;UA4FA,WAAA;;;;;;;;;UASR;;uBAEa;;;;;UAML,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCK,sBAAA,UACZ,qDACkB,4BAClB,eACP,QAAQ"}
@@ -1,5 +1,7 @@
1
- import { n as EmptyObject, r as EnvFetcher, t as ConfigParser } from "./EnvironmentParser-BmJLlm5_.mjs";
1
+ import { ConfigParser, EmptyObject, EnvFetcher } from "./EnvironmentParser-BY1oCUsc.mjs";
2
+
2
3
  //#region src/SnifferEnvironmentParser.d.ts
4
+
3
5
  /**
4
6
  * A specialized EnvironmentParser for build-time analysis that tracks
5
7
  * which environment variables are accessed without requiring actual values.
@@ -19,7 +21,7 @@ import { n as EmptyObject, r as EnvFetcher, t as ConfigParser } from "./Environm
19
21
  * const envVars = sniffer.getEnvironmentVariables(); // ['DATABASE_URL', 'API_KEY']
20
22
  * ```
21
23
  */
22
- export declare class SnifferEnvironmentParser<_T extends EmptyObject = EmptyObject> {
24
+ declare class SnifferEnvironmentParser<_T extends EmptyObject = EmptyObject> {
23
25
  private readonly accessedVars;
24
26
  private readonly optionalVars;
25
27
  /**
@@ -58,7 +60,7 @@ export declare class SnifferEnvironmentParser<_T extends EmptyObject = EmptyObje
58
60
  /**
59
61
  * Result of sniffing with fire-and-forget handling.
60
62
  */
61
- export interface SniffResult {
63
+ interface SniffResult {
62
64
  /** All environment variable names that were accessed during sniffing */
63
65
  envVars: string[];
64
66
  /**
@@ -74,7 +76,7 @@ export interface SniffResult {
74
76
  /**
75
77
  * Options for sniffing with fire-and-forget handling.
76
78
  */
77
- export interface SniffOptions {
79
+ interface SniffOptions {
78
80
  /**
79
81
  * Time in milliseconds to wait for fire-and-forget promises to settle.
80
82
  * Some libraries like better-auth create async operations that may reject
@@ -112,6 +114,8 @@ export interface SniffOptions {
112
114
  * console.log('Unhandled rejections:', result.unhandledRejections);
113
115
  * ```
114
116
  */
115
- export declare function sniffWithFireAndForget(sniffer: SnifferEnvironmentParser, operation: () => unknown | Promise<unknown>, options?: SniffOptions): Promise<SniffResult>;
117
+ declare function sniffWithFireAndForget(sniffer: SnifferEnvironmentParser, operation: () => unknown | Promise<unknown>, options?: SniffOptions): Promise<SniffResult>;
118
+ //# sourceMappingURL=SnifferEnvironmentParser.d.ts.map
116
119
  //#endregion
120
+ export { SniffOptions, SniffResult, SnifferEnvironmentParser, sniffWithFireAndForget };
117
121
  //# sourceMappingURL=SnifferEnvironmentParser.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"SnifferEnvironmentParser.d.mts","names":[],"sources":["../src/SnifferEnvironmentParser.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;qBA0Ba,yBAAyB,WAAW,cAAc;mBAC7C;mBACA;;;;;;UAOT;;;;UAsCA;;;;UA0BA;;;;EA0CR,OAAO,gBAAgB,aACtB,UAAU,KAAK,eAAe,UAC5B,aAAa;;;;;;;EAWhB,wBAAwB;IAAS;;;;;;EAYjC;;;;;iBAqEgB;;EAEhB;;;;;EAKA;;EAEA,QAAQ;;EAER,qBAAqB;;;;;iBAML;;;;;;;EAOhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAgCqB,uBACrB,SAAS,0BACT,2BAA2B,kBAC3B,UAAS,eACP,QAAQ"}
1
+ {"version":3,"file":"SnifferEnvironmentParser.d.mts","names":[],"sources":["../src/SnifferEnvironmentParser.ts"],"sourcesContent":[],"mappings":";;;;;;AA0BA;;;;;;;;;AAqHgB;AA4FhB;;;;AAW2B;AAM3B;AAuCA;AAA4C,cAzQ/B,wBAyQ+B,CAAA,WAzQK,WAyQL,GAzQmB,WAyQnB,CAAA,CAAA;EAAA,iBAClC,YAAA;EAAwB,iBACN,YAAA;EAAO;;;AAEzB;;;;;;;;;;;;;;yBA1Jc,4BACP,eAAe,UAC5B,aAAa;;;;;;;;;;;;;;;;;;;UA4FA,WAAA;;;;;;;;;UASR;;uBAEa;;;;;UAML,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCK,sBAAA,UACZ,qDACkB,4BAClB,eACP,QAAQ"}
@@ -1,5 +1,6 @@
1
- import { t as ConfigParser } from "./EnvironmentParser-X6Z-jryw.mjs";
1
+ import { ConfigParser } from "./EnvironmentParser-taAKfzT7.mjs";
2
2
  import { z } from "zod/v4";
3
+
3
4
  //#region src/SnifferEnvironmentParser.ts
4
5
  /**
5
6
  * A specialized EnvironmentParser for build-time analysis that tracks
@@ -88,7 +89,8 @@ var SnifferEnvironmentParser = class {
88
89
  * Creates a ConfigParser that will return mock values when parsed.
89
90
  */
90
91
  create(builder) {
91
- return new SnifferConfigParser(builder(this.getZodGetter), this.accessedVars);
92
+ const config = builder(this.getZodGetter);
93
+ return new SnifferConfigParser(config, this.accessedVars);
92
94
  }
93
95
  /**
94
96
  * Returns all environment variable names that were accessed.
@@ -202,7 +204,7 @@ async function sniffWithFireAndForget(sniffer, operation, options = {}) {
202
204
  unhandledRejections
203
205
  };
204
206
  }
207
+
205
208
  //#endregion
206
209
  export { SnifferEnvironmentParser, sniffWithFireAndForget };
207
-
208
210
  //# sourceMappingURL=SnifferEnvironmentParser.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"SnifferEnvironmentParser.mjs","names":[],"sources":["../src/SnifferEnvironmentParser.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport {\n\tConfigParser,\n\ttype EmptyObject,\n\ttype 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<_T extends EmptyObject = EmptyObject> {\n\tprivate readonly accessedVars: Set<string> = new Set();\n\tprivate readonly optionalVars: Set<string> = new Set();\n\n\t/**\n\t * Wraps a Zod schema to always return mock values.\n\t * This ensures .parse() and .safeParse() never fail.\n\t * Also detects when .optional() or .default() is called to track optional vars.\n\t */\n\tprivate wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\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 () => this.getMockValue(target);\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\tsuccess: true as const,\n\t\t\t\t\t\tdata: this.getMockValue(target),\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\t// Detect .optional() or .default() — mark the variable as optional\n\t\t\t\tif (prop === 'optional' || prop === 'default') {\n\t\t\t\t\tthis.optionalVars.add(name);\n\t\t\t\t}\n\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\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 * Returns a mock value based on the Zod schema type.\n\t */\n\tprivate getMockValue(schema: z.ZodType): unknown {\n\t\t// Return type-appropriate mock values\n\t\tif (schema instanceof z.ZodString) return '';\n\t\tif (schema instanceof z.ZodNumber) return 0;\n\t\tif (schema instanceof z.ZodBoolean) return false;\n\t\tif (schema instanceof z.ZodArray) return [];\n\t\tif (schema instanceof z.ZodOptional) return undefined;\n\t\tif (schema instanceof z.ZodNullable) return null;\n\n\t\t// For object schemas, build mock object from shape\n\t\tif (schema instanceof z.ZodObject && schema.shape) {\n\t\t\tconst result: Record<string, unknown> = {};\n\t\t\tfor (const [key, value] of Object.entries(schema.shape)) {\n\t\t\t\tif (value instanceof z.ZodType) {\n\t\t\t\t\tresult[key] = this.getMockValue(value);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\treturn '';\n\t}\n\n\t/**\n\t * Creates a proxied Zod getter that tracks environment variable access.\n\t */\n\tprivate getZodGetter = (name: string) => {\n\t\tthis.accessedVars.add(name);\n\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// @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\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\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 ConfigParser that will return mock values when parsed.\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 SnifferConfigParser(config, this.accessedVars);\n\t}\n\n\t/**\n\t * Returns all environment variable names that were accessed.\n\t *\n\t * @param opts.markOptional - When true, optional variables (those accessed\n\t * via `.optional()` or `.default()`) are suffixed with `?` (e.g. `PORT?`).\n\t */\n\tgetEnvironmentVariables(opts?: { markOptional?: boolean }): string[] {\n\t\tconst vars = Array.from(this.accessedVars).sort();\n\t\tif (!opts?.markOptional) return vars;\n\t\treturn vars.map((name) =>\n\t\t\tthis.optionalVars.has(name) ? `${name}?` : name,\n\t\t);\n\t}\n\n\t/**\n\t * Returns all environment variable names that were accessed via\n\t * `.optional()` or `.default()` — i.e. variables that are not required.\n\t */\n\tgetOptionalVariables(): string[] {\n\t\treturn Array.from(this.optionalVars).sort();\n\t}\n}\n\n/**\n * A ConfigParser that always succeeds with mock values.\n */\nclass SnifferConfigParser<\n\tTResponse extends EmptyObject,\n> extends ConfigParser<TResponse> {\n\toverride parse(): any {\n\t\treturn this.parseWithMocks(this.getConfig());\n\t}\n\n\tprivate getConfig(): TResponse {\n\t\t// Access the private config via any cast\n\t\treturn (this as any).config;\n\t}\n\n\tprivate parseWithMocks<T>(config: T): any {\n\t\tconst result: EmptyObject = {};\n\n\t\tif (config && typeof config !== 'object') {\n\t\t\treturn config;\n\t\t}\n\n\t\tfor (const key in config) {\n\t\t\tconst schema = config[key];\n\n\t\t\tif (schema instanceof z.ZodType) {\n\t\t\t\t// Use safeParse which will return mock values from our wrapped schema\n\t\t\t\tconst parsed = schema.safeParse(undefined);\n\t\t\t\tresult[key] = parsed.success\n\t\t\t\t\t? parsed.data\n\t\t\t\t\t: this.getDefaultForSchema(schema);\n\t\t\t} else if (schema && typeof schema === 'object') {\n\t\t\t\tresult[key] = this.parseWithMocks(schema as EmptyObject);\n\t\t\t}\n\t\t}\n\n\t\treturn result;\n\t}\n\n\tprivate getDefaultForSchema(schema: z.ZodType): unknown {\n\t\tif (schema instanceof z.ZodString) return '';\n\t\tif (schema instanceof z.ZodNumber) return 0;\n\t\tif (schema instanceof z.ZodBoolean) return false;\n\t\tif (schema instanceof z.ZodArray) return [];\n\t\tif (schema instanceof z.ZodOptional) return undefined;\n\t\tif (schema instanceof z.ZodNullable) return null;\n\n\t\tif (schema instanceof z.ZodObject && schema.shape) {\n\t\t\tconst result: Record<string, unknown> = {};\n\t\t\tfor (const [key, value] of Object.entries(schema.shape)) {\n\t\t\t\tif (value instanceof z.ZodType) {\n\t\t\t\t\tresult[key] = this.getDefaultForSchema(value);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\treturn '';\n\t}\n}\n\n/**\n * Result of sniffing with fire-and-forget handling.\n */\nexport interface SniffResult {\n\t/** All environment variable names that were accessed during sniffing */\n\tenvVars: string[];\n\t/**\n\t * Subset of envVars that are optional (accessed via `.optional()` or\n\t * `.default()`). These do not need to be present for the app to start.\n\t */\n\toptionalEnvVars: string[];\n\t/** Error thrown during sniffing (env vars may still be captured) */\n\terror?: Error;\n\t/** Unhandled promise rejections captured during sniffing */\n\tunhandledRejections: Error[];\n}\n\n/**\n * Options for sniffing with fire-and-forget handling.\n */\nexport interface SniffOptions {\n\t/**\n\t * Time in milliseconds to wait for fire-and-forget promises to settle.\n\t * Some libraries like better-auth create async operations that may reject\n\t * after the initial event loop tick.\n\t * @default 100\n\t */\n\tsettleTimeMs?: number;\n}\n\n/**\n * Executes a sniffing operation with fire-and-forget handling.\n *\n * This function:\n * 1. Captures unhandled promise rejections during the operation\n * 2. Waits for async operations to settle before returning\n * 3. Gracefully handles errors without throwing\n *\n * Use this when sniffing environment variables from code that may:\n * - Throw synchronous errors\n * - Create fire-and-forget promises that reject\n * - Have async initialization that may fail\n *\n * @param sniffer - The SnifferEnvironmentParser instance to use\n * @param operation - The async operation to execute (e.g., service.register)\n * @param options - Optional configuration\n * @returns SniffResult with env vars and any errors encountered\n *\n * @example\n * ```typescript\n * const sniffer = new SnifferEnvironmentParser();\n * const result = await sniffWithFireAndForget(sniffer, async () => {\n * await service.register({ envParser: sniffer });\n * });\n * console.log('Env vars:', result.envVars);\n * console.log('Error:', result.error);\n * console.log('Unhandled rejections:', result.unhandledRejections);\n * ```\n */\nexport async function sniffWithFireAndForget(\n\tsniffer: SnifferEnvironmentParser,\n\toperation: () => unknown | Promise<unknown>,\n\toptions: SniffOptions = {},\n): Promise<SniffResult> {\n\tconst { settleTimeMs = 100 } = options;\n\tconst unhandledRejections: Error[] = [];\n\n\t// Capture unhandled rejections during sniffing (fire-and-forget promises)\n\t// Libraries like better-auth create async operations that may reject after\n\t// the initial event loop tick\n\tconst captureRejection = (reason: unknown) => {\n\t\tconst err = reason instanceof Error ? reason : new Error(String(reason));\n\t\tunhandledRejections.push(err);\n\t};\n\tprocess.on('unhandledRejection', captureRejection);\n\n\tlet error: Error | undefined;\n\n\ttry {\n\t\tconst result = operation();\n\n\t\t// Handle async result\n\t\tif (result && typeof result === 'object' && 'then' in result) {\n\t\t\tawait Promise.resolve(result).catch((e) => {\n\t\t\t\terror = e instanceof Error ? e : new Error(String(e));\n\t\t\t});\n\t\t}\n\t} catch (e) {\n\t\terror = e instanceof Error ? e : new Error(String(e));\n\t} finally {\n\t\t// Wait for fire-and-forget promises to settle\n\t\tawait new Promise((resolve) => setTimeout(resolve, settleTimeMs));\n\t\tprocess.off('unhandledRejection', captureRejection);\n\t}\n\n\treturn {\n\t\tenvVars: sniffer.getEnvironmentVariables(),\n\t\toptionalEnvVars: sniffer.getOptionalVariables(),\n\t\terror,\n\t\tunhandledRejections,\n\t};\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"SnifferEnvironmentParser.mjs","names":["schema: z.ZodType","name: string","result: Record<string, unknown>","builder: (get: EnvFetcher) => TReturn","opts?: { markOptional?: boolean }","config: T","result: EmptyObject","sniffer: SnifferEnvironmentParser","operation: () => unknown | Promise<unknown>","options: SniffOptions","unhandledRejections: Error[]","reason: unknown","error: Error | undefined"],"sources":["../src/SnifferEnvironmentParser.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport {\n\tConfigParser,\n\ttype EmptyObject,\n\ttype 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<_T extends EmptyObject = EmptyObject> {\n\tprivate readonly accessedVars: Set<string> = new Set();\n\tprivate readonly optionalVars: Set<string> = new Set();\n\n\t/**\n\t * Wraps a Zod schema to always return mock values.\n\t * This ensures .parse() and .safeParse() never fail.\n\t * Also detects when .optional() or .default() is called to track optional vars.\n\t */\n\tprivate wrapSchema = (schema: z.ZodType, name: string): z.ZodType => {\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 () => this.getMockValue(target);\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\tsuccess: true as const,\n\t\t\t\t\t\tdata: this.getMockValue(target),\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\t// Detect .optional() or .default() — mark the variable as optional\n\t\t\t\tif (prop === 'optional' || prop === 'default') {\n\t\t\t\t\tthis.optionalVars.add(name);\n\t\t\t\t}\n\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\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 * Returns a mock value based on the Zod schema type.\n\t */\n\tprivate getMockValue(schema: z.ZodType): unknown {\n\t\t// Return type-appropriate mock values\n\t\tif (schema instanceof z.ZodString) return '';\n\t\tif (schema instanceof z.ZodNumber) return 0;\n\t\tif (schema instanceof z.ZodBoolean) return false;\n\t\tif (schema instanceof z.ZodArray) return [];\n\t\tif (schema instanceof z.ZodOptional) return undefined;\n\t\tif (schema instanceof z.ZodNullable) return null;\n\n\t\t// For object schemas, build mock object from shape\n\t\tif (schema instanceof z.ZodObject && schema.shape) {\n\t\t\tconst result: Record<string, unknown> = {};\n\t\t\tfor (const [key, value] of Object.entries(schema.shape)) {\n\t\t\t\tif (value instanceof z.ZodType) {\n\t\t\t\t\tresult[key] = this.getMockValue(value);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\treturn '';\n\t}\n\n\t/**\n\t * Creates a proxied Zod getter that tracks environment variable access.\n\t */\n\tprivate getZodGetter = (name: string) => {\n\t\tthis.accessedVars.add(name);\n\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// @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\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\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 ConfigParser that will return mock values when parsed.\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 SnifferConfigParser(config, this.accessedVars);\n\t}\n\n\t/**\n\t * Returns all environment variable names that were accessed.\n\t *\n\t * @param opts.markOptional - When true, optional variables (those accessed\n\t * via `.optional()` or `.default()`) are suffixed with `?` (e.g. `PORT?`).\n\t */\n\tgetEnvironmentVariables(opts?: { markOptional?: boolean }): string[] {\n\t\tconst vars = Array.from(this.accessedVars).sort();\n\t\tif (!opts?.markOptional) return vars;\n\t\treturn vars.map((name) =>\n\t\t\tthis.optionalVars.has(name) ? `${name}?` : name,\n\t\t);\n\t}\n\n\t/**\n\t * Returns all environment variable names that were accessed via\n\t * `.optional()` or `.default()` — i.e. variables that are not required.\n\t */\n\tgetOptionalVariables(): string[] {\n\t\treturn Array.from(this.optionalVars).sort();\n\t}\n}\n\n/**\n * A ConfigParser that always succeeds with mock values.\n */\nclass SnifferConfigParser<\n\tTResponse extends EmptyObject,\n> extends ConfigParser<TResponse> {\n\toverride parse(): any {\n\t\treturn this.parseWithMocks(this.getConfig());\n\t}\n\n\tprivate getConfig(): TResponse {\n\t\t// Access the private config via any cast\n\t\treturn (this as any).config;\n\t}\n\n\tprivate parseWithMocks<T>(config: T): any {\n\t\tconst result: EmptyObject = {};\n\n\t\tif (config && typeof config !== 'object') {\n\t\t\treturn config;\n\t\t}\n\n\t\tfor (const key in config) {\n\t\t\tconst schema = config[key];\n\n\t\t\tif (schema instanceof z.ZodType) {\n\t\t\t\t// Use safeParse which will return mock values from our wrapped schema\n\t\t\t\tconst parsed = schema.safeParse(undefined);\n\t\t\t\tresult[key] = parsed.success\n\t\t\t\t\t? parsed.data\n\t\t\t\t\t: this.getDefaultForSchema(schema);\n\t\t\t} else if (schema && typeof schema === 'object') {\n\t\t\t\tresult[key] = this.parseWithMocks(schema as EmptyObject);\n\t\t\t}\n\t\t}\n\n\t\treturn result;\n\t}\n\n\tprivate getDefaultForSchema(schema: z.ZodType): unknown {\n\t\tif (schema instanceof z.ZodString) return '';\n\t\tif (schema instanceof z.ZodNumber) return 0;\n\t\tif (schema instanceof z.ZodBoolean) return false;\n\t\tif (schema instanceof z.ZodArray) return [];\n\t\tif (schema instanceof z.ZodOptional) return undefined;\n\t\tif (schema instanceof z.ZodNullable) return null;\n\n\t\tif (schema instanceof z.ZodObject && schema.shape) {\n\t\t\tconst result: Record<string, unknown> = {};\n\t\t\tfor (const [key, value] of Object.entries(schema.shape)) {\n\t\t\t\tif (value instanceof z.ZodType) {\n\t\t\t\t\tresult[key] = this.getDefaultForSchema(value);\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn result;\n\t\t}\n\n\t\treturn '';\n\t}\n}\n\n/**\n * Result of sniffing with fire-and-forget handling.\n */\nexport interface SniffResult {\n\t/** All environment variable names that were accessed during sniffing */\n\tenvVars: string[];\n\t/**\n\t * Subset of envVars that are optional (accessed via `.optional()` or\n\t * `.default()`). These do not need to be present for the app to start.\n\t */\n\toptionalEnvVars: string[];\n\t/** Error thrown during sniffing (env vars may still be captured) */\n\terror?: Error;\n\t/** Unhandled promise rejections captured during sniffing */\n\tunhandledRejections: Error[];\n}\n\n/**\n * Options for sniffing with fire-and-forget handling.\n */\nexport interface SniffOptions {\n\t/**\n\t * Time in milliseconds to wait for fire-and-forget promises to settle.\n\t * Some libraries like better-auth create async operations that may reject\n\t * after the initial event loop tick.\n\t * @default 100\n\t */\n\tsettleTimeMs?: number;\n}\n\n/**\n * Executes a sniffing operation with fire-and-forget handling.\n *\n * This function:\n * 1. Captures unhandled promise rejections during the operation\n * 2. Waits for async operations to settle before returning\n * 3. Gracefully handles errors without throwing\n *\n * Use this when sniffing environment variables from code that may:\n * - Throw synchronous errors\n * - Create fire-and-forget promises that reject\n * - Have async initialization that may fail\n *\n * @param sniffer - The SnifferEnvironmentParser instance to use\n * @param operation - The async operation to execute (e.g., service.register)\n * @param options - Optional configuration\n * @returns SniffResult with env vars and any errors encountered\n *\n * @example\n * ```typescript\n * const sniffer = new SnifferEnvironmentParser();\n * const result = await sniffWithFireAndForget(sniffer, async () => {\n * await service.register({ envParser: sniffer });\n * });\n * console.log('Env vars:', result.envVars);\n * console.log('Error:', result.error);\n * console.log('Unhandled rejections:', result.unhandledRejections);\n * ```\n */\nexport async function sniffWithFireAndForget(\n\tsniffer: SnifferEnvironmentParser,\n\toperation: () => unknown | Promise<unknown>,\n\toptions: SniffOptions = {},\n): Promise<SniffResult> {\n\tconst { settleTimeMs = 100 } = options;\n\tconst unhandledRejections: Error[] = [];\n\n\t// Capture unhandled rejections during sniffing (fire-and-forget promises)\n\t// Libraries like better-auth create async operations that may reject after\n\t// the initial event loop tick\n\tconst captureRejection = (reason: unknown) => {\n\t\tconst err = reason instanceof Error ? reason : new Error(String(reason));\n\t\tunhandledRejections.push(err);\n\t};\n\tprocess.on('unhandledRejection', captureRejection);\n\n\tlet error: Error | undefined;\n\n\ttry {\n\t\tconst result = operation();\n\n\t\t// Handle async result\n\t\tif (result && typeof result === 'object' && 'then' in result) {\n\t\t\tawait Promise.resolve(result).catch((e) => {\n\t\t\t\terror = e instanceof Error ? e : new Error(String(e));\n\t\t\t});\n\t\t}\n\t} catch (e) {\n\t\terror = e instanceof Error ? e : new Error(String(e));\n\t} finally {\n\t\t// Wait for fire-and-forget promises to settle\n\t\tawait new Promise((resolve) => setTimeout(resolve, settleTimeMs));\n\t\tprocess.off('unhandledRejection', captureRejection);\n\t}\n\n\treturn {\n\t\tenvVars: sniffer.getEnvironmentVariables(),\n\t\toptionalEnvVars: sniffer.getOptionalVariables(),\n\t\terror,\n\t\tunhandledRejections,\n\t};\n}\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- //#region \0rolldown/runtime.js
1
+ //#region rolldown:runtime
2
2
  var __create = Object.create;
3
3
  var __defProp = Object.defineProperty;
4
4
  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -15,14 +15,16 @@ var __copyProps = (to, from, except, desc) => {
15
15
  }
16
16
  return to;
17
17
  };
18
- var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
18
+ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
19
19
  value: mod,
20
20
  enumerable: true
21
21
  }) : target, mod));
22
+
22
23
  //#endregion
23
- Object.defineProperty(exports, "__toESM", {
24
- enumerable: true,
25
- get: function() {
26
- return __toESM;
27
- }
28
- });
24
+
25
+ Object.defineProperty(exports, '__toESM', {
26
+ enumerable: true,
27
+ get: function () {
28
+ return __toESM;
29
+ }
30
+ });
@@ -1,9 +1,10 @@
1
- Object.defineProperties(exports, {
2
- __esModule: { value: true },
3
- [Symbol.toStringTag]: { value: "Module" }
4
- });
5
- let node_crypto = require("node:crypto");
1
+ Object.defineProperty(exports, '__esModule', { value: true });
2
+ const require_chunk = require('./chunk-CUT6urMc.cjs');
3
+ const node_crypto = require_chunk.__toESM(require("node:crypto"));
4
+
6
5
  //#region src/credentials.ts
6
+ /** AES-256-GCM auth tag length */
7
+ const AUTH_TAG_LENGTH = 16;
7
8
  /**
8
9
  * Decrypt credentials from encrypted payload.
9
10
  * Exported for testing purposes.
@@ -12,8 +13,8 @@ function decryptCredentials(encrypted, iv, masterKey) {
12
13
  const key = Buffer.from(masterKey, "hex");
13
14
  const ivBuffer = Buffer.from(iv, "hex");
14
15
  const combined = Buffer.from(encrypted, "base64");
15
- const ciphertext = combined.subarray(0, -16);
16
- const authTag = combined.subarray(-16);
16
+ const ciphertext = combined.subarray(0, -AUTH_TAG_LENGTH);
17
+ const authTag = combined.subarray(-AUTH_TAG_LENGTH);
17
18
  const decipher = (0, node_crypto.createDecipheriv)("aes-256-gcm", key, ivBuffer);
18
19
  decipher.setAuthTag(authTag);
19
20
  const plaintext = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
@@ -62,9 +63,10 @@ const Credentials = (() => {
62
63
  return {};
63
64
  }
64
65
  })();
66
+ var credentials_default = Credentials;
67
+
65
68
  //#endregion
66
69
  exports.Credentials = Credentials;
67
- exports.default = Credentials;
68
70
  exports.decryptCredentials = decryptCredentials;
69
-
71
+ exports.default = credentials_default;
70
72
  //# sourceMappingURL=credentials.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"credentials.cjs","names":["createDecipheriv"],"sources":["../src/credentials.ts"],"sourcesContent":["import { createDecipheriv } from 'node:crypto';\n\n/**\n * Build-time injected encrypted credentials.\n * These are replaced by tsdown/esbuild --define at build time.\n */\ndeclare const __GKM_ENCRYPTED_CREDENTIALS__: string | undefined;\ndeclare const __GKM_CREDENTIALS_IV__: string | undefined;\n\n/** AES-256-GCM auth tag length */\nconst AUTH_TAG_LENGTH = 16;\n\n/**\n * Decrypt credentials from encrypted payload.\n * Exported for testing purposes.\n */\nexport function decryptCredentials(\n\tencrypted: string,\n\tiv: string,\n\tmasterKey: string,\n): Record<string, string> {\n\tconst key = Buffer.from(masterKey, 'hex');\n\tconst ivBuffer = Buffer.from(iv, 'hex');\n\tconst combined = Buffer.from(encrypted, 'base64');\n\n\t// Split ciphertext and auth tag\n\tconst ciphertext = combined.subarray(0, -AUTH_TAG_LENGTH);\n\tconst authTag = combined.subarray(-AUTH_TAG_LENGTH);\n\n\t// Decrypt using AES-256-GCM\n\tconst decipher = createDecipheriv('aes-256-gcm', key, ivBuffer);\n\tdecipher.setAuthTag(authTag);\n\n\tconst plaintext = Buffer.concat([\n\t\tdecipher.update(ciphertext),\n\t\tdecipher.final(),\n\t]);\n\n\treturn JSON.parse(plaintext.toString('utf-8'));\n}\n\n/**\n * Credentials object for use with EnvironmentParser.\n *\n * Resolution order:\n * 1. **Dev mode (gkm dev/exec)**: Checks `globalThis.__gkm_credentials__` for\n * credentials injected by the CLI preload script. This approach survives\n * CJS/ESM module duplication (where mutating the export would only affect one copy).\n * 2. **Production mode**: Decrypts build-time embedded credentials using the\n * `GKM_MASTER_KEY` environment variable (AES-256-GCM).\n * 3. **Fallback**: Returns empty object (allows graceful fallback to process.env).\n *\n * @example\n * ```typescript\n * import { EnvironmentParser } from '@geekmidas/envkit';\n * import { Credentials } from '@geekmidas/envkit/credentials';\n *\n * export const envParser = new EnvironmentParser({...process.env, ...Credentials})\n * .create((get) => ({\n * database: {\n * url: get('DATABASE_URL').string(),\n * },\n * }))\n * .parse();\n * ```\n */\nexport const Credentials: Record<string, string> = (() => {\n\t// Dev mode: check if gkm exec/dev preload injected credentials via globalThis\n\t// This survives CJS/ESM module duplication where Object.assign on the\n\t// export would only mutate one copy of the module's Credentials object.\n\tconst injected = (globalThis as Record<string, unknown>)\n\t\t.__gkm_credentials__ as Record<string, string> | undefined;\n\tif (injected) {\n\t\treturn injected;\n\t}\n\n\t// Development mode - no credentials embedded at build time\n\tif (\n\t\ttypeof __GKM_ENCRYPTED_CREDENTIALS__ === 'undefined' ||\n\t\ttypeof __GKM_CREDENTIALS_IV__ === 'undefined'\n\t) {\n\t\treturn {};\n\t}\n\n\t// Production mode - decrypt credentials using master key\n\tconst masterKey = process.env.GKM_MASTER_KEY;\n\n\tif (!masterKey) {\n\t\t// Log warning but don't throw - allows graceful fallback to env vars\n\t\tconsole.error(\n\t\t\t'[gkm] GKM_MASTER_KEY environment variable is required to decrypt credentials.',\n\t\t);\n\t\tconsole.error(\n\t\t\t'[gkm] Falling back to environment variables. Some secrets may be missing.',\n\t\t);\n\t\treturn {};\n\t}\n\n\ttry {\n\t\treturn decryptCredentials(\n\t\t\t__GKM_ENCRYPTED_CREDENTIALS__,\n\t\t\t__GKM_CREDENTIALS_IV__,\n\t\t\tmasterKey,\n\t\t);\n\t} catch (error) {\n\t\tconsole.error('[gkm] Failed to decrypt credentials:', error);\n\t\tconsole.error('[gkm] Falling back to environment variables.');\n\t\treturn {};\n\t}\n})();\n\nexport default Credentials;\n"],"mappings":";;;;;;;;;;AAgBA,SAAgB,mBACf,WACA,IACA,WACyB;CACzB,MAAM,MAAM,OAAO,KAAK,WAAW,KAAK;CACxC,MAAM,WAAW,OAAO,KAAK,IAAI,KAAK;CACtC,MAAM,WAAW,OAAO,KAAK,WAAW,QAAQ;CAGhD,MAAM,aAAa,SAAS,SAAS,GAAG,GAAgB;CACxD,MAAM,UAAU,SAAS,SAAS,GAAgB;CAGlD,MAAM,YAAA,GAAWA,YAAAA,iBAAAA,CAAiB,eAAe,KAAK,QAAQ;CAC9D,SAAS,WAAW,OAAO;CAE3B,MAAM,YAAY,OAAO,OAAO,CAC/B,SAAS,OAAO,UAAU,GAC1B,SAAS,MAAM,CAChB,CAAC;CAED,OAAO,KAAK,MAAM,UAAU,SAAS,OAAO,CAAC;AAC9C;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,qBAA6C;CAIzD,MAAM,WAAY,WAChB;CACF,IAAI,UACH,OAAO;CAIR,IACC,OAAO,kCAAkC,eACzC,OAAO,2BAA2B,aAElC,OAAO,CAAC;CAIT,MAAM,YAAY,QAAQ,IAAI;CAE9B,IAAI,CAAC,WAAW;EAEf,QAAQ,MACP,+EACD;EACA,QAAQ,MACP,2EACD;EACA,OAAO,CAAC;CACT;CAEA,IAAI;EACH,OAAO,mBACN,+BACA,wBACA,SACD;CACD,SAAS,OAAO;EACf,QAAQ,MAAM,wCAAwC,KAAK;EAC3D,QAAQ,MAAM,8CAA8C;EAC5D,OAAO,CAAC;CACT;AACD,EAAA,CAAG"}
1
+ {"version":3,"file":"credentials.cjs","names":["encrypted: string","iv: string","masterKey: string","Credentials: Record<string, string>"],"sources":["../src/credentials.ts"],"sourcesContent":["import { createDecipheriv } from 'node:crypto';\n\n/**\n * Build-time injected encrypted credentials.\n * These are replaced by tsdown/esbuild --define at build time.\n */\ndeclare const __GKM_ENCRYPTED_CREDENTIALS__: string | undefined;\ndeclare const __GKM_CREDENTIALS_IV__: string | undefined;\n\n/** AES-256-GCM auth tag length */\nconst AUTH_TAG_LENGTH = 16;\n\n/**\n * Decrypt credentials from encrypted payload.\n * Exported for testing purposes.\n */\nexport function decryptCredentials(\n\tencrypted: string,\n\tiv: string,\n\tmasterKey: string,\n): Record<string, string> {\n\tconst key = Buffer.from(masterKey, 'hex');\n\tconst ivBuffer = Buffer.from(iv, 'hex');\n\tconst combined = Buffer.from(encrypted, 'base64');\n\n\t// Split ciphertext and auth tag\n\tconst ciphertext = combined.subarray(0, -AUTH_TAG_LENGTH);\n\tconst authTag = combined.subarray(-AUTH_TAG_LENGTH);\n\n\t// Decrypt using AES-256-GCM\n\tconst decipher = createDecipheriv('aes-256-gcm', key, ivBuffer);\n\tdecipher.setAuthTag(authTag);\n\n\tconst plaintext = Buffer.concat([\n\t\tdecipher.update(ciphertext),\n\t\tdecipher.final(),\n\t]);\n\n\treturn JSON.parse(plaintext.toString('utf-8'));\n}\n\n/**\n * Credentials object for use with EnvironmentParser.\n *\n * Resolution order:\n * 1. **Dev mode (gkm dev/exec)**: Checks `globalThis.__gkm_credentials__` for\n * credentials injected by the CLI preload script. This approach survives\n * CJS/ESM module duplication (where mutating the export would only affect one copy).\n * 2. **Production mode**: Decrypts build-time embedded credentials using the\n * `GKM_MASTER_KEY` environment variable (AES-256-GCM).\n * 3. **Fallback**: Returns empty object (allows graceful fallback to process.env).\n *\n * @example\n * ```typescript\n * import { EnvironmentParser } from '@geekmidas/envkit';\n * import { Credentials } from '@geekmidas/envkit/credentials';\n *\n * export const envParser = new EnvironmentParser({...process.env, ...Credentials})\n * .create((get) => ({\n * database: {\n * url: get('DATABASE_URL').string(),\n * },\n * }))\n * .parse();\n * ```\n */\nexport const Credentials: Record<string, string> = (() => {\n\t// Dev mode: check if gkm exec/dev preload injected credentials via globalThis\n\t// This survives CJS/ESM module duplication where Object.assign on the\n\t// export would only mutate one copy of the module's Credentials object.\n\tconst injected = (globalThis as Record<string, unknown>)\n\t\t.__gkm_credentials__ as Record<string, string> | undefined;\n\tif (injected) {\n\t\treturn injected;\n\t}\n\n\t// Development mode - no credentials embedded at build time\n\tif (\n\t\ttypeof __GKM_ENCRYPTED_CREDENTIALS__ === 'undefined' ||\n\t\ttypeof __GKM_CREDENTIALS_IV__ === 'undefined'\n\t) {\n\t\treturn {};\n\t}\n\n\t// Production mode - decrypt credentials using master key\n\tconst masterKey = process.env.GKM_MASTER_KEY;\n\n\tif (!masterKey) {\n\t\t// Log warning but don't throw - allows graceful fallback to env vars\n\t\tconsole.error(\n\t\t\t'[gkm] GKM_MASTER_KEY environment variable is required to decrypt credentials.',\n\t\t);\n\t\tconsole.error(\n\t\t\t'[gkm] Falling back to environment variables. Some secrets may be missing.',\n\t\t);\n\t\treturn {};\n\t}\n\n\ttry {\n\t\treturn decryptCredentials(\n\t\t\t__GKM_ENCRYPTED_CREDENTIALS__,\n\t\t\t__GKM_CREDENTIALS_IV__,\n\t\t\tmasterKey,\n\t\t);\n\t} catch (error) {\n\t\tconsole.error('[gkm] Failed to decrypt credentials:', error);\n\t\tconsole.error('[gkm] Falling back to environment variables.');\n\t\treturn {};\n\t}\n})();\n\nexport default Credentials;\n"],"mappings":";;;;;;AAUA,MAAM,kBAAkB;;;;;AAMxB,SAAgB,mBACfA,WACAC,IACAC,WACyB;CACzB,MAAM,MAAM,OAAO,KAAK,WAAW,MAAM;CACzC,MAAM,WAAW,OAAO,KAAK,IAAI,MAAM;CACvC,MAAM,WAAW,OAAO,KAAK,WAAW,SAAS;CAGjD,MAAM,aAAa,SAAS,SAAS,IAAI,gBAAgB;CACzD,MAAM,UAAU,SAAS,UAAU,gBAAgB;CAGnD,MAAM,WAAW,kCAAiB,eAAe,KAAK,SAAS;AAC/D,UAAS,WAAW,QAAQ;CAE5B,MAAM,YAAY,OAAO,OAAO,CAC/B,SAAS,OAAO,WAAW,EAC3B,SAAS,OAAO,AAChB,EAAC;AAEF,QAAO,KAAK,MAAM,UAAU,SAAS,QAAQ,CAAC;AAC9C;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BD,MAAaC,cAAsC,CAAC,MAAM;CAIzD,MAAM,WAAY,WAChB;AACF,KAAI,SACH,QAAO;AAIR,YACQ,kCAAkC,sBAClC,2BAA2B,YAElC,QAAO,CAAE;CAIV,MAAM,YAAY,QAAQ,IAAI;AAE9B,MAAK,WAAW;AAEf,UAAQ,MACP,gFACA;AACD,UAAQ,MACP,4EACA;AACD,SAAO,CAAE;CACT;AAED,KAAI;AACH,SAAO,mBACN,+BACA,wBACA,UACA;CACD,SAAQ,OAAO;AACf,UAAQ,MAAM,wCAAwC,MAAM;AAC5D,UAAQ,MAAM,+CAA+C;AAC7D,SAAO,CAAE;CACT;AACD,IAAG;AAEJ,0BAAe"}
@@ -3,7 +3,7 @@
3
3
  * Decrypt credentials from encrypted payload.
4
4
  * Exported for testing purposes.
5
5
  */
6
- export declare function decryptCredentials(encrypted: string, iv: string, masterKey: string): Record<string, string>;
6
+ declare function decryptCredentials(encrypted: string, iv: string, masterKey: string): Record<string, string>;
7
7
  /**
8
8
  * Credentials object for use with EnvironmentParser.
9
9
  *
@@ -29,7 +29,7 @@ export declare function decryptCredentials(encrypted: string, iv: string, master
29
29
  * .parse();
30
30
  * ```
31
31
  */
32
- export declare const Credentials: Record<string, string>;
32
+ declare const Credentials: Record<string, string>;
33
33
  //#endregion
34
- export { Credentials as default };
34
+ export { Credentials, Credentials as default, decryptCredentials };
35
35
  //# sourceMappingURL=credentials.d.cts.map
@@ -1 +1 @@
1
- {"version":3,"file":"credentials.d.cts","names":[],"sources":["../src/credentials.ts"],"mappings":";;;;;wBAgBgB,mBACf,mBACA,YACA,oBACE;;;;;;;;;;;;;;;;;;;;;;;;;;qBA8CU,aAAa"}
1
+ {"version":3,"file":"credentials.d.cts","names":[],"sources":["../src/credentials.ts"],"sourcesContent":[],"mappings":";;AAgBA;AAkDA;;iBAlDgB,kBAAA,oDAIb;;;;;;;;;;;;;;;;;;;;;;;;;;cA8CU,aAAa"}
@@ -3,7 +3,7 @@
3
3
  * Decrypt credentials from encrypted payload.
4
4
  * Exported for testing purposes.
5
5
  */
6
- export declare function decryptCredentials(encrypted: string, iv: string, masterKey: string): Record<string, string>;
6
+ declare function decryptCredentials(encrypted: string, iv: string, masterKey: string): Record<string, string>;
7
7
  /**
8
8
  * Credentials object for use with EnvironmentParser.
9
9
  *
@@ -29,7 +29,7 @@ export declare function decryptCredentials(encrypted: string, iv: string, master
29
29
  * .parse();
30
30
  * ```
31
31
  */
32
- export declare const Credentials: Record<string, string>;
32
+ declare const Credentials: Record<string, string>;
33
33
  //#endregion
34
- export { Credentials as default };
34
+ export { Credentials, Credentials as default, decryptCredentials };
35
35
  //# sourceMappingURL=credentials.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"credentials.d.mts","names":[],"sources":["../src/credentials.ts"],"mappings":";;;;;wBAgBgB,mBACf,mBACA,YACA,oBACE;;;;;;;;;;;;;;;;;;;;;;;;;;qBA8CU,aAAa"}
1
+ {"version":3,"file":"credentials.d.mts","names":[],"sources":["../src/credentials.ts"],"sourcesContent":[],"mappings":";;AAgBA;AAkDA;;iBAlDgB,kBAAA,oDAIb;;;;;;;;;;;;;;;;;;;;;;;;;;cA8CU,aAAa"}
@@ -1,5 +1,8 @@
1
1
  import { createDecipheriv } from "node:crypto";
2
+
2
3
  //#region src/credentials.ts
4
+ /** AES-256-GCM auth tag length */
5
+ const AUTH_TAG_LENGTH = 16;
3
6
  /**
4
7
  * Decrypt credentials from encrypted payload.
5
8
  * Exported for testing purposes.
@@ -8,8 +11,8 @@ function decryptCredentials(encrypted, iv, masterKey) {
8
11
  const key = Buffer.from(masterKey, "hex");
9
12
  const ivBuffer = Buffer.from(iv, "hex");
10
13
  const combined = Buffer.from(encrypted, "base64");
11
- const ciphertext = combined.subarray(0, -16);
12
- const authTag = combined.subarray(-16);
14
+ const ciphertext = combined.subarray(0, -AUTH_TAG_LENGTH);
15
+ const authTag = combined.subarray(-AUTH_TAG_LENGTH);
13
16
  const decipher = createDecipheriv("aes-256-gcm", key, ivBuffer);
14
17
  decipher.setAuthTag(authTag);
15
18
  const plaintext = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
@@ -58,7 +61,8 @@ const Credentials = (() => {
58
61
  return {};
59
62
  }
60
63
  })();
61
- //#endregion
62
- export { Credentials, Credentials as default, decryptCredentials };
64
+ var credentials_default = Credentials;
63
65
 
66
+ //#endregion
67
+ export { Credentials, decryptCredentials, credentials_default as default };
64
68
  //# sourceMappingURL=credentials.mjs.map