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

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

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

@@ -1,115 +0,0 @@
-import { ProfilesConfig } from "../types/Options.cjs";
-import { EnvapterBase } from "./EnvapterBase.cjs";
-
-//#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.cts.map

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

@@ -1,117 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { ProfilesConfig } from "../types/Options.mjs";
-import { EnvapterBase } from "./EnvapterBase.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

package/dist/node/core/PrimitiveMethods.d.cts

@@ -1,70 +0,0 @@
-import { ConditionalReturn } from "../types/Conversion.cjs";
-import { EnvironmentMethods } from "./EnvironmentMethods.cjs";
-import { EnvKeyInput, EnvapterService } from "../types/Env.cjs";
-import { ValueConverter } from "../converters/ValueConverter.cjs";
-import { TemplateResolver } from "../engine/TemplateResolver.cjs";
-
-//#region src/core/PrimitiveMethods.d.ts
-/**
- * @internal
- */
-declare class PrimitiveMethods extends EnvironmentMethods implements EnvapterService {
-  private static readonly service;
-  protected static readonly templateResolver: TemplateResolver;
-  protected static readonly valueConverter: ValueConverter;
-  isStrict(): boolean;
-  private static _get;
-  /**
-   * Get a string environment variable with optional fallback.
-   * Supports template variable resolution using `${VAR}` syntax.
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static get<Default extends string | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<string, Default>;
-  /**
-   * @see {@link PrimitiveMethods.get}
-   */
-  get<Default extends string | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<string, Default>;
-  /**
-   * Get a number environment variable with optional fallback.
-   * Automatically converts string values to numbers.
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static getNumber<Default extends number | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<number, Default>;
-  /**
-   * @see {@link PrimitiveMethods.getNumber}
-   */
-  getNumber<Default extends number | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<number, Default>;
-  /**
-   * Get a boolean environment variable with optional fallback.
-   * Recognizes: `1`, `yes`, `true`, `on` as **true**; `0`, `no`, `false`, `off` as **false** (case-insensitive).
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static getBoolean<Default extends boolean | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<boolean, Default>;
-  /**
-   * @see {@link PrimitiveMethods.getBoolean}
-   */
-  getBoolean<Default extends boolean | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<boolean, Default>;
-  /**
-   * Get a bigint environment variable with optional fallback.
-   * Automatically converts string values to bigint.
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static getBigInt<Default extends bigint | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<bigint, Default>;
-  /**
-   * @see {@link PrimitiveMethods.getBigInt}
-   */
-  getBigInt<Default extends bigint | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<bigint, Default>;
-  /**
-   * Get a symbol environment variable with optional fallback.
-   * Creates a symbol from the string value.
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static getSymbol<Default extends symbol | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<symbol, Default>;
-  /**
-   * @see {@link PrimitiveMethods.getSymbol}
-   */
-  getSymbol<Default extends symbol | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<symbol, Default>;
-}
-//#endregion
-export { PrimitiveMethods };
-//# sourceMappingURL=PrimitiveMethods.d.cts.map

package/dist/node/core/PrimitiveMethods.d.mts

@@ -1,72 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { ConditionalReturn } from "../types/Conversion.mjs";
-import { EnvironmentMethods } from "./EnvironmentMethods.mjs";
-import { EnvKeyInput, EnvapterService } from "../types/Env.mjs";
-import { ValueConverter } from "../converters/ValueConverter.mjs";
-import { TemplateResolver } from "../engine/TemplateResolver.mjs";
-
-//#region src/core/PrimitiveMethods.d.ts
-/**
- * @internal
- */
-declare class PrimitiveMethods extends EnvironmentMethods implements EnvapterService {
-  private static readonly service;
-  protected static readonly templateResolver: TemplateResolver;
-  protected static readonly valueConverter: ValueConverter;
-  isStrict(): boolean;
-  private static _get;
-  /**
-   * Get a string environment variable with optional fallback.
-   * Supports template variable resolution using `${VAR}` syntax.
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static get<Default extends string | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<string, Default>;
-  /**
-   * @see {@link PrimitiveMethods.get}
-   */
-  get<Default extends string | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<string, Default>;
-  /**
-   * Get a number environment variable with optional fallback.
-   * Automatically converts string values to numbers.
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static getNumber<Default extends number | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<number, Default>;
-  /**
-   * @see {@link PrimitiveMethods.getNumber}
-   */
-  getNumber<Default extends number | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<number, Default>;
-  /**
-   * Get a boolean environment variable with optional fallback.
-   * Recognizes: `1`, `yes`, `true`, `on` as **true**; `0`, `no`, `false`, `off` as **false** (case-insensitive).
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static getBoolean<Default extends boolean | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<boolean, Default>;
-  /**
-   * @see {@link PrimitiveMethods.getBoolean}
-   */
-  getBoolean<Default extends boolean | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<boolean, Default>;
-  /**
-   * Get a bigint environment variable with optional fallback.
-   * Automatically converts string values to bigint.
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static getBigInt<Default extends bigint | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<bigint, Default>;
-  /**
-   * @see {@link PrimitiveMethods.getBigInt}
-   */
-  getBigInt<Default extends bigint | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<bigint, Default>;
-  /**
-   * Get a symbol environment variable with optional fallback.
-   * Creates a symbol from the string value.
-   * Accepts a single key or an ordered array of keys (first match wins).
-   */
-  static getSymbol<Default extends symbol | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<symbol, Default>;
-  /**
-   * @see {@link PrimitiveMethods.getSymbol}
-   */
-  getSymbol<Default extends symbol | undefined = undefined>(key: EnvKeyInput, def?: Default): ConditionalReturn<symbol, Default>;
-}
-//#endregion
-export { PrimitiveMethods };
-//# sourceMappingURL=PrimitiveMethods.d.mts.map

package/dist/node/decorators/legacy/Envapt.d.cts

@@ -1,218 +0,0 @@
-import { ArrayOf } from "../../converters/Converters.cjs";
-import { BuiltInConverter, ConverterFunction, InferConverterFallbackType, InferConverterReturnType, InferPrimitiveReturnType, PrimitiveConstructor } from "../../types/Conversion.cjs";
-import { InferSchemaOutput, StandardSchemaV1 } from "../../infra/StandardSchema.cjs";
-import { SchemaConstraint } from "../../types/Schema.cjs";
-import { EnvKeyInput } from "../../types/Env.cjs";
-import { EnvaptFieldDecorator } from "../../types/Decorator.cjs";
-
-//#region src/decorators/legacy/Envapt.d.ts
-/**
- * A custom converter function with a fallback (both required), or a fallback only.
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options
- * @public
- * @example
- * ```ts
- * class Config extends Envapter {
- *   \@Envapt('API_KEY', {
- *     fallback: 'default-key',
- *     converter(raw, _fallback) {
- *       if (!raw || raw.trim() === '') throw new Error('API_KEY required');
- *       return raw.trim();
- *     }
- *   })
- *   static readonly apiKey: string;
- *
- *   \@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })
- *   static readonly logFile: string;
- *
- *   \@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })
- *   static readonly retryPolicy: unknown;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput, options: {
-  fallback: undefined;
-  converter?: undefined;
-}): EnvaptFieldDecorator<string | undefined>;
-declare function Envapt<TFallback>(key: EnvKeyInput, options: {
-  converter: (raw: string | undefined, fallback: TFallback) => TFallback;
-  fallback: TFallback;
-} | {
-  fallback: TFallback;
-  converter?: undefined;
-}): EnvaptFieldDecorator<TFallback>;
-/**
- * A custom converter function without a fallback. Omit `required` to return the converter's
- * output (possibly `undefined`), or pass `required: true` to throw `MissingEnvValue` on
- * missing or empty values.
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options
- * @public
- * @example
- * ```ts
- * class Config extends Envapter {
- *   \@Envapt('FEATURE_FLAGS', { converter(raw) {
- *     return raw ? raw.split('|').map(s => s.trim()) : [];
- *   } })
- *   static readonly featureFlags: string[];
- *
- *   \@Envapt('JWT_SECRET', {
- *     converter: (raw) => Buffer.from(raw ?? '', 'base64'),
- *     required: true
- *   })
- *   static readonly jwtSecret: Buffer;
- * }
- * ```
- */
-declare function Envapt<TReturnType>(key: EnvKeyInput, options: {
-  converter: ConverterFunction<TReturnType>;
-  required?: false;
-} | {
-  converter: ConverterFunction<TReturnType>;
-  required: true;
-}): EnvaptFieldDecorator<TReturnType>;
-/**
- * A built-in or array converter with a fallback, or `required: true`. The fallback type tracks
- * the converter, so `Converters.Time` takes a number or time-string and `Converters.Url` takes
- * a `URL` instance.
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options
- * @public
- * @example
- * ```ts
- * import { Converters } from 'envapt';
- *
- * class Config extends Envapter {
- *   \@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })
- *   static readonly port: number;
- *
- *   // the Url fallback is a URL instance, not a string
- *   \@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })
- *   static readonly url: URL;
- *
- *   // prefers CANARY_URL when present, otherwise APP_URL
- *   \@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })
- *   static readonly canaryUrl: URL | null;
- *
- *   // Time takes a number (milliseconds) or a time-string fallback (`<number><unit>`)
- *   \@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })
- *   static readonly requestTimeout: number;
- *
- *   \@Envapt('ALLOWED_ORIGINS', {
- *     converter: Converters.array({ of: Converters.String }),
- *     fallback: ['https://example.com']
- *   })
- *   static readonly allowedOrigins: string[];
- *
- *   \@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })
- *   static readonly databaseUrl: URL;
- * }
- * ```
- */
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  fallback: InferConverterFallbackType<TConverter>;
-  required?: false;
-} | {
-  converter: TConverter;
-  required: true;
-}): EnvaptFieldDecorator<InferConverterReturnType<TConverter>>;
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  fallback: undefined;
-  required?: false;
-}): EnvaptFieldDecorator<InferConverterReturnType<TConverter> | undefined>;
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  required?: false;
-}): EnvaptFieldDecorator<InferConverterReturnType<TConverter> | null>;
-/**
- * A primitive constructor (`Number`, `Boolean`) with an optional fallback.
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options
- * @public
- * @example
- * ```ts
- * class Config extends Envapter {
- *   \@Envapt('MAX_CONNECTIONS', { converter: Number, fallback: 100 })
- *   static readonly maxConnections: number;
- *
- *   \@Envapt('FEATURE_ENABLED', { converter: Boolean, fallback: false })
- *   static readonly featureEnabled: boolean;
- * }
- * ```
- */
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  fallback: InferPrimitiveReturnType<TConstructor>;
-  required?: false;
-} | {
-  converter: TConstructor;
-  required: true;
-}): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor>>;
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  fallback: undefined;
-  required?: false;
-}): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor> | undefined>;
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  required?: false;
-}): EnvaptFieldDecorator<InferPrimitiveReturnType<TConstructor> | null>;
-/**
- * Required, no converter (raw string). Throws `MissingEnvValue` on first access when the env
- * value is missing or empty after trimming, independent of the global `Envapter.strict` flag.
- * Pairing `required: true` with `fallback` matches no overload at compile time, and the runtime
- * Validator rejects dynamic objects that bypass the types.
- *
- * @param key - Environment variable name(s) to load
- * @param options - `{ required: true }`
- * @public
- * @example
- * ```ts
- * class Config extends Envapter {
- *   \@Envapt('API_KEY', { required: true })
- *   static readonly apiKey: string;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput, options: {
-  required: true;
-}): EnvaptFieldDecorator<string>;
-/**
- * No-fallback form. The property resolves from env or `null`.
- *
- * @param key - Environment variable name(s) to load
- * @public
- * @example
- * ```ts
- * class Config extends Envapter {
- *   \@Envapt('SIMPLE_VALUE')
- *   static readonly simple?: string | null;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput): EnvaptFieldDecorator<string | null>;
-/**
- * A Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous schemas only,
- * so a Promise-returning `validate` throws `InvalidUserDefinedConfig` at runtime. Pairing
- * `schema` with `converter` matches no overload at compile time, and the runtime Validator
- * rejects dynamic objects that bypass the types.
- * @public
- */
-declare function Envapt<Schema extends StandardSchemaV1>(key: EnvKeyInput, options: {
-  schema: SchemaConstraint<Schema>;
-  fallback?: InferSchemaOutput<Schema>;
-  required?: false;
-} | {
-  schema: SchemaConstraint<Schema>;
-  required: true;
-}): EnvaptFieldDecorator<InferSchemaOutput<Schema>>;
-//#endregion
-export { Envapt };
-//# sourceMappingURL=Envapt.d.cts.map