envapt 7.0.0-next.0 → 7.0.0-next.2

package/dist/node/decorators/modern/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 { EnvaptAccessorDecorator } from "../../types/Decorator.cjs";
-
-//#region src/decorators/modern/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 {
- *   \@Envapt('API_KEY', {
- *     fallback: 'default-key',
- *     converter(raw, _fallback) {
- *       if (!raw || raw.trim() === '') throw new Error('API_KEY required');
- *       return raw.trim();
- *     }
- *   })
- *   static accessor apiKey: string;
- *
- *   \@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })
- *   static accessor logFile: string;
- *
- *   \@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })
- *   static accessor retryPolicy: unknown;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput, options: {
-  fallback: undefined;
-  converter?: undefined;
-}): EnvaptAccessorDecorator<string | undefined>;
-declare function Envapt<TFallback>(key: EnvKeyInput, options: {
-  converter: (raw: string | undefined, fallback: TFallback) => TFallback;
-  fallback: TFallback;
-} | {
-  fallback: TFallback;
-  converter?: undefined;
-}): EnvaptAccessorDecorator<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 {
- *   \@Envapt('FEATURE_FLAGS', { converter(raw) {
- *     return raw ? raw.split('|').map(s => s.trim()) : [];
- *   } })
- *   static accessor featureFlags: string[];
- *
- *   \@Envapt('JWT_SECRET', {
- *     converter: (raw) => Buffer.from(raw ?? '', 'base64'),
- *     required: true
- *   })
- *   static accessor jwtSecret: Buffer;
- * }
- * ```
- */
-declare function Envapt<TReturnType>(key: EnvKeyInput, options: {
-  converter: ConverterFunction<TReturnType>;
-  required?: false;
-} | {
-  converter: ConverterFunction<TReturnType>;
-  required: true;
-}): EnvaptAccessorDecorator<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 {
- *   \@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })
- *   static accessor 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 accessor url: URL;
- *
- *   // prefers CANARY_URL when present, otherwise APP_URL
- *   \@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })
- *   static accessor canaryUrl: URL | null;
- *
- *   // Time takes a number (milliseconds) or a time-string fallback (`<number><unit>`)
- *   \@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })
- *   static accessor requestTimeout: number;
- *
- *   \@Envapt('ALLOWED_ORIGINS', {
- *     converter: Converters.array({ of: Converters.String }),
- *     fallback: ['https://example.com']
- *   })
- *   static accessor allowedOrigins: string[];
- *
- *   \@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })
- *   static accessor databaseUrl: URL;
- * }
- * ```
- */
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  fallback: InferConverterFallbackType<TConverter>;
-  required?: false;
-} | {
-  converter: TConverter;
-  required: true;
-}): EnvaptAccessorDecorator<InferConverterReturnType<TConverter>>;
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  fallback: undefined;
-  required?: false;
-}): EnvaptAccessorDecorator<InferConverterReturnType<TConverter> | undefined>;
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  required?: false;
-}): EnvaptAccessorDecorator<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 {
- *   \@Envapt('MAX_CONNECTIONS', { converter: Number, fallback: 100 })
- *   static accessor maxConnections: number;
- *
- *   \@Envapt('FEATURE_ENABLED', { converter: Boolean, fallback: false })
- *   static accessor featureEnabled: boolean;
- * }
- * ```
- */
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  fallback: InferPrimitiveReturnType<TConstructor>;
-  required?: false;
-} | {
-  converter: TConstructor;
-  required: true;
-}): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor>>;
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  fallback: undefined;
-  required?: false;
-}): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor> | undefined>;
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  required?: false;
-}): EnvaptAccessorDecorator<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 {
- *   \@Envapt('API_KEY', { required: true })
- *   static accessor apiKey: string;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput, options: {
-  required: true;
-}): EnvaptAccessorDecorator<string>;
-/**
- * No-fallback form. The property resolves from env or `null`.
- *
- * @param key - Environment variable name(s) to load
- * @public
- * @example
- * ```ts
- * class Config {
- *   \@Envapt('SIMPLE_VALUE')
- *   static accessor simple: string | null;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput): EnvaptAccessorDecorator<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;
-}): EnvaptAccessorDecorator<InferSchemaOutput<Schema>>;
-//#endregion
-export { Envapt };
-//# sourceMappingURL=Envapt.d.cts.map

package/dist/node/decorators/modern/Envapt.d.mts

@@ -1,220 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { ArrayOf } from "../../converters/Converters.mjs";
-import { BuiltInConverter, ConverterFunction, InferConverterFallbackType, InferConverterReturnType, InferPrimitiveReturnType, PrimitiveConstructor } from "../../types/Conversion.mjs";
-import { InferSchemaOutput, StandardSchemaV1 } from "../../infra/StandardSchema.mjs";
-import { SchemaConstraint } from "../../types/Schema.mjs";
-import { EnvKeyInput } from "../../types/Env.mjs";
-import { EnvaptAccessorDecorator } from "../../types/Decorator.mjs";
-
-//#region src/decorators/modern/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 {
- *   \@Envapt('API_KEY', {
- *     fallback: 'default-key',
- *     converter(raw, _fallback) {
- *       if (!raw || raw.trim() === '') throw new Error('API_KEY required');
- *       return raw.trim();
- *     }
- *   })
- *   static accessor apiKey: string;
- *
- *   \@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })
- *   static accessor logFile: string;
- *
- *   \@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })
- *   static accessor retryPolicy: unknown;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput, options: {
-  fallback: undefined;
-  converter?: undefined;
-}): EnvaptAccessorDecorator<string | undefined>;
-declare function Envapt<TFallback>(key: EnvKeyInput, options: {
-  converter: (raw: string | undefined, fallback: TFallback) => TFallback;
-  fallback: TFallback;
-} | {
-  fallback: TFallback;
-  converter?: undefined;
-}): EnvaptAccessorDecorator<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 {
- *   \@Envapt('FEATURE_FLAGS', { converter(raw) {
- *     return raw ? raw.split('|').map(s => s.trim()) : [];
- *   } })
- *   static accessor featureFlags: string[];
- *
- *   \@Envapt('JWT_SECRET', {
- *     converter: (raw) => Buffer.from(raw ?? '', 'base64'),
- *     required: true
- *   })
- *   static accessor jwtSecret: Buffer;
- * }
- * ```
- */
-declare function Envapt<TReturnType>(key: EnvKeyInput, options: {
-  converter: ConverterFunction<TReturnType>;
-  required?: false;
-} | {
-  converter: ConverterFunction<TReturnType>;
-  required: true;
-}): EnvaptAccessorDecorator<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 {
- *   \@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })
- *   static accessor 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 accessor url: URL;
- *
- *   // prefers CANARY_URL when present, otherwise APP_URL
- *   \@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })
- *   static accessor canaryUrl: URL | null;
- *
- *   // Time takes a number (milliseconds) or a time-string fallback (`<number><unit>`)
- *   \@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })
- *   static accessor requestTimeout: number;
- *
- *   \@Envapt('ALLOWED_ORIGINS', {
- *     converter: Converters.array({ of: Converters.String }),
- *     fallback: ['https://example.com']
- *   })
- *   static accessor allowedOrigins: string[];
- *
- *   \@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })
- *   static accessor databaseUrl: URL;
- * }
- * ```
- */
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  fallback: InferConverterFallbackType<TConverter>;
-  required?: false;
-} | {
-  converter: TConverter;
-  required: true;
-}): EnvaptAccessorDecorator<InferConverterReturnType<TConverter>>;
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  fallback: undefined;
-  required?: false;
-}): EnvaptAccessorDecorator<InferConverterReturnType<TConverter> | undefined>;
-declare function Envapt<TConverter extends BuiltInConverter | ArrayOf>(key: EnvKeyInput, options: {
-  converter: TConverter;
-  required?: false;
-}): EnvaptAccessorDecorator<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 {
- *   \@Envapt('MAX_CONNECTIONS', { converter: Number, fallback: 100 })
- *   static accessor maxConnections: number;
- *
- *   \@Envapt('FEATURE_ENABLED', { converter: Boolean, fallback: false })
- *   static accessor featureEnabled: boolean;
- * }
- * ```
- */
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  fallback: InferPrimitiveReturnType<TConstructor>;
-  required?: false;
-} | {
-  converter: TConstructor;
-  required: true;
-}): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor>>;
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  fallback: undefined;
-  required?: false;
-}): EnvaptAccessorDecorator<InferPrimitiveReturnType<TConstructor> | undefined>;
-declare function Envapt<TConstructor extends PrimitiveConstructor>(key: EnvKeyInput, options: {
-  converter: TConstructor;
-  required?: false;
-}): EnvaptAccessorDecorator<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 {
- *   \@Envapt('API_KEY', { required: true })
- *   static accessor apiKey: string;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput, options: {
-  required: true;
-}): EnvaptAccessorDecorator<string>;
-/**
- * No-fallback form. The property resolves from env or `null`.
- *
- * @param key - Environment variable name(s) to load
- * @public
- * @example
- * ```ts
- * class Config {
- *   \@Envapt('SIMPLE_VALUE')
- *   static accessor simple: string | null;
- * }
- * ```
- */
-declare function Envapt(key: EnvKeyInput): EnvaptAccessorDecorator<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;
-}): EnvaptAccessorDecorator<InferSchemaOutput<Schema>>;
-//#endregion
-export { Envapt };
-//# sourceMappingURL=Envapt.d.mts.map

package/dist/node/decorators/modern/SugarDecorators.d.cts

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

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

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

package/dist/node/engine/Envapter.d.cts

@@ -1,70 +0,0 @@
-import { Environment } from "../core/EnvironmentMethods.cjs";
-import { AdvancedMethods } from "../core/AdvancedMethods.cjs";
-
-//#region src/engine/Envapter.d.ts
-/**
- * Main configuration class for environment variable management.
- *
- * Provides both static and instance methods for retrieving typed environment variables
- * with support for template resolution, multiple .env files, and environment detection.
- *
- * Extend your own classes from this to define properties with \@Envapt decorators and get access to environment-variable methods.
- *
- * @example
- * ```ts
- * // Static usage
- * const port = Envapter.getNumber('PORT', 3000);
- * const url = Envapter.get('API_URL', 'http://localhost');
- * const replica = Envapter.get(['READONLY_URL', 'DATABASE_URL'], 'sqlite://memory');
- *
- * // Instance usage
- * const env = new Envapter();
- * const dbUrl = env.get('DATABASE_URL', 'sqlite://memory');
- * const primaryHost = env.get(['PRIMARY_HOST', 'SECONDARY_HOST']);
- * ```
- *
- * @public
- */
-declare class Envapter extends AdvancedMethods {
-  /**
-   * Tagged template literal for resolving environment variables in template strings.
-   *
-   * @example
-   * ```ts
-   * // Given API_HOST=api.example.com and API_PORT=8080 in environment
-   * const endpoint = Envapter.resolve`Connecting to ${'API_HOST'}:${'API_PORT'}`;
-   * // Returns: "Connecting to api.example.com:8080"
-   *
-   * // Works with template variables in .env too:
-   * // API_URL=https://${API_HOST}:${API_PORT}
-   * const message = Envapter.resolve`Service endpoint: ${'API_URL'}`;
-   * // Returns: "Service endpoint: https://api.example.com:8080"
-   * ```
-   */
-  static resolve(strings: TemplateStringsArray, ...keys: string[]): string;
-  /**
-   * @see {@link Envapter.resolve}
-   */
-  resolve(strings: TemplateStringsArray, ...keys: string[]): string;
-  /**
-   * Assert that one or more environment variables are present and non-empty (post-trim,
-   * after template resolution). Throws `MissingEnvValue` listing every missing key.
-   *
-   * For typed fail-fast in functional code, use `Envapter.getUsing(key, { converter, required: true })`.
-   *
-   * @example
-   * ```ts
-   * Envapter.require('DATABASE_URL');
-   * Envapter.require('DATABASE_URL', 'API_KEY', 'SENTRY_DSN');
-   * ```
-   */
-  static require(...keys: [string, ...string[]]): void;
-  private static resolveAndValidate;
-  /**
-   * @see {@link Envapter.require}
-   */
-  require(...keys: [string, ...string[]]): void;
-}
-//#endregion
-export { Envapter };
-//# sourceMappingURL=Envapter.d.cts.map

package/dist/node/engine/Envapter.d.mts

@@ -1,72 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { Environment } from "../core/EnvironmentMethods.mjs";
-import { AdvancedMethods } from "../core/AdvancedMethods.mjs";
-
-//#region src/engine/Envapter.d.ts
-/**
- * Main configuration class for environment variable management.
- *
- * Provides both static and instance methods for retrieving typed environment variables
- * with support for template resolution, multiple .env files, and environment detection.
- *
- * Extend your own classes from this to define properties with \@Envapt decorators and get access to environment-variable methods.
- *
- * @example
- * ```ts
- * // Static usage
- * const port = Envapter.getNumber('PORT', 3000);
- * const url = Envapter.get('API_URL', 'http://localhost');
- * const replica = Envapter.get(['READONLY_URL', 'DATABASE_URL'], 'sqlite://memory');
- *
- * // Instance usage
- * const env = new Envapter();
- * const dbUrl = env.get('DATABASE_URL', 'sqlite://memory');
- * const primaryHost = env.get(['PRIMARY_HOST', 'SECONDARY_HOST']);
- * ```
- *
- * @public
- */
-declare class Envapter extends AdvancedMethods {
-  /**
-   * Tagged template literal for resolving environment variables in template strings.
-   *
-   * @example
-   * ```ts
-   * // Given API_HOST=api.example.com and API_PORT=8080 in environment
-   * const endpoint = Envapter.resolve`Connecting to ${'API_HOST'}:${'API_PORT'}`;
-   * // Returns: "Connecting to api.example.com:8080"
-   *
-   * // Works with template variables in .env too:
-   * // API_URL=https://${API_HOST}:${API_PORT}
-   * const message = Envapter.resolve`Service endpoint: ${'API_URL'}`;
-   * // Returns: "Service endpoint: https://api.example.com:8080"
-   * ```
-   */
-  static resolve(strings: TemplateStringsArray, ...keys: string[]): string;
-  /**
-   * @see {@link Envapter.resolve}
-   */
-  resolve(strings: TemplateStringsArray, ...keys: string[]): string;
-  /**
-   * Assert that one or more environment variables are present and non-empty (post-trim,
-   * after template resolution). Throws `MissingEnvValue` listing every missing key.
-   *
-   * For typed fail-fast in functional code, use `Envapter.getUsing(key, { converter, required: true })`.
-   *
-   * @example
-   * ```ts
-   * Envapter.require('DATABASE_URL');
-   * Envapter.require('DATABASE_URL', 'API_KEY', 'SENTRY_DSN');
-   * ```
-   */
-  static require(...keys: [string, ...string[]]): void;
-  private static resolveAndValidate;
-  /**
-   * @see {@link Envapter.require}
-   */
-  require(...keys: [string, ...string[]]): void;
-}
-//#endregion
-export { Envapter };
-//# sourceMappingURL=Envapter.d.mts.map