envapt 5.1.1 → 5.2.0-next.0

package/dist/node/decorators/SugarDecorators.d.mts

@@ -0,0 +1,34 @@
+import { TimeFallback } from "../types/Conversion.mjs";
+import { EnvKeyInput } from "../types/Env.mjs";
+
+//#region src/decorators/SugarDecorators.d.ts
+/**
+ * Shorthand for `@Envapt(key, { converter: Converters.Boolean, fallback })`.
+ * @public
+ */
+declare function EnvBool(key: EnvKeyInput, fallback?: boolean): PropertyDecorator;
+/**
+ * Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.
+ * @public
+ */
+declare function EnvNum(key: EnvKeyInput, fallback?: number): PropertyDecorator;
+/**
+ * Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.
+ * @public
+ */
+declare function EnvStr(key: EnvKeyInput, fallback?: string): PropertyDecorator;
+/**
+ * Shorthand for `@Envapt(key, { converter: Converters.Time, fallback })`. The fallback is a
+ * millisecond number or a time string (`'15m'`); the resolved value is always milliseconds.
+ * @public
+ */
+declare function EnvTime(key: EnvKeyInput, fallback?: TimeFallback): PropertyDecorator;
+/**
+ * Shorthand for `@Envapt(key, { converter: Converters.Url, fallback })`. The fallback is a `URL`
+ * instance, not a URL string.
+ * @public
+ */
+declare function EnvUrl(key: EnvKeyInput, fallback?: URL): PropertyDecorator;
+//#endregion
+export { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl };
+//# sourceMappingURL=SugarDecorators.d.mts.map

package/dist/node/decorators/SugarDecorators.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SugarDecorators.d.mts","names":[],"sources":["../../../src/decorators/SugarDecorators.ts"],"mappings":";;;;;;;AAwBA;iBAAgB,OAAA,CAAQ,GAAA,EAAK,WAAA,EAAa,QAAA,aAAqB,iBAAiB;;;;;iBAQhE,MAAA,CAAO,GAAA,EAAK,WAAA,EAAa,QAAA,YAAoB,iBAAiB;;;AARE;AAQhF;iBAQgB,MAAA,CAAO,GAAA,EAAK,WAAA,EAAa,QAAA,YAAoB,iBAAiB;;;;;;iBAS9D,OAAA,CAAQ,GAAA,EAAK,WAAA,EAAa,QAAA,GAAW,YAAA,GAAe,iBAAA;;AAjBU;AAQ9E;;;iBAkBgB,MAAA,CAAO,GAAA,EAAK,WAAA,EAAa,QAAA,GAAW,GAAA,GAAM,iBAAA"}

package/dist/node/decorators/SugarDecorators.mjs

@@ -0,0 +1,2 @@
+import{Converters as e}from"../converters/Converters.mjs";import{createPropertyDecorator as t}from"./createPropertyDecorator.mjs";function n(e,n,r){return t(n,{converter:e,fallback:r,hasFallback:r!==void 0,required:!1,schema:void 0})}function r(t,r){return n(e.Boolean,t,r)}function i(t,r){return n(e.Number,t,r)}function a(t,r){return n(e.String,t,r)}function o(t,r){return n(e.Time,t,r)}function s(t,r){return n(e.Url,t,r)}export{r as EnvBool,i as EnvNum,a as EnvStr,o as EnvTime,s as EnvUrl};
+//# sourceMappingURL=SugarDecorators.mjs.map

package/dist/node/decorators/SugarDecorators.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SugarDecorators.mjs","names":[],"sources":["../../../src/decorators/SugarDecorators.ts"],"sourcesContent":["import { createPropertyDecorator } from './createPropertyDecorator';\nimport { Converters } from '../converters';\n\nimport type { ConverterToken } from '../converters';\nimport type { EnvKeyInput, TimeFallback } from '../types';\n\nfunction sugar<TFallback>(\n    converter: ConverterToken,\n    key: EnvKeyInput,\n    fallback: TFallback | undefined\n): PropertyDecorator {\n    return createPropertyDecorator<TFallback>(key, {\n        converter,\n        fallback,\n        hasFallback: fallback !== undefined,\n        required: false,\n        schema: undefined\n    });\n}\n\n/**\n * Shorthand for `@Envapt(key, { converter: Converters.Boolean, fallback })`.\n * @public\n */\nexport function EnvBool(key: EnvKeyInput, fallback?: boolean): PropertyDecorator {\n    return sugar(Converters.Boolean, key, fallback);\n}\n\n/**\n * Shorthand for `@Envapt(key, { converter: Converters.Number, fallback })`.\n * @public\n */\nexport function EnvNum(key: EnvKeyInput, fallback?: number): PropertyDecorator {\n    return sugar(Converters.Number, key, fallback);\n}\n\n/**\n * Shorthand for `@Envapt(key, { converter: Converters.String, fallback })`.\n * @public\n */\nexport function EnvStr(key: EnvKeyInput, fallback?: string): PropertyDecorator {\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'`); the resolved value is always milliseconds.\n * @public\n */\nexport function EnvTime(key: EnvKeyInput, fallback?: TimeFallback): PropertyDecorator {\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 */\nexport function EnvUrl(key: EnvKeyInput, fallback?: URL): PropertyDecorator {\n    return sugar(Converters.Url, key, fallback);\n}\n"],"mappings":"kIAMA,SAAS,EACL,EACA,EACA,EACiB,CACjB,OAAO,EAAmC,EAAK,CAC3C,YACA,WACA,YAAa,IAAa,IAAA,GAC1B,SAAU,GACV,OAAQ,IAAA,EACZ,CAAC,CACL,CAMA,SAAgB,EAAQ,EAAkB,EAAuC,CAC7E,OAAO,EAAM,EAAW,QAAS,EAAK,CAAQ,CAClD,CAMA,SAAgB,EAAO,EAAkB,EAAsC,CAC3E,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CAMA,SAAgB,EAAO,EAAkB,EAAsC,CAC3E,OAAO,EAAM,EAAW,OAAQ,EAAK,CAAQ,CACjD,CAOA,SAAgB,EAAQ,EAAkB,EAA4C,CAClF,OAAO,EAAM,EAAW,KAAM,EAAK,CAAQ,CAC/C,CAOA,SAAgB,EAAO,EAAkB,EAAmC,CACxE,OAAO,EAAM,EAAW,IAAK,EAAK,CAAQ,CAC9C"}

package/dist/node/decorators/createPropertyDecorator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPropertyDecorator.cjs","names":["EnvaptCache","Envapter","EnvaptError","ValueConverter"],"sources":["../../../src/decorators/createPropertyDecorator.ts"],"sourcesContent":["import { ValueConverter } from '../converters';\nimport { EnvaptCache } from '../core';\nimport { Envapter } from '../Envapter';\nimport { EnvaptError, EnvaptErrorCodes } from '../Error';\n\nimport type { StandardSchemaV1 } from '../StandardSchema';\nimport type { EnvaptConverter, EnvKeyInput } from '../types';\n\nfunction formatKeyForError(key: EnvKeyInput): string {\n    return Array.isArray(key) ? `[${key.join(', ')}]` : String(key);\n}\n\ninterface DecoratorConfig<TFallback> {\n    fallback: TFallback | undefined;\n    converter: EnvaptConverter<TFallback> | undefined;\n    hasFallback: boolean;\n    required: boolean;\n    schema: StandardSchemaV1 | undefined;\n}\n\nexport function createPropertyDecorator<TFallback>(\n    key: EnvKeyInput,\n    config: DecoratorConfig<TFallback>\n): PropertyDecorator {\n    const { fallback, converter, hasFallback, required, schema } = config;\n    return function (target: object, prop: string | symbol): void {\n        const propKey = String(prop);\n        // Distinguishing constructor (static) from prototype (instance) keeps same-named static and instance properties from colliding in the cache.\n        const className = typeof target === 'function' ? target.name : target.constructor.name;\n        const cacheKey = `${className}.${propKey}`;\n\n        Object.defineProperty(target, propKey, {\n            get: function () {\n                let value = EnvaptCache.get(cacheKey) as TFallback | null | undefined;\n\n                if (value === undefined) {\n                    const envapter = new Envapter();\n\n                    if (required && schema === undefined) {\n                        const rawValue = envapter.getRaw(key);\n                        if (rawValue === undefined || rawValue.trim() === '') {\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                    if (schema !== undefined) {\n                        value = valueConverter.convertWithSchema(key, schema, fallback, hasFallback) as TFallback;\n                    } else {\n                        value = valueConverter.convertValue(key, fallback, converter, hasFallback);\n                    }\n                    EnvaptCache.set(cacheKey, value);\n                }\n\n                return value;\n            },\n            configurable: false,\n            enumerable: true\n        });\n    };\n}\n"],"mappings":"iJAQA,SAAS,EAAkB,EAA0B,CACjD,OAAO,MAAM,QAAQ,CAAG,EAAI,IAAI,EAAI,KAAK,IAAI,EAAE,GAAK,OAAO,CAAG,CAClE,CAUA,SAAgB,EACZ,EACA,EACiB,CACjB,GAAM,CAAE,WAAU,YAAW,cAAa,WAAU,UAAW,EAC/D,OAAO,SAAU,EAAgB,EAA6B,CAC1D,IAAM,EAAU,OAAO,CAAI,EAGrB,EAAW,GADC,OAAO,GAAW,WAAa,EAAO,KAAO,EAAO,YAAY,KACpD,GAAG,IAEjC,OAAO,eAAe,EAAQ,EAAS,CACnC,IAAK,UAAY,CACb,IAAI,EAAQA,EAAAA,YAAY,IAAI,CAAQ,EAEpC,GAAI,IAAU,IAAA,GAAW,CACrB,IAAM,EAAW,IAAIC,EAAAA,SAErB,GAAI,GAAY,IAAW,IAAA,GAAW,CAClC,IAAM,EAAW,EAAS,OAAO,CAAG,EACpC,GAAI,IAAa,IAAA,IAAa,EAAS,KAAK,IAAM,GAC9C,MAAM,IAAIC,EAAAA,YAAAA,IAEN,kCAAkC,EAAkB,CAAG,EAAE,uBAC7D,CAER,CAEA,IAAM,EAAiB,IAAIC,EAAAA,eAAe,CAAQ,EAClD,AACI,EADA,IAAW,IAAA,GAGH,EAAe,aAAa,EAAK,EAAU,EAAW,CAAW,EAFjE,EAAe,kBAAkB,EAAK,EAAQ,EAAU,CAAW,EAI/E,EAAA,YAAY,IAAI,EAAU,CAAK,CACnC,CAEA,OAAO,CACX,EACA,aAAc,GACd,WAAY,EAChB,CAAC,CACL,CACJ"}

package/dist/node/decorators/createPropertyDecorator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPropertyDecorator.mjs","names":[],"sources":["../../../src/decorators/createPropertyDecorator.ts"],"sourcesContent":["import { ValueConverter } from '../converters';\nimport { EnvaptCache } from '../core';\nimport { Envapter } from '../Envapter';\nimport { EnvaptError, EnvaptErrorCodes } from '../Error';\n\nimport type { StandardSchemaV1 } from '../StandardSchema';\nimport type { EnvaptConverter, EnvKeyInput } from '../types';\n\nfunction formatKeyForError(key: EnvKeyInput): string {\n    return Array.isArray(key) ? `[${key.join(', ')}]` : String(key);\n}\n\ninterface DecoratorConfig<TFallback> {\n    fallback: TFallback | undefined;\n    converter: EnvaptConverter<TFallback> | undefined;\n    hasFallback: boolean;\n    required: boolean;\n    schema: StandardSchemaV1 | undefined;\n}\n\nexport function createPropertyDecorator<TFallback>(\n    key: EnvKeyInput,\n    config: DecoratorConfig<TFallback>\n): PropertyDecorator {\n    const { fallback, converter, hasFallback, required, schema } = config;\n    return function (target: object, prop: string | symbol): void {\n        const propKey = String(prop);\n        // Distinguishing constructor (static) from prototype (instance) keeps same-named static and instance properties from colliding in the cache.\n        const className = typeof target === 'function' ? target.name : target.constructor.name;\n        const cacheKey = `${className}.${propKey}`;\n\n        Object.defineProperty(target, propKey, {\n            get: function () {\n                let value = EnvaptCache.get(cacheKey) as TFallback | null | undefined;\n\n                if (value === undefined) {\n                    const envapter = new Envapter();\n\n                    if (required && schema === undefined) {\n                        const rawValue = envapter.getRaw(key);\n                        if (rawValue === undefined || rawValue.trim() === '') {\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                    if (schema !== undefined) {\n                        value = valueConverter.convertWithSchema(key, schema, fallback, hasFallback) as TFallback;\n                    } else {\n                        value = valueConverter.convertValue(key, fallback, converter, hasFallback);\n                    }\n                    EnvaptCache.set(cacheKey, value);\n                }\n\n                return value;\n            },\n            configurable: false,\n            enumerable: true\n        });\n    };\n}\n"],"mappings":"+MAQA,SAAS,EAAkB,EAA0B,CACjD,OAAO,MAAM,QAAQ,CAAG,EAAI,IAAI,EAAI,KAAK,IAAI,EAAE,GAAK,OAAO,CAAG,CAClE,CAUA,SAAgB,EACZ,EACA,EACiB,CACjB,GAAM,CAAE,WAAU,YAAW,cAAa,WAAU,UAAW,EAC/D,OAAO,SAAU,EAAgB,EAA6B,CAC1D,IAAM,EAAU,OAAO,CAAI,EAGrB,EAAW,GADC,OAAO,GAAW,WAAa,EAAO,KAAO,EAAO,YAAY,KACpD,GAAG,IAEjC,OAAO,eAAe,EAAQ,EAAS,CACnC,IAAK,UAAY,CACb,IAAI,EAAQ,EAAY,IAAI,CAAQ,EAEpC,GAAI,IAAU,IAAA,GAAW,CACrB,IAAM,EAAW,IAAI,EAErB,GAAI,GAAY,IAAW,IAAA,GAAW,CAClC,IAAM,EAAW,EAAS,OAAO,CAAG,EACpC,GAAI,IAAa,IAAA,IAAa,EAAS,KAAK,IAAM,GAC9C,MAAM,IAAI,EAAA,IAEN,kCAAkC,EAAkB,CAAG,EAAE,uBAC7D,CAER,CAEA,IAAM,EAAiB,IAAI,EAAe,CAAQ,EAClD,AACI,EADA,IAAW,IAAA,GAGH,EAAe,aAAa,EAAK,EAAU,EAAW,CAAW,EAFjE,EAAe,kBAAkB,EAAK,EAAQ,EAAU,CAAW,EAI/E,EAAY,IAAI,EAAU,CAAK,CACnC,CAEA,OAAO,CACX,EACA,aAAc,GACd,WAAY,EAChB,CAAC,CACL,CACJ"}

package/dist/node/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./converters/Converters.cjs"),t=require("./Error.cjs"),n=require("./core/EnvironmentMethods.cjs"),r=require("./decorators/Envapt.cjs"),i=require("./decorators/SugarDecorators.cjs"),a=require("./sources/ManualEnvSource.cjs"),o=require("./sources/WorkerEnvSource.cjs"),s=require("./sources/NodeEnvSource.cjs"),c=require("./NodeEnvapter.cjs");exports.Converters=e.Converters,exports.EnvBool=i.EnvBool,exports.EnvNum=i.EnvNum,exports.EnvStr=i.EnvStr,exports.EnvTime=i.EnvTime,exports.EnvUrl=i.EnvUrl,exports.Envapt=r.Envapt,exports.EnvaptError=t.EnvaptError,exports.EnvaptErrorCodes=t.EnvaptErrorCodes,exports.Envapter=c.NodeEnvapter,exports.Environment=n.Environment,exports.ManualEnvSource=a.ManualEnvSource,exports.NodeEnvSource=s.NodeEnvSource,exports.WorkerEnvSource=o.WorkerEnvSource,exports.isArrayOf=e.isArrayOf;

package/dist/node/index.d.cts

@@ -0,0 +1,18 @@
+import { ArrayElement, ArrayOf, ConverterToken, Converters, CustomElementConverter, isArrayOf } from "./converters/Converters.cjs";
+import { AdvancedConverterReturn, BuiltInConverter, BuiltInConverterFunction, ConditionalReturn, ConverterFunction, EnvaptConverter, InferConverterFallbackType, InferConverterReturnType, InferPrimitiveFallbackType, InferPrimitiveReturnType, JsonValue, MapOfConverterFunctions, PrimitiveConstructor, TimeFallback, TimeUnit } from "./types/Conversion.cjs";
+import { InferSchemaInput, InferSchemaOutput, StandardSchemaV1 } from "./StandardSchema.cjs";
+import { Err, SchemaConstraint, SchemaMustBeSync } from "./types/Schema.cjs";
+import { DebugLevel } from "./Debug.cjs";
+import { EnvFileOptions } from "./Dotenv.cjs";
+import { Environment } from "./core/EnvironmentMethods.cjs";
+import { EnvProfile, EnvaptOptions, ProfilesConfig } from "./types/Options.cjs";
+import { EnvKeyInput } from "./types/Env.cjs";
+import { BareEnvSource, EnvSource, FileEnvSource } from "./types/Source.cjs";
+import { Envapt } from "./decorators/Envapt.cjs";
+import { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl } from "./decorators/SugarDecorators.cjs";
+import { ManualEnvSource } from "./sources/ManualEnvSource.cjs";
+import { WorkerEnvSource } from "./sources/WorkerEnvSource.cjs";
+import { EnvaptError, EnvaptErrorCodes } from "./Error.cjs";
+import { NodeEnvapter } from "./NodeEnvapter.cjs";
+import { NodeEnvSource } from "./sources/NodeEnvSource.cjs";
+export { type AdvancedConverterReturn, type ArrayElement, type ArrayOf, type BareEnvSource, type BuiltInConverter, type BuiltInConverterFunction, type ConditionalReturn, type ConverterFunction, type ConverterToken, Converters, type CustomElementConverter, type DebugLevel, EnvBool, type EnvFileOptions, type EnvKeyInput, EnvNum, type EnvProfile, type EnvSource, EnvStr, EnvTime, EnvUrl, Envapt, type EnvaptConverter, EnvaptError, EnvaptErrorCodes, type EnvaptOptions, NodeEnvapter as Envapter, Environment, type Err, type FileEnvSource, type InferConverterFallbackType, type InferConverterReturnType, type InferPrimitiveFallbackType, type InferPrimitiveReturnType, type InferSchemaInput, type InferSchemaOutput, type JsonValue, ManualEnvSource, type MapOfConverterFunctions, NodeEnvSource, type PrimitiveConstructor, type ProfilesConfig, type SchemaConstraint, type SchemaMustBeSync, type StandardSchemaV1, type TimeFallback, type TimeUnit, WorkerEnvSource, isArrayOf };

package/dist/node/index.d.mts

@@ -0,0 +1,18 @@
+import { ArrayElement, ArrayOf, ConverterToken, Converters, CustomElementConverter, isArrayOf } from "./converters/Converters.mjs";
+import { AdvancedConverterReturn, BuiltInConverter, BuiltInConverterFunction, ConditionalReturn, ConverterFunction, EnvaptConverter, InferConverterFallbackType, InferConverterReturnType, InferPrimitiveFallbackType, InferPrimitiveReturnType, JsonValue, MapOfConverterFunctions, PrimitiveConstructor, TimeFallback, TimeUnit } from "./types/Conversion.mjs";
+import { InferSchemaInput, InferSchemaOutput, StandardSchemaV1 } from "./StandardSchema.mjs";
+import { Err, SchemaConstraint, SchemaMustBeSync } from "./types/Schema.mjs";
+import { DebugLevel } from "./Debug.mjs";
+import { EnvFileOptions } from "./Dotenv.mjs";
+import { Environment } from "./core/EnvironmentMethods.mjs";
+import { EnvProfile, EnvaptOptions, ProfilesConfig } from "./types/Options.mjs";
+import { EnvKeyInput } from "./types/Env.mjs";
+import { BareEnvSource, EnvSource, FileEnvSource } from "./types/Source.mjs";
+import { Envapt } from "./decorators/Envapt.mjs";
+import { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl } from "./decorators/SugarDecorators.mjs";
+import { ManualEnvSource } from "./sources/ManualEnvSource.mjs";
+import { WorkerEnvSource } from "./sources/WorkerEnvSource.mjs";
+import { EnvaptError, EnvaptErrorCodes } from "./Error.mjs";
+import { NodeEnvapter } from "./NodeEnvapter.mjs";
+import { NodeEnvSource } from "./sources/NodeEnvSource.mjs";
+export { type AdvancedConverterReturn, type ArrayElement, type ArrayOf, type BareEnvSource, type BuiltInConverter, type BuiltInConverterFunction, type ConditionalReturn, type ConverterFunction, type ConverterToken, Converters, type CustomElementConverter, type DebugLevel, EnvBool, type EnvFileOptions, type EnvKeyInput, EnvNum, type EnvProfile, type EnvSource, EnvStr, EnvTime, EnvUrl, Envapt, type EnvaptConverter, EnvaptError, EnvaptErrorCodes, type EnvaptOptions, NodeEnvapter as Envapter, Environment, type Err, type FileEnvSource, type InferConverterFallbackType, type InferConverterReturnType, type InferPrimitiveFallbackType, type InferPrimitiveReturnType, type InferSchemaInput, type InferSchemaOutput, type JsonValue, ManualEnvSource, type MapOfConverterFunctions, NodeEnvSource, type PrimitiveConstructor, type ProfilesConfig, type SchemaConstraint, type SchemaMustBeSync, type StandardSchemaV1, type TimeFallback, type TimeUnit, WorkerEnvSource, isArrayOf };

package/dist/node/index.mjs

@@ -0,0 +1 @@
+import{Converters as e,isArrayOf as t}from"./converters/Converters.mjs";import{EnvaptError as n,EnvaptErrorCodes as r}from"./Error.mjs";import{Environment as i}from"./core/EnvironmentMethods.mjs";import{Envapt as a}from"./decorators/Envapt.mjs";import{EnvBool as o,EnvNum as s,EnvStr as c,EnvTime as l,EnvUrl as u}from"./decorators/SugarDecorators.mjs";import{ManualEnvSource as d}from"./sources/ManualEnvSource.mjs";import{WorkerEnvSource as f}from"./sources/WorkerEnvSource.mjs";import{NodeEnvSource as p}from"./sources/NodeEnvSource.mjs";import{NodeEnvapter as m}from"./NodeEnvapter.mjs";export{e as Converters,o as EnvBool,s as EnvNum,c as EnvStr,l as EnvTime,u as EnvUrl,a as Envapt,n as EnvaptError,r as EnvaptErrorCodes,m as Envapter,i as Environment,d as ManualEnvSource,p as NodeEnvSource,f as WorkerEnvSource,t as isArrayOf};

package/dist/node/runtime.cjs

@@ -0,0 +1,2 @@
+let e=e=>{console.error(e)},t=()=>({});function n(t){e=t}function r(t){e(t)}function i(){return t()}function a(e){t=()=>e.readVars()}exports.bindRuntimeFromSource=a,exports.readRuntimeEnv=i,exports.setRuntimeSink=n,exports.writeRuntimeLine=r;
+//# sourceMappingURL=runtime.cjs.map

package/dist/node/runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.cjs","names":[],"sources":["../../src/runtime.ts"],"sourcesContent":["import type { EnvSource } from './types';\n\n// EnvapterBase imports Debug; importing it back would cycle, so the source/sink are injected via the setters below.\n/* v8 ignore start -- @preserve replaced at load on Node; the Node suite never runs these defaults */\nlet sink: (line: string) => void = (line) => {\n    // eslint-disable-next-line no-console -- the off-Node fallback log sink\n    console.error(line);\n};\nlet envReader: () => Record<string, string> = () => ({});\n/* v8 ignore stop */\n\nexport function setRuntimeSink(fn: (line: string) => void): void {\n    sink = fn;\n}\n\nexport function writeRuntimeLine(line: string): void {\n    sink(line);\n}\n\nexport function readRuntimeEnv(): Record<string, string> {\n    return envReader();\n}\n\nexport function bindRuntimeFromSource(source: EnvSource): void {\n    envReader = (): Record<string, string> => source.readVars();\n}\n"],"mappings":"AAIA,IAAI,EAAgC,GAAS,CAEzC,QAAQ,MAAM,CAAI,CACtB,EACI,OAAiD,CAAC,GAGtD,SAAgB,EAAe,EAAkC,CAC7D,EAAO,CACX,CAEA,SAAgB,EAAiB,EAAoB,CACjD,EAAK,CAAI,CACb,CAEA,SAAgB,GAAyC,CACrD,OAAO,EAAU,CACrB,CAEA,SAAgB,EAAsB,EAAyB,CAC3D,MAA0C,EAAO,SAAS,CAC9D"}

package/dist/node/runtime.mjs

@@ -0,0 +1,2 @@
+let e=e=>{console.error(e)},t=()=>({});function n(t){e=t}function r(t){e(t)}function i(){return t()}function a(e){t=()=>e.readVars()}export{a as bindRuntimeFromSource,i as readRuntimeEnv,n as setRuntimeSink,r as writeRuntimeLine};
+//# sourceMappingURL=runtime.mjs.map

package/dist/node/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":[],"sources":["../../src/runtime.ts"],"sourcesContent":["import type { EnvSource } from './types';\n\n// EnvapterBase imports Debug; importing it back would cycle, so the source/sink are injected via the setters below.\n/* v8 ignore start -- @preserve replaced at load on Node; the Node suite never runs these defaults */\nlet sink: (line: string) => void = (line) => {\n    // eslint-disable-next-line no-console -- the off-Node fallback log sink\n    console.error(line);\n};\nlet envReader: () => Record<string, string> = () => ({});\n/* v8 ignore stop */\n\nexport function setRuntimeSink(fn: (line: string) => void): void {\n    sink = fn;\n}\n\nexport function writeRuntimeLine(line: string): void {\n    sink(line);\n}\n\nexport function readRuntimeEnv(): Record<string, string> {\n    return envReader();\n}\n\nexport function bindRuntimeFromSource(source: EnvSource): void {\n    envReader = (): Record<string, string> => source.readVars();\n}\n"],"mappings":"AAIA,IAAI,EAAgC,GAAS,CAEzC,QAAQ,MAAM,CAAI,CACtB,EACI,OAAiD,CAAC,GAGtD,SAAgB,EAAe,EAAkC,CAC7D,EAAO,CACX,CAEA,SAAgB,EAAiB,EAAoB,CACjD,EAAK,CAAI,CACb,CAEA,SAAgB,GAAyC,CACrD,OAAO,EAAU,CACrB,CAEA,SAAgB,EAAsB,EAAyB,CAC3D,MAA0C,EAAO,SAAS,CAC9D"}

package/dist/node/sources/ManualEnvSource.cjs

@@ -0,0 +1,2 @@
+const e=require("./coerce.cjs");var t=class{supportsFiles=!1;vars;constructor(t){this.vars=e.coerceToStringRecord(t)}readVars(){return{...this.vars}}};exports.ManualEnvSource=t;
+//# sourceMappingURL=ManualEnvSource.cjs.map

package/dist/node/sources/ManualEnvSource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManualEnvSource.cjs","names":["coerceToStringRecord"],"sources":["../../../src/sources/ManualEnvSource.ts"],"sourcesContent":["import { coerceToStringRecord } from './coerce';\n\nimport type { BareEnvSource } from '../types';\n\n/**\n * Environment source seeded from an object you provide: the config your bundler injects into a browser\n * build (Vite's `import.meta.env`, a webpack `DefinePlugin` global), a test fixture, or any other plain\n * object. Pass it straight through; non-string values are JSON-stringified so the converters still apply.\n * It has no filesystem, so the `.env` cascade and file-based APIs do not apply.\n * @public\n */\nexport class ManualEnvSource implements BareEnvSource {\n    readonly supportsFiles = false;\n    private readonly vars: Record<string, string>;\n\n    constructor(vars: Record<string, unknown>) {\n        this.vars = coerceToStringRecord(vars);\n    }\n\n    readVars(): Record<string, string> {\n        return { ...this.vars };\n    }\n}\n"],"mappings":"gCAWA,IAAa,EAAb,KAAsD,CAClD,cAAyB,GACzB,KAEA,YAAY,EAA+B,CACvC,KAAK,KAAOA,EAAAA,qBAAqB,CAAI,CACzC,CAEA,UAAmC,CAC/B,MAAO,CAAE,GAAG,KAAK,IAAK,CAC1B,CACJ"}

package/dist/node/sources/ManualEnvSource.d.cts

@@ -0,0 +1,19 @@
+import { BareEnvSource } from "../types/Source.cjs";
+
+//#region src/sources/ManualEnvSource.d.ts
+/**
+ * Environment source seeded from an object you provide: the config your bundler injects into a browser
+ * build (Vite's `import.meta.env`, a webpack `DefinePlugin` global), a test fixture, or any other plain
+ * object. Pass it straight through; non-string values are JSON-stringified so the converters still apply.
+ * It has no filesystem, so the `.env` cascade and file-based APIs do not apply.
+ * @public
+ */
+declare class ManualEnvSource implements BareEnvSource {
+  readonly supportsFiles = false;
+  private readonly vars;
+  constructor(vars: Record<string, unknown>);
+  readVars(): Record<string, string>;
+}
+//#endregion
+export { ManualEnvSource };
+//# sourceMappingURL=ManualEnvSource.d.cts.map

package/dist/node/sources/ManualEnvSource.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManualEnvSource.d.cts","names":[],"sources":["../../../src/sources/ManualEnvSource.ts"],"mappings":";;;;;AAWA;;;;;cAAa,eAAA,YAA2B,aAAA;EAAA,SAC3B,aAAA;EAAA,iBACQ,IAAA;cAEL,IAAA,EAAM,MAAA;EAIlB,QAAA,CAAA,GAAY,MAAA;AAAA"}

package/dist/node/sources/ManualEnvSource.d.mts

@@ -0,0 +1,19 @@
+import { BareEnvSource } from "../types/Source.mjs";
+
+//#region src/sources/ManualEnvSource.d.ts
+/**
+ * Environment source seeded from an object you provide: the config your bundler injects into a browser
+ * build (Vite's `import.meta.env`, a webpack `DefinePlugin` global), a test fixture, or any other plain
+ * object. Pass it straight through; non-string values are JSON-stringified so the converters still apply.
+ * It has no filesystem, so the `.env` cascade and file-based APIs do not apply.
+ * @public
+ */
+declare class ManualEnvSource implements BareEnvSource {
+  readonly supportsFiles = false;
+  private readonly vars;
+  constructor(vars: Record<string, unknown>);
+  readVars(): Record<string, string>;
+}
+//#endregion
+export { ManualEnvSource };
+//# sourceMappingURL=ManualEnvSource.d.mts.map

package/dist/node/sources/ManualEnvSource.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManualEnvSource.d.mts","names":[],"sources":["../../../src/sources/ManualEnvSource.ts"],"mappings":";;;;;AAWA;;;;;cAAa,eAAA,YAA2B,aAAA;EAAA,SAC3B,aAAA;EAAA,iBACQ,IAAA;cAEL,IAAA,EAAM,MAAA;EAIlB,QAAA,CAAA,GAAY,MAAA;AAAA"}

package/dist/node/sources/ManualEnvSource.mjs

@@ -0,0 +1,2 @@
+import{coerceToStringRecord as e}from"./coerce.mjs";var t=class{supportsFiles=!1;vars;constructor(t){this.vars=e(t)}readVars(){return{...this.vars}}};export{t as ManualEnvSource};
+//# sourceMappingURL=ManualEnvSource.mjs.map

package/dist/node/sources/ManualEnvSource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManualEnvSource.mjs","names":[],"sources":["../../../src/sources/ManualEnvSource.ts"],"sourcesContent":["import { coerceToStringRecord } from './coerce';\n\nimport type { BareEnvSource } from '../types';\n\n/**\n * Environment source seeded from an object you provide: the config your bundler injects into a browser\n * build (Vite's `import.meta.env`, a webpack `DefinePlugin` global), a test fixture, or any other plain\n * object. Pass it straight through; non-string values are JSON-stringified so the converters still apply.\n * It has no filesystem, so the `.env` cascade and file-based APIs do not apply.\n * @public\n */\nexport class ManualEnvSource implements BareEnvSource {\n    readonly supportsFiles = false;\n    private readonly vars: Record<string, string>;\n\n    constructor(vars: Record<string, unknown>) {\n        this.vars = coerceToStringRecord(vars);\n    }\n\n    readVars(): Record<string, string> {\n        return { ...this.vars };\n    }\n}\n"],"mappings":"oDAWA,IAAa,EAAb,KAAsD,CAClD,cAAyB,GACzB,KAEA,YAAY,EAA+B,CACvC,KAAK,KAAO,EAAqB,CAAI,CACzC,CAEA,UAAmC,CAC/B,MAAO,CAAE,GAAG,KAAK,IAAK,CAC1B,CACJ"}

package/dist/node/sources/NodeEnvSource.cjs

@@ -0,0 +1,2 @@
+const e=require("../_virtual/_rolldown/runtime.cjs");let t=require("node:process");t=e.__toESM(t,1);let n=require("node:fs");n=e.__toESM(n,1);let r=require("node:path"),i=require("node:url");var a=class{supportsFiles=!0;readVars(){return{...t.default.env}}readFile(e,t){try{return n.default.readFileSync(e,t)}catch{return}}normalizeBaseDir(e){return e instanceof URL||e.startsWith(`file:`)?(0,r.dirname)((0,i.fileURLToPath)(e)):(0,r.resolve)(e)}resolvePath(e,t){return(0,r.isAbsolute)(t)?t:(0,r.join)(e,t)}writeVars(e){for(let[n,r]of Object.entries(e))t.default.env[n]=r}};exports.NodeEnvSource=a;
+//# sourceMappingURL=NodeEnvSource.cjs.map

package/dist/node/sources/NodeEnvSource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeEnvSource.cjs","names":["process","fs"],"sources":["../../../src/sources/NodeEnvSource.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { dirname, isAbsolute, join, resolve } from 'node:path';\nimport process from 'node:process';\nimport { fileURLToPath } from 'node:url';\n\nimport type { FileEnvSource } from '../types';\n\n/**\n * Default environment source on Node, Bun, and Deno: a snapshot of `process.env`. Its\n * `supportsFiles` is `true`, so the engine also layers the `.env` cascade on top, resolves\n * `baseDir`, and can mirror loaded keys back to `process.env`.\n * @public\n */\nexport class NodeEnvSource implements FileEnvSource {\n    readonly supportsFiles = true;\n\n    readVars(): Record<string, string> {\n        // Clone so the loader and downstream reads never mutate process.env.\n        return { ...(process.env as Record<string, string>) };\n    }\n\n    readFile(path: string, encoding: string): string | undefined {\n        try {\n            // justified: our public encoding type is `string`; fs needs the BufferEncoding subset.\n            return fs.readFileSync(path, encoding as BufferEncoding);\n        } catch {\n            return undefined;\n        }\n    }\n\n    // `file:` URLs resolve to their containing directory; plain paths (`import.meta.dirname`, `__dirname`) are taken as the directory.\n    normalizeBaseDir(value: string | URL): string {\n        if (value instanceof URL) return dirname(fileURLToPath(value));\n        if (value.startsWith('file:')) return dirname(fileURLToPath(value));\n        return resolve(value);\n    }\n\n    resolvePath(baseDir: string, candidate: string): string {\n        if (isAbsolute(candidate)) return candidate;\n        return join(baseDir, candidate);\n    }\n\n    writeVars(vars: Record<string, string>): void {\n        for (const [key, value] of Object.entries(vars)) {\n            process.env[key] = value;\n        }\n    }\n}\n"],"mappings":"+LAaA,IAAa,EAAb,KAAoD,CAChD,cAAyB,GAEzB,UAAmC,CAE/B,MAAO,CAAE,GAAIA,EAAAA,QAAQ,GAA+B,CACxD,CAEA,SAAS,EAAc,EAAsC,CACzD,GAAI,CAEA,OAAOC,EAAAA,QAAG,aAAa,EAAM,CAA0B,CAC3D,MAAQ,CACJ,MACJ,CACJ,CAGA,iBAAiB,EAA6B,CAG1C,OAFI,aAAiB,KACjB,EAAM,WAAW,OAAO,GAAG,EAAA,EAAA,UAAA,EAAA,EAAA,eAA6B,CAAK,CAAC,GAClE,EAAA,EAAA,SAAe,CAAK,CACxB,CAEA,YAAY,EAAiB,EAA2B,CAEpD,OADA,EAAA,EAAA,YAAe,CAAS,EAAU,GAClC,EAAA,EAAA,MAAY,EAAS,CAAS,CAClC,CAEA,UAAU,EAAoC,CAC1C,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAI,EAC1C,EAAA,QAAQ,IAAI,GAAO,CAE3B,CACJ"}

package/dist/node/sources/NodeEnvSource.d.cts

@@ -0,0 +1,20 @@
+import { FileEnvSource } from "../types/Source.cjs";
+
+//#region src/sources/NodeEnvSource.d.ts
+/**
+ * Default environment source on Node, Bun, and Deno: a snapshot of `process.env`. Its
+ * `supportsFiles` is `true`, so the engine also layers the `.env` cascade on top, resolves
+ * `baseDir`, and can mirror loaded keys back to `process.env`.
+ * @public
+ */
+declare class NodeEnvSource implements FileEnvSource {
+  readonly supportsFiles = true;
+  readVars(): Record<string, string>;
+  readFile(path: string, encoding: string): string | undefined;
+  normalizeBaseDir(value: string | URL): string;
+  resolvePath(baseDir: string, candidate: string): string;
+  writeVars(vars: Record<string, string>): void;
+}
+//#endregion
+export { NodeEnvSource };
+//# sourceMappingURL=NodeEnvSource.d.cts.map

package/dist/node/sources/NodeEnvSource.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeEnvSource.d.cts","names":[],"sources":["../../../src/sources/NodeEnvSource.ts"],"mappings":";;;;;AAaA;;;;cAAa,aAAA,YAAyB,aAAA;EAAA,SACzB,aAAA;EAET,QAAA,CAAA,GAAY,MAAA;EAKZ,QAAA,CAAS,IAAA,UAAc,QAAA;EAUvB,gBAAA,CAAiB,KAAA,WAAgB,GAAA;EAMjC,WAAA,CAAY,OAAA,UAAiB,SAAA;EAK7B,SAAA,CAAU,IAAA,EAAM,MAAA;AAAA"}

package/dist/node/sources/NodeEnvSource.d.mts

@@ -0,0 +1,20 @@
+import { FileEnvSource } from "../types/Source.mjs";
+
+//#region src/sources/NodeEnvSource.d.ts
+/**
+ * Default environment source on Node, Bun, and Deno: a snapshot of `process.env`. Its
+ * `supportsFiles` is `true`, so the engine also layers the `.env` cascade on top, resolves
+ * `baseDir`, and can mirror loaded keys back to `process.env`.
+ * @public
+ */
+declare class NodeEnvSource implements FileEnvSource {
+  readonly supportsFiles = true;
+  readVars(): Record<string, string>;
+  readFile(path: string, encoding: string): string | undefined;
+  normalizeBaseDir(value: string | URL): string;
+  resolvePath(baseDir: string, candidate: string): string;
+  writeVars(vars: Record<string, string>): void;
+}
+//#endregion
+export { NodeEnvSource };
+//# sourceMappingURL=NodeEnvSource.d.mts.map

package/dist/node/sources/NodeEnvSource.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeEnvSource.d.mts","names":[],"sources":["../../../src/sources/NodeEnvSource.ts"],"mappings":";;;;;AAaA;;;;cAAa,aAAA,YAAyB,aAAA;EAAA,SACzB,aAAA;EAET,QAAA,CAAA,GAAY,MAAA;EAKZ,QAAA,CAAS,IAAA,UAAc,QAAA;EAUvB,gBAAA,CAAiB,KAAA,WAAgB,GAAA;EAMjC,WAAA,CAAY,OAAA,UAAiB,SAAA;EAK7B,SAAA,CAAU,IAAA,EAAM,MAAA;AAAA"}

package/dist/node/sources/NodeEnvSource.mjs

@@ -0,0 +1,2 @@
+import e from"node:process";import t from"node:fs";import{dirname as n,isAbsolute as r,join as i,resolve as a}from"node:path";import{fileURLToPath as o}from"node:url";var s=class{supportsFiles=!0;readVars(){return{...e.env}}readFile(e,n){try{return t.readFileSync(e,n)}catch{return}}normalizeBaseDir(e){return e instanceof URL||e.startsWith(`file:`)?n(o(e)):a(e)}resolvePath(e,t){return r(t)?t:i(e,t)}writeVars(t){for(let[n,r]of Object.entries(t))e.env[n]=r}};export{s as NodeEnvSource};
+//# sourceMappingURL=NodeEnvSource.mjs.map

package/dist/node/sources/NodeEnvSource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeEnvSource.mjs","names":[],"sources":["../../../src/sources/NodeEnvSource.ts"],"sourcesContent":["import fs from 'node:fs';\nimport { dirname, isAbsolute, join, resolve } from 'node:path';\nimport process from 'node:process';\nimport { fileURLToPath } from 'node:url';\n\nimport type { FileEnvSource } from '../types';\n\n/**\n * Default environment source on Node, Bun, and Deno: a snapshot of `process.env`. Its\n * `supportsFiles` is `true`, so the engine also layers the `.env` cascade on top, resolves\n * `baseDir`, and can mirror loaded keys back to `process.env`.\n * @public\n */\nexport class NodeEnvSource implements FileEnvSource {\n    readonly supportsFiles = true;\n\n    readVars(): Record<string, string> {\n        // Clone so the loader and downstream reads never mutate process.env.\n        return { ...(process.env as Record<string, string>) };\n    }\n\n    readFile(path: string, encoding: string): string | undefined {\n        try {\n            // justified: our public encoding type is `string`; fs needs the BufferEncoding subset.\n            return fs.readFileSync(path, encoding as BufferEncoding);\n        } catch {\n            return undefined;\n        }\n    }\n\n    // `file:` URLs resolve to their containing directory; plain paths (`import.meta.dirname`, `__dirname`) are taken as the directory.\n    normalizeBaseDir(value: string | URL): string {\n        if (value instanceof URL) return dirname(fileURLToPath(value));\n        if (value.startsWith('file:')) return dirname(fileURLToPath(value));\n        return resolve(value);\n    }\n\n    resolvePath(baseDir: string, candidate: string): string {\n        if (isAbsolute(candidate)) return candidate;\n        return join(baseDir, candidate);\n    }\n\n    writeVars(vars: Record<string, string>): void {\n        for (const [key, value] of Object.entries(vars)) {\n            process.env[key] = value;\n        }\n    }\n}\n"],"mappings":"uKAaA,IAAa,EAAb,KAAoD,CAChD,cAAyB,GAEzB,UAAmC,CAE/B,MAAO,CAAE,GAAI,EAAQ,GAA+B,CACxD,CAEA,SAAS,EAAc,EAAsC,CACzD,GAAI,CAEA,OAAO,EAAG,aAAa,EAAM,CAA0B,CAC3D,MAAQ,CACJ,MACJ,CACJ,CAGA,iBAAiB,EAA6B,CAG1C,OAFI,aAAiB,KACjB,EAAM,WAAW,OAAO,EAAU,EAAQ,EAAc,CAAK,CAAC,EAC3D,EAAQ,CAAK,CACxB,CAEA,YAAY,EAAiB,EAA2B,CAEpD,OADI,EAAW,CAAS,EAAU,EAC3B,EAAK,EAAS,CAAS,CAClC,CAEA,UAAU,EAAoC,CAC1C,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAI,EAC1C,EAAQ,IAAI,GAAO,CAE3B,CACJ"}

package/dist/node/sources/UnboundEnvSource.cjs

@@ -0,0 +1,2 @@
+const e=require("../Error.cjs");var t=class{supportsFiles=!1;readVars(){throw new e.EnvaptError(307,`No environment source is bound. Call Envapter.useSource(...) with a source such as new ManualEnvSource({...}) or new WorkerEnvSource(env) before reading.`)}};exports.UnboundEnvSource=t;
+//# sourceMappingURL=UnboundEnvSource.cjs.map

package/dist/node/sources/UnboundEnvSource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnboundEnvSource.cjs","names":["EnvaptError"],"sources":["../../../src/sources/UnboundEnvSource.ts"],"sourcesContent":["import { EnvaptError, EnvaptErrorCodes } from '../Error';\n\nimport type { BareEnvSource } from '../types';\n\n/**\n * The default source until one is bound. Every read throws NoSourceBound so a forgotten `useSource`\n * surfaces at read time instead of silently yielding nothing. The Node entry binds {@link NodeEnvSource}\n * at load; browser and Workers bundles must call `Envapter.useSource(...)` before reading.\n * @internal\n */\nexport class UnboundEnvSource implements BareEnvSource {\n    readonly supportsFiles = false;\n\n    readVars(): Record<string, string> {\n        throw new EnvaptError(\n            EnvaptErrorCodes.NoSourceBound,\n            'No environment source is bound. Call Envapter.useSource(...) with a source such as new ManualEnvSource({...}) or new WorkerEnvSource(env) before reading.'\n        );\n    }\n}\n"],"mappings":"gCAUA,IAAa,EAAb,KAAuD,CACnD,cAAyB,GAEzB,UAAmC,CAC/B,MAAM,IAAIA,EAAAA,YAAAA,IAEN,2JACJ,CACJ,CACJ"}

package/dist/node/sources/UnboundEnvSource.mjs

@@ -0,0 +1,2 @@
+import{EnvaptError as e}from"../Error.mjs";var t=class{supportsFiles=!1;readVars(){throw new e(307,`No environment source is bound. Call Envapter.useSource(...) with a source such as new ManualEnvSource({...}) or new WorkerEnvSource(env) before reading.`)}};export{t as UnboundEnvSource};
+//# sourceMappingURL=UnboundEnvSource.mjs.map

package/dist/node/sources/UnboundEnvSource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnboundEnvSource.mjs","names":[],"sources":["../../../src/sources/UnboundEnvSource.ts"],"sourcesContent":["import { EnvaptError, EnvaptErrorCodes } from '../Error';\n\nimport type { BareEnvSource } from '../types';\n\n/**\n * The default source until one is bound. Every read throws NoSourceBound so a forgotten `useSource`\n * surfaces at read time instead of silently yielding nothing. The Node entry binds {@link NodeEnvSource}\n * at load; browser and Workers bundles must call `Envapter.useSource(...)` before reading.\n * @internal\n */\nexport class UnboundEnvSource implements BareEnvSource {\n    readonly supportsFiles = false;\n\n    readVars(): Record<string, string> {\n        throw new EnvaptError(\n            EnvaptErrorCodes.NoSourceBound,\n            'No environment source is bound. Call Envapter.useSource(...) with a source such as new ManualEnvSource({...}) or new WorkerEnvSource(env) before reading.'\n        );\n    }\n}\n"],"mappings":"2CAUA,IAAa,EAAb,KAAuD,CACnD,cAAyB,GAEzB,UAAmC,CAC/B,MAAM,IAAI,EAAA,IAEN,2JACJ,CACJ,CACJ"}

package/dist/node/sources/WorkerEnvSource.cjs

@@ -0,0 +1,2 @@
+const e=require("./coerce.cjs");var t=class{supportsFiles=!1;vars;constructor(t){this.vars=e.coerceToStringRecord(t)}readVars(){return{...this.vars}}};exports.WorkerEnvSource=t;
+//# sourceMappingURL=WorkerEnvSource.cjs.map

package/dist/node/sources/WorkerEnvSource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerEnvSource.cjs","names":["coerceToStringRecord"],"sources":["../../../src/sources/WorkerEnvSource.ts"],"sourcesContent":["import { coerceToStringRecord } from './coerce';\n\nimport type { BareEnvSource } from '../types';\n\n/**\n * Environment source for Cloudflare Workers, seeded from the `env` binding. String bindings pass\n * through; non-string bindings are JSON-stringified so the converters still apply, and so must be\n * JSON-serializable (a `bigint` or circular value throws). No filesystem, so the `.env` cascade and\n * file-based APIs do not apply.\n * @public\n */\nexport class WorkerEnvSource implements BareEnvSource {\n    readonly supportsFiles = false;\n    private readonly vars: Record<string, string>;\n\n    constructor(env: Record<string, unknown>) {\n        this.vars = coerceToStringRecord(env);\n    }\n\n    readVars(): Record<string, string> {\n        return { ...this.vars };\n    }\n}\n"],"mappings":"gCAWA,IAAa,EAAb,KAAsD,CAClD,cAAyB,GACzB,KAEA,YAAY,EAA8B,CACtC,KAAK,KAAOA,EAAAA,qBAAqB,CAAG,CACxC,CAEA,UAAmC,CAC/B,MAAO,CAAE,GAAG,KAAK,IAAK,CAC1B,CACJ"}

package/dist/node/sources/WorkerEnvSource.d.cts

@@ -0,0 +1,19 @@
+import { BareEnvSource } from "../types/Source.cjs";
+
+//#region src/sources/WorkerEnvSource.d.ts
+/**
+ * Environment source for Cloudflare Workers, seeded from the `env` binding. String bindings pass
+ * through; non-string bindings are JSON-stringified so the converters still apply, and so must be
+ * JSON-serializable (a `bigint` or circular value throws). No filesystem, so the `.env` cascade and
+ * file-based APIs do not apply.
+ * @public
+ */
+declare class WorkerEnvSource implements BareEnvSource {
+  readonly supportsFiles = false;
+  private readonly vars;
+  constructor(env: Record<string, unknown>);
+  readVars(): Record<string, string>;
+}
+//#endregion
+export { WorkerEnvSource };
+//# sourceMappingURL=WorkerEnvSource.d.cts.map

package/dist/node/sources/WorkerEnvSource.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerEnvSource.d.cts","names":[],"sources":["../../../src/sources/WorkerEnvSource.ts"],"mappings":";;;;;AAWA;;;;;cAAa,eAAA,YAA2B,aAAA;EAAA,SAC3B,aAAA;EAAA,iBACQ,IAAA;cAEL,GAAA,EAAK,MAAA;EAIjB,QAAA,CAAA,GAAY,MAAA;AAAA"}

package/dist/node/sources/WorkerEnvSource.d.mts

@@ -0,0 +1,19 @@
+import { BareEnvSource } from "../types/Source.mjs";
+
+//#region src/sources/WorkerEnvSource.d.ts
+/**
+ * Environment source for Cloudflare Workers, seeded from the `env` binding. String bindings pass
+ * through; non-string bindings are JSON-stringified so the converters still apply, and so must be
+ * JSON-serializable (a `bigint` or circular value throws). No filesystem, so the `.env` cascade and
+ * file-based APIs do not apply.
+ * @public
+ */
+declare class WorkerEnvSource implements BareEnvSource {
+  readonly supportsFiles = false;
+  private readonly vars;
+  constructor(env: Record<string, unknown>);
+  readVars(): Record<string, string>;
+}
+//#endregion
+export { WorkerEnvSource };
+//# sourceMappingURL=WorkerEnvSource.d.mts.map

package/dist/node/sources/WorkerEnvSource.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerEnvSource.d.mts","names":[],"sources":["../../../src/sources/WorkerEnvSource.ts"],"mappings":";;;;;AAWA;;;;;cAAa,eAAA,YAA2B,aAAA;EAAA,SAC3B,aAAA;EAAA,iBACQ,IAAA;cAEL,GAAA,EAAK,MAAA;EAIjB,QAAA,CAAA,GAAY,MAAA;AAAA"}

package/dist/node/sources/WorkerEnvSource.mjs

@@ -0,0 +1,2 @@
+import{coerceToStringRecord as e}from"./coerce.mjs";var t=class{supportsFiles=!1;vars;constructor(t){this.vars=e(t)}readVars(){return{...this.vars}}};export{t as WorkerEnvSource};
+//# sourceMappingURL=WorkerEnvSource.mjs.map

package/dist/node/sources/WorkerEnvSource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkerEnvSource.mjs","names":[],"sources":["../../../src/sources/WorkerEnvSource.ts"],"sourcesContent":["import { coerceToStringRecord } from './coerce';\n\nimport type { BareEnvSource } from '../types';\n\n/**\n * Environment source for Cloudflare Workers, seeded from the `env` binding. String bindings pass\n * through; non-string bindings are JSON-stringified so the converters still apply, and so must be\n * JSON-serializable (a `bigint` or circular value throws). No filesystem, so the `.env` cascade and\n * file-based APIs do not apply.\n * @public\n */\nexport class WorkerEnvSource implements BareEnvSource {\n    readonly supportsFiles = false;\n    private readonly vars: Record<string, string>;\n\n    constructor(env: Record<string, unknown>) {\n        this.vars = coerceToStringRecord(env);\n    }\n\n    readVars(): Record<string, string> {\n        return { ...this.vars };\n    }\n}\n"],"mappings":"oDAWA,IAAa,EAAb,KAAsD,CAClD,cAAyB,GACzB,KAEA,YAAY,EAA8B,CACtC,KAAK,KAAO,EAAqB,CAAG,CACxC,CAEA,UAAmC,CAC/B,MAAO,CAAE,GAAG,KAAK,IAAK,CAC1B,CACJ"}

package/dist/node/sources/coerce.cjs

@@ -0,0 +1,2 @@
+function e(e){let t={};for(let[n,r]of Object.entries(e)){if(typeof r==`string`){t[n]=r;continue}let e=JSON.stringify(r);e!==void 0&&(t[n]=e)}return t}exports.coerceToStringRecord=e;
+//# sourceMappingURL=coerce.cjs.map

package/dist/node/sources/coerce.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.cjs","names":[],"sources":["../../../src/sources/coerce.ts"],"sourcesContent":["// Shared by ManualEnvSource and WorkerEnvSource. The returned record is fresh, so a caller mutating its\n// object later can't leak into the source; non-string values are JSON-stringified.\nexport function coerceToStringRecord(env: Record<string, unknown>): Record<string, string> {\n    const snapshot: Record<string, string> = {};\n    for (const [key, value] of Object.entries(env)) {\n        if (typeof value === 'string') {\n            snapshot[key] = value;\n            continue;\n        }\n        const encoded = JSON.stringify(value);\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- TS lib mistypes JSON.stringify's return as always-string; it is string | undefined at runtime\n        if (encoded !== undefined) snapshot[key] = encoded;\n    }\n    return snapshot;\n}\n"],"mappings":"AAEA,SAAgB,EAAqB,EAAsD,CACvF,IAAM,EAAmC,CAAC,EAC1C,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAG,EAAG,CAC5C,GAAI,OAAO,GAAU,SAAU,CAC3B,EAAS,GAAO,EAChB,QACJ,CACA,IAAM,EAAU,KAAK,UAAU,CAAK,EAEhC,IAAY,IAAA,KAAW,EAAS,GAAO,EAC/C,CACA,OAAO,CACX"}

package/dist/node/sources/coerce.mjs

@@ -0,0 +1,2 @@
+function e(e){let t={};for(let[n,r]of Object.entries(e)){if(typeof r==`string`){t[n]=r;continue}let e=JSON.stringify(r);e!==void 0&&(t[n]=e)}return t}export{e as coerceToStringRecord};
+//# sourceMappingURL=coerce.mjs.map

package/dist/node/sources/coerce.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.mjs","names":[],"sources":["../../../src/sources/coerce.ts"],"sourcesContent":["// Shared by ManualEnvSource and WorkerEnvSource. The returned record is fresh, so a caller mutating its\n// object later can't leak into the source; non-string values are JSON-stringified.\nexport function coerceToStringRecord(env: Record<string, unknown>): Record<string, string> {\n    const snapshot: Record<string, string> = {};\n    for (const [key, value] of Object.entries(env)) {\n        if (typeof value === 'string') {\n            snapshot[key] = value;\n            continue;\n        }\n        const encoded = JSON.stringify(value);\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- TS lib mistypes JSON.stringify's return as always-string; it is string | undefined at runtime\n        if (encoded !== undefined) snapshot[key] = encoded;\n    }\n    return snapshot;\n}\n"],"mappings":"AAEA,SAAgB,EAAqB,EAAsD,CACvF,IAAM,EAAmC,CAAC,EAC1C,IAAK,GAAM,CAAC,EAAK,KAAU,OAAO,QAAQ,CAAG,EAAG,CAC5C,GAAI,OAAO,GAAU,SAAU,CAC3B,EAAS,GAAO,EAChB,QACJ,CACA,IAAM,EAAU,KAAK,UAAU,CAAK,EAEhC,IAAY,IAAA,KAAW,EAAS,GAAO,EAC/C,CACA,OAAO,CACX"}

package/dist/node/types/Conversion.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Conversion.d.cts","names":[],"sources":["../../../src/types/Conversion.ts"],"mappings":";;;;;AAAgG;;;KAO3F,gBAAA,GAAmB,cAAc;AAAA;AAAA;;;AAAA,KAMjC,oBAAA,UAA8B,MAAA,UAAgB,MAAA,UAAgB,OAAA,UAAiB,MAAA,UAAgB,MAAA;;;;;KAM/F,SAAA;;;;;;;;KASA,iBAAA,yBAA0C,GAAA,EAAK,SAAA,EAAW,QAAA,GAAW,SAAA,KAAc,SAAA;AAfkB;;;;AAM5F;AAN4F,KAsBrG,eAAA,cAA6B,oBAAA,GAAuB,gBAAA,GAAmB,OAAA,GAAU,iBAAA,CAAkB,SAAA;AAAA,KAEnG,aAAA;AAAA,KACA,SAAA,GAAY,SAAS;AAAA,UAChB,UAAA;EAAA,CACL,GAAA,WAAc,SAAS;AAAA;;;;;KAOvB,SAAA,GAAY,aAAA,GAAgB,SAAA,GAAY,UAAA;AAAA,UAEnC,YAAA;EACN,MAAA;EACA,MAAA;EACA,OAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;EACA,KAAA;EACA,IAAA,EAAM,SAAA;EACN,GAAA,EAAK,GAAA;EACL,MAAA,EAAQ,MAAA;EACR,IAAA,EAAM,IAAA;EACN,IAAA;AAAA;;;;;KAOC,0BAAA,sBAAgD,gBAAA,IAAoB,YAAA,CAAa,YAAA;;;;AAjC2B;KAuC5G,gCAAA,GAAmC,YAAA,CAAa,gBAAgB;;;;AArCnD;KA2Cb,wBAAA,OACE,IAAA,EAAM,UAAA,KAAe,IAAA,YAAgB,gCAAA,MACvC,gCAAA;;;;AA5CqB;KAkDrB,uBAAA,GAA0B,MAAA,CAAO,gBAAA,EAAkB,wBAAA;;;;AAhD5B;KAsDvB,QAAA;;;;;KAMA,YAAA,wBAAoC,QAAQ;;;;;;KAO5C,iBAAA,0BAA2C,SAAA,qBAA8B,UAAA,eAAyB,UAAA;AA5DhD;AAAA;;;;;;;;AAAA,KAuElD,wBAAA,eACD,UAAA,SAAmB,OAAA,kBACb,OAAA,SAAgB,gBAAA,GACZ,YAAA,CAAa,OAAA,MACb,OAAA,SAAgB,sBAAA,mBACd,QAAA,aAEN,UAAA,SAAmB,gBAAA,GACjB,0BAAA,CAA2B,UAAA;;;;;;;KASlC,0BAAA,eAAyC,UAAA,kBACxC,YAAA,GACA,UAAA,SAAmB,OAAA,kBACjB,OAAA,kBACI,YAAA,KACA,wBAAA,CAAyB,UAAA,IAC7B,wBAAA,CAAyB,UAAA;;;;;KAM5B,uBAAA,sCAA6D,iBAAA,CAC9D,wBAAA,CAAyB,UAAA,GACzB,SAAA;;;;;KAOC,wBAAA,sBAA8C,oBAAA,IAAwB,YAAA,gBAA4B,MAAA,YAEjG,YAAA,gBAA4B,MAAA,YAE1B,YAAA,gBAA4B,OAAA,aAE1B,YAAA,gBAA4B,MAAA,YAE1B,YAAA,gBAA4B,MAAA;AAvGhC;AAAA;;;AAAA,KA+GH,0BAAA,8EACD,SAAA,2BAEM,SAAA,2BAEE,SAAA,6BAEE,SAAA,2BAEE,SAAA"}

package/dist/node/types/Conversion.d.mts

@@ -0,0 +1,128 @@
+import { ArrayOf, ConverterToken, CustomElementConverter } from "../converters/Converters.mjs";
+
+//#region src/types/Conversion.d.ts
+/**
+ * Scalar built-in converter tokens (e.g. `'number'`, `'time'`).
+ * Excludes the array builder (see {@link ArrayOf}).
+ * @public
+ */
+type BuiltInConverter = ConverterToken;
+/**
+ * Primitive types supported by Envapter
+ * @public
+ */
+type PrimitiveConstructor = typeof String | typeof Number | typeof Boolean | typeof BigInt | typeof Symbol;
+/**
+ * String value from a .env file or environment variable
+ * @public
+ */
+type BaseInput = string | undefined;
+/**
+ * Custom parser function type for environment variables
+ * @param raw - Raw string value from environment
+ * @param fallback - Fallback value if parsing fails
+ * @returns Parsed value of type T
+ * @public
+ */
+type ConverterFunction<TFallback = unknown> = (raw: BaseInput, fallback?: TFallback) => TFallback;
+/**
+ * Environment variable converter: a primitive constructor, a built-in scalar token, an `ArrayOf<...>`
+ * produced by {@link Converters.array}, or a custom parser function.
+ * @public
+ */
+type EnvaptConverter<TFallback> = PrimitiveConstructor | BuiltInConverter | ArrayOf | ConverterFunction<TFallback>;
+type JsonPrimitive = string | number | boolean | null;
+type JsonArray = JsonValue[];
+interface JsonObject {
+  [key: string]: JsonValue;
+}
+/**
+ * JSON value types for custom converters
+ * @public
+ */
+type JsonValue = JsonPrimitive | JsonArray | JsonObject;
+interface ConverterMap {
+  string: string;
+  number: number;
+  boolean: boolean;
+  bigint: bigint;
+  symbol: symbol;
+  integer: number;
+  float: number;
+  json: JsonValue;
+  url: URL;
+  regexp: RegExp;
+  date: Date;
+  time: number;
+}
+/**
+ * Type mapping for built-in scalar converters to their return types
+ * @internal
+ */
+type BuiltInConverterReturnType<ConverterKey extends BuiltInConverter> = ConverterMap[ConverterKey];
+/**
+ * Return type for built-in converter functions
+ * @internal
+ */
+type ReturnValuesOfConverterFunctions = ConverterMap[BuiltInConverter];
+/**
+ * Function type for built-in converter functions
+ * @internal
+ */
+type BuiltInConverterFunction = (...args: Parameters<(...args: any[]) => ReturnValuesOfConverterFunctions>) => ReturnValuesOfConverterFunctions | undefined;
+/**
+ * Map of built-in converter functions
+ * @internal
+ */
+type MapOfConverterFunctions = Record<BuiltInConverter, BuiltInConverterFunction>;
+/**
+ * Time unit types for duration conversions
+ * @internal
+ */
+type TimeUnit = 'ms' | 's' | 'm' | 'h' | 'd' | 'w';
+/**
+ * Fallback type for time duration conversions
+ * @public
+ */
+type TimeFallback = number | `${number}${TimeUnit}`;
+/**
+ * Helper type for getter methods that conditionally return undefined based on whether a fallback is provided
+ * If fallback is provided, return ReturnType. If no fallback (undefined), return ReturnType | undefined.
+ * @internal
+ */
+type ConditionalReturn<ReturnType, TFallback> = TFallback extends undefined ? ReturnType | undefined : ReturnType;
+/**
+ * Inferred return type for a converter.
+ *
+ * - `ArrayOf<E>` resolves to the element type's return as an array. When `E` is a custom
+ *   function, the function's return type drives the array element. When `E` is a scalar
+ *   token, `ConverterMap` provides the element type.
+ * - Bare scalar tokens resolve through `ConverterMap`.
+ * @internal
+ */
+type InferConverterReturnType<TConverter> = TConverter extends ArrayOf<infer Element> ? Element extends BuiltInConverter ? ConverterMap[Element][] : Element extends CustomElementConverter<infer Returned> ? Returned[] : never : TConverter extends BuiltInConverter ? BuiltInConverterReturnType<TConverter> : never;
+/**
+ * Type inference for the *fallback* slot of a converter. `Converters.Time` (scalar or array
+ * element) accepts {@link TimeFallback} / `TimeFallback[]`; everything else mirrors the
+ * return type. Add future asymmetric fallback/return converters to this conditional.
+ * @internal
+ */
+type InferConverterFallbackType<TConverter> = TConverter extends 'time' ? TimeFallback : TConverter extends ArrayOf<infer Element> ? Element extends 'time' ? TimeFallback[] : InferConverterReturnType<TConverter> : InferConverterReturnType<TConverter>;
+/**
+ * Complete type inference for advanced converter methods
+ * @internal
+ */
+type AdvancedConverterReturn<TConverter, TFallback = undefined> = ConditionalReturn<InferConverterReturnType<TConverter>, TFallback>;
+/**
+ * Type inference for primitive constructor return types
+ * @internal
+ */
+type InferPrimitiveReturnType<TConstructor extends PrimitiveConstructor> = TConstructor extends typeof String ? string : TConstructor extends typeof Number ? number : TConstructor extends typeof Boolean ? boolean : TConstructor extends typeof BigInt ? bigint : TConstructor extends typeof Symbol ? symbol : never;
+/**
+ * Type inference for primitive fallback values
+ * @internal
+ */
+type InferPrimitiveFallbackType<TFallback extends string | number | boolean | bigint | symbol | undefined> = TFallback extends string ? string : TFallback extends number ? number : TFallback extends boolean ? boolean : TFallback extends bigint ? bigint : TFallback extends symbol ? symbol : undefined;
+//#endregion
+export type { AdvancedConverterReturn, BuiltInConverter, BuiltInConverterFunction, ConditionalReturn, ConverterFunction, EnvaptConverter, InferConverterFallbackType, InferConverterReturnType, InferPrimitiveFallbackType, InferPrimitiveReturnType, JsonValue, MapOfConverterFunctions, PrimitiveConstructor, TimeFallback, TimeUnit };
+//# sourceMappingURL=Conversion.d.mts.map

package/dist/node/types/Conversion.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Conversion.d.mts","names":[],"sources":["../../../src/types/Conversion.ts"],"mappings":";;;;;AAAgG;;;KAO3F,gBAAA,GAAmB,cAAc;AAAA;AAAA;;;AAAA,KAMjC,oBAAA,UAA8B,MAAA,UAAgB,MAAA,UAAgB,OAAA,UAAiB,MAAA,UAAgB,MAAA;;;;;KAM/F,SAAA;;;;;;;;KASA,iBAAA,yBAA0C,GAAA,EAAK,SAAA,EAAW,QAAA,GAAW,SAAA,KAAc,SAAA;AAfkB;;;;AAM5F;AAN4F,KAsBrG,eAAA,cAA6B,oBAAA,GAAuB,gBAAA,GAAmB,OAAA,GAAU,iBAAA,CAAkB,SAAA;AAAA,KAEnG,aAAA;AAAA,KACA,SAAA,GAAY,SAAS;AAAA,UAChB,UAAA;EAAA,CACL,GAAA,WAAc,SAAS;AAAA;;;;;KAOvB,SAAA,GAAY,aAAA,GAAgB,SAAA,GAAY,UAAA;AAAA,UAEnC,YAAA;EACN,MAAA;EACA,MAAA;EACA,OAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;EACA,KAAA;EACA,IAAA,EAAM,SAAA;EACN,GAAA,EAAK,GAAA;EACL,MAAA,EAAQ,MAAA;EACR,IAAA,EAAM,IAAA;EACN,IAAA;AAAA;;;;;KAOC,0BAAA,sBAAgD,gBAAA,IAAoB,YAAA,CAAa,YAAA;;;;AAjC2B;KAuC5G,gCAAA,GAAmC,YAAA,CAAa,gBAAgB;;;;AArCnD;KA2Cb,wBAAA,OACE,IAAA,EAAM,UAAA,KAAe,IAAA,YAAgB,gCAAA,MACvC,gCAAA;;;;AA5CqB;KAkDrB,uBAAA,GAA0B,MAAA,CAAO,gBAAA,EAAkB,wBAAA;;;;AAhD5B;KAsDvB,QAAA;;;;;KAMA,YAAA,wBAAoC,QAAQ;;;;;;KAO5C,iBAAA,0BAA2C,SAAA,qBAA8B,UAAA,eAAyB,UAAA;AA5DhD;AAAA;;;;;;;;AAAA,KAuElD,wBAAA,eACD,UAAA,SAAmB,OAAA,kBACb,OAAA,SAAgB,gBAAA,GACZ,YAAA,CAAa,OAAA,MACb,OAAA,SAAgB,sBAAA,mBACd,QAAA,aAEN,UAAA,SAAmB,gBAAA,GACjB,0BAAA,CAA2B,UAAA;;;;;;;KASlC,0BAAA,eAAyC,UAAA,kBACxC,YAAA,GACA,UAAA,SAAmB,OAAA,kBACjB,OAAA,kBACI,YAAA,KACA,wBAAA,CAAyB,UAAA,IAC7B,wBAAA,CAAyB,UAAA;;;;;KAM5B,uBAAA,sCAA6D,iBAAA,CAC9D,wBAAA,CAAyB,UAAA,GACzB,SAAA;;;;;KAOC,wBAAA,sBAA8C,oBAAA,IAAwB,YAAA,gBAA4B,MAAA,YAEjG,YAAA,gBAA4B,MAAA,YAE1B,YAAA,gBAA4B,OAAA,aAE1B,YAAA,gBAA4B,MAAA,YAE1B,YAAA,gBAA4B,MAAA;AAvGhC;AAAA;;;AAAA,KA+GH,0BAAA,8EACD,SAAA,2BAEM,SAAA,2BAEE,SAAA,6BAEE,SAAA,2BAEE,SAAA"}

package/dist/node/types/Env.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Env.d.cts","names":[],"sources":["../../../src/types/Env.ts"],"mappings":";;;;;KAIK,WAAA;AAAW;AAAA;;AAAA,UAKN,eAAA;EACN,MAAA,CAAO,GAAA,EAAK,WAAA;EACZ,GAAA,CAAI,GAAA,EAAK,WAAW,EAAE,GAAA;EACtB,QAAA;AAAA"}

package/dist/node/types/Env.d.mts

@@ -0,0 +1,17 @@
+//#region src/types/Env.d.ts
+/**
+ * Accepted shape for environment variable lookups. Either a single key or an ordered list of keys.
+ * @public
+ */
+type EnvKeyInput = string | readonly [string, ...string[]];
+/**
+ * @internal
+ */
+interface EnvapterService {
+  getRaw(key: EnvKeyInput): string | undefined;
+  get(key: EnvKeyInput, def?: string): string | undefined;
+  isStrict(): boolean;
+}
+//#endregion
+export type { EnvKeyInput, EnvapterService };
+//# sourceMappingURL=Env.d.mts.map

package/dist/node/types/Env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Env.d.mts","names":[],"sources":["../../../src/types/Env.ts"],"mappings":";;;;;KAIK,WAAA;AAAW;AAAA;;AAAA,UAKN,eAAA;EACN,MAAA,CAAO,GAAA,EAAK,WAAA;EACZ,GAAA,CAAI,GAAA,EAAK,WAAW,EAAE,GAAA;EACtB,QAAA;AAAA"}

package/dist/{types → node/types}/Options.d.cts

@@ -13,7 +13,7 @@ interface EnvaptOptions<TFallback = string> {
   required?: boolean;
 }
 /**
- * Per-environment profile entry passed to {@link configureProfiles}.
+ * Per-environment profile entry passed to `Envapter.configureProfiles`.
  * @public
  */
 interface EnvProfile {
@@ -21,7 +21,7 @@ interface EnvProfile {
   paths: string | string[];
 }
 /**
- * Configuration object for {@link configureProfiles}. Maps each `Environment` to an optional
+ * Configuration object for `Envapter.configureProfiles`. Maps each `Environment` to an optional
  * profile override. Unspecified environments fall through to the default cascade behavior
  * (`.env.${env}.local`, `.env.local`, `.env.${env}`, `.env`).
  * @public

package/dist/node/types/Options.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Options.d.cts","names":[],"sources":["../../../src/types/Options.ts"],"mappings":";;;;;;AAC8D;;;UAOpD,aAAA;EACN,QAAA,GAAW,SAAA;EACX,SAAA,GAAY,eAAA,CAAgB,SAAA;EAC5B,QAAA;AAAA;;;;;UAOM,UAAA;EARsB;EAU5B,KAAK;AAAA;AATG;AAAA;;;;AASH;AATG,KAkBP,cAAA,GAAiB,OAAA,CAAQ,MAAA,CAAO,WAAA,EAAa,UAAA;EAA/B;;;;;EAMf,WAAA;AAAA"}