envapt 5.1.1 → 5.2.0-next.1

package/dist/workerd/index.mjs

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

package/dist/workerd/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/workerd.ts"],"sourcesContent":["import { installFileApiStubs } from './installFileApiStubs';\n\nexport * from './browser';\n\ninstallFileApiStubs();\n"],"mappings":"2kBAIA,EAAoB"}

package/dist/workerd/installFileApiStubs.mjs

@@ -0,0 +1,2 @@
+import{EnvaptError as e}from"./Error.mjs";import{Envapter as t}from"./Envapter.mjs";const n=[`envPaths`,`baseDir`,`envFileOptions`,`configureProfiles`,`resetProfiles`];function r(t){throw new e(306,`Envapter.${t} requires a filesystem-backed source and is not available in this build.`)}function i(){for(let e of n)Object.defineProperty(t,e,{configurable:!0,get:()=>r(e),set:()=>r(e)})}export{i as installFileApiStubs};
+//# sourceMappingURL=installFileApiStubs.mjs.map

package/dist/workerd/installFileApiStubs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"installFileApiStubs.mjs","names":[],"sources":["../../src/installFileApiStubs.ts"],"sourcesContent":["import { Envapter } from './Envapter';\nimport { EnvaptError, EnvaptErrorCodes } from './Error';\n\nconst FILE_ONLY_APIS = ['envPaths', 'baseDir', 'envFileOptions', 'configureProfiles', 'resetProfiles'] as const;\n\nfunction fileApiUnsupported(api: string): never {\n    throw new EnvaptError(\n        EnvaptErrorCodes.FileApiUnsupported,\n        `Envapter.${api} requires a filesystem-backed source and is not available in this build.`\n    );\n}\n\n// Call from each entry's own top level, not via `export * from` another entry: the build tree-shakes a\n// re-exported entry's side effect away, which would silently drop these stubs from that entry's output.\nexport function installFileApiStubs(): void {\n    for (const api of FILE_ONLY_APIS) {\n        Object.defineProperty(Envapter, api, {\n            configurable: true,\n            get: () => fileApiUnsupported(api),\n            set: () => fileApiUnsupported(api)\n        });\n    }\n}\n"],"mappings":"oFAGA,MAAM,EAAiB,CAAC,WAAY,UAAW,iBAAkB,oBAAqB,eAAe,EAErG,SAAS,EAAmB,EAAoB,CAC5C,MAAM,IAAI,EAAA,IAEN,YAAY,EAAI,yEACpB,CACJ,CAIA,SAAgB,GAA4B,CACxC,IAAK,IAAM,KAAO,EACd,OAAO,eAAe,EAAU,EAAK,CACjC,aAAc,GACd,QAAW,EAAmB,CAAG,EACjC,QAAW,EAAmB,CAAG,CACrC,CAAC,CAET"}

package/dist/workerd/runtime.mjs

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

package/dist/workerd/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,GAOtD,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/workerd/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/workerd/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/workerd/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/workerd/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/workerd/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/workerd/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/workerd/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/workerd/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/workerd/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/workerd/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/workerd/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/workerd/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/workerd/types/Options.d.mts

@@ -0,0 +1,39 @@
+import { EnvaptConverter } from "./Conversion.mjs";
+import { Environment } from "../core/EnvironmentMethods.mjs";
+
+//#region src/types/Options.d.ts
+/**
+ * Options for the \@Envapt decorator (modern API). `required: true` is mutually exclusive
+ * with `fallback`; see the per-converter overloads in `Envapt.ts` for the type-level mutex.
+ * @public
+ */
+interface EnvaptOptions<TFallback = string> {
+  fallback?: TFallback;
+  converter?: EnvaptConverter<TFallback>;
+  required?: boolean;
+}
+/**
+ * Per-environment profile entry passed to `Envapter.configureProfiles`.
+ * @public
+ */
+interface EnvProfile {
+  /** One or more `.env` paths to load for this environment. Order matters: earlier paths take precedence. */
+  paths: string | string[];
+}
+/**
+ * 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
+ */
+type ProfilesConfig = Partial<Record<Environment, EnvProfile>> & {
+  /**
+   * When `false`, disables the default dotenv-flow cascade entirely. Only the explicitly
+   * configured paths are loaded. Defaults to `true` (cascade still runs, configured paths
+   * are layered on top with higher precedence).
+   */
+  useDefaults?: boolean;
+};
+//#endregion
+export type { EnvProfile, EnvaptOptions, ProfilesConfig };
+//# sourceMappingURL=Options.d.mts.map

package/dist/workerd/types/Schema.d.mts

@@ -0,0 +1,12 @@
+import { StandardSchemaV1 } from "../StandardSchema.mjs";
+
+//#region src/types/Schema.d.ts
+declare const _envaptErrBrand: unique symbol;
+type Err<Msg extends string> = Msg & {
+  readonly [_envaptErrBrand]: never;
+};
+type SchemaMustBeSync = Err<'Schema must be synchronous. envapt is boot-time config loading; async refinements (validate returning `Promise<Result>`) belong outside the env layer.'>;
+type SchemaConstraint<Schema extends StandardSchemaV1> = ReturnType<Schema['~standard']['validate']> extends Promise<unknown> ? SchemaMustBeSync : Schema;
+//#endregion
+export type { Err, SchemaConstraint, SchemaMustBeSync };
+//# sourceMappingURL=Schema.d.mts.map

package/dist/workerd/types/Source.d.mts

@@ -0,0 +1,44 @@
+//#region src/types/Source.d.ts
+/**
+ * A source with no filesystem: an injected object on the browser, or the Cloudflare `env` binding on
+ * Workers. The `.env` cascade, profiles, and the `envPaths`/`baseDir`/`configureProfiles` APIs do not
+ * apply; only `readVars()` populates the cache.
+ * @public
+ */
+interface BareEnvSource {
+  /** Return every variable this source provides, as plain strings. */
+  readVars(): Record<string, string>;
+  /** Leave unset (or `false`); a bare source has no filesystem. */
+  readonly supportsFiles?: false;
+}
+/**
+ * A filesystem-backed source, like the default {@link NodeEnvSource}. Setting `supportsFiles` to
+ * `true` requires all four file capabilities, so the engine can load the `.env` cascade, resolve
+ * `baseDir`, and mirror loaded keys back to the ambient environment.
+ * @public
+ */
+interface FileEnvSource {
+  /** Return every variable this source provides, as plain strings. */
+  readVars(): Record<string, string>;
+  /** When `true`, the engine loads the `.env` cascade, profiles, and `envPaths` through the methods below. */
+  readonly supportsFiles: true;
+  /** Read a file's text, or `undefined` when it is absent or unreadable. Backs the loader and existence checks. */
+  readFile(path: string, encoding: string): string | undefined;
+  /** Join a relative `.env` path onto `baseDir`; absolute paths are returned unchanged. */
+  resolvePath(baseDir: string, candidate: string): string;
+  /** Normalize a `baseDir` value (a directory path, or a module / `file:` URL) to an absolute directory path. */
+  normalizeBaseDir(value: string | URL): string;
+  /** Mirror loaded keys back to the ambient environment (e.g. `process.env`); backs `Envapter.syncProcessEnv`. */
+  writeVars(vars: Record<string, string>): void;
+}
+/**
+ * A pluggable source of environment variables. The default {@link NodeEnvSource} (a
+ * {@link FileEnvSource}) reads `process.env` plus the `.env` cascade; a {@link BareEnvSource} lets the
+ * same engine run where there is no ambient environment (an injected object on the browser, the
+ * Cloudflare `env` binding on Workers). Bind one with `Envapter.useSource`.
+ * @public
+ */
+type EnvSource = BareEnvSource | FileEnvSource;
+//#endregion
+export type { BareEnvSource, EnvSource, FileEnvSource };
+//# sourceMappingURL=Source.d.mts.map

package/package.json

@@ -1,34 +1,64 @@
 {
   "name": "envapt",
   "type": "module",
-  "version": "5.1.1",
-  "description": "Type-safe environment variables for TypeScript. Zero-dependency .env loader and parser with the same API on Node, Bun, and Deno. Decorators, converters, and Standard Schema (zod/valibot/arktype) validation.",
-  "types": "./dist/index.d.mts",
+  "version": "5.2.0-next.1",
+  "description": "Type-safe environment variables for TypeScript. Zero-dependency typed reader with the same API on Node, Bun, Deno, Cloudflare Workers, and the browser; loads .env files on Node, Bun, and Deno. Decorators, converters, and Standard Schema (zod/valibot/arktype) validation.",
+  "types": "./dist/node/index.d.mts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.mjs"
+      "workerd": {
+        "types": "./dist/workerd/index.d.mts",
+        "default": "./dist/workerd/index.mjs"
       },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
+      "browser": {
+        "types": "./dist/browser/index.d.mts",
+        "default": "./dist/browser/index.mjs"
+      },
+      "node": {
+        "import": {
+          "types": "./dist/node/index.d.mts",
+          "default": "./dist/node/index.mjs"
+        },
+        "require": {
+          "types": "./dist/node/index.d.cts",
+          "default": "./dist/node/index.cjs"
+        }
+      },
+      "default": {
+        "import": {
+          "types": "./dist/node/index.d.mts",
+          "default": "./dist/node/index.mjs"
+        },
+        "require": {
+          "types": "./dist/node/index.d.cts",
+          "default": "./dist/node/index.cjs"
+        }
       }
     },
+    "./workerd": {
+      "types": "./dist/workerd/index.d.mts",
+      "default": "./dist/workerd/index.mjs"
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.mts",
+      "default": "./dist/browser/index.mjs"
+    },
     "./config": {
       "import": {
-        "types": "./dist/config.d.mts",
-        "default": "./dist/config.mjs"
+        "types": "./dist/node/config.d.mts",
+        "default": "./dist/node/config.mjs"
       },
       "require": {
-        "types": "./dist/config.d.cts",
-        "default": "./dist/config.cjs"
+        "types": "./dist/node/config.d.cts",
+        "default": "./dist/node/config.cjs"
       }
     }
   },
   "sideEffects": [
-    "./dist/config.cjs",
-    "./dist/config.mjs"
+    "./dist/node/config.cjs",
+    "./dist/node/config.mjs",
+    "./dist/browser/index.mjs",
+    "./dist/workerd/index.mjs"
   ],
   "files": [
     "dist",
@@ -55,6 +85,9 @@
     "type-safe",
     "deno",
     "bun",
+    "cloudflare-workers",
+    "workers",
+    "browser",
     "zod",
     "valibot",
     "arktype",
@@ -77,17 +110,23 @@
     "provenance": true
   },
   "devDependencies": {
+    "@cloudflare/vitest-pool-workers": "0.16.14",
+    "@cloudflare/workers-types": "^4.20260609.1",
+    "@vitest/browser": "4.1.7",
+    "@vitest/browser-playwright": "4.1.7",
     "arktype": "^2.2.0",
-    "expect-type": "^1.3.0",
+    "esbuild": "^0.28.0",
+    "playwright": "1.60.0",
     "valibot": "^1.4.1",
     "zod": "4.4.3"
   },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "tsdown",
+    "build": "pnpm run clean && tsdown",
+    "build:verify": "pnpm tsx scripts/verify-no-node.ts",
     "dev": "tsc --watch",
-    "lint": "eslint '{src,tests,scripts}/**/*.{ts,tsx}' --cache",
-    "lint:fix": "eslint '{src,tests,scripts}/**/*.{ts,tsx}' --fix --cache",
+    "lint": "eslint '{src,tests,scripts}/**/*.{ts,tsx,mjs,cjs}' --cache",
+    "lint:fix": "eslint '{src,tests,scripts}/**/*.{ts,tsx,mjs,cjs}' --fix --cache",
     "fmt": "prettier --write '{src,tests,scripts}/**/*.{ts,tsx,json,md}' --cache",
     "fmt:check": "prettier --check '{src,tests,scripts}/**/*.{ts,tsx,json,md}' --cache",
     "fmt:all": "prettier --write .",
@@ -96,6 +135,10 @@
     "test": "vitest run",
     "test:watch": "vitest dev",
     "test:integration": "node tests/integration/run.mjs",
+    "test:workers": "tsc --noEmit -p tests/workers/tsconfig.json && vitest run --config vitest.workers.config.ts",
+    "test:browser": "tsc --noEmit -p tests/browser/tsconfig.json && vitest run --config vitest.browser.config.ts",
+    "test:consumer-build": "node tests/consumer-build/run.mjs",
+    "test:all": "node ../../scripts/test-all.mjs",
     "coverage": "pnpm run test --coverage",
     "cs": "changeset",
     "cs:publish": "changeset publish",
@@ -103,5 +146,5 @@
     "bump": "pnpm tsx ../../scripts/bump-jsr.ts",
     "release": "pnpm run cs:publish"
   },
-  "readme": "<img src=\"https://raw.githubusercontent.com/materwelonDhruv/envapt/main/.github/assets/logo.png\" width=\"120\" align=\"left\" alt=\"envapt logo\" />\n\n<h3>envapt</h3>\n\n<p>\n  <strong>The apt way to handle environment variables.</strong><br/>\n  Read them as typed values, with zero runtime dependencies.\n</p>\n\n<p>\n  <a href=\"https://www.npmjs.com/package/envapt\"><img alt=\"npm\" src=\"https://img.shields.io/npm/v/envapt?logo=npm&logoColor=cb3838&label=%20&labelColor=103544&color=cb3838\"></a>\n  <a href=\"https://www.npmjs.com/package/envapt\"><img alt=\"downloads\" src=\"https://img.shields.io/npm/dm/envapt?style=flat&color=f7f6e8&labelColor=103544&label=downloads\"></a>\n  <a href=\"https://jsr.io/@materwelon/envapt\"><img alt=\"jsr\" src=\"https://jsr.io/badges/@materwelon/envapt\"></a>\n  <img alt=\"CI\" src=\"https://img.shields.io/github/actions/workflow/status/materwelonDhruv/envapt/checks.yml?branch=main&label=tests&style=flat&logo=github&color=3fb950&labelColor=103544\">\n  <a href=\"LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/npm/l/envapt?style=flat&color=e97826&logo=apache&label=\"></a>\n</p>\n\n<br clear=\"left\"/>\n\n`process.env` always hands you a `string | undefined`. envapt returns the type you asked for, with a\nfallback that removes `undefined` from the return type.\n\n```ts\nimport { Envapter } from 'envapt';\n\nconst port = Envapter.getNumber('PORT', 3000); // number, not string | undefined\n```\n\n**[Read the docs →](https://envapt.materwelon.dev)**\n\n## What you get\n\n- **Typed values.** A fallback removes `undefined` from the return type. Built-in converters cover\n  numbers, booleans, bigint, JSON, URLs, regular expressions, dates, durations, and arrays, or pass\n  your own function or a Standard Schema validator (zod, valibot, arktype).\n- **Zero runtime dependencies.** envapt ships its own `.env` parser, so nothing is added to your\n  dependency tree.\n- **Runs on Node, Bun, and Deno.** Node `>=20`, Bun `>=1.3`, Deno `>=2.5`; ESM and CJS.\n- **`.env` loading built in.** A per-environment file cascade, `${VAR}` templates, and strict /\n  required checks.\n\n## Install\n\n```sh\nnpm install envapt\npnpm add envapt\nyarn add envapt\nbun add envapt\ndeno add jsr:@materwelon/envapt\n```\n\n## Quick start\n\nRead values functionally with `Envapter`, or bind them to class fields with the `@Envapt` decorator.\nBoth share the same parsing, converters, and cache.\n\n### Functional\n\nRead a value from any call site, in JavaScript or TypeScript. No build step.\n\n```ts\nimport { Envapter, Converters } from 'envapt';\n\nconst port = Envapter.getNumber('PORT', 3000);\nconst origins = Envapter.getUsing('ALLOWED_ORIGINS', Converters.array(), []);\n```\n\n### Decorator\n\nBind a value to a class field. TypeScript, with `experimentalDecorators` in your `tsconfig.json`.\n\n```ts\nimport { Envapt, Converters } from 'envapt';\n\nclass Config {\n    @Envapt('PORT', { converter: Converters.Number, fallback: 3000 })\n    declare static readonly port: number;\n}\n```\n\n## Documentation\n\nThe guide, converter reference, validation, configuration, and the v4 to v5 migration live at\n**[envapt.materwelon.dev](https://envapt.materwelon.dev)**.\n\n## Agent skill\n\nInstall the envapt agent skill so AI coding tools use the correct API:\n\n```sh\nnpx skills add materwelonDhruv/envapt\n```\n\n---\n\n<p align=\"center\"><sub>Built by <a href=\"https://github.com/materwelondhruv\">@materwelonDhruv</a> · Apache 2.0</sub></p>\n"
+  "readme": "<img src=\"https://raw.githubusercontent.com/materwelonDhruv/envapt/main/.github/assets/logo.png\" width=\"120\" align=\"left\" alt=\"envapt logo\" />\n\n<h3>envapt</h3>\n\n<p>\n  <strong>The apt way to handle environment variables.</strong><br/>\n  Read them as typed values, with zero runtime dependencies.\n</p>\n\n<p>\n  <a href=\"https://www.npmjs.com/package/envapt\"><img alt=\"npm\" src=\"https://img.shields.io/npm/v/envapt?logo=npm&logoColor=cb3838&label=%20&labelColor=103544&color=cb3838\"></a>\n  <a href=\"https://www.npmjs.com/package/envapt\"><img alt=\"downloads\" src=\"https://img.shields.io/npm/dm/envapt?style=flat&color=f7f6e8&labelColor=103544&label=downloads\"></a>\n  <a href=\"https://jsr.io/@materwelon/envapt\"><img alt=\"jsr\" src=\"https://jsr.io/badges/@materwelon/envapt\"></a>\n  <img alt=\"CI\" src=\"https://img.shields.io/github/actions/workflow/status/materwelonDhruv/envapt/checks.yml?branch=main&label=tests&style=flat&logo=github&color=3fb950&labelColor=103544\">\n  <a href=\"LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/npm/l/envapt?style=flat&color=e97826&logo=apache&label=\"></a>\n</p>\n\n<br clear=\"left\"/>\n\n`process.env` always hands you a `string | undefined`. envapt returns the type you asked for, with a\nfallback that removes `undefined` from the return type. On Node, Bun, and Deno it reads `process.env`\nand your `.env` files; on Cloudflare Workers and in the browser you bind the source with\n`Envapter.useSource(...)`.\n\n```ts\nimport { Envapter } from 'envapt';\n\nconst port = Envapter.getNumber('PORT', 3000); // number, not string | undefined\n```\n\n**[Read the docs →](https://envapt.materwelon.dev)**\n\n## What you get\n\n- **Typed values.** A fallback removes `undefined` from the return type. Built-in converters cover\n  numbers, booleans, bigint, JSON, URLs, regular expressions, dates, durations, and arrays, or pass\n  your own function or a Standard Schema validator (zod, valibot, arktype).\n- **Zero runtime dependencies.** envapt ships its own `.env` parser, so nothing is added to your\n  dependency tree.\n- **Runs on Node, Bun, Deno, Cloudflare Workers, and the browser.** Node `>=20`, Bun `>=1.3`, Deno\n  `>=2.5` (ESM and CJS); the Workers and browser builds resolve through the package `exports`\n  conditions.\n- **`.env` loading on Node, Bun, and Deno.** A per-environment file cascade, `${VAR}` templates, and\n  strict / required checks. Off Node there is no filesystem, so you bind a source with\n  `Envapter.useSource(...)` and read with the same typed API.\n\n## Install\n\n```sh\nnpm install envapt\npnpm add envapt\nyarn add envapt\nbun add envapt\ndeno add jsr:@materwelon/envapt\n```\n\n## Quick start\n\nRead values functionally with `Envapter`, or bind them to class fields with the `@Envapt` decorator.\nBoth share the same parsing, converters, and cache.\n\n### Functional\n\nRead a value from any call site, in JavaScript or TypeScript. No build step. On Node the source is\nbound for you; on Workers and in the browser, call `Envapter.useSource(...)` first.\n\n```ts\nimport { Envapter, Converters } from 'envapt';\n\nconst port = Envapter.getNumber('PORT', 3000);\nconst origins = Envapter.getUsing('ALLOWED_ORIGINS', Converters.array(), []);\n```\n\nOn Cloudflare Workers, `env` is importable at module scope, so bind it once in a config module; in the\nbrowser, seed a `ManualEnvSource` from the object your bundler injects.\n\n```ts\nimport { env } from 'cloudflare:workers';\nimport { Envapter, WorkerEnvSource } from 'envapt';\n\nEnvapter.useSource(new WorkerEnvSource(env));\n\nexport const apiToken = Envapter.get('API_TOKEN');\n```\n\n### Decorator\n\nBind a value to a class field. TypeScript, with `experimentalDecorators` in your `tsconfig.json`.\n\n```ts\nimport { Envapt, Converters } from 'envapt';\n\nclass Config {\n    @Envapt('PORT', { converter: Converters.Number, fallback: 3000 })\n    declare static readonly port: number;\n}\n```\n\n## Documentation\n\nThe guide, converter reference, validation, configuration, and the v4 to v5 migration live at\n**[envapt.materwelon.dev](https://envapt.materwelon.dev)**.\n\n## Agent skill\n\nInstall the envapt agent skill so AI coding tools use the correct API:\n\n```sh\nnpx skills add materwelonDhruv/envapt\n```\n\n---\n\n<p align=\"center\"><sub>Built by <a href=\"https://github.com/materwelondhruv\">@materwelonDhruv</a> · Apache 2.0</sub></p>\n"
 }

package/dist/Debug.cjs

@@ -1,2 +0,0 @@
-const e=require("./_virtual/_rolldown/runtime.cjs"),t=require("./Error.cjs");let n=require("node:process");n=e.__toESM(n,1);const r=new Set([`silent`,`warn`,`verbose`]);let i=`silent`,a=!1;function o(e){return e!==void 0&&r.has(e)}function s(){if(!a){let e=n.default.env.ENVAPT_DEBUG;i=o(e)?e:`silent`,a=!0}return i}function c(e){if(!o(e))throw new t.EnvaptError(302,`Invalid debug level "${String(e)}". Expected 'silent' | 'warn' | 'verbose'.`);i=e,a=!0}function l(){return s()}function u(e){let t=s();(t===`warn`||t===`verbose`)&&n.default.stderr.write(`[envapt] ${e}\n`)}function d(e){s()===`verbose`&&n.default.stderr.write(`[envapt] ${e}\n`)}exports.debugVerbose=d,exports.debugWarn=u,exports.getDebugLevel=l,exports.setDebugLevel=c;
-//# sourceMappingURL=Debug.cjs.map

package/dist/Debug.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Debug.cjs","names":["process","EnvaptError"],"sources":["../src/Debug.ts"],"sourcesContent":["import process from 'node:process';\n\nimport { EnvaptError, EnvaptErrorCodes } from './Error';\n\n/**\n * Debug log levels for {@link Envapter.debug}. `silent` (default) emits nothing.\n * `warn` covers signals that might indicate misconfiguration: failed file reads,\n * unresolved templates (when not strict), fallback values used in place of missing\n * env. `verbose` adds every loaded file, per-file key count, per-key load lines, and\n * effective-paths / cache-rebuild notices.\n * @public\n */\nexport type DebugLevel = 'silent' | 'warn' | 'verbose';\n\nconst VALID_LEVELS: ReadonlySet<string> = new Set<DebugLevel>(['silent', 'warn', 'verbose']);\n\nlet currentLevel: DebugLevel = 'silent';\nlet initialized = false;\n\nfunction isDebugLevel(value: string | undefined): value is DebugLevel {\n    return value !== undefined && VALID_LEVELS.has(value);\n}\n\n// Reads `ENVAPT_DEBUG` lazily on first access. Setter wins after that.\nfunction resolveLevel(): DebugLevel {\n    if (!initialized) {\n        const fromEnv = process.env.ENVAPT_DEBUG;\n        currentLevel = isDebugLevel(fromEnv) ? fromEnv : 'silent';\n        initialized = true;\n    }\n    return currentLevel;\n}\n\n/** @internal */\nexport function setDebugLevel(level: DebugLevel): void {\n    if (!isDebugLevel(level)) {\n        throw new EnvaptError(\n            EnvaptErrorCodes.InvalidUserDefinedConfig,\n            `Invalid debug level \"${String(level)}\". Expected 'silent' | 'warn' | 'verbose'.`\n        );\n    }\n    currentLevel = level;\n    initialized = true;\n}\n\n/** @internal */\nexport function getDebugLevel(): DebugLevel {\n    return resolveLevel();\n}\n\n/** @internal */\nexport function resetDebugForTesting(): void {\n    currentLevel = 'silent';\n    initialized = false;\n}\n\n/** @internal */\nexport function debugWarn(message: string): void {\n    const level = resolveLevel();\n    if (level === 'warn' || level === 'verbose') {\n        process.stderr.write(`[envapt] ${message}\\n`);\n    }\n}\n\n/** @internal */\nexport function debugVerbose(message: string): void {\n    if (resolveLevel() === 'verbose') {\n        process.stderr.write(`[envapt] ${message}\\n`);\n    }\n}\n"],"mappings":"4HAcA,MAAM,EAAoC,IAAI,IAAgB,CAAC,SAAU,OAAQ,SAAS,CAAC,EAE3F,IAAI,EAA2B,SAC3B,EAAc,GAElB,SAAS,EAAa,EAAgD,CAClE,OAAO,IAAU,IAAA,IAAa,EAAa,IAAI,CAAK,CACxD,CAGA,SAAS,GAA2B,CAChC,GAAI,CAAC,EAAa,CACd,IAAM,EAAUA,EAAAA,QAAQ,IAAI,aAC5B,EAAe,EAAa,CAAO,EAAI,EAAU,SACjD,EAAc,EAClB,CACA,OAAO,CACX,CAGA,SAAgB,EAAc,EAAyB,CACnD,GAAI,CAAC,EAAa,CAAK,EACnB,MAAM,IAAIC,EAAAA,YAAAA,IAEN,wBAAwB,OAAO,CAAK,EAAE,2CAC1C,EAEJ,EAAe,EACf,EAAc,EAClB,CAGA,SAAgB,GAA4B,CACxC,OAAO,EAAa,CACxB,CASA,SAAgB,EAAU,EAAuB,CAC7C,IAAM,EAAQ,EAAa,GACvB,IAAU,QAAU,IAAU,YAC9B,EAAA,QAAQ,OAAO,MAAM,YAAY,EAAQ,GAAG,CAEpD,CAGA,SAAgB,EAAa,EAAuB,CAC5C,EAAa,IAAM,WACnB,EAAA,QAAQ,OAAO,MAAM,YAAY,EAAQ,GAAG,CAEpD"}

package/dist/Debug.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Debug.d.cts","names":[],"sources":["../src/Debug.ts"],"mappings":";;AAYA;;;;AAAsB;;;KAAV,UAAA"}

package/dist/Debug.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Debug.d.mts","names":[],"sources":["../src/Debug.ts"],"mappings":";;AAYA;;;;AAAsB;;;KAAV,UAAA"}

package/dist/Debug.mjs

@@ -1,2 +0,0 @@
-import{EnvaptError as e}from"./Error.mjs";import t from"node:process";const n=new Set([`silent`,`warn`,`verbose`]);let r=`silent`,i=!1;function a(e){return e!==void 0&&n.has(e)}function o(){if(!i){let e=t.env.ENVAPT_DEBUG;r=a(e)?e:`silent`,i=!0}return r}function s(t){if(!a(t))throw new e(302,`Invalid debug level "${String(t)}". Expected 'silent' | 'warn' | 'verbose'.`);r=t,i=!0}function c(){return o()}function l(e){let n=o();(n===`warn`||n===`verbose`)&&t.stderr.write(`[envapt] ${e}\n`)}function u(e){o()===`verbose`&&t.stderr.write(`[envapt] ${e}\n`)}export{u as debugVerbose,l as debugWarn,c as getDebugLevel,s as setDebugLevel};
-//# sourceMappingURL=Debug.mjs.map

package/dist/Debug.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Debug.mjs","names":[],"sources":["../src/Debug.ts"],"sourcesContent":["import process from 'node:process';\n\nimport { EnvaptError, EnvaptErrorCodes } from './Error';\n\n/**\n * Debug log levels for {@link Envapter.debug}. `silent` (default) emits nothing.\n * `warn` covers signals that might indicate misconfiguration: failed file reads,\n * unresolved templates (when not strict), fallback values used in place of missing\n * env. `verbose` adds every loaded file, per-file key count, per-key load lines, and\n * effective-paths / cache-rebuild notices.\n * @public\n */\nexport type DebugLevel = 'silent' | 'warn' | 'verbose';\n\nconst VALID_LEVELS: ReadonlySet<string> = new Set<DebugLevel>(['silent', 'warn', 'verbose']);\n\nlet currentLevel: DebugLevel = 'silent';\nlet initialized = false;\n\nfunction isDebugLevel(value: string | undefined): value is DebugLevel {\n    return value !== undefined && VALID_LEVELS.has(value);\n}\n\n// Reads `ENVAPT_DEBUG` lazily on first access. Setter wins after that.\nfunction resolveLevel(): DebugLevel {\n    if (!initialized) {\n        const fromEnv = process.env.ENVAPT_DEBUG;\n        currentLevel = isDebugLevel(fromEnv) ? fromEnv : 'silent';\n        initialized = true;\n    }\n    return currentLevel;\n}\n\n/** @internal */\nexport function setDebugLevel(level: DebugLevel): void {\n    if (!isDebugLevel(level)) {\n        throw new EnvaptError(\n            EnvaptErrorCodes.InvalidUserDefinedConfig,\n            `Invalid debug level \"${String(level)}\". Expected 'silent' | 'warn' | 'verbose'.`\n        );\n    }\n    currentLevel = level;\n    initialized = true;\n}\n\n/** @internal */\nexport function getDebugLevel(): DebugLevel {\n    return resolveLevel();\n}\n\n/** @internal */\nexport function resetDebugForTesting(): void {\n    currentLevel = 'silent';\n    initialized = false;\n}\n\n/** @internal */\nexport function debugWarn(message: string): void {\n    const level = resolveLevel();\n    if (level === 'warn' || level === 'verbose') {\n        process.stderr.write(`[envapt] ${message}\\n`);\n    }\n}\n\n/** @internal */\nexport function debugVerbose(message: string): void {\n    if (resolveLevel() === 'verbose') {\n        process.stderr.write(`[envapt] ${message}\\n`);\n    }\n}\n"],"mappings":"sEAcA,MAAM,EAAoC,IAAI,IAAgB,CAAC,SAAU,OAAQ,SAAS,CAAC,EAE3F,IAAI,EAA2B,SAC3B,EAAc,GAElB,SAAS,EAAa,EAAgD,CAClE,OAAO,IAAU,IAAA,IAAa,EAAa,IAAI,CAAK,CACxD,CAGA,SAAS,GAA2B,CAChC,GAAI,CAAC,EAAa,CACd,IAAM,EAAU,EAAQ,IAAI,aAC5B,EAAe,EAAa,CAAO,EAAI,EAAU,SACjD,EAAc,EAClB,CACA,OAAO,CACX,CAGA,SAAgB,EAAc,EAAyB,CACnD,GAAI,CAAC,EAAa,CAAK,EACnB,MAAM,IAAI,EAAA,IAEN,wBAAwB,OAAO,CAAK,EAAE,2CAC1C,EAEJ,EAAe,EACf,EAAc,EAClB,CAGA,SAAgB,GAA4B,CACxC,OAAO,EAAa,CACxB,CASA,SAAgB,EAAU,EAAuB,CAC7C,IAAM,EAAQ,EAAa,GACvB,IAAU,QAAU,IAAU,YAC9B,EAAQ,OAAO,MAAM,YAAY,EAAQ,GAAG,CAEpD,CAGA,SAAgB,EAAa,EAAuB,CAC5C,EAAa,IAAM,WACnB,EAAQ,OAAO,MAAM,YAAY,EAAQ,GAAG,CAEpD"}

package/dist/Dotenv.cjs

@@ -1,3 +0,0 @@
-const e=require("./_virtual/_rolldown/runtime.cjs"),t=require("./Debug.cjs");let n=require("node:fs");n=e.__toESM(n,1);const r=/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=(.*)$/u;function i(e){let t=new Map,n=e.split(/\r?\n/u);for(let e=0;e<n.length;e++){let r=a(n,e);e=r.endLine,r.entry&&t.set(r.entry.key,r.entry.value)}return t}function a(e,t){let n=e[t]??``,i=n.trim();if(i===``||i.startsWith(`#`))return{entry:void 0,endLine:t};let a=n.match(r);if(!a)return{entry:void 0,endLine:t};let c=a[1],l=(a[2]??``).replace(/^\s+/u,``),u=l[0];if(u===`"`||u===`'`||u==="`"){let n=o(l,e,t,u);return{entry:{key:c,value:n.value},endLine:n.endLine}}return{entry:{key:c,value:s(l)},endLine:t}}function o(e,t,n,r){let i=e,a=n,o=l(i,r);for(;o<0&&a<t.length-1;)a++,i+=`\n${t[a]??``}`,o=l(i,r);let s=o>0?i.slice(1,o):i.slice(1);return{value:r===`"`?u(s):s,endLine:a}}function s(e){let t=c(e);return(t===-1?e:e.slice(0,t)).trimEnd()}function c(e){for(let t=0;t<e.length;t++)if(e[t]===`#`&&(t===0||/\s/u.test(e[t-1])))return t;return-1}function l(e,t){for(let n=e.length-1;n>0;n--)if(e[n]===t){if(t===`"`){let t=0,r=n-1;for(;r>=0&&e[r]===`\\`;)t++,r--;if(t%2==1)continue}return n}return-1}function u(e){let t=``;for(let n=0;n<e.length;n++){let r=e[n];if(r!==`\\`||n===e.length-1){t+=r;continue}let i=e[n+1];switch(n++,i){case`n`:t+=`
-`;break;case`r`:t+=`\r`;break;case`t`:t+=`	`;break;case`\\`:t+=`\\`;break;case`"`:t+=`"`;break;default:t+=`\\${i??``}`}}return t}function d(e){let r=Array.isArray(e.path)?e.path:[e.path],a=e.encoding??`utf8`,o=e.override??!1,s=new Set;for(let c of r){let r;try{r=n.default.readFileSync(c,a)}catch{t.debugWarn(`could not read ${c}`);continue}let l=i(r);t.debugVerbose(`loaded ${c}: ${l.size} ${l.size===1?`key`:`keys`}`);for(let[n,r]of l)(!Object.prototype.hasOwnProperty.call(e.processEnv,n)||o)&&(e.processEnv[n]=r,s.add(n),t.debugVerbose(`${c} -> ${n}`))}return s}exports.loadDotenv=d;
-//# sourceMappingURL=Dotenv.cjs.map

package/dist/Dotenv.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Dotenv.cjs","names":["fs"],"sources":["../src/Dotenv.ts"],"sourcesContent":["import fs from 'node:fs';\n\nimport { debugVerbose, debugWarn } from './Debug';\n\n/**\n * Public options for the internal `.env` loader. Mirrors the subset of dotenv's\n * `config()` options that envapt actually supports (no DOTENV_KEY, no quiet).\n * For debug output, use `Envapter.debug` (or the `ENVAPT_DEBUG` env var).\n *\n * @public\n */\nexport interface EnvFileOptions {\n    /** Encoding for reading .env files. Defaults to 'utf8'. */\n    encoding?: BufferEncoding;\n    /** When true, later files override earlier ones (and existing processEnv values). Default false (first-wins). */\n    override?: boolean;\n}\n\n/**\n * Internal call signature used by `EnvapterBase`. The `path` and `processEnv`\n * fields are managed by envapt and never user-supplied.\n * @internal\n */\nexport interface LoadDotenvInput extends EnvFileOptions {\n    path: string | string[];\n    processEnv: Record<string, string>;\n}\n\n// Matches: optional `export`, KEY name, optional whitespace, `=`, optional whitespace, value tail.\n// Multi-line quoted values are handled by re-buffering subsequent lines below.\n// Bounded by anchors with linear-time quantifiers; no catastrophic backtracking risk -- justified\n// eslint-disable-next-line security/detect-unsafe-regex\nconst KEY_LINE_RE = /^\\s*(?:export\\s+)?([A-Za-z_][A-Za-z0-9_]*)\\s*=(.*)$/u;\n\n/**\n * Parse a `.env` text blob into a `Map<string, string>`.\n *\n * Supported syntax:\n * - `KEY=value` and `export KEY=value`\n * - blank lines and full-line `# comments`\n * - single-quoted `'literal'` values (no escape interpretation)\n * - double-quoted `\"value\"` values (interprets `\\n`, `\\r`, `\\t`, `\\\\`, `\\\"`)\n * - backtick-quoted values (literal, like single quotes)\n * - quoted values may span multiple lines\n * - inline `# comment` after an unquoted value (requires whitespace before `#`)\n * - empty values resolve to `\"\"`\n *\n * Mirrors dotenv's quirk where unescaped inner quotes inside a quoted value\n * are tolerated by greedy-matching to the rightmost matching quote on the\n * (possibly multi-line) value buffer. This is what lets a value like\n * `JSON=\"{\"name\":\"x\"}\"` round-trip without escaping.\n *\n * Does NOT perform `${VAR}` expansion — envapt's `Parser` handles that downstream.\n * @internal\n */\nexport function parseDotenv(src: string): Map<string, string> {\n    const out = new Map<string, string>();\n    const lines = src.split(/\\r?\\n/u);\n\n    for (let i = 0; i < lines.length; i++) {\n        const consumed = parseEntry(lines, i);\n        i = consumed.endLine;\n        if (consumed.entry) out.set(consumed.entry.key, consumed.entry.value);\n    }\n\n    return out;\n}\n\ninterface ParsedEntry {\n    key: string;\n    value: string;\n}\n\nfunction parseEntry(lines: string[], start: number): { entry: ParsedEntry | undefined; endLine: number } {\n    /* v8 ignore next -- @preserve caller bounds-checks start so this never falls back */\n    const line = lines[start] ?? '';\n    const trimmedLine = line.trim();\n    if (trimmedLine === '' || trimmedLine.startsWith('#')) return { entry: undefined, endLine: start };\n\n    const match = line.match(KEY_LINE_RE);\n    if (!match) return { entry: undefined, endLine: start };\n\n    const key = match[1] as string;\n    // Drop only leading whitespace before the value; trailing whitespace and inline comments\n    // are dealt with below depending on whether the value is quoted.\n    /* v8 ignore next -- @preserve regex group 2 always matches via `(.*)`, fallback is defensive */\n    const rest = (match[2] ?? '').replace(/^\\s+/u, '');\n    const firstChar = rest[0];\n\n    if (firstChar === '\"' || firstChar === \"'\" || firstChar === '`') {\n        const consumed = consumeQuotedValue(rest, lines, start, firstChar);\n        return { entry: { key, value: consumed.value }, endLine: consumed.endLine };\n    }\n\n    return { entry: { key, value: stripInlineComment(rest) }, endLine: start };\n}\n\nfunction consumeQuotedValue(\n    firstLineRest: string,\n    lines: string[],\n    startLine: number,\n    quote: string\n): { value: string; endLine: number } {\n    let buffer = firstLineRest;\n    let cursor = startLine;\n    let closeIdx = findLastUnescapedQuote(buffer, quote);\n\n    while (closeIdx < 0 && cursor < lines.length - 1) {\n        cursor++;\n        /* v8 ignore next -- @preserve cursor is bounded by the while condition above */\n        buffer += `\\n${lines[cursor] ?? ''}`;\n        closeIdx = findLastUnescapedQuote(buffer, quote);\n    }\n\n    const inner = closeIdx > 0 ? buffer.slice(1, closeIdx) : buffer.slice(1);\n    return { value: quote === '\"' ? unescapeDouble(inner) : inner, endLine: cursor };\n}\n\nfunction stripInlineComment(value: string): string {\n    const hashIdx = findInlineCommentStart(value);\n    const stripped = hashIdx === -1 ? value : value.slice(0, hashIdx);\n    return stripped.trimEnd();\n}\n\nfunction findInlineCommentStart(value: string): number {\n    for (let i = 0; i < value.length; i++) {\n        if (value[i] === '#' && (i === 0 || /\\s/u.test(value[i - 1] as string))) return i;\n    }\n    return -1;\n}\n\n/**\n * Find the rightmost matching closing quote in `buffer` (skipping index 0 which is the\n * opening quote). For `\"`, a quote preceded by an odd number of backslashes is escaped\n * and ignored. Single and backtick quotes do not unescape.\n */\nfunction findLastUnescapedQuote(buffer: string, quote: string): number {\n    for (let i = buffer.length - 1; i > 0; i--) {\n        if (buffer[i] !== quote) continue;\n        if (quote === '\"') {\n            let backslashes = 0;\n            let k = i - 1;\n            while (k >= 0 && buffer[k] === '\\\\') {\n                backslashes++;\n                k--;\n            }\n            if (backslashes % 2 === 1) continue; // escaped\n        }\n        return i;\n    }\n    return -1;\n}\n\nfunction unescapeDouble(raw: string): string {\n    let out = '';\n    for (let i = 0; i < raw.length; i++) {\n        const ch = raw[i];\n        if (ch !== '\\\\' || i === raw.length - 1) {\n            out += ch;\n            continue;\n        }\n        const next = raw[i + 1];\n        i++;\n        switch (next) {\n            case 'n':\n                out += '\\n';\n                break;\n            case 'r':\n                out += '\\r';\n                break;\n            case 't':\n                out += '\\t';\n                break;\n            case '\\\\':\n                out += '\\\\';\n                break;\n            case '\"':\n                out += '\"';\n                break;\n            default:\n                /* v8 ignore next -- @preserve `next` is always defined when this branch is reached (guarded above) */\n                out += `\\\\${next ?? ''}`;\n        }\n    }\n    return out;\n}\n\n/**\n * Load one or more `.env` files into a target `processEnv` map. Mirrors the\n * subset of dotenv's `config()` semantics that envapt depends on: first-wins\n * across multiple paths by default, optional `override: true`, optional\n * non-UTF8 encoding, missing files are skipped silently.\n *\n * Returns the set of keys actually written into `input.processEnv`. Skipped\n * collisions (under default `override: false`) are NOT included.\n * @internal\n */\nexport function loadDotenv(input: LoadDotenvInput): Set<string> {\n    const paths = Array.isArray(input.path) ? input.path : [input.path];\n    const encoding: BufferEncoding = input.encoding ?? 'utf8';\n    const override = input.override ?? false;\n    const written = new Set<string>();\n\n    for (const filePath of paths) {\n        let src: string;\n        try {\n            src = fs.readFileSync(filePath, encoding);\n        } catch {\n            debugWarn(`could not read ${filePath}`);\n            continue;\n        }\n\n        const parsed = parseDotenv(src);\n        debugVerbose(`loaded ${filePath}: ${parsed.size} ${parsed.size === 1 ? 'key' : 'keys'}`);\n        for (const [key, value] of parsed) {\n            const exists = Object.prototype.hasOwnProperty.call(input.processEnv, key);\n            if (!exists || override) {\n                input.processEnv[key] = value;\n                written.add(key);\n                debugVerbose(`${filePath} -> ${key}`);\n            }\n        }\n    }\n\n    return written;\n}\n"],"mappings":"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"}

package/dist/Dotenv.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Dotenv.d.cts","names":[],"sources":["../src/Dotenv.ts"],"mappings":";;AAWA;;;;;;UAAiB,cAAA;EAIL;EAFR,QAAA,GAAW,cAAc;;EAEzB,QAAA;AAAA"}

package/dist/Dotenv.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Dotenv.d.mts","names":[],"sources":["../src/Dotenv.ts"],"mappings":";;AAWA;;;;;;UAAiB,cAAA;EAIL;EAFR,QAAA,GAAW,cAAc;;EAEzB,QAAA;AAAA"}

package/dist/Dotenv.mjs

@@ -1,3 +0,0 @@
-import{debugVerbose as e,debugWarn as t}from"./Debug.mjs";import n from"node:fs";const r=/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=(.*)$/u;function i(e){let t=new Map,n=e.split(/\r?\n/u);for(let e=0;e<n.length;e++){let r=a(n,e);e=r.endLine,r.entry&&t.set(r.entry.key,r.entry.value)}return t}function a(e,t){let n=e[t]??``,i=n.trim();if(i===``||i.startsWith(`#`))return{entry:void 0,endLine:t};let a=n.match(r);if(!a)return{entry:void 0,endLine:t};let c=a[1],l=(a[2]??``).replace(/^\s+/u,``),u=l[0];if(u===`"`||u===`'`||u==="`"){let n=o(l,e,t,u);return{entry:{key:c,value:n.value},endLine:n.endLine}}return{entry:{key:c,value:s(l)},endLine:t}}function o(e,t,n,r){let i=e,a=n,o=l(i,r);for(;o<0&&a<t.length-1;)a++,i+=`\n${t[a]??``}`,o=l(i,r);let s=o>0?i.slice(1,o):i.slice(1);return{value:r===`"`?u(s):s,endLine:a}}function s(e){let t=c(e);return(t===-1?e:e.slice(0,t)).trimEnd()}function c(e){for(let t=0;t<e.length;t++)if(e[t]===`#`&&(t===0||/\s/u.test(e[t-1])))return t;return-1}function l(e,t){for(let n=e.length-1;n>0;n--)if(e[n]===t){if(t===`"`){let t=0,r=n-1;for(;r>=0&&e[r]===`\\`;)t++,r--;if(t%2==1)continue}return n}return-1}function u(e){let t=``;for(let n=0;n<e.length;n++){let r=e[n];if(r!==`\\`||n===e.length-1){t+=r;continue}let i=e[n+1];switch(n++,i){case`n`:t+=`
-`;break;case`r`:t+=`\r`;break;case`t`:t+=`	`;break;case`\\`:t+=`\\`;break;case`"`:t+=`"`;break;default:t+=`\\${i??``}`}}return t}function d(r){let a=Array.isArray(r.path)?r.path:[r.path],o=r.encoding??`utf8`,s=r.override??!1,c=new Set;for(let l of a){let a;try{a=n.readFileSync(l,o)}catch{t(`could not read ${l}`);continue}let u=i(a);e(`loaded ${l}: ${u.size} ${u.size===1?`key`:`keys`}`);for(let[t,n]of u)(!Object.prototype.hasOwnProperty.call(r.processEnv,t)||s)&&(r.processEnv[t]=n,c.add(t),e(`${l} -> ${t}`))}return c}export{d as loadDotenv};
-//# sourceMappingURL=Dotenv.mjs.map