envapt 7.0.0-next.0 → 7.0.0-next.1

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

@@ -1,28 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-//#region src/types/Decorator.d.ts
-/**
- * A legacy (experimentalDecorators) property decorator that also constrains the decorated field's
- * declared type. `Output` is the value the decorator produces. The field must be wide enough to hold
- * it, so a field narrower than `Output` fails to compile while a wider or nullable field is accepted.
- * The tuple wrap stops `Output` from distributing when it is a union.
- * @public
- */
-type EnvaptFieldDecorator<Output> = <Target, Key extends keyof Target>(target: Target, key: [Output] extends [Target[Key]] ? Key : {
-  '[envapt] field type must hold the converter output': Output;
-}) => void;
-/**
- * A modern (TC39 Stage 3) accessor decorator that also constrains the decorated `accessor`'s
- * declared type. `Output` is the value the decorator produces. The accessor must be wide enough to
- * hold it, so an accessor narrower than `Output` fails to compile while a wider or nullable one is
- * accepted. The tuple wrap stops `Output` from distributing when it is a union.
- * @public
- */
-type EnvaptAccessorDecorator<Output> = <This, Value>(target: ClassAccessorDecoratorTarget<This, [Output] extends [Value] ? Value : {
-  '[envapt] field type must hold the converter output': Output;
-}>, context: ClassAccessorDecoratorContext<This, [Output] extends [Value] ? Value : {
-  '[envapt] field type must hold the converter output': Output;
-}>) => ClassAccessorDecoratorResult<This, Value>;
-//#endregion
-export { EnvaptAccessorDecorator, EnvaptFieldDecorator };
-//# sourceMappingURL=Decorator.d.mts.map

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

@@ -1,17 +0,0 @@
-//#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.cts.map

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

@@ -1,19 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-//#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/Options.d.cts

@@ -1,39 +0,0 @@
-import { EnvaptConverter } from "./Conversion.cjs";
-import { Environment } from "../core/EnvironmentMethods.cjs";
-
-//#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.cts.map

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

@@ -1,41 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-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/node/types/Schema.d.cts

@@ -1,12 +0,0 @@
-import { StandardSchemaV1 } from "../infra/StandardSchema.cjs";
-
-//#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.cts.map

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

@@ -1,14 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { StandardSchemaV1 } from "../infra/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/node/types/Source.d.cts

@@ -1,44 +0,0 @@
-//#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.cts.map

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

@@ -1,46 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-//#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/dist/workerd/converters/Converters.d.mts

@@ -1,93 +0,0 @@
-//#region src/converters/Converters.d.ts
-declare const SCALAR: {
-  readonly String: "string";
-  readonly Number: "number";
-  readonly Boolean: "boolean";
-  readonly Bigint: "bigint";
-  readonly Symbol: "symbol";
-  readonly Integer: "integer";
-  readonly Float: "float";
-  readonly Json: "json";
-  readonly Url: "url";
-  readonly Regexp: "regexp";
-  readonly Date: "date";
-  readonly Time: "time";
-};
-/**
- * String tokens for every built-in scalar converter.
- * @public
- */
-type ConverterToken = (typeof SCALAR)[keyof typeof SCALAR];
-/**
- * Custom element converter for use inside {@link Converters.array}. Receives the trimmed,
- * non-empty raw string for one array slot and returns the parsed value.
- * @public
- */
-type CustomElementConverter<TReturn = unknown> = (raw: string) => TReturn;
-/**
- * Valid element converters for {@link Converters.array}: any scalar token except
- * `json` and `regexp` (those don't compose as array elements), or a custom function.
- * @public
- */
-type ArrayElement = Exclude<ConverterToken, 'json' | 'regexp'> | CustomElementConverter;
-/**
- * Phantom-branded token produced by {@link Converters.array}. The `T` type parameter carries
- * the element converter through any variable indirection so inference survives. The
- * `__envaptKind` discriminant is present at runtime for dispatch.
- * @public
- */
-interface ArrayOf<TElement extends ArrayElement = ArrayElement> {
-  readonly __envaptKind: 'array';
-  readonly of: TElement;
-  readonly delimiter: string;
-}
-/**
- * Runtime type guard for tokens produced by {@link Converters.array}.
- * @internal
- */
-declare function isArrayOf(value: unknown): value is ArrayOf;
-type ArrayScalarElement = Exclude<ConverterToken, 'json' | 'regexp'>;
-declare function buildArrayConverter<TReturn>(opts: {
-  of: CustomElementConverter<TReturn>;
-  delimiter?: string;
-}): ArrayOf<CustomElementConverter<TReturn>>;
-declare function buildArrayConverter<TToken extends ArrayScalarElement>(opts: {
-  of: TToken;
-  delimiter?: string;
-}): ArrayOf<TToken>;
-declare function buildArrayConverter(opts?: {
-  delimiter?: string;
-}): ArrayOf<'string'>;
-/**
- * Built-in converters for environment variables. Use the scalar tokens (e.g. `Converters.Number`)
- * for primitive types and the {@link Converters.array} builder for delimited lists.
- *
- * @example
- * ```ts
- * \@Envapt('PORT', { converter: Converters.Number, fallback: 3000 })
- * static readonly port: number;
- *
- * \@Envapt('TAGS', { converter: Converters.array({ of: Converters.String, delimiter: ' ' }) })
- * static readonly tags: string[];
- * ```
- *
- * @public
- */
-declare const Converters: {
-  readonly array: typeof buildArrayConverter;
-  readonly String: "string";
-  readonly Number: "number";
-  readonly Boolean: "boolean";
-  readonly Bigint: "bigint";
-  readonly Symbol: "symbol";
-  readonly Integer: "integer";
-  readonly Float: "float";
-  readonly Json: "json";
-  readonly Url: "url";
-  readonly Regexp: "regexp";
-  readonly Date: "date";
-  readonly Time: "time";
-};
-//#endregion
-export { ArrayElement, ArrayOf, ConverterToken, Converters, CustomElementConverter, isArrayOf };
-//# sourceMappingURL=Converters.d.mts.map

package/dist/workerd/converters/ValueConverter.d.mts

@@ -1,25 +0,0 @@
-import { EnvaptConverter } from "../types/Conversion.mjs";
-import { StandardSchemaV1 } from "../infra/StandardSchema.mjs";
-import { EnvKeyInput, EnvapterService } from "../types/Env.mjs";
-
-//#region src/converters/ValueConverter.d.ts
-/**
- * Convert a resolved environment value to its declared type via built-in, primitive, array,
- * custom, or Standard Schema converters.
- * @internal
- */
-declare class ValueConverter {
-  private readonly envService;
-  constructor(envService: EnvapterService);
-  convertValue<TFallback>(key: EnvKeyInput, fallback: TFallback | undefined, converter: EnvaptConverter<TFallback> | undefined, hasFallback: boolean): TFallback | null | undefined;
-  private processFallbackForConverter;
-  private convertPrimitiveToString;
-  private processBuiltInConverter;
-  private processArrayConverter;
-  private processCustomConverter;
-  private resolveConverter;
-  convertWithSchema(key: EnvKeyInput, schema: StandardSchemaV1, fallback: unknown, hasFallback: boolean): unknown;
-}
-//#endregion
-export { ValueConverter };
-//# sourceMappingURL=ValueConverter.d.mts.map

package/dist/workerd/core/AdvancedMethods.d.mts

@@ -1,76 +0,0 @@
-import { ArrayOf } from "../converters/Converters.mjs";
-import { AdvancedConverterReturn, BuiltInConverter, ConditionalReturn, ConverterFunction, InferConverterReturnType, TimeFallback } from "../types/Conversion.mjs";
-import { InferSchemaOutput, StandardSchemaV1 } from "../infra/StandardSchema.mjs";
-import { SchemaConstraint } from "../types/Schema.mjs";
-import { EnvKeyInput } from "../types/Env.mjs";
-import { PrimitiveMethods } from "./PrimitiveMethods.mjs";
-
-//#region src/core/AdvancedMethods.d.ts
-interface GetUsingRequiredOptions<TConverter> {
-  converter: TConverter;
-  required: true;
-}
-interface GetWithRequiredOptions<TReturnType> {
-  converter: ConverterFunction<TReturnType>;
-  required: true;
-}
-/**
- * Mixin for advanced methods for environment variable conversion using built-in and custom converters
- * @internal
- */
-declare class AdvancedMethods extends PrimitiveMethods {
-  /**
-   * Get an environment variable using a built-in converter.
-   *
-   * Supports both scalar tokens (e.g. `Converters.Number`) and `ArrayOf<...>` tokens
-   * produced by `Converters.array(...)`. The key can be a single name or an ordered list;
-   * the first defined value wins.
-   */
-  static getUsing<TFallback extends TimeFallback | undefined = undefined>(key: EnvKeyInput, converter: 'time', fallback?: TFallback): ConditionalReturn<number, TFallback>;
-  static getUsing<TConverter extends BuiltInConverter | ArrayOf, TFallback = undefined>(key: EnvKeyInput, converter: TConverter, fallback?: TFallback): AdvancedConverterReturn<TConverter, TFallback>;
-  static getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter | ArrayOf, fallback?: TReturn): TReturn;
-  static getUsing(key: EnvKeyInput, options: GetUsingRequiredOptions<'time'>): number;
-  static getUsing<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: GetUsingRequiredOptions<TConverter>): InferConverterReturnType<TConverter>;
-  /**
-   * @see {@link AdvancedMethods.getUsing}
-   */
-  getUsing<TFallback extends TimeFallback | undefined = undefined>(key: EnvKeyInput, converter: 'time', fallback?: TFallback): ConditionalReturn<number, TFallback>;
-  getUsing<TConverter extends BuiltInConverter | ArrayOf, TFallback = undefined>(key: EnvKeyInput, converter: TConverter, fallback?: TFallback): AdvancedConverterReturn<TConverter, TFallback>;
-  getUsing<TReturn>(key: EnvKeyInput, converter: BuiltInConverter | ArrayOf, fallback?: TReturn): TReturn;
-  getUsing(key: EnvKeyInput, options: GetUsingRequiredOptions<'time'>): number;
-  getUsing<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: GetUsingRequiredOptions<TConverter>): InferConverterReturnType<TConverter>;
-  /**
-   * Get an environment variable using a custom converter function.
-   * Accepts a single key or an ordered list for automatic fallback.
-   */
-  static getWith<TReturnType, TFallback extends TReturnType | undefined = undefined>(key: EnvKeyInput, converter: ConverterFunction<TReturnType>, fallback?: TFallback): ConditionalReturn<TReturnType, TFallback>;
-  static getWith<TReturnType>(key: EnvKeyInput, options: GetWithRequiredOptions<TReturnType>): TReturnType;
-  /**
-   * @see {@link AdvancedMethods.getWith}
-   */
-  getWith<TReturnType, TFallback extends TReturnType | undefined = undefined>(key: EnvKeyInput, converter: ConverterFunction<TReturnType>, fallback?: TFallback): ConditionalReturn<TReturnType, TFallback>;
-  getWith<TReturnType>(key: EnvKeyInput, options: GetWithRequiredOptions<TReturnType>): TReturnType;
-  /**
-   * Validate an environment variable through a {@link StandardSchemaV1}-conformant schema
-   * (zod, valibot, arktype, etc). Throws `MissingEnvValue` if the env value is absent and
-   * no fallback is provided. The fallback, when provided, is returned as-is on missing;
-   * it does NOT pass through the schema (mirrors custom-converter behavior).
-   *
-   * Synchronous schemas only. A Promise-returning `validate` triggers an
-   * `InvalidUserDefinedConfig` throw at the call site.
-   *
-   * @example
-   * ```ts
-   * import { z } from 'zod';
-   * const port = Envapter.parse('PORT', z.coerce.number().min(1024).max(65535), 3000);
-   * ```
-   */
-  static parse<Schema extends StandardSchemaV1>(key: EnvKeyInput, schema: SchemaConstraint<Schema>, fallback?: InferSchemaOutput<Schema>): InferSchemaOutput<Schema>;
-  /**
-   * @see {@link AdvancedMethods.parse}
-   */
-  parse<Schema extends StandardSchemaV1>(key: EnvKeyInput, schema: SchemaConstraint<Schema>, fallback?: InferSchemaOutput<Schema>): InferSchemaOutput<Schema>;
-}
-//#endregion
-export { AdvancedMethods };
-//# sourceMappingURL=AdvancedMethods.d.mts.map

package/dist/workerd/core/EnvapterBase.d.mts

@@ -1,75 +0,0 @@
-import { DebugLevel } from "../infra/Debug.mjs";
-import { EnvFileOptions } from "../infra/Dotenv.mjs";
-import { EnvKeyInput } from "../types/Env.mjs";
-import { EnvSource, FileEnvSource } from "../types/Source.mjs";
-
-//#region src/core/EnvapterBase.d.ts
-/** @internal */
-declare abstract class EnvapterBase {
-  protected static _envPaths: string[];
-  protected static _envPathsExplicitlySet: boolean;
-  protected static _baseDir: string | undefined;
-  protected static _userDefinedEnvFileOptions: EnvFileOptions;
-  protected static _strict: boolean;
-  protected static _syncProcessEnv: boolean;
-  protected static _dotenvAddedKeys: Set<string>;
-  protected static _source: EnvSource;
-  /**
-   * Enable or disable strict mode. Default `false`. Setting refreshes the cache so
-   * previously-cached converted values get re-evaluated under the new rule.
-   */
-  static set strict(value: boolean);
-  static get strict(): boolean;
-  /**
-   * Set the debug log level. Defaults to `silent`. When unset, reads `ENVAPT_DEBUG` from the
-   * bound source on first access; the setter overrides any env-var value. Output goes to stderr
-   * on Node (the console elsewhere), prefixed with `[envapt]`.
-   */
-  static set debug(level: DebugLevel);
-  static get debug(): DebugLevel;
-  /**
-   * Opt-in mirror of dotenv-loaded keys back to `process.env`. Default `false`.
-   *
-   * Only keys the loader actually wrote are mirrored, so collision behavior follows
-   * `envFileOptions.override`: with the default `false`, pre-existing `process.env` values
-   * are preserved; with `true`, the file value wins in both the cache and the mirror.
-   *
-   * Flipping `false → true` mirrors the existing tracked delta immediately (no cache
-   * refresh). Flipping `true → false` is one-way: previously mirrored keys remain in
-   * `process.env` until the process exits.
-   */
-  static set syncProcessEnv(value: boolean);
-  static get syncProcessEnv(): boolean;
-  protected static treatAsMissing(value: string | undefined): boolean;
-  protected static resolveAgainstBase(candidate: string): string;
-  protected static assertFileApiSupported(api: string, source: EnvSource): asserts source is FileEnvSource;
-  protected static sourceFileExists(path: string): boolean;
-  protected static refreshCache(): void;
-  protected static mirrorToProcessEnv(): void;
-  protected static resolveEffectivePaths(): string[];
-  protected static resolveKeyInput(keyInput: EnvKeyInput): {
-    key: string;
-    value: string | undefined;
-  };
-  protected static get config(): Map<string, unknown>;
-  /**
-   * Eagerly load the `.env` cascade now instead of lazily on the first read. Idempotent: a no-op
-   * once the cache is built. Useful before mirroring to `process.env` (see {@link syncProcessEnv}),
-   * which is what the `envapt/config` side-effect entry does.
-   */
-  static load(): void;
-  /**
-   * Bind the environment {@link EnvSource}. On Node the entry binds {@link NodeEnvSource} for you
-   * (a `process.env` snapshot plus the `.env` cascade); on the browser or Workers, pass a
-   * `ManualEnvSource` / `WorkerEnvSource` (or any `EnvSource`) before reading. Clears and rebuilds
-   * the cache.
-   */
-  static useSource(source: EnvSource): void;
-  /**
-   * Read an environment variable as its raw string, skipping parsing and conversion.
-   */
-  getRaw(key: EnvKeyInput): string | undefined;
-}
-//#endregion
-export { EnvapterBase };
-//# sourceMappingURL=EnvapterBase.d.mts.map

package/dist/workerd/core/EnvironmentMethods.d.mts

@@ -1,115 +0,0 @@
-import { EnvapterBase } from "./EnvapterBase.mjs";
-import { ProfilesConfig } from "../types/Options.mjs";
-
-//#region src/core/EnvironmentMethods.d.ts
-/**
- * Environment types supported by Envapter
- * @public
- */
-declare enum Environment {
-  Development = 0,
-  Staging = 1,
-  Production = 2,
-  Test = 3
-}
-/**
- * Mixin for environment detection and checking methods
- * @internal
- */
-declare class EnvironmentMethods extends EnvapterBase {
-  protected static _environment: Environment | undefined;
-  protected static _environmentExplicitlySet: boolean;
-  protected static _profiles: ProfilesConfig | undefined;
-  protected static determineEnvironment(env?: string | Environment): void;
-  private static firstEnvKeyValue;
-  /**
-   * Get the current application environment
-   */
-  static get environment(): Environment;
-  /**
-   * Set the application environment. Accepts either Environment enum or string value.
-   */
-  static set environment(env: string | Environment);
-  /**
-   * @see {@link EnvironmentMethods.environment}
-   */
-  get environment(): Environment;
-  /**
-   * @see {@link EnvironmentMethods.environment}
-   */
-  set environment(env: string | Environment);
-  /**
-   * Check if the current environment is production
-   */
-  static get isProduction(): boolean;
-  /**
-   * @see {@link EnvironmentMethods.isProduction}
-   */
-  get isProduction(): boolean;
-  /**
-   * Check if the current environment is staging
-   */
-  static get isStaging(): boolean;
-  /**
-   * @see {@link EnvironmentMethods.isStaging}
-   */
-  get isStaging(): boolean;
-  /**
-   * Check if the current environment is development
-   */
-  static get isDevelopment(): boolean;
-  /**
-   * @see {@link EnvironmentMethods.isDevelopment}
-   */
-  get isDevelopment(): boolean;
-  /**
-   * Check if the current environment is test
-   */
-  static get isTest(): boolean;
-  /**
-   * @see {@link EnvironmentMethods.isTest}
-   */
-  get isTest(): boolean;
-  protected static refreshCache(): void;
-  /**
-   * Reads the source's raw vars (not `this.config`, which would recurse: cascade selection runs
-   * before the `.env` load). `Envapter.environment` may differ post-load if a file sets `ENVIRONMENT`.
-   * @internal
-   */
-  protected static getCascadeEnvironment(): Environment;
-  /**
-   * Build the dotenv-flow cascade for a given environment, in dotenv first-wins precedence
-   * order (highest precedence first). Missing files are silently filtered.
-   *
-   * Precedence is **most-specific-wins** (matches Vite / Astro / Vocs):
-   *   `.env.${env}.local` \> `.env.${env}` \> `.env.local` \> `.env`
-   *
-   * This differs from dotenv-flow / Next.js convention which puts `.env.local` above
-   * `.env.${env}`. We chose the most-specific-wins order so committed env-specific files
-   * (`.env.production`) are authoritative for that environment regardless of whether a
-   * stray `.env.local` is present.
-   * @internal
-   */
-  protected static buildCascadePaths(env: Environment): string[];
-  private static normalizeProfilePaths;
-  /**
-   * Override the base implementation to layer the dotenv-flow cascade + any
-   * `Envapter.configureProfiles` overrides on top of `_envPaths` when the user has NOT
-   * explicitly set `envPaths`.
-   *
-   * Precedence (passed to dotenv with first-wins semantics):
-   *   1. profile-configured paths for the current env (if any)
-   *   2. `.env.${env}.local`
-   *   3. `.env.${env}`
-   *   4. `.env.local`
-   *   5. `.env`
-   *
-   * If `useDefaults: false` is set on the profiles config, only (1) is loaded, no cascade.
-   * If `envPaths` was explicitly set, only `envPaths` is loaded (everything else ignored).
-   * @internal
-   */
-  protected static resolveEffectivePaths(): string[];
-}
-//#endregion
-export { Environment, EnvironmentMethods };
-//# sourceMappingURL=EnvironmentMethods.d.mts.map