npm - envapt - Versions diffs - 8.2.0 → 8.2.1 - Mend

envapt 8.2.0 → 8.2.1

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 (124) hide show

package/dist/portable/converters/ValueConverter.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"ValueConverter.mjs","names":[],"sources":["../../../src/converters/ValueConverter.ts"],"sourcesContent":["import { BuiltInConverters } from './BuiltInConverters';\nimport { state } from '../core/state';\nimport { Validator } from '../engine/Validators';\nimport { debugVerbose } from '../infra/Debug';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { ArrayOf } from './Converters';\nimport type { StandardSchemaV1 } from '../infra/StandardSchema';\nimport type { BuiltInConverter, EnvKeyInput, EnvaptConverter, PrimitiveConstructor } from '../types';\nimport type { EnvapterService } from '../types/Env';\n\nfunction formatKeyForError(key: EnvKeyInput): string {\n return Array.isArray(key) ? `[${key.join(', ')}]` : String(key);\n}\n\n/*\n Convert a resolved environment value to its declared type via built-in, primitive, array,\n * custom, or Standard Schema converters.\n * @internal\n /\nexport class ValueConverter {\n constructor(private readonly envService: EnvapterService) {}\n\n convertValue<TFallback>(\n key: EnvKeyInput,\n fallback: TFallback \| undefined,\n converter: EnvaptConverter<TFallback> \| undefined,\n hasFallback: boolean\n ): TFallback \| undefined {\n const resolvedConverter = this.resolveConverter(converter, fallback);\n const processedFallback = this.processFallbackForConverter(resolvedConverter, fallback);\n\n if (Validator.isArrayConverter(resolvedConverter)) {\n return this.processArrayConverter(key, processedFallback, resolvedConverter, hasFallback);\n }\n\n if (Validator.isPrimitiveConstructor(resolvedConverter)) {\n const stringConverter = this.convertPrimitiveToString(resolvedConverter);\n return this.processBuiltInConverter(key, processedFallback, stringConverter, hasFallback, true);\n }\n\n if (Validator.isBuiltInConverter(resolvedConverter)) {\n return this.processBuiltInConverter(key, processedFallback, resolvedConverter, hasFallback, false);\n }\n\n return this.processCustomConverter(key, processedFallback, resolvedConverter, hasFallback);\n }\n\n private processFallbackForConverter<TFallback>(\n converter: EnvaptConverter<TFallback>,\n fallback: TFallback \| undefined\n ): TFallback \| undefined {\n if (Validator.isPrimitiveConstructor(converter) && fallback !== undefined) {\n return Validator.coercePrimitiveFallback<TFallback>(converter, fallback);\n }\n return fallback;\n }\n\n private convertPrimitiveToString(primitiveConstructor: PrimitiveConstructor): BuiltInConverter {\n if (primitiveConstructor === String) return 'string';\n if (primitiveConstructor === Number) return 'number';\n if (primitiveConstructor === Boolean) return 'boolean';\n if (primitiveConstructor === BigInt) return 'bigint';\n / v8 ignore next -- @preserve /\n if (primitiveConstructor === Symbol) return 'symbol';\n\n / v8 ignore next -- @preserve */\n throw new EnvaptError(EnvaptErrorCodes.InvalidConverterType, `Unknown primitive constructor`);\n }\n\n private processBuiltInConverter<TFallback>(\n key: EnvKeyInput,\n fallback: TFallback \| undefined,\n resolvedConverter: BuiltInConverter,\n hasFallback: boolean,\n wasOriginallyConstructor: boolean\n ): TFallback \| undefined {\n Validator.builtInConverter(resolvedConverter);\n\n if (hasFallback && !wasOriginallyConstructor) {\n Validator.validateBuiltInConverterFallback(resolvedConverter, fallback);\n }\n\n const parsed = this.envService.get(key, undefined);\n\n if (parsed === undefined) {\n if (!hasFallback) return undefined;\n // coerce a string fallback to the number return type through the time converter\n if (resolvedConverter === 'time' && typeof fallback === 'string') {\n const timeFn = BuiltInConverters.getConverter(resolvedConverter);\n return timeFn('', fallback) as TFallback;\n }\n return fallback;\n }\n\n const converterFn = BuiltInConverters.getConverter(resolvedConverter);\n const converted = converterFn(parsed, undefined);\n\n if (converted === undefined) {\n // key and type only, no value, since env values can be secrets and verbose logs reach stderr\n debugVerbose(\n `could not convert ${formatKeyForError(key)} as ${resolvedConverter}${hasFallback ? ', using the fallback' : ''}`\n );\n // re-run with the real fallback so time's string-form fallback still coerces to a number\n return hasFallback ? (converterFn(parsed, fallback) as TFallback) : undefined;\n }\n\n return converted as TFallback;\n }\n\n private processArrayConverter<TFallback>(\n key: EnvKeyInput,\n fallback: TFallback \| undefined,\n resolvedConverter: ArrayOf,\n hasFallback: boolean\n ): TFallback \| undefined {\n Validator.arrayConverter(resolvedConverter);\n\n if (hasFallback && !Array.isArray(fallback)) {\n throw new EnvaptError(\n EnvaptErrorCodes.InvalidFallback,\n `ArrayOf<...> requires that the fallback be an array, got ${typeof fallback}`\n );\n }\n\n if (hasFallback && Array.isArray(fallback)) {\n Validator.validateArrayFallbackElementTypes(fallback);\n Validator.validateArrayConverterElementTypeMatch(resolvedConverter.of, fallback);\n }\n\n const parsed = this.envService.get(key, undefined);\n\n if (parsed === undefined) {\n if (!hasFallback) return undefined;\n // coerce each time-string entry through the time converter so the array is number[]\n // matching the declared return type\n if (\n resolvedConverter.of === 'time' &&\n Array.isArray(fallback) &&\n fallback.every((v) => typeof v === 'string')\n ) {\n const timeFn = BuiltInConverters.getConverter('time');\n return fallback.map((v) => timeFn('', v as string)) as TFallback;\n }\n return fallback;\n }\n\n const result = BuiltInConverters.processArrayConverter(parsed, resolvedConverter, state.strict);\n return result as TFallback;\n }\n\n private processCustomConverter<TFallback>(\n key: EnvKeyInput,\n fallback: TFallback \| undefined,\n resolvedConverter: EnvaptConverter<TFallback>,\n _hasFallback: boolean // unused. the custom converter runs even when raw is undefined\n ): TFallback \| undefined {\n Validator.customConvertor(resolvedConverter);\n\n const raw = this.envService.get(key, undefined);\n\n return resolvedConverter(raw, fallback);\n }\n\n private resolveConverter<TFallback>(\n converter: EnvaptConverter<TFallback> \| undefined,\n fallback: TFallback \| undefined\n ): EnvaptConverter<TFallback> {\n if (converter) return converter;\n\n const fallbackType = typeof fallback;\n if (fallbackType === 'number') return 'number';\n if (fallbackType === 'boolean') return 'boolean';\n if (fallbackType === 'bigint') return 'bigint';\n if (fallbackType === 'symbol') return 'symbol';\n return 'string';\n }\n\n // Single dispatch site for decorator + `Envapter.parse()` so error codes (208 / 209 / 305)\n // stay consistent. Missing+no-fallback throws here so callers don't duplicate the check.\n convertWithSchema(key: EnvKeyInput, schema: StandardSchemaV1, fallback: unknown, hasFallback: boolean): unknown {\n const raw = this.envService.get(key, undefined);\n\n if (raw === undefined) {\n if (hasFallback) return fallback;\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${formatKeyForError(key)}\" is missing or empty.`\n );\n }\n\n let outcome: StandardSchemaV1.Result<unknown> \| Promise<StandardSchemaV1.Result<unknown>>;\n try {\n outcome = schema['~standard'].validate(raw);\n } catch (cause) {\n throw new EnvaptError(\n EnvaptErrorCodes.SchemaThrew,\n `Schema for \"${formatKeyForError(key)}\" threw during validation: ${(cause as Error).message}`,\n { cause }\n );\n }\n\n if (outcome instanceof Promise) {\n throw new EnvaptError(\n EnvaptErrorCodes.InvalidUserDefinedConfig,\n `Schema for \"${formatKeyForError(key)}\" returned a Promise. envapt requires synchronous schemas; use a sync validator or perform async checks outside the env layer.`\n );\n }\n\n if (outcome.issues !== undefined) {\n const first = outcome.issues[0];\n const firstMessage = first?.message ?? 'no issue message';\n throw new EnvaptError(\n EnvaptErrorCodes.SchemaValidationFailed,\n `Schema validation failed for \"${formatKeyForError(key)}\": ${firstMessage}`,\n { issues: outcome.issues }\n );\n }\n\n return outcome.value;\n }\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"ValueConverter.mjs","names":[],"sources":["../../../src/converters/ValueConverter.ts"],"sourcesContent":["import { BuiltInConverters } from './BuiltInConverters';\nimport { state } from '../core/state';\nimport { Validator } from '../engine/Validators';\nimport { debugVerbose } from '../infra/Debug';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { ArrayOf } from './Converters';\nimport type { StandardSchemaV1 } from '../infra/StandardSchema';\nimport type { BuiltInConverter, EnvKeyInput, EnvaptConverter, PrimitiveConstructor } from '../types';\nimport type { EnvapterService } from '../types/Env';\n\nfunction formatKeyForError(key: EnvKeyInput): string {\n return Array.isArray(key) ? `[${key.join(', ')}]` : String(key);\n}\n\nexport class ValueConverter {\n constructor(private readonly envService: EnvapterService) {}\n\n convertValue<TFallback>(\n key: EnvKeyInput,\n fallback: TFallback \| undefined,\n converter: EnvaptConverter<TFallback> \| undefined,\n hasFallback: boolean\n ): TFallback \| undefined {\n const resolvedConverter = this.resolveConverter(converter, fallback);\n const processedFallback = this.processFallbackForConverter(resolvedConverter, fallback);\n\n if (Validator.isArrayConverter(resolvedConverter)) {\n return this.processArrayConverter(key, processedFallback, resolvedConverter, hasFallback);\n }\n\n if (Validator.isPrimitiveConstructor(resolvedConverter)) {\n const stringConverter = this.convertPrimitiveToString(resolvedConverter);\n return this.processBuiltInConverter(key, processedFallback, stringConverter, hasFallback, true);\n }\n\n if (Validator.isBuiltInConverter(resolvedConverter)) {\n return this.processBuiltInConverter(key, processedFallback, resolvedConverter, hasFallback, false);\n }\n\n return this.processCustomConverter(key, processedFallback, resolvedConverter, hasFallback);\n }\n\n private processFallbackForConverter<TFallback>(\n converter: EnvaptConverter<TFallback>,\n fallback: TFallback \| undefined\n ): TFallback \| undefined {\n if (Validator.isPrimitiveConstructor(converter) && fallback !== undefined) {\n return Validator.coercePrimitiveFallback<TFallback>(converter, fallback);\n }\n return fallback;\n }\n\n private convertPrimitiveToString(primitiveConstructor: PrimitiveConstructor): BuiltInConverter {\n if (primitiveConstructor === String) return 'string';\n if (primitiveConstructor === Number) return 'number';\n if (primitiveConstructor === Boolean) return 'boolean';\n if (primitiveConstructor === BigInt) return 'bigint';\n /* v8 ignore next -- @preserve /\n if (primitiveConstructor === Symbol) return 'symbol';\n\n / v8 ignore next -- @preserve */\n throw new EnvaptError(EnvaptErrorCodes.InvalidConverterType, `Unknown primitive constructor`);\n }\n\n private processBuiltInConverter<TFallback>(\n key: EnvKeyInput,\n fallback: TFallback \| undefined,\n resolvedConverter: BuiltInConverter,\n hasFallback: boolean,\n wasOriginallyConstructor: boolean\n ): TFallback \| undefined {\n Validator.builtInConverter(resolvedConverter);\n\n if (hasFallback && !wasOriginallyConstructor) {\n Validator.validateBuiltInConverterFallback(resolvedConverter, fallback);\n }\n\n const parsed = this.envService.get(key, undefined);\n\n if (parsed === undefined) {\n if (!hasFallback) return undefined;\n // time returns a number even when the fallback is a string\n if (resolvedConverter === 'time' && typeof fallback === 'string') {\n const timeFn = BuiltInConverters.getConverter(resolvedConverter);\n return timeFn('', fallback) as TFallback;\n }\n return fallback;\n }\n\n const converterFn = BuiltInConverters.getConverter(resolvedConverter);\n const converted = converterFn(parsed, undefined);\n\n if (converted === undefined) {\n // leave the value out because env values can be secrets\n debugVerbose(\n `could not convert ${formatKeyForError(key)} as ${resolvedConverter}${hasFallback ? ', using the fallback' : ''}`\n );\n // time needs the real fallback to turn a string fallback into a number\n return hasFallback ? (converterFn(parsed, fallback) as TFallback) : undefined;\n }\n\n return converted as TFallback;\n }\n\n private processArrayConverter<TFallback>(\n key: EnvKeyInput,\n fallback: TFallback \| undefined,\n resolvedConverter: ArrayOf,\n hasFallback: boolean\n ): TFallback \| undefined {\n Validator.arrayConverter(resolvedConverter);\n\n if (hasFallback && !Array.isArray(fallback)) {\n throw new EnvaptError(\n EnvaptErrorCodes.InvalidFallback,\n `ArrayOf<...> requires that the fallback be an array, got ${typeof fallback}`\n );\n }\n\n if (hasFallback && Array.isArray(fallback)) {\n Validator.validateArrayFallbackElementTypes(fallback);\n Validator.validateArrayConverterElementTypeMatch(resolvedConverter.of, fallback);\n }\n\n const parsed = this.envService.get(key, undefined);\n\n if (parsed === undefined) {\n if (!hasFallback) return undefined;\n // a time array returns number[] even when its fallback holds strings\n if (\n resolvedConverter.of === 'time' &&\n Array.isArray(fallback) &&\n fallback.every((v) => typeof v === 'string')\n ) {\n const timeFn = BuiltInConverters.getConverter('time');\n return fallback.map((v) => timeFn('', v as string)) as TFallback;\n }\n return fallback;\n }\n\n const result = BuiltInConverters.processArrayConverter(parsed, resolvedConverter, state.strict);\n return result as TFallback;\n }\n\n private processCustomConverter<TFallback>(\n key: EnvKeyInput,\n fallback: TFallback \| undefined,\n resolvedConverter: EnvaptConverter<TFallback>,\n _hasFallback: boolean // unused. the custom converter runs even when raw is undefined\n ): TFallback \| undefined {\n Validator.customConvertor(resolvedConverter);\n\n const raw = this.envService.get(key, undefined);\n\n return resolvedConverter(raw, fallback);\n }\n\n private resolveConverter<TFallback>(\n converter: EnvaptConverter<TFallback> \| undefined,\n fallback: TFallback \| undefined\n ): EnvaptConverter<TFallback> {\n if (converter) return converter;\n\n const fallbackType = typeof fallback;\n if (fallbackType === 'number') return 'number';\n if (fallbackType === 'boolean') return 'boolean';\n if (fallbackType === 'bigint') return 'bigint';\n if (fallbackType === 'symbol') return 'symbol';\n return 'string';\n }\n\n // the decorators and `Envapter.parse()` both run schema reads through here\n convertWithSchema(key: EnvKeyInput, schema: StandardSchemaV1, fallback: unknown, hasFallback: boolean): unknown {\n const raw = this.envService.get(key, undefined);\n\n if (raw === undefined) {\n if (hasFallback) return fallback;\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${formatKeyForError(key)}\" is missing or empty.`\n );\n }\n\n let outcome: StandardSchemaV1.Result<unknown> \| Promise<StandardSchemaV1.Result<unknown>>;\n try {\n outcome = schema['~standard'].validate(raw);\n } catch (cause) {\n throw new EnvaptError(\n EnvaptErrorCodes.SchemaThrew,\n `Schema for \"${formatKeyForError(key)}\" threw during validation: ${(cause as Error).message}`,\n { cause }\n );\n }\n\n if (outcome instanceof Promise) {\n throw new EnvaptError(\n EnvaptErrorCodes.InvalidUserDefinedConfig,\n `Schema for \"${formatKeyForError(key)}\" returned a Promise. envapt requires synchronous schemas; use a sync validator or perform async checks outside the env layer.`\n );\n }\n\n if (outcome.issues !== undefined) {\n const first = outcome.issues[0];\n const firstMessage = first?.message ?? 'no issue message';\n throw new EnvaptError(\n EnvaptErrorCodes.SchemaValidationFailed,\n `Schema validation failed for \"${formatKeyForError(key)}\": ${firstMessage}`,\n { issues: outcome.issues }\n );\n }\n\n return outcome.value;\n }\n}\n"],"mappings":"8PAWA,SAAS,EAAkB,EAA0B,CACjD,OAAO,MAAM,QAAQ,CAAG,EAAI,IAAI,EAAI,KAAK,IAAI,EAAE,GAAK,OAAO,CAAG,CAClE,CAEA,IAAa,EAAb,KAA4B,CACK,WAA7B,YAAY,EAA8C,CAA7B,KAAA,WAAA,CAA8B,CAE3D,aACI,EACA,EACA,EACA,EACqB,CACrB,IAAM,EAAoB,KAAK,iBAAiB,EAAW,CAAQ,EAC7D,EAAoB,KAAK,4BAA4B,EAAmB,CAAQ,EAEtF,GAAI,EAAU,iBAAiB,CAAiB,EAC5C,OAAO,KAAK,sBAAsB,EAAK,EAAmB,EAAmB,CAAW,EAG5F,GAAI,EAAU,uBAAuB,CAAiB,EAAG,CACrD,IAAM,EAAkB,KAAK,yBAAyB,CAAiB,EACvE,OAAO,KAAK,wBAAwB,EAAK,EAAmB,EAAiB,EAAa,EAAI,CAClG,CAMA,OAJI,EAAU,mBAAmB,CAAiB,EACvC,KAAK,wBAAwB,EAAK,EAAmB,EAAmB,EAAa,EAAK,EAG9F,KAAK,uBAAuB,EAAK,EAAmB,EAAmB,CAAW,CAC7F,CAEA,4BACI,EACA,EACqB,CAIrB,OAHI,EAAU,uBAAuB,CAAS,GAAK,IAAa,IAAA,GACrD,EAAU,wBAAmC,EAAW,CAAQ,EAEpE,CACX,CAEA,yBAAiC,EAA8D,CAC3F,GAAI,IAAyB,OAAQ,MAAO,SAC5C,GAAI,IAAyB,OAAQ,MAAO,SAC5C,GAAI,IAAyB,QAAS,MAAO,UAC7C,GAAI,IAAyB,OAAQ,MAAO,SAE5C,GAAI,IAAyB,OAAQ,MAAO,SAG5C,MAAM,IAAI,EAAA,IAAmD,+BAA+B,CAChG,CAEA,wBACI,EACA,EACA,EACA,EACA,EACqB,CACrB,EAAU,iBAAiB,CAAiB,EAExC,GAAe,CAAC,GAChB,EAAU,iCAAiC,EAAmB,CAAQ,EAG1E,IAAM,EAAS,KAAK,WAAW,IAAI,EAAK,IAAA,EAAS,EAEjD,GAAI,IAAW,IAAA,GAOX,OANK,EAED,IAAsB,QAAU,OAAO,GAAa,SACrC,EAAkB,aAAa,CAClC,CAAC,CAAC,GAAI,CAAQ,EAEvB,EANW,OAStB,IAAM,EAAc,EAAkB,aAAa,CAAiB,EAC9D,EAAY,EAAY,EAAQ,IAAA,EAAS,EAW/C,OATI,IAAc,IAAA,IAEd,EACI,qBAAqB,EAAkB,CAAG,EAAE,MAAM,IAAoB,EAAc,uBAAyB,IACjH,EAEO,EAAe,EAAY,EAAQ,CAAQ,EAAkB,IAAA,IAGjE,CACX,CAEA,sBACI,EACA,EACA,EACA,EACqB,CAGrB,GAFA,EAAU,eAAe,CAAiB,EAEtC,GAAe,CAAC,MAAM,QAAQ,CAAQ,EACtC,MAAM,IAAI,EAAA,IAEN,4DAA4D,OAAO,GACvE,EAGA,GAAe,MAAM,QAAQ,CAAQ,IACrC,EAAU,kCAAkC,CAAQ,EACpD,EAAU,uCAAuC,EAAkB,GAAI,CAAQ,GAGnF,IAAM,EAAS,KAAK,WAAW,IAAI,EAAK,IAAA,EAAS,EAEjD,GAAI,IAAW,IAAA,GAAW,CACtB,GAAI,CAAC,EAAa,OAElB,GACI,EAAkB,KAAO,QACzB,MAAM,QAAQ,CAAQ,GACtB,EAAS,MAAO,GAAM,OAAO,GAAM,QAAQ,EAC7C,CACE,IAAM,EAAS,EAAkB,aAAa,MAAM,EACpD,OAAO,EAAS,IAAK,GAAM,EAAO,GAAI,CAAW,CAAC,CACtD,CACA,OAAO,CACX,CAGA,OADe,EAAkB,sBAAsB,EAAQ,EAAmB,EAAM,MAC5E,CAChB,CAEA,uBACI,EACA,EACA,EACA,EACqB,CAKrB,OAJA,EAAU,gBAAgB,CAAiB,EAIpC,EAFK,KAAK,WAAW,IAAI,EAAK,IAAA,EAEV,EAAG,CAAQ,CAC1C,CAEA,iBACI,EACA,EAC0B,CAC1B,GAAI,EAAW,OAAO,EAEtB,IAAM,EAAe,OAAO,EAK5B,OAJI,IAAiB,SAAiB,SAClC,IAAiB,UAAkB,UACnC,IAAiB,SAAiB,SAClC,IAAiB,SAAiB,SAC/B,QACX,CAGA,kBAAkB,EAAkB,EAA0B,EAAmB,EAA+B,CAC5G,IAAM,EAAM,KAAK,WAAW,IAAI,EAAK,IAAA,EAAS,EAE9C,GAAI,IAAQ,IAAA,GAAW,CACnB,GAAI,EAAa,OAAO,EACxB,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAkB,CAAG,EAAE,uBAC7D,CACJ,CAEA,IAAI,EACJ,GAAI,CACA,EAAU,EAAO,YAAY,CAAC,SAAS,CAAG,CAC9C,OAAS,EAAO,CACZ,MAAM,IAAI,EAAA,IAEN,eAAe,EAAkB,CAAG,EAAE,6BAA8B,EAAgB,UACpF,CAAE,OAAM,CACZ,CACJ,CAEA,GAAI,aAAmB,QACnB,MAAM,IAAI,EAAA,IAEN,eAAe,EAAkB,CAAG,EAAE,+HAC1C,EAGJ,GAAI,EAAQ,SAAW,IAAA,GAAW,CAE9B,IAAM,EADQ,EAAQ,OAAO,EACH,EAAE,SAAW,mBACvC,MAAM,IAAI,EAAA,IAEN,iCAAiC,EAAkB,CAAG,EAAE,KAAK,IAC7D,CAAE,OAAQ,EAAQ,MAAO,CAC7B,CACJ,CAEA,OAAO,EAAQ,KACnB,CACJ"}

package/dist/portable/core/AdvancedMethods.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AdvancedMethods.mjs","names":[],"sources":["../../../src/core/AdvancedMethods.ts"],"sourcesContent":["import { resolveKeyInput, templateResolver, valueConverter } from './engine';\nimport { hasFallback, isMissing } from './missing';\nimport { PrimitiveMethods } from './PrimitiveMethods';\nimport { debugWarn } from '../infra/Debug';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\nimport { recase } from '../infra/recase';\n\nimport type { ArrayOf } from '../converters';\nimport type { TemplateResolver } from '../engine/TemplateResolver';\nimport type { InferSchemaOutput, StandardSchemaV1 } from '../infra/StandardSchema';\nimport type {\n AdvancedConverterReturn,\n BuiltInConverter,\n ConditionalReturn,\n ConverterFunction,\n EnvaptConverter,\n EnvKeyInput,\n InferConverterReturnType,\n InferSpecField,\n KeyCasing,\n RecaseKey,\n RequiredSpec,\n SchemaConstraint,\n TimeFallback\n} from '../types';\n\nfunction formatKeyForError(key: EnvKeyInput): string {\n return Array.isArray(key) ? `[${key.join(', ')}]` : String(key);\n}\n\n// missing check runs after template resolution so a value that resolves to blank falls through\n// (empty always, whitespace-only under strict)\nexport function resolveRequired(\n resolved: { key: string; value: string \| undefined },\n templateResolver: TemplateResolver\n): { key: string; value: string \| undefined } {\n if (resolved.value === undefined) return resolved;\n const value = templateResolver.resolveTemplate(resolved.key, resolved.value);\n return { key: resolved.key, value: isMissing(value) ? undefined : value };\n}\n\n/*\n Mixin for advanced methods for environment variable conversion using built-in and custom converters\n * @internal\n /\nexport class AdvancedMethods extends PrimitiveMethods {\n /\n Get an environment variable using a built-in converter.\n \n Supports both scalar tokens (e.g. `Converters.Number`) and `ArrayOf<...>` tokens\n * produced by `Converters.array(...)`. The key can be a single name or an ordered list.\n * The first defined value wins.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#converters}\n * @see {@link https://envapt.materwelon.dev/docs/converters#custom-converters}\n /\n // Time-specific overload must precede the generic BuiltInConverter overload so it wins\n // overload resolution (TimeFallback accepts time-strings like `'10s'`).\n static getUsing<TFallback extends TimeFallback \| undefined = undefined>(\n key: EnvKeyInput,\n converter: 'time',\n fallback?: TFallback\n ): ConditionalReturn<number, TFallback>;\n static getUsing<TConverter extends BuiltInConverter \| ArrayOf, TFallback = undefined>(\n key: EnvKeyInput,\n converter: TConverter,\n fallback?: TFallback\n ): AdvancedConverterReturn<TConverter, TFallback>;\n static getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter \| ArrayOf, fallback?: TReturn): TReturn;\n static getUsing<TConverter extends BuiltInConverter \| ArrayOf, TFallback = undefined>(\n key: EnvKeyInput,\n converter: TConverter,\n fallback?: TFallback\n ): AdvancedConverterReturn<TConverter, TFallback> {\n const { key: resolvedKey, value } = resolveKeyInput(key);\n\n // a missing value with a fallback falls through to the parser so asymmetric types\n // (TimeFallback, TimeFallback[] for `of: time`) coerce to the return type\n if (isMissing(value) && !hasFallback(fallback)) {\n debugWarn(`${resolvedKey} is missing or empty`);\n return undefined as AdvancedConverterReturn<TConverter, TFallback>;\n }\n\n const result = valueConverter.convertValue(resolvedKey, fallback, converter, hasFallback(fallback));\n\n return result as AdvancedConverterReturn<TConverter, TFallback>;\n }\n\n /\n @see {@link AdvancedMethods.getUsing}\n /\n getUsing<TFallback extends TimeFallback \| undefined = undefined>(\n key: EnvKeyInput,\n converter: 'time',\n fallback?: TFallback\n ): ConditionalReturn<number, TFallback>;\n getUsing<TConverter extends BuiltInConverter \| ArrayOf, TFallback = undefined>(\n key: EnvKeyInput,\n converter: TConverter,\n fallback?: TFallback\n ): AdvancedConverterReturn<TConverter, TFallback>;\n getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter \| ArrayOf, fallback?: TReturn): TReturn;\n getUsing<TConverter extends BuiltInConverter \| ArrayOf, TFallback = undefined>(\n key: EnvKeyInput,\n converter: TConverter,\n fallback?: TFallback\n ): AdvancedConverterReturn<TConverter, TFallback> {\n return AdvancedMethods.getUsing(key, converter, fallback);\n }\n\n /\n Get an environment variable using a custom converter function.\n * Accepts a single key or an ordered list for automatic fallback.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#converters}\n * @see {@link https://envapt.materwelon.dev/docs/converters#custom-converters}\n /\n static getWith<TReturnType, TFallback extends TReturnType \| undefined = undefined>(\n key: EnvKeyInput,\n converter: ConverterFunction<TReturnType>,\n fallback?: TFallback\n ): ConditionalReturn<TReturnType, TFallback> {\n // run the custom converter even on a missing value, with raw as undefined\n const result = valueConverter.convertValue<TReturnType>(key, fallback, converter, hasFallback(fallback));\n\n return result as ConditionalReturn<TReturnType, TFallback>;\n }\n\n /\n @see {@link AdvancedMethods.getWith}\n /\n getWith<TReturnType, TFallback extends TReturnType \| undefined = undefined>(\n key: EnvKeyInput,\n converter: ConverterFunction<TReturnType>,\n fallback?: TFallback\n ): ConditionalReturn<TReturnType, TFallback> {\n return AdvancedMethods.getWith(key, converter, fallback);\n }\n\n /\n Read a required environment variable and convert it, throwing `MissingEnvValue` when the value\n * is missing or empty. Returns the non-undefined converter output. Accepts a built-in or `ArrayOf`\n * token, or a custom parser function. The key can be a single name or an ordered list.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#fail-fast-on-missing-values}\n * @see {@link https://envapt.materwelon.dev/docs/converters#require-a-converted-value}\n /\n static getRequired<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n converter: TConverter\n ): InferConverterReturnType<TConverter>;\n static getRequired<TReturnType>(key: EnvKeyInput, converter: ConverterFunction<TReturnType, string>): TReturnType;\n static getRequired<TConverter extends BuiltInConverter \| ArrayOf, TReturnType>(\n key: EnvKeyInput,\n converter: TConverter \| ConverterFunction<TReturnType, string>\n ): InferConverterReturnType<TConverter> \| TReturnType {\n // a required read treats empty as missing, so an empty value falls through to the next candidate.\n const candidates: readonly string[] = typeof key === 'string' ? [key] : key;\n let resolvedKey = '';\n let value: string \| undefined;\n for (const candidate of candidates) {\n const resolved = resolveRequired(resolveKeyInput(candidate), templateResolver);\n resolvedKey = resolved.key;\n if (resolved.value !== undefined) {\n value = resolved.value;\n break;\n }\n }\n if (value === undefined) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${formatKeyForError(key)}\" is missing or empty.`\n );\n }\n // cast widens the raw-string parser back to convertValue's ConverterFunction<T> (value proven present above).\n const result = valueConverter.convertValue<TReturnType>(\n resolvedKey,\n undefined,\n converter as EnvaptConverter<TReturnType>,\n false\n );\n // a built-in yields undefined for a present value it cannot convert, a custom converter can return null, both break the non-undefined return\n if (result === undefined \|\| result === null) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${formatKeyForError(key)}\" is present but could not be converted.`\n );\n }\n return result;\n }\n\n /\n @see {@link AdvancedMethods.getRequired}\n /\n getRequired<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n converter: TConverter\n ): InferConverterReturnType<TConverter>;\n getRequired<TReturnType>(key: EnvKeyInput, converter: ConverterFunction<TReturnType, string>): TReturnType;\n getRequired<TConverter extends BuiltInConverter \| ArrayOf, TReturnType>(\n key: EnvKeyInput,\n converter: TConverter \| ConverterFunction<TReturnType, string>\n ): InferConverterReturnType<TConverter> \| TReturnType {\n return AdvancedMethods.getRequired(key, converter as ConverterFunction<TReturnType, string>);\n }\n\n /\n Read a group of required environment variables in one call. Each key in `spec` maps to a\n * converter (a token, an `array()` token, or a custom parser), and the returned record holds\n * every converted value, all non-undefined. Collects every missing or empty key and throws one\n * `MissingEnvValue` listing them all. Pass a `casing` (`'camelCase'`, `'PascalCase'`, or\n * `'kebab-case'`) to rename the record keys, splitting on underscores, which assumes the\n * conventional SCREAMING_SNAKE env-var names. With no casing the keys stay as-is.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#fail-fast-on-missing-values}\n * @see {@link https://envapt.materwelon.dev/docs/converters#require-a-converted-value}\n /\n static getRequiredAll<Spec extends RequiredSpec, Casing extends KeyCasing \| undefined = undefined>(\n spec: Spec,\n casing?: Casing\n ): { [K in keyof Spec as RecaseKey<K & string, Casing>]: InferSpecField<Spec[K]> } {\n const keys = Object.keys(spec);\n const missing = keys.filter(\n (key) => resolveRequired(resolveKeyInput(key), templateResolver).value === undefined\n );\n if (missing.length > 0) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Missing required environment variables: ${missing.join(', ')}.`\n );\n }\n\n const result: Record<string, unknown> = {};\n for (const key of keys) {\n // same widening cast as getRequired, every value was proven present above.\n const converted = valueConverter.convertValue<unknown>(\n key,\n undefined,\n spec[key] as EnvaptConverter<unknown>,\n false\n );\n if (converted === undefined \|\| converted === null) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${key}\" is present but could not be converted.`\n );\n }\n result[recase(key, casing)] = converted;\n }\n return result as { [K in keyof Spec as RecaseKey<K & string, Casing>]: InferSpecField<Spec[K]> };\n }\n\n /\n @see {@link AdvancedMethods.getRequiredAll}\n /\n getRequiredAll<Spec extends RequiredSpec, Casing extends KeyCasing \| undefined = undefined>(\n spec: Spec,\n casing?: Casing\n ): { [K in keyof Spec as RecaseKey<K & string, Casing>]: InferSpecField<Spec[K]> } {\n return AdvancedMethods.getRequiredAll(spec, casing);\n }\n\n /\n Validate an environment variable through a {@link StandardSchemaV1}-conformant schema\n * (zod, valibot, arktype, etc). Throws `MissingEnvValue` if the env value is absent and\n * no fallback is provided. The fallback, when provided, is returned as-is on missing.\n * It does NOT pass through the schema, mirroring custom-converter behavior.\n \n Synchronous schemas only. A Promise-returning `validate` triggers an\n * `InvalidUserDefinedConfig` throw at the call site.\n \n @example\n * ```ts\n * import { z } from 'zod';\n * const port = Envapter.parse('PORT', z.coerce.number().min(1024).max(65535), 3000);\n * ```\n * @see {@link https://envapt.materwelon.dev/docs/standard-schema#any-conformant-validator-or-none}\n /\n static parse<Schema extends StandardSchemaV1>(\n key: EnvKeyInput,\n schema: SchemaConstraint<Schema>,\n fallback?: InferSchemaOutput<Schema>\n ): InferSchemaOutput<Schema> {\n // SchemaConstraint resolves to the unsatisfiable SchemaMustBeSync brand for async\n // schemas, so reaching this body means the input is structurally a sync Schema.\n const result = valueConverter.convertWithSchema(\n key,\n schema as unknown as StandardSchemaV1,\n fallback,\n hasFallback(fallback)\n );\n return result;\n }\n\n /\n @see {@link AdvancedMethods.parse}\n */\n parse<Schema extends StandardSchemaV1>(\n key: EnvKeyInput,\n schema: SchemaConstraint<Schema>,\n fallback?: InferSchemaOutput<Schema>\n ): InferSchemaOutput<Schema> {\n const result = valueConverter.convertWithSchema(\n key,\n schema as unknown as StandardSchemaV1,\n fallback,\n hasFallback(fallback)\n );\n return result;\n }\n}\n"],"mappings":"2VA0BA,SAAS,EAAkB,EAA0B,CACjD,OAAO,MAAM,QAAQ,CAAG,EAAI,IAAI,EAAI,KAAK,IAAI,EAAE,GAAK,OAAO,CAAG,CAClE,CAIA,SAAgB,EACZ,EACA,EAC0C,CAC1C,GAAI,EAAS,QAAU,IAAA,GAAW,OAAO,EACzC,IAAM,EAAQ,EAAiB,gBAAgB,EAAS,IAAK,EAAS,KAAK,EAC3E,MAAO,CAAE,IAAK,EAAS,IAAK,MAAO,EAAU,CAAK,EAAI,IAAA,GAAY,CAAM,CAC5E,CAMA,IAAa,EAAb,MAAa,UAAwB,CAAiB,CAuBlD,OAAO,SACH,EACA,EACA,EAC8C,CAC9C,GAAM,CAAE,IAAK,EAAa,SAAU,EAAgB,CAAG,EAIvD,GAAI,EAAU,CAAK,GAAK,CAAC,EAAY,CAAQ,EAAG,CAC5C,EAAU,GAAG,EAAY,qBAAqB,EAC9C,MACJ,CAIA,OAFe,EAAe,aAAa,EAAa,EAAU,EAAW,EAAY,CAAQ,CAErF,CAChB,CAgBA,SACI,EACA,EACA,EAC8C,CAC9C,OAAO,EAAgB,SAAS,EAAK,EAAW,CAAQ,CAC5D,CAQA,OAAO,QACH,EACA,EACA,EACyC,CAIzC,OAFe,EAAe,aAA0B,EAAK,EAAU,EAAW,EAAY,CAAQ,CAE1F,CAChB,CAKA,QACI,EACA,EACA,EACyC,CACzC,OAAO,EAAgB,QAAQ,EAAK,EAAW,CAAQ,CAC3D,CAcA,OAAO,YACH,EACA,EACkD,CAElD,IAAM,EAAgC,OAAO,GAAQ,SAAW,CAAC,CAAG,EAAI,EACpE,EAAc,GACd,EACJ,IAAK,IAAM,KAAa,EAAY,CAChC,IAAM,EAAW,EAAgB,EAAgB,CAAS,EAAG,CAAgB,EAE7E,GADA,EAAc,EAAS,IACnB,EAAS,QAAU,IAAA,GAAW,CAC9B,EAAQ,EAAS,MACjB,KACJ,CACJ,CACA,GAAI,IAAU,IAAA,GACV,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAkB,CAAG,EAAE,uBAC7D,EAGJ,IAAM,EAAS,EAAe,aAC1B,EACA,IAAA,GACA,EACA,EACJ,EAEA,GAAI,GAAmC,KACnC,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAkB,CAAG,EAAE,yCAC7D,EAEJ,OAAO,CACX,CAUA,YACI,EACA,EACkD,CAClD,OAAO,EAAgB,YAAY,EAAK,CAAmD,CAC/F,CAYA,OAAO,eACH,EACA,EAC+E,CAC/E,IAAM,EAAO,OAAO,KAAK,CAAI,EACvB,EAAU,EAAK,OAChB,GAAQ,EAAgB,EAAgB,CAAG,EAAG,CAAgB,CAAC,CAAC,QAAU,IAAA,EAC/E,EACA,GAAI,EAAQ,OAAS,EACjB,MAAM,IAAI,EAAA,IAEN,2CAA2C,EAAQ,KAAK,IAAI,EAAE,EAClE,EAGJ,IAAM,EAAkC,CAAC,EACzC,IAAK,IAAM,KAAO,EAAM,CAEpB,IAAM,EAAY,EAAe,aAC7B,EACA,IAAA,GACA,EAAK,GACL,EACJ,EACA,GAAI,GAAyC,KACzC,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAI,yCAC1C,EAEJ,EAAO,EAAO,EAAK,CAAM,GAAK,CAClC,CACA,OAAO,CACX,CAKA,eACI,EACA,EAC+E,CAC/E,OAAO,EAAgB,eAAe,EAAM,CAAM,CACtD,CAkBA,OAAO,MACH,EACA,EACA,EACyB,CASzB,OANe,EAAe,kBAC1B,EACA,EACA,EACA,EAAY,CAAQ,CAEZ,CAChB,CAKA,MACI,EACA,EACA,EACyB,CAOzB,OANe,EAAe,kBAC1B,EACA,EACA,EACA,EAAY,CAAQ,CAEZ,CAChB,CACJ"}
1	+ {"version":3,"file":"AdvancedMethods.mjs","names":[],"sources":["../../../src/core/AdvancedMethods.ts"],"sourcesContent":["import { resolveKeyInput, templateResolver, valueConverter } from './engine';\nimport { hasFallback, isMissing } from './missing';\nimport { PrimitiveMethods } from './PrimitiveMethods';\nimport { debugWarn } from '../infra/Debug';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\nimport { recase } from '../infra/recase';\n\nimport type { ArrayOf } from '../converters';\nimport type { TemplateResolver } from '../engine/TemplateResolver';\nimport type { InferSchemaOutput, StandardSchemaV1 } from '../infra/StandardSchema';\nimport type {\n AdvancedConverterReturn,\n BuiltInConverter,\n ConditionalReturn,\n ConverterFunction,\n EnvaptConverter,\n EnvKeyInput,\n InferConverterReturnType,\n InferSpecField,\n KeyCasing,\n RecaseKey,\n RequiredSpec,\n SchemaConstraint,\n TimeFallback\n} from '../types';\n\nfunction formatKeyForError(key: EnvKeyInput): string {\n return Array.isArray(key) ? `[${key.join(', ')}]` : String(key);\n}\n\n// check after template resolution because a template can resolve to an empty string\nexport function resolveRequired(\n resolved: { key: string; value: string \| undefined },\n templateResolver: TemplateResolver\n): { key: string; value: string \| undefined } {\n if (resolved.value === undefined) return resolved;\n const value = templateResolver.resolveTemplate(resolved.key, resolved.value);\n return { key: resolved.key, value: isMissing(value) ? undefined : value };\n}\n\nexport class AdvancedMethods extends PrimitiveMethods {\n /*\n Get an environment variable using a built-in converter.\n \n Supports both scalar tokens (e.g. `Converters.Number`) and `ArrayOf<...>` tokens\n * produced by `Converters.array(...)`. The key can be a single name or an ordered list.\n * The first defined value wins.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#converters}\n * @see {@link https://envapt.materwelon.dev/docs/converters#custom-converters}\n /\n // TypeScript uses the first overload that matches. Keep 'time' above the generic one.\n static getUsing<TFallback extends TimeFallback \| undefined = undefined>(\n key: EnvKeyInput,\n converter: 'time',\n fallback?: TFallback\n ): ConditionalReturn<number, TFallback>;\n static getUsing<TConverter extends BuiltInConverter \| ArrayOf, TFallback = undefined>(\n key: EnvKeyInput,\n converter: TConverter,\n fallback?: TFallback\n ): AdvancedConverterReturn<TConverter, TFallback>;\n static getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter \| ArrayOf, fallback?: TReturn): TReturn;\n static getUsing<TConverter extends BuiltInConverter \| ArrayOf, TFallback = undefined>(\n key: EnvKeyInput,\n converter: TConverter,\n fallback?: TFallback\n ): AdvancedConverterReturn<TConverter, TFallback> {\n const { key: resolvedKey, value } = resolveKeyInput(key);\n\n // a time fallback can be a string that still needs converting to a number\n if (isMissing(value) && !hasFallback(fallback)) {\n debugWarn(`${resolvedKey} is missing or empty`);\n return undefined as AdvancedConverterReturn<TConverter, TFallback>;\n }\n\n const result = valueConverter.convertValue(resolvedKey, fallback, converter, hasFallback(fallback));\n\n return result as AdvancedConverterReturn<TConverter, TFallback>;\n }\n\n /\n @see {@link AdvancedMethods.getUsing}\n /\n getUsing<TFallback extends TimeFallback \| undefined = undefined>(\n key: EnvKeyInput,\n converter: 'time',\n fallback?: TFallback\n ): ConditionalReturn<number, TFallback>;\n getUsing<TConverter extends BuiltInConverter \| ArrayOf, TFallback = undefined>(\n key: EnvKeyInput,\n converter: TConverter,\n fallback?: TFallback\n ): AdvancedConverterReturn<TConverter, TFallback>;\n getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter \| ArrayOf, fallback?: TReturn): TReturn;\n getUsing<TConverter extends BuiltInConverter \| ArrayOf, TFallback = undefined>(\n key: EnvKeyInput,\n converter: TConverter,\n fallback?: TFallback\n ): AdvancedConverterReturn<TConverter, TFallback> {\n return AdvancedMethods.getUsing(key, converter, fallback);\n }\n\n /\n Get an environment variable using a custom converter function.\n * Accepts a single key or an ordered list for automatic fallback.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#converters}\n * @see {@link https://envapt.materwelon.dev/docs/converters#custom-converters}\n /\n static getWith<TReturnType, TFallback extends TReturnType \| undefined = undefined>(\n key: EnvKeyInput,\n converter: ConverterFunction<TReturnType>,\n fallback?: TFallback\n ): ConditionalReturn<TReturnType, TFallback> {\n // run the custom converter even on a missing value, with raw as undefined\n const result = valueConverter.convertValue<TReturnType>(key, fallback, converter, hasFallback(fallback));\n\n return result as ConditionalReturn<TReturnType, TFallback>;\n }\n\n /\n @see {@link AdvancedMethods.getWith}\n /\n getWith<TReturnType, TFallback extends TReturnType \| undefined = undefined>(\n key: EnvKeyInput,\n converter: ConverterFunction<TReturnType>,\n fallback?: TFallback\n ): ConditionalReturn<TReturnType, TFallback> {\n return AdvancedMethods.getWith(key, converter, fallback);\n }\n\n /\n Read a required environment variable and convert it, throwing `MissingEnvValue` when the value\n * is missing or empty. Returns the non-undefined converter output. Accepts a built-in or `ArrayOf`\n * token, or a custom parser function. The key can be a single name or an ordered list.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#fail-fast-on-missing-values}\n * @see {@link https://envapt.materwelon.dev/docs/converters#require-a-converted-value}\n /\n static getRequired<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n converter: TConverter\n ): InferConverterReturnType<TConverter>;\n static getRequired<TReturnType>(key: EnvKeyInput, converter: ConverterFunction<TReturnType, string>): TReturnType;\n static getRequired<TConverter extends BuiltInConverter \| ArrayOf, TReturnType>(\n key: EnvKeyInput,\n converter: TConverter \| ConverterFunction<TReturnType, string>\n ): InferConverterReturnType<TConverter> \| TReturnType {\n // an empty value falls through to the next key\n const candidates: readonly string[] = typeof key === 'string' ? [key] : key;\n let resolvedKey = '';\n let value: string \| undefined;\n for (const candidate of candidates) {\n const resolved = resolveRequired(resolveKeyInput(candidate), templateResolver);\n resolvedKey = resolved.key;\n if (resolved.value !== undefined) {\n value = resolved.value;\n break;\n }\n }\n if (value === undefined) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${formatKeyForError(key)}\" is missing or empty.`\n );\n }\n // the string-only parser is safe to widen because the value is present\n const result = valueConverter.convertValue<TReturnType>(\n resolvedKey,\n undefined,\n converter as EnvaptConverter<TReturnType>,\n false\n );\n // a built-in returns undefined when it cannot convert, and a custom converter can return null\n if (result === undefined \|\| result === null) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${formatKeyForError(key)}\" is present but could not be converted.`\n );\n }\n return result;\n }\n\n /\n @see {@link AdvancedMethods.getRequired}\n /\n getRequired<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n converter: TConverter\n ): InferConverterReturnType<TConverter>;\n getRequired<TReturnType>(key: EnvKeyInput, converter: ConverterFunction<TReturnType, string>): TReturnType;\n getRequired<TConverter extends BuiltInConverter \| ArrayOf, TReturnType>(\n key: EnvKeyInput,\n converter: TConverter \| ConverterFunction<TReturnType, string>\n ): InferConverterReturnType<TConverter> \| TReturnType {\n return AdvancedMethods.getRequired(key, converter as ConverterFunction<TReturnType, string>);\n }\n\n /\n Read a group of required environment variables in one call. Each key in `spec` maps to a\n * converter (a token, an `array()` token, or a custom parser), and the returned record holds\n * every converted value, all non-undefined. Collects every missing or empty key and throws one\n * `MissingEnvValue` listing them all. Pass a `casing` (`'camelCase'`, `'PascalCase'`, or\n * `'kebab-case'`) to rename the record keys. The rename splits each key on underscores, as in\n * SCREAMING_SNAKE env-var names. With no casing the keys stay as-is.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#fail-fast-on-missing-values}\n * @see {@link https://envapt.materwelon.dev/docs/converters#require-a-converted-value}\n /\n static getRequiredAll<Spec extends RequiredSpec, Casing extends KeyCasing \| undefined = undefined>(\n spec: Spec,\n casing?: Casing\n ): { [K in keyof Spec as RecaseKey<K & string, Casing>]: InferSpecField<Spec[K]> } {\n const keys = Object.keys(spec);\n const missing = keys.filter(\n (key) => resolveRequired(resolveKeyInput(key), templateResolver).value === undefined\n );\n if (missing.length > 0) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Missing required environment variables: ${missing.join(', ')}.`\n );\n }\n\n const result: Record<string, unknown> = {};\n for (const key of keys) {\n // safe to widen because every value is present by now\n const converted = valueConverter.convertValue<unknown>(\n key,\n undefined,\n spec[key] as EnvaptConverter<unknown>,\n false\n );\n if (converted === undefined \|\| converted === null) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${key}\" is present but could not be converted.`\n );\n }\n result[recase(key, casing)] = converted;\n }\n return result as { [K in keyof Spec as RecaseKey<K & string, Casing>]: InferSpecField<Spec[K]> };\n }\n\n /\n @see {@link AdvancedMethods.getRequiredAll}\n /\n getRequiredAll<Spec extends RequiredSpec, Casing extends KeyCasing \| undefined = undefined>(\n spec: Spec,\n casing?: Casing\n ): { [K in keyof Spec as RecaseKey<K & string, Casing>]: InferSpecField<Spec[K]> } {\n return AdvancedMethods.getRequiredAll(spec, casing);\n }\n\n /\n Validate an environment variable through a {@link StandardSchemaV1}-conformant schema\n * (zod, valibot, arktype, etc). Throws `MissingEnvValue` if the env value is absent and\n * no fallback is provided. When the value is missing, the fallback is returned as-is and does\n * not pass through the schema.\n \n Synchronous schemas only. A `validate` that returns a Promise throws `InvalidUserDefinedConfig`.\n \n @example\n * ```ts\n * import { z } from 'zod';\n * const port = Envapter.parse('PORT', z.coerce.number().min(1024).max(65535), 3000);\n * ```\n * @see {@link https://envapt.materwelon.dev/docs/standard-schema#any-conformant-validator-or-none}\n /\n static parse<Schema extends StandardSchemaV1>(\n key: EnvKeyInput,\n schema: SchemaConstraint<Schema>,\n fallback?: InferSchemaOutput<Schema>\n ): InferSchemaOutput<Schema> {\n // SchemaConstraint rejects async schemas at compile time\n const result = valueConverter.convertWithSchema(\n key,\n schema as unknown as StandardSchemaV1,\n fallback,\n hasFallback(fallback)\n );\n return result;\n }\n\n /\n @see {@link AdvancedMethods.parse}\n */\n parse<Schema extends StandardSchemaV1>(\n key: EnvKeyInput,\n schema: SchemaConstraint<Schema>,\n fallback?: InferSchemaOutput<Schema>\n ): InferSchemaOutput<Schema> {\n const result = valueConverter.convertWithSchema(\n key,\n schema as unknown as StandardSchemaV1,\n fallback,\n hasFallback(fallback)\n );\n return result;\n }\n}\n"],"mappings":"2VA0BA,SAAS,EAAkB,EAA0B,CACjD,OAAO,MAAM,QAAQ,CAAG,EAAI,IAAI,EAAI,KAAK,IAAI,EAAE,GAAK,OAAO,CAAG,CAClE,CAGA,SAAgB,EACZ,EACA,EAC0C,CAC1C,GAAI,EAAS,QAAU,IAAA,GAAW,OAAO,EACzC,IAAM,EAAQ,EAAiB,gBAAgB,EAAS,IAAK,EAAS,KAAK,EAC3E,MAAO,CAAE,IAAK,EAAS,IAAK,MAAO,EAAU,CAAK,EAAI,IAAA,GAAY,CAAM,CAC5E,CAEA,IAAa,EAAb,MAAa,UAAwB,CAAiB,CAsBlD,OAAO,SACH,EACA,EACA,EAC8C,CAC9C,GAAM,CAAE,IAAK,EAAa,SAAU,EAAgB,CAAG,EAGvD,GAAI,EAAU,CAAK,GAAK,CAAC,EAAY,CAAQ,EAAG,CAC5C,EAAU,GAAG,EAAY,qBAAqB,EAC9C,MACJ,CAIA,OAFe,EAAe,aAAa,EAAa,EAAU,EAAW,EAAY,CAAQ,CAErF,CAChB,CAgBA,SACI,EACA,EACA,EAC8C,CAC9C,OAAO,EAAgB,SAAS,EAAK,EAAW,CAAQ,CAC5D,CAQA,OAAO,QACH,EACA,EACA,EACyC,CAIzC,OAFe,EAAe,aAA0B,EAAK,EAAU,EAAW,EAAY,CAAQ,CAE1F,CAChB,CAKA,QACI,EACA,EACA,EACyC,CACzC,OAAO,EAAgB,QAAQ,EAAK,EAAW,CAAQ,CAC3D,CAcA,OAAO,YACH,EACA,EACkD,CAElD,IAAM,EAAgC,OAAO,GAAQ,SAAW,CAAC,CAAG,EAAI,EACpE,EAAc,GACd,EACJ,IAAK,IAAM,KAAa,EAAY,CAChC,IAAM,EAAW,EAAgB,EAAgB,CAAS,EAAG,CAAgB,EAE7E,GADA,EAAc,EAAS,IACnB,EAAS,QAAU,IAAA,GAAW,CAC9B,EAAQ,EAAS,MACjB,KACJ,CACJ,CACA,GAAI,IAAU,IAAA,GACV,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAkB,CAAG,EAAE,uBAC7D,EAGJ,IAAM,EAAS,EAAe,aAC1B,EACA,IAAA,GACA,EACA,EACJ,EAEA,GAAI,GAAmC,KACnC,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAkB,CAAG,EAAE,yCAC7D,EAEJ,OAAO,CACX,CAUA,YACI,EACA,EACkD,CAClD,OAAO,EAAgB,YAAY,EAAK,CAAmD,CAC/F,CAYA,OAAO,eACH,EACA,EAC+E,CAC/E,IAAM,EAAO,OAAO,KAAK,CAAI,EACvB,EAAU,EAAK,OAChB,GAAQ,EAAgB,EAAgB,CAAG,EAAG,CAAgB,CAAC,CAAC,QAAU,IAAA,EAC/E,EACA,GAAI,EAAQ,OAAS,EACjB,MAAM,IAAI,EAAA,IAEN,2CAA2C,EAAQ,KAAK,IAAI,EAAE,EAClE,EAGJ,IAAM,EAAkC,CAAC,EACzC,IAAK,IAAM,KAAO,EAAM,CAEpB,IAAM,EAAY,EAAe,aAC7B,EACA,IAAA,GACA,EAAK,GACL,EACJ,EACA,GAAI,GAAyC,KACzC,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAI,yCAC1C,EAEJ,EAAO,EAAO,EAAK,CAAM,GAAK,CAClC,CACA,OAAO,CACX,CAKA,eACI,EACA,EAC+E,CAC/E,OAAO,EAAgB,eAAe,EAAM,CAAM,CACtD,CAiBA,OAAO,MACH,EACA,EACA,EACyB,CAQzB,OANe,EAAe,kBAC1B,EACA,EACA,EACA,EAAY,CAAQ,CAEZ,CAChB,CAKA,MACI,EACA,EACA,EACyB,CAOzB,OANe,EAAe,kBAC1B,EACA,EACA,EACA,EAAY,CAAQ,CAEZ,CAChB,CACJ"}

package/dist/portable/core/EnvapterBase.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"EnvapterBase.mjs","names":[],"sources":["../../../src/core/EnvapterBase.ts"],"sourcesContent":["import { ensureLoaded, mirrorToProcessEnv, refreshCache, resolveKeyInput } from './engine';\nimport { cache, state } from './state';\nimport { Validator } from '../engine/Validators';\nimport { getDebugLevel, setDebugLevel } from '../infra/Debug';\nimport { bindRuntimeFromSource } from '../infra/runtime';\nimport { normalizeSource } from '../sources/normalizeSource';\n\nimport type { DebugLevel } from '../infra/Debug';\nimport type { EnvKeyInput, FileApiMode, Source } from '../types';\n\~~n/** @internal /\~~nexport abstract class EnvapterBase {\n /\n Enable or disable strict mode. Default `false`. Setting ~~refreshes~~ ~~the~~ ~~cache~~ so\n * ~~previously-cached converted values get re-evaluated under~~ the ~~new rule~~.\n * @see {@link https://envapt.materwelon.dev/docs/strict-mode#what-strict-mode-changes}\n /\n static set strict(value: boolean) {\n state.strict = value;\n refreshCache();\n }\n\n static get strict(): boolean {\n return state.strict;\n }\n\n /\n Set the debug log level. Defaults to `silent`. When unset, reads `ENVAPT_DEBUG` from the\n * bound source on first access. The setter overrides any env-var value. Output goes to stderr\n * on Node (the console elsewhere), prefixed with `[envapt]`.\n * @see {@link https://envapt.materwelon.dev/docs/configuration#debug-logging}\n /\n static set debug(level: DebugLevel) {\n setDebugLevel(level);\n }\n\n static get debug(): DebugLevel {\n return getDebugLevel();\n }\n\n /\n Opt-in mirror of dotenv-loaded keys back to `process.env`. Default `false`.\n \n ~~Only~~ keys the loader ~~actually~~ wrote are mirrored~~, so collision behavior follows\~~n * ~~`envFileOptions.override`:~~ ~~with~~ the default `false`, ~~pre-~~existing `process.env` values\n * ~~are preserved~~. With `true`, the file value wins in both the cache and the mirror.\n \n Flipping `false → true` mirrors the ~~existing~~ ~~tracked~~ ~~delta~~ immediately ~~(no~~ cache\n * ~~refresh).~~ Flipping `true → false` is ~~one-way:~~ ~~previously~~ ~~mirrored~~ keys ~~remain~~ in\n * `process.env` until the process exits.\n * @see {@link https://envapt.materwelon.dev/docs/configuration#mirroring-to-processenv}\n /\n static set syncProcessEnv(value: boolean) {\n Validator.validateSyncProcessEnv(value);\n const previous = state.syncProcessEnv;\n state.syncProcessEnv = value;\n if (!previous && value && cache.size > 0) mirrorToProcessEnv();\n }\n\n static get syncProcessEnv(): boolean {\n return state.syncProcessEnv;\n }\n\n /\n On the portable build, this controls the filesystem-only config APIs (`envPaths`, `baseDir`,\n * `envFileOptions`, `configureProfiles`, `resetProfiles`). `'warn'` (the default) warns once and\n * no-ops, `'throw'` throws {@link EnvaptError} `FileApiUnsupported`. The node build runs these\n * APIs normally and this value has no effect there.\n * @see {@link https://envapt.materwelon.dev/docs/compatibility#binding-by-runtime}\n /\n static set fileApiMode(mode: FileApiMode) {\n Validator.validateFileApiMode(mode);\n // ~~no refreshCache, this~~ only ~~gates~~ the portable stubs.\n state.fileApiMode = mode;\n }\n\n static get fileApiMode(): FileApiMode {\n return state.fileApiMode;\n }\n\n /\n Eagerly load the `.env` cascade now instead of lazily on the first read. Idempotent: a no-op\n * once the cache is built. Useful before mirroring to `process.env` (see {@link syncProcessEnv}),\n * which is what the `envapt/config` side-effect entry does.\n * @see {@link https://envapt.materwelon.dev/docs/configuration#which-files-load}\n /\n static load(): void {\n ensureLoaded();\n }\n\n /\n Bind the environment {@link Source}. On Node the entry binds {@link FileSource} for you\n * (a `process.env` snapshot plus the `.env` cascade). On the browser or Workers, pass a\n * `PortableSource` (or any `Source`) before reading. Pass a `(key) => string \| undefined` reader for\n * a source that reads one key at a time and cannot list its keys. Clears and rebuilds the cache.\n * @see {@link https://envapt.materwelon.dev/docs/sources#the-providers}\n /\n static useSource(source: Source \| ((key: string) => string \| undefined)): void {\n const resolved = normalizeSource(source);\n state.source = resolved;\n bindRuntimeFromSource(resolved);\n refreshCache();\n }\n\n /\n Read an environment variable as its raw string, skipping parsing and conversion.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#raw-values}\n */\n getRaw(key: EnvKeyInput): string \| undefined {\n return resolveKeyInput(key).value;\n }\n}\n"],"mappings":"~~mZAWA~~,IAAsB,EAAtB,KAAmC,~~CAM~~/B,WAAW,OAAO,EAAgB,CAC9B,EAAM,OAAS,EACf,EAAa,CACjB,CAEA,WAAW,QAAkB,CACzB,OAAO,EAAM,MACjB,CAQA,WAAW,MAAM,EAAmB,CAChC,EAAc,CAAK,CACvB,CAEA,WAAW,OAAoB,CAC3B,OAAO,EAAc,CACzB,CAcA,WAAW,eAAe,EAAgB,CACtC,EAAU,uBAAuB,CAAK,EACtC,IAAM,EAAW,EAAM,eACvB,EAAM,eAAiB,EACnB,CAAC,GAAY,GAAS,EAAM,KAAO,GAAG,EAAmB,CACjE,CAEA,WAAW,gBAA0B,CACjC,OAAO,EAAM,cACjB,CASA,WAAW,YAAY,EAAmB,CACtC,EAAU,oBAAoB,CAAI,EAElC,EAAM,YAAc,CACxB,CAEA,WAAW,aAA2B,CAClC,OAAO,EAAM,WACjB,CAQA,OAAO,MAAa,CAChB,EAAa,CACjB,CASA,OAAO,UAAU,EAA8D,CAC3E,IAAM,EAAW,EAAgB,CAAM,EACvC,EAAM,OAAS,EACf,EAAsB,CAAQ,EAC9B,EAAa,CACjB,CAMA,OAAO,EAAsC,CACzC,OAAO,EAAgB,CAAG,CAAC,CAAC,KAChC,CACJ"}
1	+ {"version":3,"file":"EnvapterBase.mjs","names":[],"sources":["../../../src/core/EnvapterBase.ts"],"sourcesContent":["import { ensureLoaded, mirrorToProcessEnv, refreshCache, resolveKeyInput } from './engine';\nimport { cache, state } from './state';\nimport { Validator } from '../engine/Validators';\nimport { getDebugLevel, setDebugLevel } from '../infra/Debug';\nimport { bindRuntimeFromSource } from '../infra/runtime';\nimport { normalizeSource } from '../sources/normalizeSource';\n\nimport type { DebugLevel } from '../infra/Debug';\nimport type { EnvKeyInput, FileApiMode, Source } from '../types';\n\nexport abstract class EnvapterBase {\n /*\n Enable or disable strict mode. Default `false`. Setting it clears and rebuilds the cache.\n * @see {@link https://envapt.materwelon.dev/docs/strict-mode#what-strict-mode-changes}\n /\n static set strict(value: boolean) {\n state.strict = value;\n refreshCache();\n }\n\n static get strict(): boolean {\n return state.strict;\n }\n\n /\n Set the debug log level. Defaults to `silent`. When unset, reads `ENVAPT_DEBUG` from the\n * bound source on first access. The setter overrides any env-var value. Output goes to stderr\n * on Node (the console elsewhere), prefixed with `[envapt]`.\n * @see {@link https://envapt.materwelon.dev/docs/configuration#debug-logging}\n /\n static set debug(level: DebugLevel) {\n setDebugLevel(level);\n }\n\n static get debug(): DebugLevel {\n return getDebugLevel();\n }\n\n /\n Opt-in mirror of dotenv-loaded keys back to `process.env`. Default `false`.\n \n `envFileOptions.override` controls collisions because only keys the loader wrote are mirrored.\n * With the default `false`, existing `process.env` values stay. With `true`, the file value\n * wins in both the cache and the mirror.\n \n Flipping `false → true` mirrors the loaded keys immediately without a cache refresh.\n * Flipping `true → false` does not remove anything. Mirrored keys stay in `process.env`\n * until the process exits.\n * @see {@link https://envapt.materwelon.dev/docs/configuration#mirroring-to-processenv}\n /\n static set syncProcessEnv(value: boolean) {\n Validator.validateSyncProcessEnv(value);\n const previous = state.syncProcessEnv;\n state.syncProcessEnv = value;\n if (!previous && value && cache.size > 0) mirrorToProcessEnv();\n }\n\n static get syncProcessEnv(): boolean {\n return state.syncProcessEnv;\n }\n\n /\n On the portable build, this controls the filesystem-only config APIs (`envPaths`, `baseDir`,\n * `envFileOptions`, `configureProfiles`, `resetProfiles`). `'warn'` (the default) warns once and\n * no-ops. `'throw'` throws {@link EnvaptError} `FileApiUnsupported`. The node build runs these\n * APIs normally and this value has no effect there.\n * @see {@link https://envapt.materwelon.dev/docs/compatibility#binding-by-runtime}\n /\n static set fileApiMode(mode: FileApiMode) {\n Validator.validateFileApiMode(mode);\n // only the portable stubs read this\n state.fileApiMode = mode;\n }\n\n static get fileApiMode(): FileApiMode {\n return state.fileApiMode;\n }\n\n /\n Eagerly load the `.env` cascade now instead of lazily on the first read. Idempotent: a no-op\n * once the cache is built. Useful before mirroring to `process.env` (see {@link syncProcessEnv}),\n * which is what the `envapt/config` side-effect entry does.\n * @see {@link https://envapt.materwelon.dev/docs/configuration#which-files-load}\n /\n static load(): void {\n ensureLoaded();\n }\n\n /\n Bind the environment {@link Source}. On Node the entry binds {@link FileSource} for you\n * (a `process.env` snapshot plus the `.env` cascade). On the browser or Workers, pass a\n * `PortableSource` (or any `Source`) before reading. Pass a `(key) => string \| undefined` reader for\n * a source that reads one key at a time and cannot list its keys. Clears and rebuilds the cache.\n * @see {@link https://envapt.materwelon.dev/docs/sources#the-providers}\n /\n static useSource(source: Source \| ((key: string) => string \| undefined)): void {\n const resolved = normalizeSource(source);\n state.source = resolved;\n bindRuntimeFromSource(resolved);\n refreshCache();\n }\n\n /\n Read an environment variable as its raw string, skipping parsing and conversion.\n * @see {@link https://envapt.materwelon.dev/docs/envapter#raw-values}\n */\n getRaw(key: EnvKeyInput): string \| undefined {\n return resolveKeyInput(key).value;\n }\n}\n"],"mappings":"mZAUA,IAAsB,EAAtB,KAAmC,CAK/B,WAAW,OAAO,EAAgB,CAC9B,EAAM,OAAS,EACf,EAAa,CACjB,CAEA,WAAW,QAAkB,CACzB,OAAO,EAAM,MACjB,CAQA,WAAW,MAAM,EAAmB,CAChC,EAAc,CAAK,CACvB,CAEA,WAAW,OAAoB,CAC3B,OAAO,EAAc,CACzB,CAcA,WAAW,eAAe,EAAgB,CACtC,EAAU,uBAAuB,CAAK,EACtC,IAAM,EAAW,EAAM,eACvB,EAAM,eAAiB,EACnB,CAAC,GAAY,GAAS,EAAM,KAAO,GAAG,EAAmB,CACjE,CAEA,WAAW,gBAA0B,CACjC,OAAO,EAAM,cACjB,CASA,WAAW,YAAY,EAAmB,CACtC,EAAU,oBAAoB,CAAI,EAElC,EAAM,YAAc,CACxB,CAEA,WAAW,aAA2B,CAClC,OAAO,EAAM,WACjB,CAQA,OAAO,MAAa,CAChB,EAAa,CACjB,CASA,OAAO,UAAU,EAA8D,CAC3E,IAAM,EAAW,EAAgB,CAAM,EACvC,EAAM,OAAS,EACf,EAAsB,CAAQ,EAC9B,EAAa,CACjB,CAMA,OAAO,EAAsC,CACzC,OAAO,EAAgB,CAAG,CAAC,CAAC,KAChC,CACJ"}

package/dist/portable/core/EnvironmentMethods.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"EnvironmentMethods.mjs","names":[],"sources":["../../../src/core/EnvironmentMethods.ts"],"sourcesContent":["import { determineEnvironment } from './engine';\nimport { EnvapterBase } from './EnvapterBase';\nimport { Environment } from './Environment';\nimport { state } from './state';\n\~~n/*\n Mixin for environment detection and checking methods\n * @internal\n /\~~nexport class EnvironmentMethods extends EnvapterBase {\n /\n Get the current application environment\n * @see {@link https://envapt.materwelon.dev/docs/environment#detecting-the-environment}\n /\n static get environment(): Environment {\n if (state.environment === undefined) {\n determineEnvironment();\n }\n return state.environment as Environment;\n }\n\n /\n Set the application environment. Accepts either Environment enum or string value.\n * @see {@link https://envapt.materwelon.dev/docs/environment#detecting-the-environment}\n /\n static set environment(env: string \| Environment) {\n determineEnvironment(env);\n }\n\n /\n @see {@link EnvironmentMethods.environment}\n /\n get environment(): Environment {\n return EnvironmentMethods.environment;\n }\n\n /\n @see {@link EnvironmentMethods.environment}\n /\n set environment(env: string \| Environment) {\n determineEnvironment(env);\n }\n\n /\n Check if the current environment is production\n * @see {@link https://envapt.materwelon.dev/docs/environment#branching-on-the-environment}\n /\n static get isProduction(): boolean {\n return this.environment === Environment.Production;\n }\n\n /\n @see {@link EnvironmentMethods.isProduction}\n /\n get isProduction(): boolean {\n return EnvironmentMethods.environment === Environment.Production;\n }\n\n /\n Check if the current environment is staging\n * @see {@link https://envapt.materwelon.dev/docs/environment#branching-on-the-environment}\n /\n static get isStaging(): boolean {\n return this.environment === Environment.Staging;\n }\n\n /\n @see {@link EnvironmentMethods.isStaging}\n /\n get isStaging(): boolean {\n return EnvironmentMethods.environment === Environment.Staging;\n }\n\n /\n Check if the current environment is development\n * @see {@link https://envapt.materwelon.dev/docs/environment#branching-on-the-environment}\n /\n static get isDevelopment(): boolean {\n return this.environment === Environment.Development;\n }\n\n /\n @see {@link EnvironmentMethods.isDevelopment}\n /\n get isDevelopment(): boolean {\n return EnvironmentMethods.environment === Environment.Development;\n }\n\n /\n Check if the current environment is test\n * @see {@link https://envapt.materwelon.dev/docs/environment#branching-on-the-environment}\n /\n static get isTest(): boolean {\n return this.environment === Environment.Test;\n }\n\n /\n @see {@link EnvironmentMethods.isTest}\n */\n get isTest(): boolean {\n return EnvironmentMethods.environment === Environment.Test;\n }\n}\n"],"mappings":"~~oKASA~~,IAAa,EAAb,MAAa,UAA2B,CAAa,CAKjD,WAAW,aAA2B,CAIlC,OAHI,EAAM,cAAgB,IAAA,IACtB,EAAqB,EAElB,EAAM,WACjB,CAMA,WAAW,YAAY,EAA2B,CAC9C,EAAqB,CAAG,CAC5B,CAKA,IAAI,aAA2B,CAC3B,OAAO,EAAmB,WAC9B,CAKA,IAAI,YAAY,EAA2B,CACvC,EAAqB,CAAG,CAC5B,CAMA,WAAW,cAAwB,CAC/B,OAAO,KAAK,cAAA,CAChB,CAKA,IAAI,cAAwB,CACxB,OAAO,EAAmB,cAAA,CAC9B,CAMA,WAAW,WAAqB,CAC5B,OAAO,KAAK,cAAA,CAChB,CAKA,IAAI,WAAqB,CACrB,OAAO,EAAmB,cAAA,CAC9B,CAMA,WAAW,eAAyB,CAChC,OAAO,KAAK,cAAA,CAChB,CAKA,IAAI,eAAyB,CACzB,OAAO,EAAmB,cAAA,CAC9B,CAMA,WAAW,QAAkB,CACzB,OAAO,KAAK,cAAA,CAChB,CAKA,IAAI,QAAkB,CAClB,OAAO,EAAmB,cAAA,CAC9B,CACJ"}
1	+ {"version":3,"file":"EnvironmentMethods.mjs","names":[],"sources":["../../../src/core/EnvironmentMethods.ts"],"sourcesContent":["import { determineEnvironment } from './engine';\nimport { EnvapterBase } from './EnvapterBase';\nimport { Environment } from './Environment';\nimport { state } from './state';\n\nexport class EnvironmentMethods extends EnvapterBase {\n /*\n Get the current application environment\n * @see {@link https://envapt.materwelon.dev/docs/environment#detecting-the-environment}\n /\n static get environment(): Environment {\n if (state.environment === undefined) {\n determineEnvironment();\n }\n return state.environment as Environment;\n }\n\n /\n Set the application environment. Accepts either Environment enum or string value.\n * @see {@link https://envapt.materwelon.dev/docs/environment#detecting-the-environment}\n /\n static set environment(env: string \| Environment) {\n determineEnvironment(env);\n }\n\n /\n @see {@link EnvironmentMethods.environment}\n /\n get environment(): Environment {\n return EnvironmentMethods.environment;\n }\n\n /\n @see {@link EnvironmentMethods.environment}\n /\n set environment(env: string \| Environment) {\n determineEnvironment(env);\n }\n\n /\n Check if the current environment is production\n * @see {@link https://envapt.materwelon.dev/docs/environment#branching-on-the-environment}\n /\n static get isProduction(): boolean {\n return this.environment === Environment.Production;\n }\n\n /\n @see {@link EnvironmentMethods.isProduction}\n /\n get isProduction(): boolean {\n return EnvironmentMethods.environment === Environment.Production;\n }\n\n /\n Check if the current environment is staging\n * @see {@link https://envapt.materwelon.dev/docs/environment#branching-on-the-environment}\n /\n static get isStaging(): boolean {\n return this.environment === Environment.Staging;\n }\n\n /\n @see {@link EnvironmentMethods.isStaging}\n /\n get isStaging(): boolean {\n return EnvironmentMethods.environment === Environment.Staging;\n }\n\n /\n Check if the current environment is development\n * @see {@link https://envapt.materwelon.dev/docs/environment#branching-on-the-environment}\n /\n static get isDevelopment(): boolean {\n return this.environment === Environment.Development;\n }\n\n /\n @see {@link EnvironmentMethods.isDevelopment}\n /\n get isDevelopment(): boolean {\n return EnvironmentMethods.environment === Environment.Development;\n }\n\n /\n Check if the current environment is test\n * @see {@link https://envapt.materwelon.dev/docs/environment#branching-on-the-environment}\n /\n static get isTest(): boolean {\n return this.environment === Environment.Test;\n }\n\n /\n @see {@link EnvironmentMethods.isTest}\n */\n get isTest(): boolean {\n return EnvironmentMethods.environment === Environment.Test;\n }\n}\n"],"mappings":"oKAKA,IAAa,EAAb,MAAa,UAA2B,CAAa,CAKjD,WAAW,aAA2B,CAIlC,OAHI,EAAM,cAAgB,IAAA,IACtB,EAAqB,EAElB,EAAM,WACjB,CAMA,WAAW,YAAY,EAA2B,CAC9C,EAAqB,CAAG,CAC5B,CAKA,IAAI,aAA2B,CAC3B,OAAO,EAAmB,WAC9B,CAKA,IAAI,YAAY,EAA2B,CACvC,EAAqB,CAAG,CAC5B,CAMA,WAAW,cAAwB,CAC/B,OAAO,KAAK,cAAA,CAChB,CAKA,IAAI,cAAwB,CACxB,OAAO,EAAmB,cAAA,CAC9B,CAMA,WAAW,WAAqB,CAC5B,OAAO,KAAK,cAAA,CAChB,CAKA,IAAI,WAAqB,CACrB,OAAO,EAAmB,cAAA,CAC9B,CAMA,WAAW,eAAyB,CAChC,OAAO,KAAK,cAAA,CAChB,CAKA,IAAI,eAAyB,CACzB,OAAO,EAAmB,cAAA,CAC9B,CAMA,WAAW,QAAkB,CACzB,OAAO,KAAK,cAAA,CAChB,CAKA,IAAI,QAAkB,CAClB,OAAO,EAAmB,cAAA,CAC9B,CACJ"}

package/dist/portable/core/PrimitiveMethods.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"PrimitiveMethods.mjs","names":[],"sources":["../../../src/core/PrimitiveMethods.ts"],"sourcesContent":["import { Primitive, readPrimitive } from './engine';\nimport { EnvironmentMethods } from './EnvironmentMethods';\n\nimport type { ConditionalReturn, EnvKeyInput } from '../types';\n\~~n/*\n @internal\n /\~~nexport class PrimitiveMethods extends EnvironmentMethods {\n /\n Get a string environment variable with optional fallback.\n * Supports template variable resolution using `${VAR}` syntax.\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static get<Default extends string \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<string, Default> {\n return readPrimitive(key, Primitive.String, def);\n }\n\n /\n @see {@link PrimitiveMethods.get}\n /\n get<Default extends string \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<string, Default> {\n return readPrimitive(key, Primitive.String, def);\n }\n\n /\n Get a number environment variable with optional fallback.\n * Automatically converts string values to numbers.\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static getNumber<Default extends number \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<number, Default> {\n return readPrimitive(key, Primitive.Number, def);\n }\n\n /\n @see {@link PrimitiveMethods.getNumber}\n /\n getNumber<Default extends number \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<number, Default> {\n return readPrimitive(key, Primitive.Number, def);\n }\n\n /\n Get a boolean environment variable with optional fallback.\n * Recognizes: `1`, `yes`, `true`, `on` as true; `0`, `no`, `false`, `off` as false (case-insensitive).\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static getBoolean<Default extends boolean \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<boolean, Default> {\n return readPrimitive(key, Primitive.Boolean, def);\n }\n\n /\n @see {@link PrimitiveMethods.getBoolean}\n /\n getBoolean<Default extends boolean \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<boolean, Default> {\n return readPrimitive(key, Primitive.Boolean, def);\n }\n\n /\n Get a bigint environment variable with optional fallback.\n * Automatically converts string values to bigint.\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static getBigInt<Default extends bigint \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<bigint, Default> {\n return readPrimitive(key, Primitive.BigInt, def);\n }\n\n /\n @see {@link PrimitiveMethods.getBigInt}\n /\n getBigInt<Default extends bigint \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<bigint, Default> {\n return readPrimitive(key, Primitive.BigInt, def);\n }\n\n /\n Get a symbol environment variable with optional fallback.\n * Creates a symbol from the string value.\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static getSymbol<Default extends symbol \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<symbol, Default> {\n return readPrimitive(key, Primitive.Symbol, def);\n }\n\n /\n @see {@link PrimitiveMethods.getSymbol}\n */\n getSymbol<Default extends symbol \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<symbol, Default> {\n return readPrimitive(key, Primitive.Symbol, def);\n }\n}\n"],"mappings":"~~2GAQA~~,IAAa,EAAb,cAAsC,CAAmB,CAOrD,OAAO,IACH,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAKA,IACI,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAQA,OAAO,UACH,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAKA,UACI,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAQA,OAAO,WACH,EACA,EACmC,CACnC,OAAO,EAAc,EAAA,EAAwB,CAAG,CACpD,CAKA,WACI,EACA,EACmC,CACnC,OAAO,EAAc,EAAA,EAAwB,CAAG,CACpD,CAQA,OAAO,UACH,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAKA,UACI,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAQA,OAAO,UACH,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAKA,UACI,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CACJ"}
1	+ {"version":3,"file":"PrimitiveMethods.mjs","names":[],"sources":["../../../src/core/PrimitiveMethods.ts"],"sourcesContent":["import { Primitive, readPrimitive } from './engine';\nimport { EnvironmentMethods } from './EnvironmentMethods';\n\nimport type { ConditionalReturn, EnvKeyInput } from '../types';\n\nexport class PrimitiveMethods extends EnvironmentMethods {\n /*\n Get a string environment variable with optional fallback.\n * Supports template variable resolution using `${VAR}` syntax.\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static get<Default extends string \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<string, Default> {\n return readPrimitive(key, Primitive.String, def);\n }\n\n /\n @see {@link PrimitiveMethods.get}\n /\n get<Default extends string \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<string, Default> {\n return readPrimitive(key, Primitive.String, def);\n }\n\n /\n Get a number environment variable with optional fallback.\n * Automatically converts string values to numbers.\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static getNumber<Default extends number \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<number, Default> {\n return readPrimitive(key, Primitive.Number, def);\n }\n\n /\n @see {@link PrimitiveMethods.getNumber}\n /\n getNumber<Default extends number \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<number, Default> {\n return readPrimitive(key, Primitive.Number, def);\n }\n\n /\n Get a boolean environment variable with optional fallback.\n * Recognizes: `1`, `yes`, `true`, `on` as true; `0`, `no`, `false`, `off` as false (case-insensitive).\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static getBoolean<Default extends boolean \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<boolean, Default> {\n return readPrimitive(key, Primitive.Boolean, def);\n }\n\n /\n @see {@link PrimitiveMethods.getBoolean}\n /\n getBoolean<Default extends boolean \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<boolean, Default> {\n return readPrimitive(key, Primitive.Boolean, def);\n }\n\n /\n Get a bigint environment variable with optional fallback.\n * Automatically converts string values to bigint.\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static getBigInt<Default extends bigint \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<bigint, Default> {\n return readPrimitive(key, Primitive.BigInt, def);\n }\n\n /\n @see {@link PrimitiveMethods.getBigInt}\n /\n getBigInt<Default extends bigint \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<bigint, Default> {\n return readPrimitive(key, Primitive.BigInt, def);\n }\n\n /\n Get a symbol environment variable with optional fallback.\n * Creates a symbol from the string value.\n * Accepts a single key or an ordered array of keys (first match wins).\n * @see {@link https://envapt.materwelon.dev/docs/envapter#primitives}\n /\n static getSymbol<Default extends symbol \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<symbol, Default> {\n return readPrimitive(key, Primitive.Symbol, def);\n }\n\n /\n @see {@link PrimitiveMethods.getSymbol}\n */\n getSymbol<Default extends symbol \| undefined = undefined>(\n key: EnvKeyInput,\n def?: Default\n ): ConditionalReturn<symbol, Default> {\n return readPrimitive(key, Primitive.Symbol, def);\n }\n}\n"],"mappings":"2GAKA,IAAa,EAAb,cAAsC,CAAmB,CAOrD,OAAO,IACH,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAKA,IACI,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAQA,OAAO,UACH,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAKA,UACI,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAQA,OAAO,WACH,EACA,EACmC,CACnC,OAAO,EAAc,EAAA,EAAwB,CAAG,CACpD,CAKA,WACI,EACA,EACmC,CACnC,OAAO,EAAc,EAAA,EAAwB,CAAG,CACpD,CAQA,OAAO,UACH,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAKA,UACI,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAQA,OAAO,UACH,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CAKA,UACI,EACA,EACkC,CAClC,OAAO,EAAc,EAAA,EAAuB,CAAG,CACnD,CACJ"}

package/dist/portable/core/engine.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"engine.mjs","names":[],"sources":["../../../src/core/engine.ts"],"sourcesContent":["import { BuiltInConverters, ValueConverter } from '../converters';\nimport { ENV_KEYS, Environment, firstEnvKeyValue, parseEnvironment } from './Environment';\nimport { isMissing } from './missing';\nimport { resolveEffectivePaths } from './paths';\nimport { cache, state } from './state';\nimport { TemplateResolver } from '../engine/TemplateResolver';\nimport { debugVerbose, debugWarn } from '../infra/Debug';\nimport { loadDotenv } from '../infra/Dotenv';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { ConditionalReturn, EnvKeyInput } from '../types';\nimport type { EnvapterService } from '../types/Env';\n\nexport function resolveKeyInput(keyInput: EnvKeyInput): { key: string; value: string \| undefined } {\n const keys = Array.isArray(keyInput) ? keyInput : [keyInput];\n const normalizedKeys = keys as readonly string[];\n\n if (normalizedKeys.length === 0) {\n throw new EnvaptError(EnvaptErrorCodes.InvalidKeyInput, 'At least one environment key must be provided.');\n }\n\n if (normalizedKeys.some((k) => typeof k !== 'string')) {\n throw new EnvaptError(EnvaptErrorCodes.InvalidKeyInput, 'Environment keys must be strings.');\n }\n\n if (normalizedKeys.some((k) => k.trim() === '')) {\n throw new EnvaptError(EnvaptErrorCodes.InvalidKeyInput, 'Environment keys cannot be empty strings.');\n }\n\n // An ordered read keeps trying so a present-but-empty candidate falls through to the next, matching\n // getRequired and firstEnvKeyValue. A single key or an all-empty list resolves to the first present value.\n let firstPresent: { key: string; value: string } \| undefined;\n for (const candidate of normalizedKeys) {\n const value = readCached(candidate);\n if (value === undefined) continue;\n if (!isMissing(value)) return { key: candidate, value };\n firstPresent ??= { key: candidate, value };\n }\n\n return firstPresent ?? { key: normalizedKeys[0] as string, value: undefined };\n}\n\nexport function ensureLoaded(): Map<string, unknown> {\n if (!state.cacheBuilt) {\n const source = state.source;\n // Clone so the loader and downstream reads never mutate the source's backing object.\n const isolatedEnv: Record<string, string> = { ...source.readVars() };\n\n let added = new Set<string>();\n // Sources without a filesystem (injected objects on the browser or Workers) skip the .env\n // cascade, profiles, and envPaths. Only the readVars() snapshot populates the cache.\n if (source.supportsFiles) {\n debugVerbose(`base dir: ${state.baseDir ?? 'working directory'}`);\n // Outside the try below so a missing configured profile path surfaces its EnvaptError. Only dotenv parse errors stay caught.\n const effectivePaths = resolveEffectivePaths();\n debugVerbose(`effective .env paths: ${effectivePaths.length === 0 ? '(none)' : effectivePaths.join(', ')}`);\n try {\n added = loadDotenv({\n ...state.userDefinedEnvFileOptions,\n path: effectivePaths,\n processEnv: isolatedEnv,\n readFile: source.readFile.bind(source)\n });\n } catch (error) {\n debugWarn(`failed to load .env: ${error instanceof Error ? error.message : String(error)}`);\n }\n }\n state.dotenvAddedKeys = added;\n for (const [key, value] of Object.entries(isolatedEnv)) cache.set(key, value);\n debugVerbose(`cache populated: ${cache.size} keys total`);\n // set before mirroring, whose template expansion reads the cache and would re-enter this build otherwise\n state.cacheBuilt = true;\n if (state.syncProcessEnv) mirrorToProcessEnv();\n }\n\n return cache;\n}\n\nfunction readCached(key: string): string \| undefined {\n const c = ensureLoaded();\n // decorator memoization also stores non-string values in this shared cache\n if (c.has(key)) {\n const cached = c.get(key);\n return typeof cached === 'string' ? cached : undefined;\n }\n const source = state.source;\n if (typeof source.readVar !== 'function') return undefined;\n const value = source.readVar(key);\n // cache a miss too, so a later read of an absent key skips the reader\n c.set(key, value);\n return value;\n}\n\nexport function refreshCache(): void {\n // Reset an inferred environment so re-hydration re-determines it from current state. An explicit\n // Envapter.environment = X is preserved through the refresh and used for cascade selection.\n if (!state.environmentExplicitlySet) state.environment = undefined;\n cache.clear();\n state.cacheBuilt = false;\n state.dotenvAddedKeys = new Set<string>();\n debugVerbose('cache cleared, reloading config');\n ensureLoaded();\n}\n\nexport function mirrorToProcessEnv(): void {\n if (state.dotenvAddedKeys.size === 0) return;\n const source = state.source;\n /* v8 ignore next -- @preserve dotenv keys only accumulate under a file source, so the delta implies supportsFiles here /\n if (!source.supportsFiles) return;\n const mirrored: Record<string, string> = {};\n for (const key of state.dotenvAddedKeys) {\n const value = cache.get(key);\n / v8 ignore next -- @preserve loader only writes strings, defensive against future cache contents /\n if (typeof value !== 'string') continue;\n mirrored[key] = resolveForMirror(key, value);\n debugVerbose(`mirrored ${key} to the ambient environment`);\n }\n source.writeVars(mirrored);\n debugVerbose(`mirrored ${state.dotenvAddedKeys.size} keys to the ambient environment`);\n}\n\nfunction resolveForMirror(key: string, value: string): string {\n return templateResolver.resolveTemplate(key, value);\n}\n\nexport function determineEnvironment(env?: string \| Environment): void {\n if (typeof env === 'number') {\n state.environment = env;\n state.environmentExplicitlySet = true;\n return;\n }\n if (typeof env === 'string') {\n state.environment = parseEnvironment(env) ?? Environment.Development;\n state.environmentExplicitlySet = true;\n return;\n }\n\n const raw = firstEnvKeyValue((key) => readCached(key));\n if (raw === undefined) {\n debugWarn(`no environment set (looked for ${ENV_KEYS.join(', ')}); defaulting to development`);\n state.environment = Environment.Development;\n return;\n }\n const parsed = parseEnvironment(raw);\n if (parsed === undefined) {\n debugWarn(`unrecognized environment \"${raw}\"; defaulting to development`);\n state.environment = Environment.Development;\n return;\n }\n state.environment = parsed;\n}\n\n/\n @internal\n */\nexport enum Primitive {\n String,\n Number,\n Boolean,\n BigInt,\n Symbol\n}\n\nconst PRIMITIVE_NAMES: Record<Primitive, string> = {\n [Primitive.String]: 'string',\n [Primitive.Number]: 'number',\n [Primitive.Boolean]: 'boolean',\n [Primitive.BigInt]: 'bigint',\n [Primitive.Symbol]: 'symbol'\n};\n\n// getRaw is the raw string lookup, get is the template-resolved string read. Lazy arrows so the\n// resolver singletons below store envService without calling readPrimitive, which reads\n// templateResolver before it is assigned.\nconst envService: EnvapterService = {\n getRaw: (key) => resolveKeyInput(key).value,\n get: (key, def) => readPrimitive<string, string \| undefined>(key, Primitive.String, def)\n};\n\nexport const templateResolver: TemplateResolver = new TemplateResolver(envService);\nexport const valueConverter: ValueConverter = new ValueConverter(envService);\n\nexport function readPrimitive<EnvVarReturnType, DefaultType extends EnvVarReturnType \| undefined = undefined>(\n key: EnvKeyInput,\n type: Primitive,\n def?: DefaultType\n): ConditionalReturn<EnvVarReturnType, DefaultType> {\n const { key: resolvedKey, value } = resolveKeyInput(key);\n if (isMissing(value)) {\n if (def !== undefined) debugWarn(`${resolvedKey} is missing or empty, using fallback ${String(def)}`);\n else debugWarn(`${resolvedKey} is missing or empty`);\n return def as ConditionalReturn<EnvVarReturnType, DefaultType>;\n }\n\n const parsed = templateResolver.resolveTemplate(resolvedKey, String(value));\n\n let converted: EnvVarReturnType \| undefined;\n if (type === Primitive.Number) converted = BuiltInConverters.number(parsed) as EnvVarReturnType \| undefined;\n else if (type === Primitive.Boolean) converted = BuiltInConverters.boolean(parsed) as EnvVarReturnType \| undefined;\n else if (type === Primitive.BigInt) converted = BuiltInConverters.bigint(parsed) as EnvVarReturnType \| undefined;\n else if (type === Primitive.Symbol) converted = BuiltInConverters.symbol(parsed) as EnvVarReturnType \| undefined;\n else converted = BuiltInConverters.string(parsed) as EnvVarReturnType \| undefined;\n\n if (converted === undefined) {\n // key and type only, no value: env values can be secrets and verbose logs reach stderr\n debugVerbose(\n `could not convert ${resolvedKey} as ${PRIMITIVE_NAMES[type]}${def !== undefined ? ', using the fallback' : ''}`\n );\n return def as ConditionalReturn<EnvVarReturnType, DefaultType>;\n }\n\n return converted;\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"engine.mjs","names":[],"sources":["../../../src/core/engine.ts"],"sourcesContent":["import { BuiltInConverters, ValueConverter } from '../converters';\nimport { ENV_KEYS, Environment, firstEnvKeyValue, parseEnvironment } from './Environment';\nimport { isMissing } from './missing';\nimport { resolveEffectivePaths } from './paths';\nimport { cache, state } from './state';\nimport { TemplateResolver } from '../engine/TemplateResolver';\nimport { debugVerbose, debugWarn } from '../infra/Debug';\nimport { loadDotenv } from '../infra/Dotenv';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { ConditionalReturn, EnvKeyInput } from '../types';\nimport type { EnvapterService } from '../types/Env';\n\nexport function resolveKeyInput(keyInput: EnvKeyInput): { key: string; value: string \| undefined } {\n const keys = Array.isArray(keyInput) ? keyInput : [keyInput];\n const normalizedKeys = keys as readonly string[];\n\n if (normalizedKeys.length === 0) {\n throw new EnvaptError(EnvaptErrorCodes.InvalidKeyInput, 'At least one environment key must be provided.');\n }\n\n if (normalizedKeys.some((k) => typeof k !== 'string')) {\n throw new EnvaptError(EnvaptErrorCodes.InvalidKeyInput, 'Environment keys must be strings.');\n }\n\n if (normalizedKeys.some((k) => k.trim() === '')) {\n throw new EnvaptError(EnvaptErrorCodes.InvalidKeyInput, 'Environment keys cannot be empty strings.');\n }\n\n // an empty value falls through to the next key and only comes back when every key is empty\n let firstPresent: { key: string; value: string } \| undefined;\n for (const candidate of normalizedKeys) {\n const value = readCached(candidate);\n if (value === undefined) continue;\n if (!isMissing(value)) return { key: candidate, value };\n firstPresent ??= { key: candidate, value };\n }\n\n return firstPresent ?? { key: normalizedKeys[0] as string, value: undefined };\n}\n\nexport function ensureLoaded(): Map<string, unknown> {\n if (!state.cacheBuilt) {\n const source = state.source;\n // the loader writes into this object\n const isolatedEnv: Record<string, string> = { ...source.readVars() };\n\n let added = new Set<string>();\n if (source.supportsFiles) {\n debugVerbose(`base dir: ${state.baseDir ?? 'working directory'}`);\n // outside the try because a missing profile path has to throw\n const effectivePaths = resolveEffectivePaths();\n debugVerbose(`effective .env paths: ${effectivePaths.length === 0 ? '(none)' : effectivePaths.join(', ')}`);\n try {\n added = loadDotenv({\n ...state.userDefinedEnvFileOptions,\n path: effectivePaths,\n processEnv: isolatedEnv,\n readFile: source.readFile.bind(source)\n });\n } catch (error) {\n debugWarn(`failed to load .env: ${error instanceof Error ? error.message : String(error)}`);\n }\n }\n state.dotenvAddedKeys = added;\n for (const [key, value] of Object.entries(isolatedEnv)) cache.set(key, value);\n debugVerbose(`cache populated: ${cache.size} keys total`);\n // set before mirroring because template expansion reads the cache\n state.cacheBuilt = true;\n if (state.syncProcessEnv) mirrorToProcessEnv();\n }\n\n return cache;\n}\n\nfunction readCached(key: string): string \| undefined {\n const c = ensureLoaded();\n // decorator memoization also stores non-string values in this shared cache\n if (c.has(key)) {\n const cached = c.get(key);\n return typeof cached === 'string' ? cached : undefined;\n }\n const source = state.source;\n if (typeof source.readVar !== 'function') return undefined;\n const value = source.readVar(key);\n // caches misses too\n c.set(key, value);\n return value;\n}\n\nexport function refreshCache(): void {\n // an inferred environment can change once the new vars load\n if (!state.environmentExplicitlySet) state.environment = undefined;\n cache.clear();\n state.cacheBuilt = false;\n state.dotenvAddedKeys = new Set<string>();\n debugVerbose('cache cleared, reloading config');\n ensureLoaded();\n}\n\nexport function mirrorToProcessEnv(): void {\n if (state.dotenvAddedKeys.size === 0) return;\n const source = state.source;\n /* v8 ignore next -- @preserve dotenv keys only accumulate under a file source, so the delta implies supportsFiles here /\n if (!source.supportsFiles) return;\n const mirrored: Record<string, string> = {};\n for (const key of state.dotenvAddedKeys) {\n const value = cache.get(key);\n / v8 ignore next -- @preserve the loader only writes strings */\n if (typeof value !== 'string') continue;\n mirrored[key] = resolveForMirror(key, value);\n debugVerbose(`mirrored ${key} to the ambient environment`);\n }\n source.writeVars(mirrored);\n debugVerbose(`mirrored ${state.dotenvAddedKeys.size} keys to the ambient environment`);\n}\n\nfunction resolveForMirror(key: string, value: string): string {\n return templateResolver.resolveTemplate(key, value);\n}\n\nexport function determineEnvironment(env?: string \| Environment): void {\n if (typeof env === 'number') {\n state.environment = env;\n state.environmentExplicitlySet = true;\n return;\n }\n if (typeof env === 'string') {\n state.environment = parseEnvironment(env) ?? Environment.Development;\n state.environmentExplicitlySet = true;\n return;\n }\n\n const raw = firstEnvKeyValue((key) => readCached(key));\n if (raw === undefined) {\n debugWarn(`no environment set (looked for ${ENV_KEYS.join(', ')}); defaulting to development`);\n state.environment = Environment.Development;\n return;\n }\n const parsed = parseEnvironment(raw);\n if (parsed === undefined) {\n debugWarn(`unrecognized environment \"${raw}\"; defaulting to development`);\n state.environment = Environment.Development;\n return;\n }\n state.environment = parsed;\n}\n\nexport enum Primitive {\n String,\n Number,\n Boolean,\n BigInt,\n Symbol\n}\n\nconst PRIMITIVE_NAMES: Record<Primitive, string> = {\n [Primitive.String]: 'string',\n [Primitive.Number]: 'number',\n [Primitive.Boolean]: 'boolean',\n [Primitive.BigInt]: 'bigint',\n [Primitive.Symbol]: 'symbol'\n};\n\n// arrows because readPrimitive reads templateResolver, which is assigned below\nconst envService: EnvapterService = {\n getRaw: (key) => resolveKeyInput(key).value,\n get: (key, def) => readPrimitive<string, string \| undefined>(key, Primitive.String, def)\n};\n\nexport const templateResolver: TemplateResolver = new TemplateResolver(envService);\nexport const valueConverter: ValueConverter = new ValueConverter(envService);\n\nexport function readPrimitive<EnvVarReturnType, DefaultType extends EnvVarReturnType \| undefined = undefined>(\n key: EnvKeyInput,\n type: Primitive,\n def?: DefaultType\n): ConditionalReturn<EnvVarReturnType, DefaultType> {\n const { key: resolvedKey, value } = resolveKeyInput(key);\n if (isMissing(value)) {\n if (def !== undefined) debugWarn(`${resolvedKey} is missing or empty, using fallback ${String(def)}`);\n else debugWarn(`${resolvedKey} is missing or empty`);\n return def as ConditionalReturn<EnvVarReturnType, DefaultType>;\n }\n\n const parsed = templateResolver.resolveTemplate(resolvedKey, String(value));\n\n let converted: EnvVarReturnType \| undefined;\n if (type === Primitive.Number) converted = BuiltInConverters.number(parsed) as EnvVarReturnType \| undefined;\n else if (type === Primitive.Boolean) converted = BuiltInConverters.boolean(parsed) as EnvVarReturnType \| undefined;\n else if (type === Primitive.BigInt) converted = BuiltInConverters.bigint(parsed) as EnvVarReturnType \| undefined;\n else if (type === Primitive.Symbol) converted = BuiltInConverters.symbol(parsed) as EnvVarReturnType \| undefined;\n else converted = BuiltInConverters.string(parsed) as EnvVarReturnType \| undefined;\n\n if (converted === undefined) {\n // leave the value out because env values can be secrets\n debugVerbose(\n `could not convert ${resolvedKey} as ${PRIMITIVE_NAMES[type]}${def !== undefined ? ', using the fallback' : ''}`\n );\n return def as ConditionalReturn<EnvVarReturnType, DefaultType>;\n }\n\n return converted;\n}\n"],"mappings":"qlBAaA,SAAgB,EAAgB,EAAmE,CAE/F,IAAM,EADO,MAAM,QAAQ,CAAQ,EAAI,EAAW,CAAC,CAAQ,EAG3D,GAAI,EAAe,SAAW,EAC1B,MAAM,IAAI,EAAA,IAA8C,gDAAgD,EAG5G,GAAI,EAAe,KAAM,GAAM,OAAO,GAAM,QAAQ,EAChD,MAAM,IAAI,EAAA,IAA8C,mCAAmC,EAG/F,GAAI,EAAe,KAAM,GAAM,EAAE,KAAK,IAAM,EAAE,EAC1C,MAAM,IAAI,EAAA,IAA8C,2CAA2C,EAIvG,IAAI,EACJ,IAAK,IAAM,KAAa,EAAgB,CACpC,IAAM,EAAQ,EAAW,CAAS,EAC9B,OAAU,IAAA,GACd,IAAI,CAAC,EAAU,CAAK,EAAG,MAAO,CAAE,IAAK,EAAW,OAAM,EACtD,IAAiB,CAAE,IAAK,EAAW,OAAM,CADa,CAE1D,CAEA,OAAO,GAAgB,CAAE,IAAK,EAAe,GAAc,MAAO,IAAA,EAAU,CAChF,CAEA,SAAgB,GAAqC,CACjD,GAAI,CAAC,EAAM,WAAY,CACnB,IAAM,EAAS,EAAM,OAEf,EAAsC,CAAE,GAAG,EAAO,SAAS,CAAE,EAE/D,EAAQ,IAAI,IAChB,GAAI,EAAO,cAAe,CACtB,EAAa,aAAa,EAAM,SAAW,qBAAqB,EAEhE,IAAM,EAAiB,EAAsB,EAC7C,EAAa,yBAAyB,EAAe,SAAW,EAAI,SAAW,EAAe,KAAK,IAAI,GAAG,EAC1G,GAAI,CACA,EAAQ,EAAW,CACf,GAAG,EAAM,0BACT,KAAM,EACN,WAAY,EACZ,SAAU,EAAO,SAAS,KAAK,CAAM,CACzC,CAAC,CACL,OAAS,EAAO,CACZ,EAAU,wBAAwB,aAAiB,MAAQ,EAAM,QAAU,OAAO,CAAK,GAAG,CAC9F,CACJ,CACA,EAAM,gBAAkB,EACxB,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAW,EAAG,EAAM,IAAI,EAAK,CAAK,EAC5E,EAAa,oBAAoB,EAAM,KAAK,YAAY,EAExD,EAAM,WAAa,GACf,EAAM,gBAAgB,EAAmB,CACjD,CAEA,OAAO,CACX,CAEA,SAAS,EAAW,EAAiC,CACjD,IAAM,EAAI,EAAa,EAEvB,GAAI,EAAE,IAAI,CAAG,EAAG,CACZ,IAAM,EAAS,EAAE,IAAI,CAAG,EACxB,OAAO,OAAO,GAAW,SAAW,EAAS,IAAA,EACjD,CACA,IAAM,EAAS,EAAM,OACrB,GAAI,OAAO,EAAO,SAAY,WAAY,OAC1C,IAAM,EAAQ,EAAO,QAAQ,CAAG,EAGhC,OADA,EAAE,IAAI,EAAK,CAAK,EACT,CACX,CAEA,SAAgB,GAAqB,CAE5B,EAAM,2BAA0B,EAAM,YAAc,IAAA,IACzD,EAAM,MAAM,EACZ,EAAM,WAAa,GACnB,EAAM,gBAAkB,IAAI,IAC5B,EAAa,iCAAiC,EAC9C,EAAa,CACjB,CAEA,SAAgB,GAA2B,CACvC,GAAI,EAAM,gBAAgB,OAAS,EAAG,OACtC,IAAM,EAAS,EAAM,OAErB,GAAI,CAAC,EAAO,cAAe,OAC3B,IAAM,EAAmC,CAAC,EAC1C,IAAK,IAAM,KAAO,EAAM,gBAAiB,CACrC,IAAM,EAAQ,EAAM,IAAI,CAAG,EAEvB,OAAO,GAAU,WACrB,EAAS,GAAO,EAAiB,EAAK,CAAK,EAC3C,EAAa,YAAY,EAAI,4BAA4B,EAC7D,CACA,EAAO,UAAU,CAAQ,EACzB,EAAa,YAAY,EAAM,gBAAgB,KAAK,iCAAiC,CACzF,CAEA,SAAS,EAAiB,EAAa,EAAuB,CAC1D,OAAO,EAAiB,gBAAgB,EAAK,CAAK,CACtD,CAEA,SAAgB,EAAqB,EAAkC,CACnE,GAAI,OAAO,GAAQ,SAAU,CACzB,EAAM,YAAc,EACpB,EAAM,yBAA2B,GACjC,MACJ,CACA,GAAI,OAAO,GAAQ,SAAU,CACzB,EAAM,YAAc,EAAiB,CAAG,GAAA,EACxC,EAAM,yBAA2B,GACjC,MACJ,CAEA,IAAM,EAAM,EAAkB,GAAQ,EAAW,CAAG,CAAC,EACrD,GAAI,IAAQ,IAAA,GAAW,CACnB,EAAU,kCAAkC,EAAS,KAAK,IAAI,EAAE,6BAA6B,EAC7F,EAAM,YAAA,EACN,MACJ,CACA,IAAM,EAAS,EAAiB,CAAG,EACnC,GAAI,IAAW,IAAA,GAAW,CACtB,EAAU,6BAA6B,EAAI,6BAA6B,EACxE,EAAM,YAAA,EACN,MACJ,CACA,EAAM,YAAc,CACxB,CAUA,MAAM,EAA6C,CAC3B,EAAA,SACA,EAAA,SACC,EAAA,UACD,EAAA,SACA,EAAA,QACxB,EAGM,EAA8B,CAChC,OAAS,GAAQ,EAAgB,CAAG,CAAC,CAAC,MACtC,KAAM,EAAK,IAAQ,EAA0C,EAAA,EAAuB,CAAG,CAC3F,EAEa,EAAqC,IAAI,EAAiB,CAAU,EACpE,EAAiC,IAAI,EAAe,CAAU,EAE3E,SAAgB,EACZ,EACA,EACA,EACgD,CAChD,GAAM,CAAE,IAAK,EAAa,SAAU,EAAgB,CAAG,EACvD,GAAI,EAAU,CAAK,EAGf,OADK,EADD,IAAQ,IAAA,GACG,GAAG,EAAY,sBADG,GAAG,EAAY,uCAAuC,OAAO,CAAG,GAC9C,EAC5C,EAGX,IAAM,EAAS,EAAiB,gBAAgB,EAAa,OAAO,CAAK,CAAC,EAEtE,EAeJ,MAdA,CAIK,EAJD,IAAA,EAAuC,EAAkB,OAAO,CAAM,EACjE,IAAA,EAAwC,EAAkB,QAAQ,CAAM,EACxE,IAAA,EAAuC,EAAkB,OAAO,CAAM,EACtE,IAAA,EAAuC,EAAkB,OAAO,CAAM,EAC9D,EAAkB,OAAO,CAAM,EAE5C,IAAc,IAAA,IAEd,EACI,qBAAqB,EAAY,MAAM,EAAgB,KAAQ,IAAQ,IAAA,GAAqC,GAAzB,wBACvF,EACO,GAGJ,CACX"}

package/dist/portable/core/missing.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"missing.mjs","names":[],"sources":["../../../src/core/missing.ts"],"sourcesContent":["import { state } from './state';\n\n// ~~the~~ ~~one~~ missing-check, ~~use~~ it ~~everywhere so behavior stays consistent~~\nexport function isMissing(value: string \| undefined): boolean {\n if (value === undefined \|\| value === '') return true;\n if (state.strict && value.trim() === '') return true;\n return false;\n}\n\~~n// an explicit undefined fallback counts as no fallback, use it everywhere so behavior stays consistent\~~nexport function hasFallback(fallback: unknown): boolean {\n return fallback !== undefined;\n}\n"],"mappings":"oCAGA,SAAgB,EAAU,EAAoC,CAG1D,MADA,GADI,IAAU,IAAA,IAAa,IAAU,IACjC,EAAM,QAAU,EAAM,KAAK,IAAM,GAEzC,~~CAGA~~,SAAgB,EAAY,EAA4B,CACpD,OAAO,IAAa,IAAA,EACxB"}
1	+ {"version":3,"file":"missing.mjs","names":[],"sources":["../../../src/core/missing.ts"],"sourcesContent":["import { state } from './state';\n\n// every missing-value check goes through this\nexport function isMissing(value: string \| undefined): boolean {\n if (value === undefined \|\| value === '') return true;\n if (state.strict && value.trim() === '') return true;\n return false;\n}\n\nexport function hasFallback(fallback: unknown): boolean {\n return fallback !== undefined;\n}\n"],"mappings":"oCAGA,SAAgB,EAAU,EAAoC,CAG1D,MADA,GADI,IAAU,IAAA,IAAa,IAAU,IACjC,EAAM,QAAU,EAAM,KAAK,IAAM,GAEzC,CAEA,SAAgB,EAAY,EAA4B,CACpD,OAAO,IAAa,IAAA,EACxB"}

package/dist/portable/core/paths.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"paths.mjs","names":[],"sources":["../../../src/core/paths.ts"],"sourcesContent":["import { Environment, firstEnvKeyValue, parseEnvironment } from './Environment';\nimport { state } from './state';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { EnvProfile, FileCapableSource, Source } from '../types';\n\n// No baseDir: ~~candidate returned unchanged so~~ the source resolves it against its own default~~\n//~~ (process.cwd() on Node~~). Resolution goes through the source to keep this node-free.\~~nexport function resolveAgainstBase(candidate: string): string {\n const baseDir = state.baseDir;\n if (baseDir === undefined) return candidate;\n const source = state.source;\n /* v8 ignore next -- @preserve callers are all file-gated, so the source is never bare here /\n if (!source.supportsFiles) return candidate;\n return source.resolvePath(baseDir, candidate);\n}\n\n// File-based config (envPaths/baseDir/configureProfiles) is meaningless without a filesystem, and it\n// throws instead of silently ignoring it on the browser or Workers. Narrows the source so callers\n// can use the file capabilities (resolvePath/normalizeBaseDir) after the check.\nexport function assertFileApiSupported(api: string, source: Source): asserts source is FileCapableSource {\n if (!source.supportsFiles) {\n throw new EnvaptError(\n EnvaptErrorCodes.FileApiUnsupported,\n `${api} requires a filesystem-backed source; the bound source does not support .env files.`\n );\n }\n}\n\~~n// Existence via the bound source instead of fs.existsSync/accessSync: a file \"exists\" when the source\n// can read it.\~~nexport function sourceFileExists(path: string): boolean {\n const source = state.source;\n / v8 ignore next -- @preserve every caller is file-gated, so this never sees a bare source /\n if (!source.supportsFiles) return false;\n return source.readFile(path, 'utf8') !== undefined;\n}\n\n// ~~Precedence~~ ~~is most-~~specific~~-wins~~ ~~(matches Vite / Astro / Vocs): `.env.${env}.local` > `.env.${env}`\n// > `.env.local` > `.env`. This differs from dotenv-flow / Next.js~~, ~~which~~ ~~put~~ ~~`.env.local`~~ ~~above\n//~~ ~~`.env.${env}`.~~ ~~Most-specific-wins~~ ~~keeps~~ a ~~committed~~ ~~`.env.production`~~ ~~authoritative~~ ~~regardless~~ ~~of a~~\~~n// stray `.env.local`. Missing files are filtered.\~~nfunction buildCascadePaths(env: Environment): string[] {\n const envName = Environment[env].toLowerCase();\n return [`.env.${envName}.local`, `.env.${envName}`, '.env.local', '.env']\n .map((name) => resolveAgainstBase(name))\n .filter((p) => sourceFileExists(p));\n}\n\nfunction normalizeProfilePaths(profile: EnvProfile \| undefined): string[] {\n if (!profile) return [];\n return Array.isArray(profile.paths) ? profile.paths : [profile.paths];\n}\n\n// ~~the~~ ~~cache is not built yet here, so read~~ the ~~reader~~ directly (readCached would re-enter ~~this~~ build)\nfunction getCascadeEnvironment(): Environment {\n if (state.environment !== undefined) return state.environment;\n\n const source = state.source;\n const vars = source.readVars();\n const raw = firstEnvKeyValue((key) => vars[key] ?? source.readVar?.(key));\n return raw === undefined ? Environment.Development : (parseEnvironment(raw) ?? Environment.Development);\n}\n\n/\n Resolve the `.env` paths to load. When `envPaths` was explicitly set, only those load. Otherwise\n * layer any `configureProfiles` paths for the active environment (higher precedence) over the\n * dotenv-flow cascade, all in dotenv first-wins order. `useDefaults: false` drops the cascade.\n */\nexport function resolveEffectivePaths(): string[] {\n if (state.envPathsExplicitlySet) return state.envPaths.map((p) => resolveAgainstBase(p));\n\n const env = getCascadeEnvironment();\n const profileEntry = state.profiles?.[env];\n const profilePaths = normalizeProfilePaths(profileEntry);\n\n ~~// Validate that explicitly configured profile paths exist for the active env.\n~~ if (profilePaths.length > 0) {\n const missing = profilePaths.filter((p) => !sourceFileExists(resolveAgainstBase(p)));\n if (missing.length > 0) {\n throw new EnvaptError(\n EnvaptErrorCodes.EnvFilesNotFound,\n `Environment file not found at path: ${missing.join(', ')}`\n );\n }\n }\n\n const cascade = state.profiles?.useDefaults === false ? [] : buildCascadePaths(env);\n return [...profilePaths.map((p) => resolveAgainstBase(p)), ...cascade];\n}\n"],"mappings":"~~iLAQA~~,SAAgB,EAAmB,EAA2B,CAC1D,IAAM,EAAU,EAAM,QACtB,GAAI,IAAY,IAAA,GAAW,OAAO,EAClC,IAAM,EAAS,EAAM,OAGrB,OADK,EAAO,cACL,EAAO,YAAY,EAAS,CAAS,EADV,CAEtC,~~CAgBA~~,SAAgB,EAAiB,EAAuB,CACpD,IAAM,EAAS,EAAM,OAGrB,OADK,EAAO,cACL,EAAO,SAAS,EAAM,MAAM,IAAM,IAAA,GADP,EAEtC,~~CAMA~~,SAAS,EAAkB,EAA4B,CACnD,IAAM,EAAU,EAAY,EAAI,CAAC,YAAY,EAC7C,MAAO,CAAC,QAAQ,EAAQ,QAAS,QAAQ,IAAW,aAAc,MAAM,CAAC,CACpE,IAAK,GAAS,EAAmB,CAAI,CAAC,CAAC,CACvC,OAAQ,GAAM,EAAiB,CAAC,CAAC,CAC1C,CAEA,SAAS,EAAsB,EAA2C,CAEtE,OADK,EACE,MAAM,QAAQ,EAAQ,KAAK,EAAI,EAAQ,MAAQ,CAAC,EAAQ,KAAK,EAD/C,CAAC,CAE1B,CAGA,SAAS,GAAqC,CAC1C,GAAI,EAAM,cAAgB,IAAA,GAAW,OAAO,EAAM,YAElD,IAAM,EAAS,EAAM,OACf,EAAO,EAAO,SAAS,EACvB,EAAM,EAAkB,GAAQ,EAAK,IAAQ,EAAO,UAAU,CAAG,CAAC,EACxE,OAAO,IAAQ,IAAA,GAAA,EAAuC,EAAiB,CAAG,GAAA,CAC9E,~~CAOA~~,SAAgB,GAAkC,CAC9C,GAAI,EAAM,sBAAuB,OAAO,EAAM,SAAS,IAAK,GAAM,EAAmB,CAAC,CAAC,EAEvF,IAAM,EAAM,EAAsB,EAC5B,EAAe,EAAM,WAAW,GAChC,EAAe,EAAsB,CAAY,~~EAGvD~~,GAAI,EAAa,OAAS,EAAG,CACzB,IAAM,EAAU,EAAa,OAAQ,GAAM,CAAC,EAAiB,EAAmB,CAAC,CAAC,CAAC,EACnF,GAAI,EAAQ,OAAS,EACjB,MAAM,IAAI,EAAA,IAEN,uCAAuC,EAAQ,KAAK,IAAI,GAC5D,CAER,CAEA,IAAM,EAAU,EAAM,UAAU,cAAgB,GAAQ,CAAC,EAAI,EAAkB,CAAG,EAClF,MAAO,CAAC,GAAG,EAAa,IAAK,GAAM,EAAmB,CAAC,CAAC,EAAG,GAAG,CAAO,CACzE"}
1	+ {"version":3,"file":"paths.mjs","names":[],"sources":["../../../src/core/paths.ts"],"sourcesContent":["import { Environment, firstEnvKeyValue, parseEnvironment } from './Environment';\nimport { state } from './state';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { EnvProfile, FileCapableSource, Source } from '../types';\n\n// without a baseDir the source resolves the path against its own default, process.cwd() on Node\nexport function resolveAgainstBase(candidate: string): string {\n const baseDir = state.baseDir;\n if (baseDir === undefined) return candidate;\n const source = state.source;\n /* v8 ignore next -- @preserve callers are all file-gated, so the source is never bare here /\n if (!source.supportsFiles) return candidate;\n return source.resolvePath(baseDir, candidate);\n}\n\nexport function assertFileApiSupported(api: string, source: Source): asserts source is FileCapableSource {\n if (!source.supportsFiles) {\n throw new EnvaptError(\n EnvaptErrorCodes.FileApiUnsupported,\n `${api} requires a filesystem-backed source; the bound source does not support .env files.`\n );\n }\n}\n\nexport function sourceFileExists(path: string): boolean {\n const source = state.source;\n / v8 ignore next -- @preserve every caller is file-gated, so this never sees a bare source */\n if (!source.supportsFiles) return false;\n return source.readFile(path, 'utf8') !== undefined;\n}\n\n// most specific first, since the loader keeps the first value per key unless override is on\nfunction buildCascadePaths(env: Environment): string[] {\n const envName = Environment[env].toLowerCase();\n return [`.env.${envName}.local`, `.env.${envName}`, '.env.local', '.env']\n .map((name) => resolveAgainstBase(name))\n .filter((p) => sourceFileExists(p));\n}\n\nfunction normalizeProfilePaths(profile: EnvProfile \| undefined): string[] {\n if (!profile) return [];\n return Array.isArray(profile.paths) ? profile.paths : [profile.paths];\n}\n\n// reads the source directly because readCached would re-enter the cache build\nfunction getCascadeEnvironment(): Environment {\n if (state.environment !== undefined) return state.environment;\n\n const source = state.source;\n const vars = source.readVars();\n const raw = firstEnvKeyValue((key) => vars[key] ?? source.readVar?.(key));\n return raw === undefined ? Environment.Development : (parseEnvironment(raw) ?? Environment.Development);\n}\n\nexport function resolveEffectivePaths(): string[] {\n if (state.envPathsExplicitlySet) return state.envPaths.map((p) => resolveAgainstBase(p));\n\n const env = getCascadeEnvironment();\n const profileEntry = state.profiles?.[env];\n const profilePaths = normalizeProfilePaths(profileEntry);\n\n if (profilePaths.length > 0) {\n const missing = profilePaths.filter((p) => !sourceFileExists(resolveAgainstBase(p)));\n if (missing.length > 0) {\n throw new EnvaptError(\n EnvaptErrorCodes.EnvFilesNotFound,\n `Environment file not found at path: ${missing.join(', ')}`\n );\n }\n }\n\n const cascade = state.profiles?.useDefaults === false ? [] : buildCascadePaths(env);\n return [...profilePaths.map((p) => resolveAgainstBase(p)), ...cascade];\n}\n"],"mappings":"iLAOA,SAAgB,EAAmB,EAA2B,CAC1D,IAAM,EAAU,EAAM,QACtB,GAAI,IAAY,IAAA,GAAW,OAAO,EAClC,IAAM,EAAS,EAAM,OAGrB,OADK,EAAO,cACL,EAAO,YAAY,EAAS,CAAS,EADV,CAEtC,CAWA,SAAgB,EAAiB,EAAuB,CACpD,IAAM,EAAS,EAAM,OAGrB,OADK,EAAO,cACL,EAAO,SAAS,EAAM,MAAM,IAAM,IAAA,GADP,EAEtC,CAGA,SAAS,EAAkB,EAA4B,CACnD,IAAM,EAAU,EAAY,EAAI,CAAC,YAAY,EAC7C,MAAO,CAAC,QAAQ,EAAQ,QAAS,QAAQ,IAAW,aAAc,MAAM,CAAC,CACpE,IAAK,GAAS,EAAmB,CAAI,CAAC,CAAC,CACvC,OAAQ,GAAM,EAAiB,CAAC,CAAC,CAC1C,CAEA,SAAS,EAAsB,EAA2C,CAEtE,OADK,EACE,MAAM,QAAQ,EAAQ,KAAK,EAAI,EAAQ,MAAQ,CAAC,EAAQ,KAAK,EAD/C,CAAC,CAE1B,CAGA,SAAS,GAAqC,CAC1C,GAAI,EAAM,cAAgB,IAAA,GAAW,OAAO,EAAM,YAElD,IAAM,EAAS,EAAM,OACf,EAAO,EAAO,SAAS,EACvB,EAAM,EAAkB,GAAQ,EAAK,IAAQ,EAAO,UAAU,CAAG,CAAC,EACxE,OAAO,IAAQ,IAAA,GAAA,EAAuC,EAAiB,CAAG,GAAA,CAC9E,CAEA,SAAgB,GAAkC,CAC9C,GAAI,EAAM,sBAAuB,OAAO,EAAM,SAAS,IAAK,GAAM,EAAmB,CAAC,CAAC,EAEvF,IAAM,EAAM,EAAsB,EAC5B,EAAe,EAAM,WAAW,GAChC,EAAe,EAAsB,CAAY,EAEvD,GAAI,EAAa,OAAS,EAAG,CACzB,IAAM,EAAU,EAAa,OAAQ,GAAM,CAAC,EAAiB,EAAmB,CAAC,CAAC,CAAC,EACnF,GAAI,EAAQ,OAAS,EACjB,MAAM,IAAI,EAAA,IAEN,uCAAuC,EAAQ,KAAK,IAAI,GAC5D,CAER,CAEA,IAAM,EAAU,EAAM,UAAU,cAAgB,GAAQ,CAAC,EAAI,EAAkB,CAAG,EAClF,MAAO,CAAC,GAAG,EAAa,IAAK,GAAM,EAAmB,CAAC,CAAC,EAAG,GAAG,CAAO,CACzE"}

package/dist/portable/core/state.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"state.mjs","names":[],"sources":["../../../src/core/state.ts"],"sourcesContent":["import { UnboundSource } from '../sources/UnboundSource';\n\nimport type { Environment } from './Environment';\nimport type { EnvFileOptions } from '../infra/Dotenv';\nimport type { FileApiMode, ProfilesConfig, Source } from '../types';\n\n// ~~The~~ ~~engine's~~ ~~mutable~~ ~~state~~ ~~that should not be exposed in~~ the package exports map.\nexport const state = {\n envPaths: ['.env'] as string[],\n envPathsExplicitlySet: false,\n baseDir: undefined as string \| undefined,\n userDefinedEnvFileOptions: {} as EnvFileOptions,\n strict: false,\n syncProcessEnv: false,\n fileApiMode: 'warn' as FileApiMode,\n // loader-written keys only (collisions skipped), refilled on every cache rebuild.\n dotenvAddedKeys: new Set<string>(),\n // cache.size ~~can't~~ ~~tell~~ ~~built-and-empty~~ ~~from~~ ~~not-built,~~ so a ~~source~~ ~~resolving~~ to no keys ~~would rebuild on every read without this.\~~n cacheBuilt: false,\n // unbound by default so non-Node builds throw NoSourceBound on read until useSource() runs.\n source: new UnboundSource() as Source,\n environment: undefined as Environment \| undefined,\n environmentExplicitlySet: false,\n profiles: undefined as ProfilesConfig \| undefined\n};\n\nexport const cache = new Map<string, unknown>();\n"],"mappings":"6DAOA,MAAa,EAAQ,CACjB,SAAU,CAAC,MAAM,EACjB,sBAAuB,GACvB,QAAS,IAAA,GACT,0BAA2B,CAAC,EAC5B,OAAQ,GACR,eAAgB,GAChB,YAAa,OAEb,gBAAiB,IAAI,IAErB,WAAY,GAEZ,OAAQ,IAAI,EACZ,YAAa,IAAA,GACb,yBAA0B,GAC1B,SAAU,IAAA,EACd,EAEa,EAAQ,IAAI"}
1	+ {"version":3,"file":"state.mjs","names":[],"sources":["../../../src/core/state.ts"],"sourcesContent":["import { UnboundSource } from '../sources/UnboundSource';\n\nimport type { Environment } from './Environment';\nimport type { EnvFileOptions } from '../infra/Dotenv';\nimport type { FileApiMode, ProfilesConfig, Source } from '../types';\n\n// keep this out of the package exports map\nexport const state = {\n envPaths: ['.env'] as string[],\n envPathsExplicitlySet: false,\n baseDir: undefined as string \| undefined,\n userDefinedEnvFileOptions: {} as EnvFileOptions,\n strict: false,\n syncProcessEnv: false,\n fileApiMode: 'warn' as FileApiMode,\n // loader-written keys only (collisions skipped), refilled on every cache rebuild.\n dotenvAddedKeys: new Set<string>(),\n // cache.size is 0 both before the build and after a build that found no keys\n cacheBuilt: false,\n // unbound by default so non-Node builds throw NoSourceBound on read until useSource() runs.\n source: new UnboundSource() as Source,\n environment: undefined as Environment \| undefined,\n environmentExplicitlySet: false,\n profiles: undefined as ProfilesConfig \| undefined\n};\n\nexport const cache = new Map<string, unknown>();\n"],"mappings":"6DAOA,MAAa,EAAQ,CACjB,SAAU,CAAC,MAAM,EACjB,sBAAuB,GACvB,QAAS,IAAA,GACT,0BAA2B,CAAC,EAC5B,OAAQ,GACR,eAAgB,GAChB,YAAa,OAEb,gBAAiB,IAAI,IAErB,WAAY,GAEZ,OAAQ,IAAI,EACZ,YAAa,IAAA,GACb,yBAA0B,GAC1B,SAAU,IAAA,EACd,EAEa,EAAQ,IAAI"}

package/dist/portable/decorators/legacy/Envapt.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Envapt.mjs","names":[],"sources":["../../../../src/decorators/legacy/Envapt.ts"],"sourcesContent":["import { createPropertyDecorator } from './createPropertyDecorator';\nimport { parseEnvaptOptions } from '../parseEnvaptOptions';\n\nimport type { ArrayOf } from '../../converters';\nimport type { InferSchemaOutput, StandardSchemaV1 } from '../../infra/StandardSchema';\nimport type {\n BuiltInConverter,\n ConverterFunction,\n EnvaptFieldDecorator,\n EnvKeyInput,\n InferConverterFallbackType,\n InferConverterReturnType,\n InferPrimitiveReturnType,\n PrimitiveConstructor,\n SchemaConstraint\n} from '../../types';\n\n/*\n A custom converter function with a fallback (both required), or a fallback only.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n * \\@Envapt('API_KEY', {\n * fallback: 'default-key',\n * converter(raw, _fallback) {\n * if (!raw \|\| raw.trim() === '') throw new Error('API_KEY required');\n * return raw.trim();\n * }\n * })\n * static readonly apiKey: string;\n \n \\@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })\n * static readonly logFile: string;\n \n \\@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })\n * static readonly retryPolicy: unknown;\n * }\n * ```\n /\nexport function Envapt(\n key: EnvKeyInput,\n options?: { fallback: undefined; converter?: undefined }\n): EnvaptFieldDecorator<string \| undefined>;\nexport function Envapt<TFallback>(\n key: EnvKeyInput,\n options:\n \| { converter: (raw: string \| undefined, fallback: TFallback) => TFallback; fallback: TFallback }\n \| { fallback: TFallback; converter?: undefined }\n): EnvaptFieldDecorator<TFallback>;\n\n/\n A custom converter function without a fallback. Omit `required` to return the converter's\n * output (possibly `undefined`), or pass `required: true` to throw `MissingEnvValue` on\n * missing or empty values.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n * \\@Envapt('FEATURE_FLAGS', { converter(raw) {\n * return raw ? raw.split('\|').map(s => s.trim()) : [];\n * } })\n * static readonly featureFlags: string[];\n \n \\@Envapt('JWT_SECRET', {\n * converter: (raw) => Buffer.from(raw ?? '', 'base64'),\n * required: true\n * })\n * static readonly jwtSecret: Buffer;\n * }\n * ```\n /\nexport function Envapt<TReturnType>(\n key: EnvKeyInput,\n options:\n \| { converter: ConverterFunction<TReturnType>; required?: false }\n \| { converter: ConverterFunction<TReturnType>; required: true }\n): EnvaptFieldDecorator<TReturnType>;\n\n/\n A built-in or array converter with a fallback, or `required: true`. The fallback type tracks\n * the converter, so `Converters.Time` takes a number or time-string and `Converters.Url` takes\n * a `URL` instance.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * import { Converters } from 'envapt';\n \n class Config extends Envapter {\n * \\@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })\n * static readonly port: number;\n \n // the Url fallback is a URL instance~~, not a string~~\n * \\@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })\n * static readonly url: URL;\n \n // ~~prefers~~ CANARY_URL when present, otherwise APP_URL\n * \\@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })\n * static readonly canaryUrl: URL \| undefined;\n \n // Time takes a number (milliseconds) or a time-string fallback (`<number><unit>`)\n * \\@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })\n * static readonly requestTimeout: number;\n \n \\@Envapt('ALLOWED_ORIGINS', {\n * converter: Converters.array({ of: Converters.String }),\n * fallback: ['https://example.com']\n * })\n * static readonly allowedOrigins: string[];\n \n \\@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })\n * static readonly databaseUrl: URL;\n * }\n * ```\n /\nexport function Envapt<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n options:\n \| { converter: TConverter; fallback: InferConverterFallbackType<TConverter>; required?: false }\n \| { converter: TConverter; required: true }\n): EnvaptFieldDecorator<InferConverterReturnType<TConverter>>;\nexport function Envapt<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n options: { converter: TConverter; fallback?: undefined; required?: false }\n): EnvaptFieldDecorator<InferConverterReturnType<TConverter> \| undefined>;\n\n/\n A primitive constructor (`Number`, `Boolean`) with an optional fallback.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n * \\@Envapt('MAX_CONNECTIONS', { converter: Number, fallback: 100 })\n * static readonly maxConnections: number;\n \n \\@Envapt('FEATURE_ENABLED', { converter: Boolean, fallback: false })\n * static readonly featureEnabled: boolean;\n * }\n * ```\n /\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n key: EnvKeyInput,\n options:\n \| { converter: TConstructor; fallback: InferPrimitiveReturnType<TConstructor>; required?: false }\n \| { converter: TConstructor; required: true }\n): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor>>;\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n key: EnvKeyInput,\n options: { converter: TConstructor; fallback?: undefined; required?: false }\n): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor> \| undefined>;\n\n/\n Required, no converter (raw string). Throws `MissingEnvValue` on first access when the env\n * value is missing or empty ~~after trimming, independent of the global `Envapter~~.~~strict`~~ flag.\n * Pairing `required: true` with `fallback` matches no overload at compile time, and ~~the~~ ~~runtime\n~~ * ~~Validator~~ ~~rejects~~ ~~dynamic~~ ~~objects~~ ~~that~~ ~~bypass~~ ~~the types~~.\n \n @param key - Environment variable name(s) to load\n * @param options - `{ required: true }`\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n * \\@Envapt('API_KEY', { required: true })\n * static readonly apiKey: string;\n * }\n * ```\n /\nexport function Envapt(key: EnvKeyInput, options: { required: true }): EnvaptFieldDecorator<string>;\n\n/\n A Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous schemas only,\n * so a Promise~~-returning~~ ~~`validate`~~ throws `InvalidUserDefinedConfig` at runtime. Pairing\n * `schema` with `converter` matches no overload at compile time, and ~~the~~ ~~runtime~~ ~~Validator~~\n * ~~rejects~~ ~~dynamic~~ ~~objects~~ ~~that~~ ~~bypass the types~~.\n * @public\n /\nexport function Envapt<Schema extends StandardSchemaV1>(\n key: EnvKeyInput,\n options:\n \| { schema: SchemaConstraint<Schema>; fallback?: InferSchemaOutput<Schema>; required?: false }\n \| { schema: SchemaConstraint<Schema>; required: true }\n): EnvaptFieldDecorator<InferSchemaOutput<Schema>>;\n\n/\n Instance or static property decorator that loads and converts an environment variable.\n * @see {@link https://envapt.materwelon.dev/docs/decorators#declaring-decorated-fields}\n */\nexport function Envapt<TFallback = unknown>(key: EnvKeyInput, options?: unknown): EnvaptFieldDecorator<unknown> {\n return createPropertyDecorator(key, parseEnvaptOptions<TFallback>(options)) as EnvaptFieldDecorator<unknown>;\n}\n"],"mappings":"~~uIAwMA~~,SAAgB,EAA4B,EAAkB,EAAkD,CAC5G,OAAO,EAAwB,EAAK,EAA8B,CAAO,CAAC,CAC9E"}
1	+ {"version":3,"file":"Envapt.mjs","names":[],"sources":["../../../../src/decorators/legacy/Envapt.ts"],"sourcesContent":["import { createPropertyDecorator } from './createPropertyDecorator';\nimport { parseEnvaptOptions } from '../parseEnvaptOptions';\n\nimport type { ArrayOf } from '../../converters';\nimport type { InferSchemaOutput, StandardSchemaV1 } from '../../infra/StandardSchema';\nimport type {\n BuiltInConverter,\n ConverterFunction,\n EnvaptFieldDecorator,\n EnvKeyInput,\n InferConverterFallbackType,\n InferConverterReturnType,\n InferPrimitiveReturnType,\n PrimitiveConstructor,\n SchemaConstraint\n} from '../../types';\n\n/*\n A custom converter function with a fallback (both required), or a fallback only.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n * \\@Envapt('API_KEY', {\n * fallback: 'default-key',\n * converter(raw, _fallback) {\n * if (!raw \|\| raw.trim() === '') throw new Error('API_KEY required');\n * return raw.trim();\n * }\n * })\n * static readonly apiKey: string;\n \n \\@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })\n * static readonly logFile: string;\n \n \\@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })\n * static readonly retryPolicy: unknown;\n * }\n * ```\n /\nexport function Envapt(\n key: EnvKeyInput,\n options?: { fallback: undefined; converter?: undefined }\n): EnvaptFieldDecorator<string \| undefined>;\nexport function Envapt<TFallback>(\n key: EnvKeyInput,\n options:\n \| { converter: (raw: string \| undefined, fallback: TFallback) => TFallback; fallback: TFallback }\n \| { fallback: TFallback; converter?: undefined }\n): EnvaptFieldDecorator<TFallback>;\n\n/\n A custom converter function without a fallback. Omit `required` to return the converter's\n * output (possibly `undefined`), or pass `required: true` to throw `MissingEnvValue` on\n * missing or empty values.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n * \\@Envapt('FEATURE_FLAGS', { converter(raw) {\n * return raw ? raw.split('\|').map(s => s.trim()) : [];\n * } })\n * static readonly featureFlags: string[];\n \n \\@Envapt('JWT_SECRET', {\n * converter: (raw) => Buffer.from(raw ?? '', 'base64'),\n * required: true\n * })\n * static readonly jwtSecret: Buffer;\n * }\n * ```\n /\nexport function Envapt<TReturnType>(\n key: EnvKeyInput,\n options:\n \| { converter: ConverterFunction<TReturnType>; required?: false }\n \| { converter: ConverterFunction<TReturnType>; required: true }\n): EnvaptFieldDecorator<TReturnType>;\n\n/\n A built-in or array converter with a fallback, or `required: true`. The fallback type tracks\n * the converter, so `Converters.Time` takes a number or time-string and `Converters.Url` takes\n * a `URL` instance.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * import { Converters } from 'envapt';\n \n class Config extends Envapter {\n * \\@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })\n * static readonly port: number;\n \n // the Url fallback is a URL instance\n * \\@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })\n * static readonly url: URL;\n \n // reads CANARY_URL when present, otherwise APP_URL\n * \\@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })\n * static readonly canaryUrl: URL \| undefined;\n \n // Time takes a number (milliseconds) or a time-string fallback (`<number><unit>`)\n * \\@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })\n * static readonly requestTimeout: number;\n \n \\@Envapt('ALLOWED_ORIGINS', {\n * converter: Converters.array({ of: Converters.String }),\n * fallback: ['https://example.com']\n * })\n * static readonly allowedOrigins: string[];\n \n \\@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })\n * static readonly databaseUrl: URL;\n * }\n * ```\n /\nexport function Envapt<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n options:\n \| { converter: TConverter; fallback: InferConverterFallbackType<TConverter>; required?: false }\n \| { converter: TConverter; required: true }\n): EnvaptFieldDecorator<InferConverterReturnType<TConverter>>;\nexport function Envapt<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n options: { converter: TConverter; fallback?: undefined; required?: false }\n): EnvaptFieldDecorator<InferConverterReturnType<TConverter> \| undefined>;\n\n/\n A primitive constructor (`Number`, `Boolean`) with an optional fallback.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n * \\@Envapt('MAX_CONNECTIONS', { converter: Number, fallback: 100 })\n * static readonly maxConnections: number;\n \n \\@Envapt('FEATURE_ENABLED', { converter: Boolean, fallback: false })\n * static readonly featureEnabled: boolean;\n * }\n * ```\n /\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n key: EnvKeyInput,\n options:\n \| { converter: TConstructor; fallback: InferPrimitiveReturnType<TConstructor>; required?: false }\n \| { converter: TConstructor; required: true }\n): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor>>;\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n key: EnvKeyInput,\n options: { converter: TConstructor; fallback?: undefined; required?: false }\n): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor> \| undefined>;\n\n/\n Required, no converter (raw string). Throws `MissingEnvValue` on first access when the env\n * value is missing or empty. Pairing `required: true` with `fallback` matches no overload at\n * compile time, and a call that bypasses the types throws `InvalidUserDefinedConfig` at runtime.\n \n @param key - Environment variable name(s) to load\n * @param options - `{ required: true }`\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n * \\@Envapt('API_KEY', { required: true })\n * static readonly apiKey: string;\n * }\n * ```\n /\nexport function Envapt(key: EnvKeyInput, options: { required: true }): EnvaptFieldDecorator<string>;\n\n/\n A Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous schemas only.\n * A `validate` that returns a Promise throws `InvalidUserDefinedConfig` at runtime. Pairing\n * `schema` with `converter` matches no overload at compile time, and a call that bypasses the\n * types throws `InvalidUserDefinedConfig` at runtime.\n * @public\n /\nexport function Envapt<Schema extends StandardSchemaV1>(\n key: EnvKeyInput,\n options:\n \| { schema: SchemaConstraint<Schema>; fallback?: InferSchemaOutput<Schema>; required?: false }\n \| { schema: SchemaConstraint<Schema>; required: true }\n): EnvaptFieldDecorator<InferSchemaOutput<Schema>>;\n\n/\n Instance or static property decorator that loads and converts an environment variable.\n * @see {@link https://envapt.materwelon.dev/docs/decorators#declaring-decorated-fields}\n */\nexport function Envapt<TFallback = unknown>(key: EnvKeyInput, options?: unknown): EnvaptFieldDecorator<unknown> {\n return createPropertyDecorator(key, parseEnvaptOptions<TFallback>(options)) as EnvaptFieldDecorator<unknown>;\n}\n"],"mappings":"uIAuMA,SAAgB,EAA4B,EAAkB,EAAkD,CAC5G,OAAO,EAAwB,EAAK,EAA8B,CAAO,CAAC,CAC9E"}

package/dist/portable/decorators/legacy/SugarDecorators.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"SugarDecorators.mjs","names":[],"sources":["../../../../src/decorators/legacy/SugarDecorators.ts"],"sourcesContent":["import { createPropertyDecorator } from './createPropertyDecorator';\nimport { Converters } from '../../converters';\n\nimport type { ConverterToken } from '../../converters';\nimport type { EnvaptFieldDecorator, EnvKeyInput, TimeFallback } from '../../types';\n\nfunction sugar<TFallback>(\n converter: ConverterToken,\n key: EnvKeyInput,\n fallback: TFallback \| undefined\n): EnvaptFieldDecorator<TFallback> {\n // the ~~runtime installer is a plain (target, key) decorator, so the~~ cast only adds a~~\n //~~ compile-time ~~field-type~~ ~~constraint~~ ~~with~~ no ~~runtime counterpart~~\n return createPropertyDecorator<TFallback>(key, {\n converter,\n fallback,\n hasFallback: fallback !== undefined,\n required: false,\n schema: undefined\n }) as EnvaptFieldDecorator<TFallback>;\n}\n\n/*\n Shorthand for `@Envapt(key, { converter: Converters.Boolean, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptFieldDecorator<boolean>;\nexport function EnvBool(key: EnvKeyInput): EnvaptFieldDecorator<boolean \| undefined>;\nexport function EnvBool(key: EnvKeyInput, fallback?: boolean): EnvaptFieldDecorator<boolean \| undefined> {\n return sugar(Converters.Boolean, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvNum(key: EnvKeyInput, fallback: number): EnvaptFieldDecorator<number>;\nexport function EnvNum(key: EnvKeyInput): EnvaptFieldDecorator<number \| undefined>;\nexport function EnvNum(key: EnvKeyInput, fallback?: number): EnvaptFieldDecorator<number \| undefined> {\n return sugar(Converters.Number, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvStr(key: EnvKeyInput, fallback: string): EnvaptFieldDecorator<string>;\nexport function EnvStr(key: EnvKeyInput): EnvaptFieldDecorator<string \| undefined>;\nexport function EnvStr(key: EnvKeyInput, fallback?: string): EnvaptFieldDecorator<string \| undefined> {\n return sugar(Converters.String, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Time, fallback })`. The fallback is a\n * millisecond number or a time string (`'15m'`), and the resolved value is always milliseconds.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptFieldDecorator<number>;\nexport function EnvTime(key: EnvKeyInput): EnvaptFieldDecorator<number \| undefined>;\nexport function EnvTime(key: EnvKeyInput, fallback?: TimeFallback): EnvaptFieldDecorator<number \| undefined> {\n return sugar(Converters.Time, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback is a ~~`URL`\~~n * ~~instance, not a~~ URL ~~string~~.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n */\nexport function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptFieldDecorator<URL>;\nexport function EnvUrl(key: EnvKeyInput): EnvaptFieldDecorator<URL \| undefined>;\nexport function EnvUrl(key: EnvKeyInput, fallback?: URL): EnvaptFieldDecorator<URL \| undefined> {\n return sugar(Converters.Url, key, fallback);\n}\n"],"mappings":"qIAMA,SAAS,EACL,EACA,EACA,EAC+B,~~CAG~~/B,OAAO,EAAmC,EAAK,CAC3C,YACA,WACA,YAAa,IAAa,IAAA,GAC1B,SAAU,GACV,OAAQ,IAAA,EACZ,CAAC,CACL,CASA,SAAgB,EAAQ,EAAkB,EAA+D,CACrG,OAAO,EAAM,EAAW,QAAS,EAAK,CAAQ,CAClD,CASA,SAAgB,EAAO,EAAkB,EAA6D,CAClG,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CASA,SAAgB,EAAO,EAAkB,EAA6D,CAClG,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CAUA,SAAgB,EAAQ,EAAkB,EAAmE,CACzG,OAAO,EAAM,EAAW,KAAM,EAAK,CAAQ,CAC/C,CAUA,SAAgB,EAAO,EAAkB,EAAuD,CAC5F,OAAO,EAAM,EAAW,IAAK,EAAK,CAAQ,CAC9C"}
1	+ {"version":3,"file":"SugarDecorators.mjs","names":[],"sources":["../../../../src/decorators/legacy/SugarDecorators.ts"],"sourcesContent":["import { createPropertyDecorator } from './createPropertyDecorator';\nimport { Converters } from '../../converters';\n\nimport type { ConverterToken } from '../../converters';\nimport type { EnvaptFieldDecorator, EnvKeyInput, TimeFallback } from '../../types';\n\nfunction sugar<TFallback>(\n converter: ConverterToken,\n key: EnvKeyInput,\n fallback: TFallback \| undefined\n): EnvaptFieldDecorator<TFallback> {\n // the cast only adds a compile-time check on the field type\n return createPropertyDecorator<TFallback>(key, {\n converter,\n fallback,\n hasFallback: fallback !== undefined,\n required: false,\n schema: undefined\n }) as EnvaptFieldDecorator<TFallback>;\n}\n\n/*\n Shorthand for `@Envapt(key, { converter: Converters.Boolean, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptFieldDecorator<boolean>;\nexport function EnvBool(key: EnvKeyInput): EnvaptFieldDecorator<boolean \| undefined>;\nexport function EnvBool(key: EnvKeyInput, fallback?: boolean): EnvaptFieldDecorator<boolean \| undefined> {\n return sugar(Converters.Boolean, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvNum(key: EnvKeyInput, fallback: number): EnvaptFieldDecorator<number>;\nexport function EnvNum(key: EnvKeyInput): EnvaptFieldDecorator<number \| undefined>;\nexport function EnvNum(key: EnvKeyInput, fallback?: number): EnvaptFieldDecorator<number \| undefined> {\n return sugar(Converters.Number, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvStr(key: EnvKeyInput, fallback: string): EnvaptFieldDecorator<string>;\nexport function EnvStr(key: EnvKeyInput): EnvaptFieldDecorator<string \| undefined>;\nexport function EnvStr(key: EnvKeyInput, fallback?: string): EnvaptFieldDecorator<string \| undefined> {\n return sugar(Converters.String, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Time, fallback })`. The fallback is a\n * millisecond number or a time string (`'15m'`), and the resolved value is always milliseconds.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptFieldDecorator<number>;\nexport function EnvTime(key: EnvKeyInput): EnvaptFieldDecorator<number \| undefined>;\nexport function EnvTime(key: EnvKeyInput, fallback?: TimeFallback): EnvaptFieldDecorator<number \| undefined> {\n return sugar(Converters.Time, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback must be a\n * `URL` instance.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n */\nexport function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptFieldDecorator<URL>;\nexport function EnvUrl(key: EnvKeyInput): EnvaptFieldDecorator<URL \| undefined>;\nexport function EnvUrl(key: EnvKeyInput, fallback?: URL): EnvaptFieldDecorator<URL \| undefined> {\n return sugar(Converters.Url, key, fallback);\n}\n"],"mappings":"qIAMA,SAAS,EACL,EACA,EACA,EAC+B,CAE/B,OAAO,EAAmC,EAAK,CAC3C,YACA,WACA,YAAa,IAAa,IAAA,GAC1B,SAAU,GACV,OAAQ,IAAA,EACZ,CAAC,CACL,CASA,SAAgB,EAAQ,EAAkB,EAA+D,CACrG,OAAO,EAAM,EAAW,QAAS,EAAK,CAAQ,CAClD,CASA,SAAgB,EAAO,EAAkB,EAA6D,CAClG,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CASA,SAAgB,EAAO,EAAkB,EAA6D,CAClG,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CAUA,SAAgB,EAAQ,EAAkB,EAAmE,CACzG,OAAO,EAAM,EAAW,KAAM,EAAK,CAAQ,CAC/C,CAUA,SAAgB,EAAO,EAAkB,EAAuD,CAC5F,OAAO,EAAM,EAAW,IAAK,EAAK,CAAQ,CAC9C"}

package/dist/portable/decorators/modern/Envapt.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Envapt.mjs","names":[],"sources":["../../../../src/decorators/modern/Envapt.ts"],"sourcesContent":["import { createAccessorDecorator } from './createAccessorDecorator';\nimport { parseEnvaptOptions } from '../parseEnvaptOptions';\n\nimport type { ArrayOf } from '../../converters';\nimport type { InferSchemaOutput, StandardSchemaV1 } from '../../infra/StandardSchema';\nimport type {\n BuiltInConverter,\n ConverterFunction,\n EnvaptAccessorDecorator,\n EnvKeyInput,\n InferConverterFallbackType,\n InferConverterReturnType,\n InferPrimitiveReturnType,\n PrimitiveConstructor,\n SchemaConstraint\n} from '../../types';\n\n/*\n A custom converter function with a fallback (both required), or a fallback only.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config {\n * \\@Envapt('API_KEY', {\n * fallback: 'default-key',\n * converter(raw, _fallback) {\n * if (!raw \|\| raw.trim() === '') throw new Error('API_KEY required');\n * return raw.trim();\n * }\n * })\n * static accessor apiKey: string;\n \n \\@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })\n * static accessor logFile: string;\n \n \\@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })\n * static accessor retryPolicy: unknown;\n * }\n * ```\n /\nexport function Envapt(\n key: EnvKeyInput,\n options?: { fallback: undefined; converter?: undefined }\n): EnvaptAccessorDecorator<string \| undefined>;\nexport function Envapt<TFallback>(\n key: EnvKeyInput,\n options:\n \| { converter: (raw: string \| undefined, fallback: TFallback) => TFallback; fallback: TFallback }\n \| { fallback: TFallback; converter?: undefined }\n): EnvaptAccessorDecorator<TFallback>;\n\n/\n A custom converter function without a fallback. Omit `required` to return the converter's\n * output (possibly `undefined`), or pass `required: true` to throw `MissingEnvValue` on\n * missing or empty values.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config {\n * \\@Envapt('FEATURE_FLAGS', { converter(raw) {\n * return raw ? raw.split('\|').map(s => s.trim()) : [];\n * } })\n * static accessor featureFlags: string[];\n \n \\@Envapt('JWT_SECRET', {\n * converter: (raw) => Buffer.from(raw ?? '', 'base64'),\n * required: true\n * })\n * static accessor jwtSecret: Buffer;\n * }\n * ```\n /\nexport function Envapt<TReturnType>(\n key: EnvKeyInput,\n options:\n \| { converter: ConverterFunction<TReturnType>; required?: false }\n \| { converter: ConverterFunction<TReturnType>; required: true }\n): EnvaptAccessorDecorator<TReturnType>;\n\n/\n A built-in or array converter with a fallback, or `required: true`. The fallback type tracks\n * the converter, so `Converters.Time` takes a number or time-string and `Converters.Url` takes\n * a `URL` instance.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * import { Converters } from 'envapt';\n \n class Config {\n * \\@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })\n * static accessor port: number;\n \n // the Url fallback is a URL instance~~, not a string~~\n * \\@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })\n * static accessor url: URL;\n \n // ~~prefers~~ CANARY_URL when present, otherwise APP_URL\n * \\@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })\n * static accessor canaryUrl: URL \| undefined;\n \n // Time takes a number (milliseconds) or a time-string fallback (`<number><unit>`)\n * \\@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })\n * static accessor requestTimeout: number;\n \n \\@Envapt('ALLOWED_ORIGINS', {\n * converter: Converters.array({ of: Converters.String }),\n * fallback: ['https://example.com']\n * })\n * static accessor allowedOrigins: string[];\n \n \\@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })\n * static accessor databaseUrl: URL;\n * }\n * ```\n /\nexport function Envapt<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n options:\n \| { converter: TConverter; fallback: InferConverterFallbackType<TConverter>; required?: false }\n \| { converter: TConverter; required: true }\n): EnvaptAccessorDecorator<InferConverterReturnType<TConverter>>;\nexport function Envapt<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n options: { converter: TConverter; fallback?: undefined; required?: false }\n): EnvaptAccessorDecorator<InferConverterReturnType<TConverter> \| undefined>;\n\n/\n A primitive constructor (`Number`, `Boolean`) with an optional fallback.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config {\n * \\@Envapt('MAX_CONNECTIONS', { converter: Number, fallback: 100 })\n * static accessor maxConnections: number;\n \n \\@Envapt('FEATURE_ENABLED', { converter: Boolean, fallback: false })\n * static accessor featureEnabled: boolean;\n * }\n * ```\n /\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n key: EnvKeyInput,\n options:\n \| { converter: TConstructor; fallback: InferPrimitiveReturnType<TConstructor>; required?: false }\n \| { converter: TConstructor; required: true }\n): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor>>;\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n key: EnvKeyInput,\n options: { converter: TConstructor; fallback?: undefined; required?: false }\n): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor> \| undefined>;\n\n/\n Required, no converter (raw string). Throws `MissingEnvValue` on first access when the env\n * value is missing or empty ~~after trimming, independent of the global `Envapter~~.~~strict`~~ flag.\n * Pairing `required: true` with `fallback` matches no overload at compile time, and ~~the~~ ~~runtime\n~~ * ~~Validator~~ ~~rejects~~ ~~dynamic~~ ~~objects~~ ~~that~~ ~~bypass~~ ~~the types~~.\n \n @param key - Environment variable name(s) to load\n * @param options - `{ required: true }`\n * @public\n * @example\n * ```ts\n * class Config {\n * \\@Envapt('API_KEY', { required: true })\n * static accessor apiKey: string;\n * }\n * ```\n /\nexport function Envapt(key: EnvKeyInput, options: { required: true }): EnvaptAccessorDecorator<string>;\n\n/\n A Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous schemas only,\n * so a Promise~~-returning~~ ~~`validate`~~ throws `InvalidUserDefinedConfig` at runtime. Pairing\n * `schema` with `converter` matches no overload at compile time, and ~~the~~ ~~runtime~~ ~~Validator~~\n * ~~rejects~~ ~~dynamic~~ ~~objects~~ ~~that~~ ~~bypass the types~~.\n * @public\n /\nexport function Envapt<Schema extends StandardSchemaV1>(\n key: EnvKeyInput,\n options:\n \| { schema: SchemaConstraint<Schema>; fallback?: InferSchemaOutput<Schema>; required?: false }\n \| { schema: SchemaConstraint<Schema>; required: true }\n): EnvaptAccessorDecorator<InferSchemaOutput<Schema>>;\n\n/\n Modern (TC39 Stage 3) accessor decorator that loads and converts an environment variable. The\n * decorated property uses the `accessor` keyword and needs no `experimentalDecorators` flag.\n * Instance accessors need the definite-assignment ~~`!`,~~ ~~static~~ accessors do not.\n \n @param key - Environment variable name(s) to load\n * @param options - Converter, fallback, `required`, or `schema`. See the overloads.\n * @public\n * @example\n * ```ts\n * import { Envapt, Converters } from 'envapt';\n \n class Config {\n * \\@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })\n * static accessor port: number;\n \n \\@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })\n * accessor databaseUrl!: URL;\n * }\n * ```\n * @see {@link https://envapt.materwelon.dev/docs/decorators#declaring-decorated-fields}\n /\n/ v8 ignore start -- @preserve oxc (vitest's transform) ~~breaks~~ ~~modern accessor decorators (~~context.name unset), so ~~the~~ ~~tsc~~ ~~stage3-emit~~ ~~harness covers these, not vitest~~ /\nexport function Envapt<TFallback = unknown>(key: EnvKeyInput, options?: unknown): EnvaptAccessorDecorator<unknown> {\n return createAccessorDecorator(key, parseEnvaptOptions<TFallback>(options)) as EnvaptAccessorDecorator<unknown>;\n}\n/ v8 ignore stop */\n"],"mappings":"~~uIA2NA~~,SAAgB,EAA4B,EAAkB,EAAqD,CAC/G,OAAO,EAAwB,EAAK,EAA8B,CAAO,CAAC,CAC9E"}
1	+ {"version":3,"file":"Envapt.mjs","names":[],"sources":["../../../../src/decorators/modern/Envapt.ts"],"sourcesContent":["import { createAccessorDecorator } from './createAccessorDecorator';\nimport { parseEnvaptOptions } from '../parseEnvaptOptions';\n\nimport type { ArrayOf } from '../../converters';\nimport type { InferSchemaOutput, StandardSchemaV1 } from '../../infra/StandardSchema';\nimport type {\n BuiltInConverter,\n ConverterFunction,\n EnvaptAccessorDecorator,\n EnvKeyInput,\n InferConverterFallbackType,\n InferConverterReturnType,\n InferPrimitiveReturnType,\n PrimitiveConstructor,\n SchemaConstraint\n} from '../../types';\n\n/*\n A custom converter function with a fallback (both required), or a fallback only.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config {\n * \\@Envapt('API_KEY', {\n * fallback: 'default-key',\n * converter(raw, _fallback) {\n * if (!raw \|\| raw.trim() === '') throw new Error('API_KEY required');\n * return raw.trim();\n * }\n * })\n * static accessor apiKey: string;\n \n \\@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })\n * static accessor logFile: string;\n \n \\@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })\n * static accessor retryPolicy: unknown;\n * }\n * ```\n /\nexport function Envapt(\n key: EnvKeyInput,\n options?: { fallback: undefined; converter?: undefined }\n): EnvaptAccessorDecorator<string \| undefined>;\nexport function Envapt<TFallback>(\n key: EnvKeyInput,\n options:\n \| { converter: (raw: string \| undefined, fallback: TFallback) => TFallback; fallback: TFallback }\n \| { fallback: TFallback; converter?: undefined }\n): EnvaptAccessorDecorator<TFallback>;\n\n/\n A custom converter function without a fallback. Omit `required` to return the converter's\n * output (possibly `undefined`), or pass `required: true` to throw `MissingEnvValue` on\n * missing or empty values.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config {\n * \\@Envapt('FEATURE_FLAGS', { converter(raw) {\n * return raw ? raw.split('\|').map(s => s.trim()) : [];\n * } })\n * static accessor featureFlags: string[];\n \n \\@Envapt('JWT_SECRET', {\n * converter: (raw) => Buffer.from(raw ?? '', 'base64'),\n * required: true\n * })\n * static accessor jwtSecret: Buffer;\n * }\n * ```\n /\nexport function Envapt<TReturnType>(\n key: EnvKeyInput,\n options:\n \| { converter: ConverterFunction<TReturnType>; required?: false }\n \| { converter: ConverterFunction<TReturnType>; required: true }\n): EnvaptAccessorDecorator<TReturnType>;\n\n/\n A built-in or array converter with a fallback, or `required: true`. The fallback type tracks\n * the converter, so `Converters.Time` takes a number or time-string and `Converters.Url` takes\n * a `URL` instance.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * import { Converters } from 'envapt';\n \n class Config {\n * \\@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })\n * static accessor port: number;\n \n // the Url fallback is a URL instance\n * \\@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })\n * static accessor url: URL;\n \n // reads CANARY_URL when present, otherwise APP_URL\n * \\@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })\n * static accessor canaryUrl: URL \| undefined;\n \n // Time takes a number (milliseconds) or a time-string fallback (`<number><unit>`)\n * \\@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })\n * static accessor requestTimeout: number;\n \n \\@Envapt('ALLOWED_ORIGINS', {\n * converter: Converters.array({ of: Converters.String }),\n * fallback: ['https://example.com']\n * })\n * static accessor allowedOrigins: string[];\n \n \\@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })\n * static accessor databaseUrl: URL;\n * }\n * ```\n /\nexport function Envapt<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n options:\n \| { converter: TConverter; fallback: InferConverterFallbackType<TConverter>; required?: false }\n \| { converter: TConverter; required: true }\n): EnvaptAccessorDecorator<InferConverterReturnType<TConverter>>;\nexport function Envapt<TConverter extends BuiltInConverter \| ArrayOf>(\n key: EnvKeyInput,\n options: { converter: TConverter; fallback?: undefined; required?: false }\n): EnvaptAccessorDecorator<InferConverterReturnType<TConverter> \| undefined>;\n\n/\n A primitive constructor (`Number`, `Boolean`) with an optional fallback.\n \n @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config {\n * \\@Envapt('MAX_CONNECTIONS', { converter: Number, fallback: 100 })\n * static accessor maxConnections: number;\n \n \\@Envapt('FEATURE_ENABLED', { converter: Boolean, fallback: false })\n * static accessor featureEnabled: boolean;\n * }\n * ```\n /\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n key: EnvKeyInput,\n options:\n \| { converter: TConstructor; fallback: InferPrimitiveReturnType<TConstructor>; required?: false }\n \| { converter: TConstructor; required: true }\n): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor>>;\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n key: EnvKeyInput,\n options: { converter: TConstructor; fallback?: undefined; required?: false }\n): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor> \| undefined>;\n\n/\n Required, no converter (raw string). Throws `MissingEnvValue` on first access when the env\n * value is missing or empty. Pairing `required: true` with `fallback` matches no overload at\n * compile time, and a call that bypasses the types throws `InvalidUserDefinedConfig` at runtime.\n \n @param key - Environment variable name(s) to load\n * @param options - `{ required: true }`\n * @public\n * @example\n * ```ts\n * class Config {\n * \\@Envapt('API_KEY', { required: true })\n * static accessor apiKey: string;\n * }\n * ```\n /\nexport function Envapt(key: EnvKeyInput, options: { required: true }): EnvaptAccessorDecorator<string>;\n\n/\n A Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous schemas only.\n * A `validate` that returns a Promise throws `InvalidUserDefinedConfig` at runtime. Pairing\n * `schema` with `converter` matches no overload at compile time, and a call that bypasses the\n * types throws `InvalidUserDefinedConfig` at runtime.\n * @public\n /\nexport function Envapt<Schema extends StandardSchemaV1>(\n key: EnvKeyInput,\n options:\n \| { schema: SchemaConstraint<Schema>; fallback?: InferSchemaOutput<Schema>; required?: false }\n \| { schema: SchemaConstraint<Schema>; required: true }\n): EnvaptAccessorDecorator<InferSchemaOutput<Schema>>;\n\n/\n Modern (TC39 Stage 3) accessor decorator that loads and converts an environment variable. The\n * decorated property uses the `accessor` keyword and needs no `experimentalDecorators` flag.\n * Instance accessors need the definite-assignment `!`. Static accessors do not.\n \n @param key - Environment variable name(s) to load\n * @param options - Converter, fallback, `required`, or `schema`. See the overloads.\n * @public\n * @example\n * ```ts\n * import { Envapt, Converters } from 'envapt';\n \n class Config {\n * \\@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })\n * static accessor port: number;\n \n \\@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })\n * accessor databaseUrl!: URL;\n * }\n * ```\n * @see {@link https://envapt.materwelon.dev/docs/decorators#declaring-decorated-fields}\n /\n/ v8 ignore start -- @preserve the tsc stage3-emit tests cover these because oxc (vitest's transform) leaves context.name unset on modern accessor decorators /\nexport function Envapt<TFallback = unknown>(key: EnvKeyInput, options?: unknown): EnvaptAccessorDecorator<unknown> {\n return createAccessorDecorator(key, parseEnvaptOptions<TFallback>(options)) as EnvaptAccessorDecorator<unknown>;\n}\n/ v8 ignore stop */\n"],"mappings":"uIA0NA,SAAgB,EAA4B,EAAkB,EAAqD,CAC/G,OAAO,EAAwB,EAAK,EAA8B,CAAO,CAAC,CAC9E"}

package/dist/portable/decorators/modern/SugarDecorators.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"SugarDecorators.mjs","names":[],"sources":["../../../../src/decorators/modern/SugarDecorators.ts"],"sourcesContent":["import { createAccessorDecorator } from './createAccessorDecorator';\nimport { Converters } from '../../converters';\n\nimport type { ConverterToken } from '../../converters';\nimport type { EnvaptAccessorDecorator, EnvKeyInput, TimeFallback } from '../../types';\n\n/* v8 ignore start -- @preserve oxc (vitest's transform) ~~breaks~~ ~~modern accessor decorators (~~context.name unset), so ~~the~~ ~~tsc~~ ~~stage3-emit~~ ~~harness covers these, not vitest~~ /\nfunction sugar<TFallback>(\n converter: ConverterToken,\n key: EnvKeyInput,\n fallback: TFallback \| undefined\n): EnvaptAccessorDecorator<TFallback> {\n // the ~~runtime installer is a plain accessor decorator, so the~~ cast only adds a~~\n //~~ compile-time ~~field-type~~ ~~constraint~~ ~~with~~ no ~~runtime counterpart~~\n return createAccessorDecorator<TFallback>(key, {\n converter,\n fallback,\n hasFallback: fallback !== undefined,\n required: false,\n schema: undefined\n }) as EnvaptAccessorDecorator<TFallback>;\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Boolean, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptAccessorDecorator<boolean>;\nexport function EnvBool(key: EnvKeyInput): EnvaptAccessorDecorator<boolean \| undefined>;\nexport function EnvBool(key: EnvKeyInput, fallback?: boolean): EnvaptAccessorDecorator<boolean \| undefined> {\n return sugar(Converters.Boolean, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvNum(key: EnvKeyInput, fallback: number): EnvaptAccessorDecorator<number>;\nexport function EnvNum(key: EnvKeyInput): EnvaptAccessorDecorator<number \| undefined>;\nexport function EnvNum(key: EnvKeyInput, fallback?: number): EnvaptAccessorDecorator<number \| undefined> {\n return sugar(Converters.Number, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvStr(key: EnvKeyInput, fallback: string): EnvaptAccessorDecorator<string>;\nexport function EnvStr(key: EnvKeyInput): EnvaptAccessorDecorator<string \| undefined>;\nexport function EnvStr(key: EnvKeyInput, fallback?: string): EnvaptAccessorDecorator<string \| undefined> {\n return sugar(Converters.String, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Time, fallback })`. The fallback is a\n * millisecond number or a time string (`'15m'`), and the resolved value is always milliseconds.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptAccessorDecorator<number>;\nexport function EnvTime(key: EnvKeyInput): EnvaptAccessorDecorator<number \| undefined>;\nexport function EnvTime(key: EnvKeyInput, fallback?: TimeFallback): EnvaptAccessorDecorator<number \| undefined> {\n return sugar(Converters.Time, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback is a ~~`URL`\~~n * ~~instance, not a~~ URL ~~string~~.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptAccessorDecorator<URL>;\nexport function EnvUrl(key: EnvKeyInput): EnvaptAccessorDecorator<URL \| undefined>;\nexport function EnvUrl(key: EnvKeyInput, fallback?: URL): EnvaptAccessorDecorator<URL \| undefined> {\n return sugar(Converters.Url, key, fallback);\n}\n/ v8 ignore stop */\n"],"mappings":"qIAOA,SAAS,EACL,EACA,EACA,EACkC,~~CAGlC~~,OAAO,EAAmC,EAAK,CAC3C,YACA,WACA,YAAa,IAAa,IAAA,GAC1B,SAAU,GACV,OAAQ,IAAA,EACZ,CAAC,CACL,CASA,SAAgB,EAAQ,EAAkB,EAAkE,CACxG,OAAO,EAAM,EAAW,QAAS,EAAK,CAAQ,CAClD,CASA,SAAgB,EAAO,EAAkB,EAAgE,CACrG,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CASA,SAAgB,EAAO,EAAkB,EAAgE,CACrG,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CAUA,SAAgB,EAAQ,EAAkB,EAAsE,CAC5G,OAAO,EAAM,EAAW,KAAM,EAAK,CAAQ,CAC/C,CAUA,SAAgB,EAAO,EAAkB,EAA0D,CAC/F,OAAO,EAAM,EAAW,IAAK,EAAK,CAAQ,CAC9C"}
1	+ {"version":3,"file":"SugarDecorators.mjs","names":[],"sources":["../../../../src/decorators/modern/SugarDecorators.ts"],"sourcesContent":["import { createAccessorDecorator } from './createAccessorDecorator';\nimport { Converters } from '../../converters';\n\nimport type { ConverterToken } from '../../converters';\nimport type { EnvaptAccessorDecorator, EnvKeyInput, TimeFallback } from '../../types';\n\n/* v8 ignore start -- @preserve the tsc stage3-emit tests cover these because oxc (vitest's transform) leaves context.name unset on modern accessor decorators /\nfunction sugar<TFallback>(\n converter: ConverterToken,\n key: EnvKeyInput,\n fallback: TFallback \| undefined\n): EnvaptAccessorDecorator<TFallback> {\n // the cast only adds a compile-time check on the field type\n return createAccessorDecorator<TFallback>(key, {\n converter,\n fallback,\n hasFallback: fallback !== undefined,\n required: false,\n schema: undefined\n }) as EnvaptAccessorDecorator<TFallback>;\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Boolean, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvBool(key: EnvKeyInput, fallback: boolean): EnvaptAccessorDecorator<boolean>;\nexport function EnvBool(key: EnvKeyInput): EnvaptAccessorDecorator<boolean \| undefined>;\nexport function EnvBool(key: EnvKeyInput, fallback?: boolean): EnvaptAccessorDecorator<boolean \| undefined> {\n return sugar(Converters.Boolean, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvNum(key: EnvKeyInput, fallback: number): EnvaptAccessorDecorator<number>;\nexport function EnvNum(key: EnvKeyInput): EnvaptAccessorDecorator<number \| undefined>;\nexport function EnvNum(key: EnvKeyInput, fallback?: number): EnvaptAccessorDecorator<number \| undefined> {\n return sugar(Converters.Number, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvStr(key: EnvKeyInput, fallback: string): EnvaptAccessorDecorator<string>;\nexport function EnvStr(key: EnvKeyInput): EnvaptAccessorDecorator<string \| undefined>;\nexport function EnvStr(key: EnvKeyInput, fallback?: string): EnvaptAccessorDecorator<string \| undefined> {\n return sugar(Converters.String, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Time, fallback })`. The fallback is a\n * millisecond number or a time string (`'15m'`), and the resolved value is always milliseconds.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvTime(key: EnvKeyInput, fallback: TimeFallback): EnvaptAccessorDecorator<number>;\nexport function EnvTime(key: EnvKeyInput): EnvaptAccessorDecorator<number \| undefined>;\nexport function EnvTime(key: EnvKeyInput, fallback?: TimeFallback): EnvaptAccessorDecorator<number \| undefined> {\n return sugar(Converters.Time, key, fallback);\n}\n\n/\n Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback must be a\n * `URL` instance.\n * @public\n * @see {@link https://envapt.materwelon.dev/docs/decorators#shorthand-decorators}\n /\nexport function EnvUrl(key: EnvKeyInput, fallback: URL): EnvaptAccessorDecorator<URL>;\nexport function EnvUrl(key: EnvKeyInput): EnvaptAccessorDecorator<URL \| undefined>;\nexport function EnvUrl(key: EnvKeyInput, fallback?: URL): EnvaptAccessorDecorator<URL \| undefined> {\n return sugar(Converters.Url, key, fallback);\n}\n/ v8 ignore stop */\n"],"mappings":"qIAOA,SAAS,EACL,EACA,EACA,EACkC,CAElC,OAAO,EAAmC,EAAK,CAC3C,YACA,WACA,YAAa,IAAa,IAAA,GAC1B,SAAU,GACV,OAAQ,IAAA,EACZ,CAAC,CACL,CASA,SAAgB,EAAQ,EAAkB,EAAkE,CACxG,OAAO,EAAM,EAAW,QAAS,EAAK,CAAQ,CAClD,CASA,SAAgB,EAAO,EAAkB,EAAgE,CACrG,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CASA,SAAgB,EAAO,EAAkB,EAAgE,CACrG,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CAUA,SAAgB,EAAQ,EAAkB,EAAsE,CAC5G,OAAO,EAAM,EAAW,KAAM,EAAK,CAAQ,CAC/C,CAUA,SAAgB,EAAO,EAAkB,EAA0D,CAC/F,OAAO,EAAM,EAAW,IAAK,EAAK,CAAQ,CAC9C"}

package/dist/portable/decorators/modern/createAccessorDecorator.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"createAccessorDecorator.mjs","names":[],"sources":["../../../../src/decorators/modern/createAccessorDecorator.ts"],"sourcesContent":["import { EnvaptError, EnvaptErrorCodes } from '../../infra/Error';\nimport { decoratorCacheKey, resolveDecoratorValue } from '../resolveDecoratorValue';\n\nimport type { EnvKeyInput } from '../../types';\nimport type { DecoratorConfig } from '../resolveDecoratorValue';\n\n/* v8 ignore start -- @preserve oxc (vitest's transform) ~~breaks~~ ~~modern accessor decorators (~~context.name unset), so ~~the~~ ~~tsc~~ ~~stage3-emit~~ ~~harness covers these, not vitest~~ /\nexport function createAccessorDecorator<TFallback>(key: EnvKeyInput, config: DecoratorConfig<TFallback>) {\n return function <This, Value>(\n _target: ClassAccessorDecoratorTarget<This, Value>,\n context: ClassAccessorDecoratorContext<This, Value>\n ): ClassAccessorDecoratorResult<This, Value> {\n const name: string \| symbol \| undefined = context.name;\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- a broken Stage 3 transform can leave context.name unset, which would collapse every accessor to one cache key\n if (name === undefined) {\n throw new EnvaptError(\n EnvaptErrorCodes.InvalidUserDefinedConfig,\n 'The runtime did not provide the accessor name to @Envapt, this Stage 3 decorator transform is unsupported.'\n );\n }\n const propKey = String(name);\n\n return {\n get(this: This): Value {\n const self = this as object;\n // ~~derive~~ ~~static-ness~~ ~~from `this`~~ (~~the class is a function, an instance is not~~) ~~rather~~ ~~than\n //~~ context.static, ~~which some transformers (oxc) leave~~ unset~~, collapsing every owner to Function~~\n const isStatic = typeof self === 'function';\n const owner = isStatic ? self : self.constructor;\n const cacheKey = decoratorCacheKey(owner, isStatic, propKey);\n return resolveDecoratorValue(key, config, cacheKey) as Value;\n },\n set(): void {\n throw new EnvaptError(\n EnvaptErrorCodes.InvalidUserDefinedConfig,\n `Cannot assign to \"${propKey}\". @Envapt accessor properties resolve from the environment and are read-only.`\n );\n }\n };\n };\n}\n/ v8 ignore stop */\n"],"mappings":"gJAOA,SAAgB,EAAmC,EAAkB,EAAoC,CACrG,OAAO,SACH,EACA,EACyC,CACzC,IAAM,EAAoC,EAAQ,KAElD,GAAI,IAAS,IAAA,GACT,MAAM,IAAI,EAAA,IAEN,4GACJ,EAEJ,IAAM,EAAU,OAAO,CAAI,EAE3B,MAAO,CACH,KAAuB,CACnB,IAAM,EAAO,~~KAGP~~,EAAW,OAAO,GAAS,WAC3B,EAAQ,EAAW,EAAO,EAAK,YAC/B,EAAW,EAAkB,EAAO,EAAU,CAAO,EAC3D,OAAO,EAAsB,EAAK,EAAQ,CAAQ,CACtD,EACA,KAAY,CACR,MAAM,IAAI,EAAA,IAEN,qBAAqB,EAAQ,+EACjC,CACJ,CACJ,CACJ,CACJ"}
1	+ {"version":3,"file":"createAccessorDecorator.mjs","names":[],"sources":["../../../../src/decorators/modern/createAccessorDecorator.ts"],"sourcesContent":["import { EnvaptError, EnvaptErrorCodes } from '../../infra/Error';\nimport { decoratorCacheKey, resolveDecoratorValue } from '../resolveDecoratorValue';\n\nimport type { EnvKeyInput } from '../../types';\nimport type { DecoratorConfig } from '../resolveDecoratorValue';\n\n/* v8 ignore start -- @preserve the tsc stage3-emit tests cover these because oxc (vitest's transform) leaves context.name unset on modern accessor decorators /\nexport function createAccessorDecorator<TFallback>(key: EnvKeyInput, config: DecoratorConfig<TFallback>) {\n return function <This, Value>(\n _target: ClassAccessorDecoratorTarget<This, Value>,\n context: ClassAccessorDecoratorContext<This, Value>\n ): ClassAccessorDecoratorResult<This, Value> {\n const name: string \| symbol \| undefined = context.name;\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- a broken Stage 3 transform can leave context.name unset, which would collapse every accessor to one cache key\n if (name === undefined) {\n throw new EnvaptError(\n EnvaptErrorCodes.InvalidUserDefinedConfig,\n 'The runtime did not provide the accessor name to @Envapt, this Stage 3 decorator transform is unsupported.'\n );\n }\n const propKey = String(name);\n\n return {\n get(this: This): Value {\n const self = this as object;\n // some transforms (oxc) leave context.static unset\n const isStatic = typeof self === 'function';\n const owner = isStatic ? self : self.constructor;\n const cacheKey = decoratorCacheKey(owner, isStatic, propKey);\n return resolveDecoratorValue(key, config, cacheKey) as Value;\n },\n set(): void {\n throw new EnvaptError(\n EnvaptErrorCodes.InvalidUserDefinedConfig,\n `Cannot assign to \"${propKey}\". @Envapt accessor properties resolve from the environment and are read-only.`\n );\n }\n };\n };\n}\n/ v8 ignore stop */\n"],"mappings":"gJAOA,SAAgB,EAAmC,EAAkB,EAAoC,CACrG,OAAO,SACH,EACA,EACyC,CACzC,IAAM,EAAoC,EAAQ,KAElD,GAAI,IAAS,IAAA,GACT,MAAM,IAAI,EAAA,IAEN,4GACJ,EAEJ,IAAM,EAAU,OAAO,CAAI,EAE3B,MAAO,CACH,KAAuB,CACnB,IAAM,EAAO,KAEP,EAAW,OAAO,GAAS,WAC3B,EAAQ,EAAW,EAAO,EAAK,YAC/B,EAAW,EAAkB,EAAO,EAAU,CAAO,EAC3D,OAAO,EAAsB,EAAK,EAAQ,CAAQ,CACtD,EACA,KAAY,CACR,MAAM,IAAI,EAAA,IAEN,qBAAqB,EAAQ,+EACjC,CACJ,CACJ,CACJ,CACJ"}

package/dist/portable/decorators/resolveDecoratorValue.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resolveDecoratorValue.mjs","names":[],"sources":["../../../src/decorators/resolveDecoratorValue.ts"],"sourcesContent":["import { ValueConverter } from '../converters';\nimport { isMissing } from '../core/missing';\nimport { cache } from '../core/state';\nimport { Envapter } from '../engine/Envapter';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { StandardSchemaV1 } from '../infra/StandardSchema';\nimport type { EnvaptConverter, EnvKeyInput } from '../types';\n\nexport interface DecoratorConfig<TFallback> {\n fallback: TFallback \| undefined;\n converter: EnvaptConverter<TFallback> \| undefined;\n hasFallback: boolean;\n required: boolean;\n schema: StandardSchemaV1 \| undefined;\n}\n\nfunction formatKeyForError(key: EnvKeyInput): string {\n return Array.isArray(key) ? `[${key.join(', ')}]` : String(key);\n}\n\nconst classIds = new WeakMap<object, number>();\nlet nextClassId = 0;\n\n// keyed on the ~~constructor~~ object's ~~identity~~ so two ~~same-named~~ classes ~~(and~~ a ~~same-named~~\~~n// static/instance pair) stay in separate cache slots\~~nexport function decoratorCacheKey(owner: object, isStatic: boolean, prop: string): string {\n let id = classIds.get(owner);\n if (id === undefined) {\n id = nextClassId++;\n classIds.set(owner, id);\n }\n return `${id}.${isStatic ? 'static' : 'instance'}.${prop}`;\n}\n\nexport function resolveDecoratorValue<TFallback>(\n key: EnvKeyInput,\n config: DecoratorConfig<TFallback>,\n cacheKey: string\n): TFallback \| undefined {\n const { fallback, converter, hasFallback, required, schema } = config;\n\n // ~~cache.~~has ~~guards~~ ~~the read so~~ a ~~cached undefined counts as~~ resolved (a ~~converter~~ ~~returning\n //~~ undefined~~, or a missing no-fallback read) and later accesses skip re-resolving~~\n if (cache.has(cacheKey)) return cache.get(cacheKey) as TFallback \| undefined;\n\n const envapter = new Envapter();\n\n if (required && schema === undefined) {\n const rawValue = envapter.getRaw(key);\n if (isMissing(rawValue)) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${formatKeyForError(key)}\" is missing or empty.`\n );\n }\n }\n\n const valueConverter = new ValueConverter(envapter);\n const value =\n schema !== undefined\n ? (valueConverter.convertWithSchema(key, schema, fallback, hasFallback) as TFallback)\n : valueConverter.convertValue(key, fallback, converter, hasFallback);\n\n cache.set(cacheKey, value);\n return value;\n}\n"],"mappings":"+PAiBA,SAAS,EAAkB,EAA0B,CACjD,OAAO,MAAM,QAAQ,CAAG,EAAI,IAAI,EAAI,KAAK,IAAI,EAAE,GAAK,OAAO,CAAG,CAClE,CAEA,MAAM,EAAW,IAAI,QACrB,IAAI,EAAc,~~EAIlB~~,SAAgB,EAAkB,EAAe,EAAmB,EAAsB,CACtF,IAAI,EAAK,EAAS,IAAI,CAAK,EAK3B,OAJI,IAAO,IAAA,KACP,EAAK,IACL,EAAS,IAAI,EAAO,CAAE,GAEnB,GAAG,EAAG,GAAG,EAAW,SAAW,WAAW,GAAG,GACxD,CAEA,SAAgB,EACZ,EACA,EACA,EACqB,CACrB,GAAM,CAAE,WAAU,YAAW,cAAa,WAAU,UAAW,~~EAI~~/D,GAAI,EAAM,IAAI,CAAQ,EAAG,OAAO,EAAM,IAAI,CAAQ,EAElD,IAAM,EAAW,IAAI,EAErB,GAAI,GAAY,IAAW,IAAA,GAAW,CAClC,IAAM,EAAW,EAAS,OAAO,CAAG,EACpC,GAAI,EAAU,CAAQ,EAClB,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAkB,CAAG,EAAE,uBAC7D,CAER,CAEA,IAAM,EAAiB,IAAI,EAAe,CAAQ,EAC5C,EACF,IAAW,IAAA,GAEL,EAAe,aAAa,EAAK,EAAU,EAAW,CAAW,EADhE,EAAe,kBAAkB,EAAK,EAAQ,EAAU,CAAW,EAI9E,OADA,EAAM,IAAI,EAAU,CAAK,EAClB,CACX"}
1	+ {"version":3,"file":"resolveDecoratorValue.mjs","names":[],"sources":["../../../src/decorators/resolveDecoratorValue.ts"],"sourcesContent":["import { ValueConverter } from '../converters';\nimport { isMissing } from '../core/missing';\nimport { cache } from '../core/state';\nimport { Envapter } from '../engine/Envapter';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { StandardSchemaV1 } from '../infra/StandardSchema';\nimport type { EnvaptConverter, EnvKeyInput } from '../types';\n\nexport interface DecoratorConfig<TFallback> {\n fallback: TFallback \| undefined;\n converter: EnvaptConverter<TFallback> \| undefined;\n hasFallback: boolean;\n required: boolean;\n schema: StandardSchemaV1 \| undefined;\n}\n\nfunction formatKeyForError(key: EnvKeyInput): string {\n return Array.isArray(key) ? `[${key.join(', ')}]` : String(key);\n}\n\nconst classIds = new WeakMap<object, number>();\nlet nextClassId = 0;\n\n// keyed on the class object because two classes can share a name\nexport function decoratorCacheKey(owner: object, isStatic: boolean, prop: string): string {\n let id = classIds.get(owner);\n if (id === undefined) {\n id = nextClassId++;\n classIds.set(owner, id);\n }\n return `${id}.${isStatic ? 'static' : 'instance'}.${prop}`;\n}\n\nexport function resolveDecoratorValue<TFallback>(\n key: EnvKeyInput,\n config: DecoratorConfig<TFallback>,\n cacheKey: string\n): TFallback \| undefined {\n const { fallback, converter, hasFallback, required, schema } = config;\n\n // has() because a resolved value can be undefined\n if (cache.has(cacheKey)) return cache.get(cacheKey) as TFallback \| undefined;\n\n const envapter = new Envapter();\n\n if (required && schema === undefined) {\n const rawValue = envapter.getRaw(key);\n if (isMissing(rawValue)) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Required environment variable \"${formatKeyForError(key)}\" is missing or empty.`\n );\n }\n }\n\n const valueConverter = new ValueConverter(envapter);\n const value =\n schema !== undefined\n ? (valueConverter.convertWithSchema(key, schema, fallback, hasFallback) as TFallback)\n : valueConverter.convertValue(key, fallback, converter, hasFallback);\n\n cache.set(cacheKey, value);\n return value;\n}\n"],"mappings":"+PAiBA,SAAS,EAAkB,EAA0B,CACjD,OAAO,MAAM,QAAQ,CAAG,EAAI,IAAI,EAAI,KAAK,IAAI,EAAE,GAAK,OAAO,CAAG,CAClE,CAEA,MAAM,EAAW,IAAI,QACrB,IAAI,EAAc,EAGlB,SAAgB,EAAkB,EAAe,EAAmB,EAAsB,CACtF,IAAI,EAAK,EAAS,IAAI,CAAK,EAK3B,OAJI,IAAO,IAAA,KACP,EAAK,IACL,EAAS,IAAI,EAAO,CAAE,GAEnB,GAAG,EAAG,GAAG,EAAW,SAAW,WAAW,GAAG,GACxD,CAEA,SAAgB,EACZ,EACA,EACA,EACqB,CACrB,GAAM,CAAE,WAAU,YAAW,cAAa,WAAU,UAAW,EAG/D,GAAI,EAAM,IAAI,CAAQ,EAAG,OAAO,EAAM,IAAI,CAAQ,EAElD,IAAM,EAAW,IAAI,EAErB,GAAI,GAAY,IAAW,IAAA,GAAW,CAClC,IAAM,EAAW,EAAS,OAAO,CAAG,EACpC,GAAI,EAAU,CAAQ,EAClB,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAkB,CAAG,EAAE,uBAC7D,CAER,CAEA,IAAM,EAAiB,IAAI,EAAe,CAAQ,EAC5C,EACF,IAAW,IAAA,GAEL,EAAe,aAAa,EAAK,EAAU,EAAW,CAAW,EADhE,EAAe,kBAAkB,EAAK,EAAQ,EAAU,CAAW,EAI9E,OADA,EAAM,IAAI,EAAU,CAAK,EAClB,CACX"}

package/dist/portable/engine/Envapter.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"Envapter.mjs","names":[],"sources":["../../../src/engine/Envapter.ts"],"sourcesContent":["import { AdvancedMethods } from '../core';\nimport { resolveRequired } from '../core/AdvancedMethods';\nimport { resolveKeyInput, templateResolver } from '../core/engine';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { EnvKeyInput } from '../types';\n\nexport { Environment } from '../core';\n\n/*\n Main configuration class for environment variable management.\n \n Provides both static and instance methods for retrieving typed environment variables\n * with support for template resolution, multiple .env files, and environment detection.\n \n Extend your own classes from this to define properties with \\@Envapt decorators and get access to environment-variable methods.\n \n @example\n * ```ts\n * // Static usage\n * const port = Envapter.getNumber('PORT', 3000);\n * const url = Envapter.get('API_URL', 'http://localhost');\n * const replica = Envapter.get(['READONLY_URL', 'DATABASE_URL'], 'sqlite://memory');\n \n // Instance usage\n * const env = new Envapter();\n * const dbUrl = env.get('DATABASE_URL', 'sqlite://memory');\n * const primaryHost = env.get(['PRIMARY_HOST', 'SECONDARY_HOST']);\n * ```\n \n @public\n /\nexport class Envapter extends AdvancedMethods {\n /\n Tagged template literal for resolving environment variables in template strings.\n \n @example\n * ```ts\n * // Given API_HOST=api.example.com and API_PORT=8080 in environment\n * const endpoint = Envapter.resolve`Connecting to ${'API_HOST'}:${'API_PORT'}`;\n * // Returns: \"Connecting to api.example.com:8080\"\n \n // Works with template variables in .env too:\n * // API_URL=https://${API_HOST}:${API_PORT}\n * const message = Envapter.resolve`Service endpoint: ${'API_URL'}`;\n * // Returns: \"Service endpoint: https://api.example.com:8080\"\n * ```\n * @see {@link https://envapt.materwelon.dev/docs/templates#the-resolve-tagged-template}\n /\n static resolve(strings: TemplateStringsArray, ...keys: string[]): string {\n const strict = Envapter.strict;\n return strings.reduce((result, string, i) => {\n const envKey = keys[i];\n if (!envKey) return result + string;\n const raw = super.get(envKey, '');\n if (strict && raw.trim() === '') {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Cannot resolve template variable \"\\${${envKey}}\": value is missing or empty.`\n );\n }\n return result + string + raw;\n }, '');\n }\n\n /\n @see {@link Envapter.resolve}\n /\n resolve(strings: TemplateStringsArray, ...keys: string[]): string {\n return Envapter.resolve(strings, ...keys);\n }\n\n /\n Assert that one or more environment variables are present and non-empty after template\n * resolution. Throws `MissingEnvValue` listing every missing key. A whitespace-only value\n * counts as missing only under strict mode.\n \n For a typed required read in functional code, use `Envapter.getRequired(key, converter)`.\n \n @example\n * ```ts\n * Envapter.require('DATABASE_URL');\n * Envapter.require('DATABASE_URL', 'API_KEY', 'SENTRY_DSN');\n * ```\n /\n static require(...keys: [string, ...string[]]): void {\n const missing = keys.filter((k) => resolveRequired(resolveKeyInput(k), templateResolver).value === undefined);\n\n if (missing.length > 0) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Missing required environment variables: ${missing.join(', ')}.`\n );\n }\n }\n\n /\n @see {@link Envapter.require}\n /\n require(...keys: [string, ...string[]]): void {\n Envapter.require(...keys);\n }\n\n /\n Check whether `key` has a value, with the same missing semantics as `getRequired`.\n * Under strict mode an unresolvable template in an ordered key list ends the scan early\n * and counts as absent. Returns `true` exactly when a required read of the same key\n * finds a value.\n \n @example\n * ```ts\n * if (!Envapter.has('DATABASE_URL')) throw new MyStartupError('DATABASE_URL');\n * ```\n * @see {@link https://envapt.materwelon.dev/docs/envapter#fail-fast-on-missing-values}\n /\n static has(key: EnvKeyInput): boolean {\n try {\n return resolveRequired(resolveKeyInput(key), templateResolver).value !== undefined;\n } catch (error) {\n // ~~under~~ strict an ~~unresolvable template~~ throws MissingEnvValue, ~~and~~ ~~that~~ ~~read~~ ~~counts as absent~~\n if (error instanceof EnvaptError && error.code === EnvaptErrorCodes.MissingEnvValue) return false;\n throw error;\n }\n }\n\n /\n @see {@link Envapter.has}\n */\n has(key: EnvKeyInput): boolean {\n return Envapter.has(key);\n }\n}\n"],"mappings":"qQAgCA,IAAa,EAAb,MAAa,UAAiB,CAAgB,CAiB1C,OAAO,QAAQ,EAA+B,GAAG,EAAwB,CACrE,IAAM,EAAS,EAAS,OACxB,OAAO,EAAQ,QAAQ,EAAQ,EAAQ,IAAM,CACzC,IAAM,EAAS,EAAK,GACpB,GAAI,CAAC,EAAQ,OAAO,EAAS,EAC7B,IAAM,EAAM,MAAM,IAAI,EAAQ,EAAE,EAChC,GAAI,GAAU,EAAI,KAAK,IAAM,GACzB,MAAM,IAAI,EAAA,IAEN,wCAAwC,EAAO,+BACnD,EAEJ,OAAO,EAAS,EAAS,CAC7B,EAAG,EAAE,CACT,CAKA,QAAQ,EAA+B,GAAG,EAAwB,CAC9D,OAAO,EAAS,QAAQ,EAAS,GAAG,CAAI,CAC5C,CAeA,OAAO,QAAQ,GAAG,EAAmC,CACjD,IAAM,EAAU,EAAK,OAAQ,GAAM,EAAgB,EAAgB,CAAC,EAAG,CAAgB,CAAC,CAAC,QAAU,IAAA,EAAS,EAE5G,GAAI,EAAQ,OAAS,EACjB,MAAM,IAAI,EAAA,IAEN,2CAA2C,EAAQ,KAAK,IAAI,EAAE,EAClE,CAER,CAKA,QAAQ,GAAG,EAAmC,CAC1C,EAAS,QAAQ,GAAG,CAAI,CAC5B,CAcA,OAAO,IAAI,EAA2B,CAClC,GAAI,CACA,OAAO,EAAgB,EAAgB,CAAG,EAAG,CAAgB,CAAC,CAAC,QAAU,IAAA,EAC7E,OAAS,EAAO,CAEZ,GAAI,aAAiB,GAAe,EAAM,OAAA,IAA2C,MAAO,GAC5F,MAAM,CACV,CACJ,CAKA,IAAI,EAA2B,CAC3B,OAAO,EAAS,IAAI,CAAG,CAC3B,CACJ"}
1	+ {"version":3,"file":"Envapter.mjs","names":[],"sources":["../../../src/engine/Envapter.ts"],"sourcesContent":["import { AdvancedMethods } from '../core';\nimport { resolveRequired } from '../core/AdvancedMethods';\nimport { resolveKeyInput, templateResolver } from '../core/engine';\nimport { EnvaptError, EnvaptErrorCodes } from '../infra/Error';\n\nimport type { EnvKeyInput } from '../types';\n\nexport { Environment } from '../core';\n\n/*\n Main configuration class for environment variable management.\n \n Provides both static and instance methods for retrieving typed environment variables\n * with support for template resolution, multiple .env files, and environment detection.\n \n Extend your own classes from this to define properties with \\@Envapt decorators and get access to environment-variable methods.\n \n @example\n * ```ts\n * // Static usage\n * const port = Envapter.getNumber('PORT', 3000);\n * const url = Envapter.get('API_URL', 'http://localhost');\n * const replica = Envapter.get(['READONLY_URL', 'DATABASE_URL'], 'sqlite://memory');\n \n // Instance usage\n * const env = new Envapter();\n * const dbUrl = env.get('DATABASE_URL', 'sqlite://memory');\n * const primaryHost = env.get(['PRIMARY_HOST', 'SECONDARY_HOST']);\n * ```\n \n @public\n /\nexport class Envapter extends AdvancedMethods {\n /\n Tagged template literal for resolving environment variables in template strings.\n \n @example\n * ```ts\n * // Given API_HOST=api.example.com and API_PORT=8080 in environment\n * const endpoint = Envapter.resolve`Connecting to ${'API_HOST'}:${'API_PORT'}`;\n * // Returns: \"Connecting to api.example.com:8080\"\n \n // Works with template variables in .env too:\n * // API_URL=https://${API_HOST}:${API_PORT}\n * const message = Envapter.resolve`Service endpoint: ${'API_URL'}`;\n * // Returns: \"Service endpoint: https://api.example.com:8080\"\n * ```\n * @see {@link https://envapt.materwelon.dev/docs/templates#the-resolve-tagged-template}\n /\n static resolve(strings: TemplateStringsArray, ...keys: string[]): string {\n const strict = Envapter.strict;\n return strings.reduce((result, string, i) => {\n const envKey = keys[i];\n if (!envKey) return result + string;\n const raw = super.get(envKey, '');\n if (strict && raw.trim() === '') {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Cannot resolve template variable \"\\${${envKey}}\": value is missing or empty.`\n );\n }\n return result + string + raw;\n }, '');\n }\n\n /\n @see {@link Envapter.resolve}\n /\n resolve(strings: TemplateStringsArray, ...keys: string[]): string {\n return Envapter.resolve(strings, ...keys);\n }\n\n /\n Assert that one or more environment variables are present and non-empty after template\n * resolution. Throws `MissingEnvValue` listing every missing key. A whitespace-only value\n * counts as missing only under strict mode.\n \n For a typed required read in functional code, use `Envapter.getRequired(key, converter)`.\n \n @example\n * ```ts\n * Envapter.require('DATABASE_URL');\n * Envapter.require('DATABASE_URL', 'API_KEY', 'SENTRY_DSN');\n * ```\n /\n static require(...keys: [string, ...string[]]): void {\n const missing = keys.filter((k) => resolveRequired(resolveKeyInput(k), templateResolver).value === undefined);\n\n if (missing.length > 0) {\n throw new EnvaptError(\n EnvaptErrorCodes.MissingEnvValue,\n `Missing required environment variables: ${missing.join(', ')}.`\n );\n }\n }\n\n /\n @see {@link Envapter.require}\n /\n require(...keys: [string, ...string[]]): void {\n Envapter.require(...keys);\n }\n\n /\n Check whether `key` has a value, with the same missing semantics as `getRequired`.\n * Under strict mode an unresolvable template in an ordered key list ends the scan early\n * and counts as absent. Returns `true` exactly when a required read of the same key\n * finds a value.\n \n @example\n * ```ts\n * if (!Envapter.has('DATABASE_URL')) throw new MyStartupError('DATABASE_URL');\n * ```\n * @see {@link https://envapt.materwelon.dev/docs/envapter#fail-fast-on-missing-values}\n /\n static has(key: EnvKeyInput): boolean {\n try {\n return resolveRequired(resolveKeyInput(key), templateResolver).value !== undefined;\n } catch (error) {\n // strict mode throws MissingEnvValue for an unresolvable template\n if (error instanceof EnvaptError && error.code === EnvaptErrorCodes.MissingEnvValue) return false;\n throw error;\n }\n }\n\n /\n @see {@link Envapter.has}\n */\n has(key: EnvKeyInput): boolean {\n return Envapter.has(key);\n }\n}\n"],"mappings":"qQAgCA,IAAa,EAAb,MAAa,UAAiB,CAAgB,CAiB1C,OAAO,QAAQ,EAA+B,GAAG,EAAwB,CACrE,IAAM,EAAS,EAAS,OACxB,OAAO,EAAQ,QAAQ,EAAQ,EAAQ,IAAM,CACzC,IAAM,EAAS,EAAK,GACpB,GAAI,CAAC,EAAQ,OAAO,EAAS,EAC7B,IAAM,EAAM,MAAM,IAAI,EAAQ,EAAE,EAChC,GAAI,GAAU,EAAI,KAAK,IAAM,GACzB,MAAM,IAAI,EAAA,IAEN,wCAAwC,EAAO,+BACnD,EAEJ,OAAO,EAAS,EAAS,CAC7B,EAAG,EAAE,CACT,CAKA,QAAQ,EAA+B,GAAG,EAAwB,CAC9D,OAAO,EAAS,QAAQ,EAAS,GAAG,CAAI,CAC5C,CAeA,OAAO,QAAQ,GAAG,EAAmC,CACjD,IAAM,EAAU,EAAK,OAAQ,GAAM,EAAgB,EAAgB,CAAC,EAAG,CAAgB,CAAC,CAAC,QAAU,IAAA,EAAS,EAE5G,GAAI,EAAQ,OAAS,EACjB,MAAM,IAAI,EAAA,IAEN,2CAA2C,EAAQ,KAAK,IAAI,EAAE,EAClE,CAER,CAKA,QAAQ,GAAG,EAAmC,CAC1C,EAAS,QAAQ,GAAG,CAAI,CAC5B,CAcA,OAAO,IAAI,EAA2B,CAClC,GAAI,CACA,OAAO,EAAgB,EAAgB,CAAG,EAAG,CAAgB,CAAC,CAAC,QAAU,IAAA,EAC7E,OAAS,EAAO,CAEZ,GAAI,aAAiB,GAAe,EAAM,OAAA,IAA2C,MAAO,GAC5F,MAAM,CACV,CACJ,CAKA,IAAI,EAA2B,CAC3B,OAAO,EAAS,IAAI,CAAG,CAC3B,CACJ"}

package/dist/portable/engine/PortableEnvapter.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"PortableEnvapter.mjs","names":[],"sources":["../../../src/engine/PortableEnvapter.ts"],"sourcesContent":["import { Envapter } from './Envapter';\nimport { portableFileApiRead, portableFileApiWrite } from './fileApiStub';\n\nimport type { EnvFileOptions } from '../infra/Dotenv';\nimport type { ProfilesConfig } from '../types';\n\n/*\n The browser/Workers/edge facade. {@link Envapter} with the filesystem-only config APIs ~~present~~ in\n * the type ~~but inert at runtime by default~~. Under the default `fileApiMode` of `'warn'` they warn once\n * and no-op (getters return an empty default matching their type, setters do nothing). `'throw'` ~~restores~~\n * ~~the~~ {@link EnvaptError} `FileApiUnsupported`. ~~The~~ ~~read~~ ~~side still throws~~ `NoSourceBound` on first read\n * until `useSource` binds a source.\n * @public\n */\nexport class PortableEnvapter extends Envapter {\n static get envPaths(): string[] {\n return portableFileApiRead('envPaths', []);\n }\n static set envPaths(_paths: string[] \| string) {\n portableFileApiWrite('envPaths');\n }\n\n static get baseDir(): string \| undefined {\n return portableFileApiRead('baseDir', undefined);\n }\n static set baseDir(_value: string \| URL \| undefined) {\n portableFileApiWrite('baseDir');\n }\n\n static get envFileOptions(): EnvFileOptions {\n return portableFileApiRead('envFileOptions', {});\n }\n static set envFileOptions(_config: EnvFileOptions) {\n portableFileApiWrite('envFileOptions');\n }\n\n static configureProfiles(_config: ProfilesConfig): void {\n portableFileApiWrite('configureProfiles');\n }\n\n static resetProfiles(): void {\n portableFileApiWrite('resetProfiles');\n }\n}\n"],"mappings":"~~4HAcA~~,IAAa,EAAb,cAAsC,CAAS,CAC3C,WAAW,UAAqB,CAC5B,OAAO,EAAoB,WAAY,CAAC,CAAC,CAC7C,CACA,WAAW,SAAS,EAA2B,CAC3C,EAAqB,UAAU,CACnC,CAEA,WAAW,SAA8B,CACrC,OAAO,EAAoB,UAAW,IAAA,EAAS,CACnD,CACA,WAAW,QAAQ,EAAkC,CACjD,EAAqB,SAAS,CAClC,CAEA,WAAW,gBAAiC,CACxC,OAAO,EAAoB,iBAAkB,CAAC,CAAC,CACnD,CACA,WAAW,eAAe,EAAyB,CAC/C,EAAqB,gBAAgB,CACzC,CAEA,OAAO,kBAAkB,EAA+B,CACpD,EAAqB,mBAAmB,CAC5C,CAEA,OAAO,eAAsB,CACzB,EAAqB,eAAe,CACxC,CACJ"}
1	+ {"version":3,"file":"PortableEnvapter.mjs","names":[],"sources":["../../../src/engine/PortableEnvapter.ts"],"sourcesContent":["import { Envapter } from './Envapter';\nimport { portableFileApiRead, portableFileApiWrite } from './fileApiStub';\n\nimport type { EnvFileOptions } from '../infra/Dotenv';\nimport type { ProfilesConfig } from '../types';\n\n/*\n The browser/Workers/edge facade. It is {@link Envapter} with the filesystem-only config APIs kept in\n * the type. Under the default `fileApiMode` of `'warn'` they warn once and no-op (getters return an\n * empty default matching their type and setters do nothing). `'throw'` makes them throw\n * {@link EnvaptError} `FileApiUnsupported`. Reads throw `NoSourceBound` until `useSource` binds a source.\n * @public\n */\nexport class PortableEnvapter extends Envapter {\n static get envPaths(): string[] {\n return portableFileApiRead('envPaths', []);\n }\n static set envPaths(_paths: string[] \| string) {\n portableFileApiWrite('envPaths');\n }\n\n static get baseDir(): string \| undefined {\n return portableFileApiRead('baseDir', undefined);\n }\n static set baseDir(_value: string \| URL \| undefined) {\n portableFileApiWrite('baseDir');\n }\n\n static get envFileOptions(): EnvFileOptions {\n return portableFileApiRead('envFileOptions', {});\n }\n static set envFileOptions(_config: EnvFileOptions) {\n portableFileApiWrite('envFileOptions');\n }\n\n static configureProfiles(_config: ProfilesConfig): void {\n portableFileApiWrite('configureProfiles');\n }\n\n static resetProfiles(): void {\n portableFileApiWrite('resetProfiles');\n }\n}\n"],"mappings":"4HAaA,IAAa,EAAb,cAAsC,CAAS,CAC3C,WAAW,UAAqB,CAC5B,OAAO,EAAoB,WAAY,CAAC,CAAC,CAC7C,CACA,WAAW,SAAS,EAA2B,CAC3C,EAAqB,UAAU,CACnC,CAEA,WAAW,SAA8B,CACrC,OAAO,EAAoB,UAAW,IAAA,EAAS,CACnD,CACA,WAAW,QAAQ,EAAkC,CACjD,EAAqB,SAAS,CAClC,CAEA,WAAW,gBAAiC,CACxC,OAAO,EAAoB,iBAAkB,CAAC,CAAC,CACnD,CACA,WAAW,eAAe,EAAyB,CAC/C,EAAqB,gBAAgB,CACzC,CAEA,OAAO,kBAAkB,EAA+B,CACpD,EAAqB,mBAAmB,CAC5C,CAEA,OAAO,eAAsB,CACzB,EAAqB,eAAe,CACxC,CACJ"}