envapt 6.0.2 → 7.0.0-next.1

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 "../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/Envapt.cjs

@@ -1,2 +0,0 @@
-import"node:path";import"node:url";import.meta.url;const e=require("../Error.cjs"),t=require("../Validators.cjs"),n=require("./createPropertyDecorator.cjs");function r(r,i){let a,o,s,c=!1,l=!1;if(i!==void 0){if(typeof i!=`object`||!i||!(`fallback`in i||`converter`in i||`required`in i||`schema`in i))throw new e.EnvaptError(302,"The positional `@Envapt(key, fallback, converter)` form was removed in v6. Pass an options object instead, like `@Envapt(key, { converter, fallback })`, or use one of the sugar decorators.");let n=i;if(a=n.fallback,o=n.converter,c=`fallback`in n,l=n.required===!0,l&&c&&a!==void 0)throw new e.EnvaptError(302,"`required: true` and `fallback` are mutually exclusive on @Envapt options. Drop the fallback or call `Envapter.require()` separately.");if(`schema`in n&&n.schema!==void 0){if(!t.Validator.isStandardSchema(n.schema))throw new e.EnvaptError(302,"`schema` must be a Standard Schema v1 object (zod, valibot, arktype, or any `~standard`-conformant value).");if(o!==void 0)throw new e.EnvaptError(302,"`schema` and `converter` are mutually exclusive on @Envapt options. Drop one as they both turn a raw env string into a typed value.");s=n.schema}}return n.createPropertyDecorator(r,{fallback:a,converter:o,hasFallback:c,required:l,schema:s})}exports.Envapt=r;
-//# sourceMappingURL=Envapt.cjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Envapt.cjs","names":["EnvaptError","Validator","createPropertyDecorator"],"sources":["../../../src/decorators/Envapt.ts"],"sourcesContent":["import { createPropertyDecorator } from './createPropertyDecorator';\nimport { EnvaptError, EnvaptErrorCodes } from '../Error';\nimport { Validator } from '../Validators';\n\nimport type { ArrayOf } from '../converters';\nimport type { InferSchemaOutput, StandardSchemaV1 } from '../StandardSchema';\nimport type {\n    BuiltInConverter,\n    ConverterFunction,\n    EnvKeyInput,\n    EnvaptConverter,\n    InferConverterFallbackType,\n    InferPrimitiveReturnType,\n    PrimitiveConstructor,\n    SchemaConstraint\n} from '../types';\n\n/**\n * Usage 1: Either a custom converter function + fallback (both required), OR a fallback\n * only (no converter).\n *\n * @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n *   // Custom converter that validates a non-empty API key\n *   \\@Envapt('API_KEY', {\n *     fallback: 'default-key',\n *     converter(raw, _fallback) {\n *       if (!raw || raw.trim() === '') throw new Error('API_KEY required');\n *       return raw.trim();\n *     }\n *   })\n *   static readonly apiKey: string;\n *\n *   // Fallback-only (no converter): string fallback\n *   \\@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })\n *   static readonly logFile: string;\n *\n *   // Fallback-only: arbitrary object fallback\n *   \\@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })\n *   static readonly retryPolicy: unknown;\n * }\n * ```\n */\nexport function Envapt<TFallback>(\n    key: EnvKeyInput,\n    options:\n        | { converter: (raw: string | undefined, fallback: TFallback) => TFallback; fallback: TFallback }\n        | { fallback: TFallback; converter?: undefined }\n): PropertyDecorator;\n\n/**\n * Usage 2: Custom converter function without fallback. Either omit `required` (returns the\n * converter's output, possibly `undefined`) or pass `required: true` to throw `MissingEnvValue`\n * on missing/empty values.\n *\n * @param key - Environment variable name(s) to load\n * @param options - Configuration options with custom converter only, with optional `required: true`\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n *   \\@Envapt('FEATURE_FLAGS', { converter(raw) {\n *     return raw ? raw.split('|').map(s => s.trim()) : [];\n *   } })\n *   static readonly featureFlags: string[];\n *\n *   \\@Envapt('JWT_SECRET', {\n *     converter: (raw) => Buffer.from(raw ?? '', 'base64'),\n *     required: true\n *   })\n *   static readonly jwtSecret: Buffer;\n * }\n * ```\n */\nexport function Envapt<TReturnType>(\n    key: EnvKeyInput,\n    options:\n        | { converter: ConverterFunction<TReturnType>; required?: false }\n        | { converter: ConverterFunction<TReturnType>; required: true }\n): PropertyDecorator;\n\n/**\n * Usage 3: Built-in or array converter with optional fallback OR `required: true`.\n *\n * `InferConverterFallbackType` handles asymmetric cases: scalar `Converters.Time` accepts\n * `TimeFallback`, and `ArrayOf<'time'>` accepts `TimeFallback[]`. Every other converter\n * reduces to `InferConverterReturnType`. The two object-shape branches are mutually\n * exclusive: either provide a `fallback`, or pass `required: true` to throw\n * `MissingEnvValue` on missing/empty values.\n *\n * @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * import { Converters } from 'envapt';\n *\n * class Config extends Envapter {\n *   // Use built-in Number converter with a numeric fallback\n *   \\@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })\n *   static readonly port: number;\n *\n *   // Url converter: the fallback is a URL instance, not a string\n *   \\@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })\n *   static readonly url: URL;\n *\n *   // Prefer CANARY_URL when present, otherwise fall back to APP_URL\n *   \\@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })\n *   static readonly canaryUrl: URL | null;\n *\n *   // `Converters.Time` accepts either a number (milliseconds) or a time-string fallback (`<number><unit>`).\n *   \\@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })\n *   static readonly requestTimeout: number;\n *\n *   // Array converter: comma-separated list of origins -> string[]\n *   \\@Envapt('ALLOWED_ORIGINS', {\n *     converter: Converters.array({ of: Converters.String }),\n *     fallback: ['https://example.com']\n *   })\n *   static readonly allowedOrigins: string[];\n *\n *   \\@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })\n *   static readonly databaseUrl: URL;\n * }\n * ```\n */\nexport function Envapt<TConverter extends BuiltInConverter | ArrayOf>(\n    key: EnvKeyInput,\n    options:\n        | { converter: TConverter; fallback?: InferConverterFallbackType<TConverter> | undefined; required?: false }\n        | { converter: TConverter; required: true }\n): PropertyDecorator;\n\n/**\n * Usage 4: Primitive constructor with optional fallback\n *\n * @param key - Environment variable name(s) to load\n * @param options - Configuration options with primitive constructor\n * @public\n * @example\n * ```ts\n * // Use primitive constructors to coerce values\n * class Config extends Envapter {\n *   \\@Envapt('MAX_CONNECTIONS', { converter: Number, fallback: 100 })\n *   static readonly maxConnections: number;\n *\n *   \\@Envapt('FEATURE_ENABLED', { converter: Boolean, fallback: false })\n *   static readonly featureEnabled: boolean;\n * }\n * ```\n */\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n    key: EnvKeyInput,\n    options:\n        | { converter: TConstructor; fallback?: InferPrimitiveReturnType<TConstructor>; required?: false }\n        | { converter: TConstructor; required: true }\n): PropertyDecorator;\n\n/**\n * Usage 5: Required, no converter (raw string). Throws `MissingEnvValue` on first access if\n * the env value is missing or empty (post-trim). Independent of global `Envapter.strict`.\n * Combining `required: true` with `fallback` fails to match any overload at compile time;\n * the runtime Validator catches dynamic objects that bypass the types.\n *\n * @param key - Environment variable name(s) to load\n * @param options - `{ required: true }`\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n *   \\@Envapt('API_KEY', { required: true })\n *   static readonly apiKey: string;\n * }\n * ```\n */\nexport function Envapt(key: EnvKeyInput, options: { required: true }): PropertyDecorator;\n\n/**\n * No-fallback form. The property resolves from env or `null`.\n *\n * @param key - Environment variable name(s) to load\n * @public\n * @example\n * ```ts\n * // Classic API: no fallback — property will resolve from env or be null\n * class Config extends Envapter {\n *   \\@Envapt('SIMPLE_VALUE')\n *   static readonly simple?: string | null;\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport function Envapt<_TReturnType = string | null>(key: EnvKeyInput): PropertyDecorator;\n\n/**\n * Usage 6: Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous\n * schemas only; a Promise-returning `validate` triggers a runtime\n * `InvalidUserDefinedConfig` throw. Combining `schema` with `converter` fails to match any\n * overload at compile time; the runtime Validator catches dynamic objects that bypass the\n * types.\n * @public\n */\nexport function Envapt<Schema extends StandardSchemaV1>(\n    key: EnvKeyInput,\n    options:\n        | { schema: SchemaConstraint<Schema>; fallback?: InferSchemaOutput<Schema>; required?: false }\n        | { schema: SchemaConstraint<Schema>; required: true }\n): PropertyDecorator;\n\n/**\n * Instance/Static Property decorator that automatically loads and converts environment variables.\n */\nexport function Envapt<TFallback = unknown>(key: EnvKeyInput, options?: unknown): PropertyDecorator {\n    let fallback: TFallback | undefined;\n    let actualConverter: EnvaptConverter<TFallback> | undefined;\n    let actualSchema: StandardSchemaV1 | undefined;\n    let hasFallback = false;\n    let required = false;\n\n    if (options !== undefined) {\n        if (\n            typeof options !== 'object' ||\n            options === null ||\n            !('fallback' in options || 'converter' in options || 'required' in options || 'schema' in options)\n        ) {\n            throw new EnvaptError(\n                EnvaptErrorCodes.InvalidUserDefinedConfig,\n                'The positional `@Envapt(key, fallback, converter)` form was removed in v6. Pass an options object instead, like `@Envapt(key, { converter, fallback })`, or use one of the sugar decorators.'\n            );\n        }\n\n        const opts = options as {\n            fallback?: TFallback;\n            converter?: EnvaptConverter<TFallback>;\n            required?: boolean;\n            schema?: unknown;\n        };\n        fallback = opts.fallback;\n        actualConverter = opts.converter;\n        hasFallback = 'fallback' in opts;\n        required = opts.required === true;\n\n        if (required && hasFallback && fallback !== undefined) {\n            throw new EnvaptError(\n                EnvaptErrorCodes.InvalidUserDefinedConfig,\n                '`required: true` and `fallback` are mutually exclusive on @Envapt options. Drop the fallback or call `Envapter.require()` separately.'\n            );\n        }\n\n        if ('schema' in opts && opts.schema !== undefined) {\n            if (!Validator.isStandardSchema(opts.schema)) {\n                throw new EnvaptError(\n                    EnvaptErrorCodes.InvalidUserDefinedConfig,\n                    '`schema` must be a Standard Schema v1 object (zod, valibot, arktype, or any `~standard`-conformant value).'\n                );\n            }\n            if (actualConverter !== undefined) {\n                throw new EnvaptError(\n                    EnvaptErrorCodes.InvalidUserDefinedConfig,\n                    '`schema` and `converter` are mutually exclusive on @Envapt options. Drop one as they both turn a raw env string into a typed value.'\n                );\n            }\n            actualSchema = opts.schema;\n        }\n    }\n\n    return createPropertyDecorator(key, {\n        fallback,\n        converter: actualConverter,\n        hasFallback,\n        required,\n        schema: actualSchema\n    });\n}\n"],"mappings":"6JAwNA,SAAgB,EAA4B,EAAkB,EAAsC,CAChG,IAAI,EACA,EACA,EACA,EAAc,GACd,EAAW,GAEf,GAAI,IAAY,IAAA,GAAW,CACvB,GACI,OAAO,GAAY,WACnB,GACA,EAAE,aAAc,GAAW,cAAe,GAAW,aAAc,GAAW,WAAY,GAE1F,MAAM,IAAIA,EAAAA,YAAAA,IAEN,8LACJ,EAGJ,IAAM,EAAO,EAWb,GALA,EAAW,EAAK,SAChB,EAAkB,EAAK,UACvB,EAAc,aAAc,EAC5B,EAAW,EAAK,WAAa,GAEzB,GAAY,GAAe,IAAa,IAAA,GACxC,MAAM,IAAIA,EAAAA,YAAAA,IAEN,uIACJ,EAGJ,GAAI,WAAY,GAAQ,EAAK,SAAW,IAAA,GAAW,CAC/C,GAAI,CAACC,EAAAA,UAAU,iBAAiB,EAAK,MAAM,EACvC,MAAM,IAAID,EAAAA,YAAAA,IAEN,4GACJ,EAEJ,GAAI,IAAoB,IAAA,GACpB,MAAM,IAAIA,EAAAA,YAAAA,IAEN,qIACJ,EAEJ,EAAe,EAAK,MACxB,CACJ,CAEA,OAAOE,EAAAA,wBAAwB,EAAK,CAChC,WACA,UAAW,EACX,cACA,WACA,OAAQ,CACZ,CAAC,CACL"}

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

@@ -1,208 +0,0 @@
-import { ArrayOf } from "../converters/Converters.cjs";
-import { BuiltInConverter, ConverterFunction, InferConverterFallbackType, InferPrimitiveReturnType, PrimitiveConstructor } from "../types/Conversion.cjs";
-import { InferSchemaOutput, StandardSchemaV1 } from "../StandardSchema.cjs";
-import { SchemaConstraint } from "../types/Schema.cjs";
-import { EnvKeyInput } from "../types/Env.cjs";
-
-//#region src/decorators/Envapt.d.ts
-/**
- * Usage 1: Either a custom converter function + fallback (both required), OR a fallback
- * only (no converter).
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options
- * @public
- * @example
- * ```ts
- * class Config extends Envapter {
- *   // Custom converter that validates a non-empty API key
- *   \@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;
- *
- *   // Fallback-only (no converter): string fallback
- *   \@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })
- *   static readonly logFile: string;
- *
- *   // Fallback-only: arbitrary object fallback
- *   \@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })
- *   static readonly retryPolicy: unknown;
- * }
- * ```
- */
-declare function Envapt<TFallback>(key: EnvKeyInput, options: {
-  converter: (raw: string | undefined, fallback: TFallback) => TFallback;
-  fallback: TFallback;
-} | {
-  fallback: TFallback;
-  converter?: undefined;
-}): PropertyDecorator;
-/**
- * Usage 2: Custom converter function without fallback. Either omit `required` (returns the
- * converter's output, possibly `undefined`) or pass `required: true` to throw `MissingEnvValue`
- * on missing/empty values.
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options with custom converter only, with optional `required: true`
- * @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;
-}): PropertyDecorator;
-/**
- * Usage 3: Built-in or array converter with optional fallback OR `required: true`.
- *
- * `InferConverterFallbackType` handles asymmetric cases: scalar `Converters.Time` accepts
- * `TimeFallback`, and `ArrayOf<'time'>` accepts `TimeFallback[]`. Every other converter
- * reduces to `InferConverterReturnType`. The two object-shape branches are mutually
- * exclusive: either provide a `fallback`, or pass `required: true` to throw
- * `MissingEnvValue` on missing/empty values.
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options
- * @public
- * @example
- * ```ts
- * import { Converters } from 'envapt';
- *
- * class Config extends Envapter {
- *   // Use built-in Number converter with a numeric fallback
- *   \@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })
- *   static readonly port: number;
- *
- *   // Url converter: the fallback is a URL instance, not a string
- *   \@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })
- *   static readonly url: URL;
- *
- *   // Prefer CANARY_URL when present, otherwise fall back to APP_URL
- *   \@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })
- *   static readonly canaryUrl: URL | null;
- *
- *   // `Converters.Time` accepts either a number (milliseconds) or a time-string fallback (`<number><unit>`).
- *   \@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })
- *   static readonly requestTimeout: number;
- *
- *   // Array converter: comma-separated list of origins -> string[]
- *   \@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> | undefined;
-  required?: false;
-} | {
-  converter: TConverter;
-  required: true;
-}): PropertyDecorator;
-/**
- * Usage 4: Primitive constructor with optional fallback
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options with primitive constructor
- * @public
- * @example
- * ```ts
- * // Use primitive constructors to coerce values
- * 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;
-}): PropertyDecorator;
-/**
- * Usage 5: Required, no converter (raw string). Throws `MissingEnvValue` on first access if
- * the env value is missing or empty (post-trim). Independent of global `Envapter.strict`.
- * Combining `required: true` with `fallback` fails to match any overload at compile time;
- * the runtime Validator catches 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;
-}): PropertyDecorator;
-/**
- * No-fallback form. The property resolves from env or `null`.
- *
- * @param key - Environment variable name(s) to load
- * @public
- * @example
- * ```ts
- * // Classic API: no fallback — property will resolve from env or be null
- * class Config extends Envapter {
- *   \@Envapt('SIMPLE_VALUE')
- *   static readonly simple?: string | null;
- * }
- * ```
- */
-declare function Envapt<_TReturnType = string | null>(key: EnvKeyInput): PropertyDecorator;
-/**
- * Usage 6: Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous
- * schemas only; a Promise-returning `validate` triggers a runtime
- * `InvalidUserDefinedConfig` throw. Combining `schema` with `converter` fails to match any
- * overload at compile time; the runtime Validator catches 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;
-}): PropertyDecorator;
-//#endregion
-export { Envapt };
-//# sourceMappingURL=Envapt.d.cts.map

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

@@ -1,210 +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, InferPrimitiveReturnType, PrimitiveConstructor } from "../types/Conversion.mjs";
-import { InferSchemaOutput, StandardSchemaV1 } from "../StandardSchema.mjs";
-import { SchemaConstraint } from "../types/Schema.mjs";
-import { EnvKeyInput } from "../types/Env.mjs";
-
-//#region src/decorators/Envapt.d.ts
-/**
- * Usage 1: Either a custom converter function + fallback (both required), OR a fallback
- * only (no converter).
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options
- * @public
- * @example
- * ```ts
- * class Config extends Envapter {
- *   // Custom converter that validates a non-empty API key
- *   \@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;
- *
- *   // Fallback-only (no converter): string fallback
- *   \@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })
- *   static readonly logFile: string;
- *
- *   // Fallback-only: arbitrary object fallback
- *   \@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })
- *   static readonly retryPolicy: unknown;
- * }
- * ```
- */
-declare function Envapt<TFallback>(key: EnvKeyInput, options: {
-  converter: (raw: string | undefined, fallback: TFallback) => TFallback;
-  fallback: TFallback;
-} | {
-  fallback: TFallback;
-  converter?: undefined;
-}): PropertyDecorator;
-/**
- * Usage 2: Custom converter function without fallback. Either omit `required` (returns the
- * converter's output, possibly `undefined`) or pass `required: true` to throw `MissingEnvValue`
- * on missing/empty values.
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options with custom converter only, with optional `required: true`
- * @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;
-}): PropertyDecorator;
-/**
- * Usage 3: Built-in or array converter with optional fallback OR `required: true`.
- *
- * `InferConverterFallbackType` handles asymmetric cases: scalar `Converters.Time` accepts
- * `TimeFallback`, and `ArrayOf<'time'>` accepts `TimeFallback[]`. Every other converter
- * reduces to `InferConverterReturnType`. The two object-shape branches are mutually
- * exclusive: either provide a `fallback`, or pass `required: true` to throw
- * `MissingEnvValue` on missing/empty values.
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options
- * @public
- * @example
- * ```ts
- * import { Converters } from 'envapt';
- *
- * class Config extends Envapter {
- *   // Use built-in Number converter with a numeric fallback
- *   \@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })
- *   static readonly port: number;
- *
- *   // Url converter: the fallback is a URL instance, not a string
- *   \@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })
- *   static readonly url: URL;
- *
- *   // Prefer CANARY_URL when present, otherwise fall back to APP_URL
- *   \@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })
- *   static readonly canaryUrl: URL | null;
- *
- *   // `Converters.Time` accepts either a number (milliseconds) or a time-string fallback (`<number><unit>`).
- *   \@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })
- *   static readonly requestTimeout: number;
- *
- *   // Array converter: comma-separated list of origins -> string[]
- *   \@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> | undefined;
-  required?: false;
-} | {
-  converter: TConverter;
-  required: true;
-}): PropertyDecorator;
-/**
- * Usage 4: Primitive constructor with optional fallback
- *
- * @param key - Environment variable name(s) to load
- * @param options - Configuration options with primitive constructor
- * @public
- * @example
- * ```ts
- * // Use primitive constructors to coerce values
- * 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;
-}): PropertyDecorator;
-/**
- * Usage 5: Required, no converter (raw string). Throws `MissingEnvValue` on first access if
- * the env value is missing or empty (post-trim). Independent of global `Envapter.strict`.
- * Combining `required: true` with `fallback` fails to match any overload at compile time;
- * the runtime Validator catches 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;
-}): PropertyDecorator;
-/**
- * No-fallback form. The property resolves from env or `null`.
- *
- * @param key - Environment variable name(s) to load
- * @public
- * @example
- * ```ts
- * // Classic API: no fallback — property will resolve from env or be null
- * class Config extends Envapter {
- *   \@Envapt('SIMPLE_VALUE')
- *   static readonly simple?: string | null;
- * }
- * ```
- */
-declare function Envapt<_TReturnType = string | null>(key: EnvKeyInput): PropertyDecorator;
-/**
- * Usage 6: Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous
- * schemas only; a Promise-returning `validate` triggers a runtime
- * `InvalidUserDefinedConfig` throw. Combining `schema` with `converter` fails to match any
- * overload at compile time; the runtime Validator catches 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;
-}): PropertyDecorator;
-//#endregion
-export { Envapt };
-//# sourceMappingURL=Envapt.d.mts.map

package/dist/node/decorators/Envapt.mjs

@@ -1,2 +0,0 @@
-import"node:path";import"node:url";import.meta.url;import{EnvaptError as e}from"../Error.mjs";import{Validator as t}from"../Validators.mjs";import{createPropertyDecorator as n}from"./createPropertyDecorator.mjs";function r(r,i){let a,o,s,c=!1,l=!1;if(i!==void 0){if(typeof i!=`object`||!i||!(`fallback`in i||`converter`in i||`required`in i||`schema`in i))throw new e(302,"The positional `@Envapt(key, fallback, converter)` form was removed in v6. Pass an options object instead, like `@Envapt(key, { converter, fallback })`, or use one of the sugar decorators.");let n=i;if(a=n.fallback,o=n.converter,c=`fallback`in n,l=n.required===!0,l&&c&&a!==void 0)throw new e(302,"`required: true` and `fallback` are mutually exclusive on @Envapt options. Drop the fallback or call `Envapter.require()` separately.");if(`schema`in n&&n.schema!==void 0){if(!t.isStandardSchema(n.schema))throw new e(302,"`schema` must be a Standard Schema v1 object (zod, valibot, arktype, or any `~standard`-conformant value).");if(o!==void 0)throw new e(302,"`schema` and `converter` are mutually exclusive on @Envapt options. Drop one as they both turn a raw env string into a typed value.");s=n.schema}}return n(r,{fallback:a,converter:o,hasFallback:c,required:l,schema:s})}export{r as Envapt};
-//# sourceMappingURL=Envapt.mjs.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Envapt.mjs","names":[],"sources":["../../../src/decorators/Envapt.ts"],"sourcesContent":["import { createPropertyDecorator } from './createPropertyDecorator';\nimport { EnvaptError, EnvaptErrorCodes } from '../Error';\nimport { Validator } from '../Validators';\n\nimport type { ArrayOf } from '../converters';\nimport type { InferSchemaOutput, StandardSchemaV1 } from '../StandardSchema';\nimport type {\n    BuiltInConverter,\n    ConverterFunction,\n    EnvKeyInput,\n    EnvaptConverter,\n    InferConverterFallbackType,\n    InferPrimitiveReturnType,\n    PrimitiveConstructor,\n    SchemaConstraint\n} from '../types';\n\n/**\n * Usage 1: Either a custom converter function + fallback (both required), OR a fallback\n * only (no converter).\n *\n * @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n *   // Custom converter that validates a non-empty API key\n *   \\@Envapt('API_KEY', {\n *     fallback: 'default-key',\n *     converter(raw, _fallback) {\n *       if (!raw || raw.trim() === '') throw new Error('API_KEY required');\n *       return raw.trim();\n *     }\n *   })\n *   static readonly apiKey: string;\n *\n *   // Fallback-only (no converter): string fallback\n *   \\@Envapt('LOG_FILE', { fallback: '/var/log/app.log' })\n *   static readonly logFile: string;\n *\n *   // Fallback-only: arbitrary object fallback\n *   \\@Envapt('RETRY_POLICY', { fallback: { retries: 3, backoff: 'exponential' } })\n *   static readonly retryPolicy: unknown;\n * }\n * ```\n */\nexport function Envapt<TFallback>(\n    key: EnvKeyInput,\n    options:\n        | { converter: (raw: string | undefined, fallback: TFallback) => TFallback; fallback: TFallback }\n        | { fallback: TFallback; converter?: undefined }\n): PropertyDecorator;\n\n/**\n * Usage 2: Custom converter function without fallback. Either omit `required` (returns the\n * converter's output, possibly `undefined`) or pass `required: true` to throw `MissingEnvValue`\n * on missing/empty values.\n *\n * @param key - Environment variable name(s) to load\n * @param options - Configuration options with custom converter only, with optional `required: true`\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n *   \\@Envapt('FEATURE_FLAGS', { converter(raw) {\n *     return raw ? raw.split('|').map(s => s.trim()) : [];\n *   } })\n *   static readonly featureFlags: string[];\n *\n *   \\@Envapt('JWT_SECRET', {\n *     converter: (raw) => Buffer.from(raw ?? '', 'base64'),\n *     required: true\n *   })\n *   static readonly jwtSecret: Buffer;\n * }\n * ```\n */\nexport function Envapt<TReturnType>(\n    key: EnvKeyInput,\n    options:\n        | { converter: ConverterFunction<TReturnType>; required?: false }\n        | { converter: ConverterFunction<TReturnType>; required: true }\n): PropertyDecorator;\n\n/**\n * Usage 3: Built-in or array converter with optional fallback OR `required: true`.\n *\n * `InferConverterFallbackType` handles asymmetric cases: scalar `Converters.Time` accepts\n * `TimeFallback`, and `ArrayOf<'time'>` accepts `TimeFallback[]`. Every other converter\n * reduces to `InferConverterReturnType`. The two object-shape branches are mutually\n * exclusive: either provide a `fallback`, or pass `required: true` to throw\n * `MissingEnvValue` on missing/empty values.\n *\n * @param key - Environment variable name(s) to load\n * @param options - Configuration options\n * @public\n * @example\n * ```ts\n * import { Converters } from 'envapt';\n *\n * class Config extends Envapter {\n *   // Use built-in Number converter with a numeric fallback\n *   \\@Envapt('APP_PORT', { converter: Converters.Number, fallback: 3000 })\n *   static readonly port: number;\n *\n *   // Url converter: the fallback is a URL instance, not a string\n *   \\@Envapt('APP_URL', { converter: Converters.Url, fallback: new URL('http://localhost:3000') })\n *   static readonly url: URL;\n *\n *   // Prefer CANARY_URL when present, otherwise fall back to APP_URL\n *   \\@Envapt(['CANARY_URL', 'APP_URL'], { converter: Converters.Url })\n *   static readonly canaryUrl: URL | null;\n *\n *   // `Converters.Time` accepts either a number (milliseconds) or a time-string fallback (`<number><unit>`).\n *   \\@Envapt('REQUEST_TIMEOUT', { converter: Converters.Time, fallback: '10s' })\n *   static readonly requestTimeout: number;\n *\n *   // Array converter: comma-separated list of origins -> string[]\n *   \\@Envapt('ALLOWED_ORIGINS', {\n *     converter: Converters.array({ of: Converters.String }),\n *     fallback: ['https://example.com']\n *   })\n *   static readonly allowedOrigins: string[];\n *\n *   \\@Envapt('DATABASE_URL', { converter: Converters.Url, required: true })\n *   static readonly databaseUrl: URL;\n * }\n * ```\n */\nexport function Envapt<TConverter extends BuiltInConverter | ArrayOf>(\n    key: EnvKeyInput,\n    options:\n        | { converter: TConverter; fallback?: InferConverterFallbackType<TConverter> | undefined; required?: false }\n        | { converter: TConverter; required: true }\n): PropertyDecorator;\n\n/**\n * Usage 4: Primitive constructor with optional fallback\n *\n * @param key - Environment variable name(s) to load\n * @param options - Configuration options with primitive constructor\n * @public\n * @example\n * ```ts\n * // Use primitive constructors to coerce values\n * class Config extends Envapter {\n *   \\@Envapt('MAX_CONNECTIONS', { converter: Number, fallback: 100 })\n *   static readonly maxConnections: number;\n *\n *   \\@Envapt('FEATURE_ENABLED', { converter: Boolean, fallback: false })\n *   static readonly featureEnabled: boolean;\n * }\n * ```\n */\nexport function Envapt<TConstructor extends PrimitiveConstructor>(\n    key: EnvKeyInput,\n    options:\n        | { converter: TConstructor; fallback?: InferPrimitiveReturnType<TConstructor>; required?: false }\n        | { converter: TConstructor; required: true }\n): PropertyDecorator;\n\n/**\n * Usage 5: Required, no converter (raw string). Throws `MissingEnvValue` on first access if\n * the env value is missing or empty (post-trim). Independent of global `Envapter.strict`.\n * Combining `required: true` with `fallback` fails to match any overload at compile time;\n * the runtime Validator catches dynamic objects that bypass the types.\n *\n * @param key - Environment variable name(s) to load\n * @param options - `{ required: true }`\n * @public\n * @example\n * ```ts\n * class Config extends Envapter {\n *   \\@Envapt('API_KEY', { required: true })\n *   static readonly apiKey: string;\n * }\n * ```\n */\nexport function Envapt(key: EnvKeyInput, options: { required: true }): PropertyDecorator;\n\n/**\n * No-fallback form. The property resolves from env or `null`.\n *\n * @param key - Environment variable name(s) to load\n * @public\n * @example\n * ```ts\n * // Classic API: no fallback — property will resolve from env or be null\n * class Config extends Envapter {\n *   \\@Envapt('SIMPLE_VALUE')\n *   static readonly simple?: string | null;\n * }\n * ```\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport function Envapt<_TReturnType = string | null>(key: EnvKeyInput): PropertyDecorator;\n\n/**\n * Usage 6: Standard Schema v1 adapter (zod, valibot, arktype, hand-rolled). Synchronous\n * schemas only; a Promise-returning `validate` triggers a runtime\n * `InvalidUserDefinedConfig` throw. Combining `schema` with `converter` fails to match any\n * overload at compile time; the runtime Validator catches dynamic objects that bypass the\n * types.\n * @public\n */\nexport function Envapt<Schema extends StandardSchemaV1>(\n    key: EnvKeyInput,\n    options:\n        | { schema: SchemaConstraint<Schema>; fallback?: InferSchemaOutput<Schema>; required?: false }\n        | { schema: SchemaConstraint<Schema>; required: true }\n): PropertyDecorator;\n\n/**\n * Instance/Static Property decorator that automatically loads and converts environment variables.\n */\nexport function Envapt<TFallback = unknown>(key: EnvKeyInput, options?: unknown): PropertyDecorator {\n    let fallback: TFallback | undefined;\n    let actualConverter: EnvaptConverter<TFallback> | undefined;\n    let actualSchema: StandardSchemaV1 | undefined;\n    let hasFallback = false;\n    let required = false;\n\n    if (options !== undefined) {\n        if (\n            typeof options !== 'object' ||\n            options === null ||\n            !('fallback' in options || 'converter' in options || 'required' in options || 'schema' in options)\n        ) {\n            throw new EnvaptError(\n                EnvaptErrorCodes.InvalidUserDefinedConfig,\n                'The positional `@Envapt(key, fallback, converter)` form was removed in v6. Pass an options object instead, like `@Envapt(key, { converter, fallback })`, or use one of the sugar decorators.'\n            );\n        }\n\n        const opts = options as {\n            fallback?: TFallback;\n            converter?: EnvaptConverter<TFallback>;\n            required?: boolean;\n            schema?: unknown;\n        };\n        fallback = opts.fallback;\n        actualConverter = opts.converter;\n        hasFallback = 'fallback' in opts;\n        required = opts.required === true;\n\n        if (required && hasFallback && fallback !== undefined) {\n            throw new EnvaptError(\n                EnvaptErrorCodes.InvalidUserDefinedConfig,\n                '`required: true` and `fallback` are mutually exclusive on @Envapt options. Drop the fallback or call `Envapter.require()` separately.'\n            );\n        }\n\n        if ('schema' in opts && opts.schema !== undefined) {\n            if (!Validator.isStandardSchema(opts.schema)) {\n                throw new EnvaptError(\n                    EnvaptErrorCodes.InvalidUserDefinedConfig,\n                    '`schema` must be a Standard Schema v1 object (zod, valibot, arktype, or any `~standard`-conformant value).'\n                );\n            }\n            if (actualConverter !== undefined) {\n                throw new EnvaptError(\n                    EnvaptErrorCodes.InvalidUserDefinedConfig,\n                    '`schema` and `converter` are mutually exclusive on @Envapt options. Drop one as they both turn a raw env string into a typed value.'\n                );\n            }\n            actualSchema = opts.schema;\n        }\n    }\n\n    return createPropertyDecorator(key, {\n        fallback,\n        converter: actualConverter,\n        hasFallback,\n        required,\n        schema: actualSchema\n    });\n}\n"],"mappings":"oNAwNA,SAAgB,EAA4B,EAAkB,EAAsC,CAChG,IAAI,EACA,EACA,EACA,EAAc,GACd,EAAW,GAEf,GAAI,IAAY,IAAA,GAAW,CACvB,GACI,OAAO,GAAY,WACnB,GACA,EAAE,aAAc,GAAW,cAAe,GAAW,aAAc,GAAW,WAAY,GAE1F,MAAM,IAAI,EAAA,IAEN,8LACJ,EAGJ,IAAM,EAAO,EAWb,GALA,EAAW,EAAK,SAChB,EAAkB,EAAK,UACvB,EAAc,aAAc,EAC5B,EAAW,EAAK,WAAa,GAEzB,GAAY,GAAe,IAAa,IAAA,GACxC,MAAM,IAAI,EAAA,IAEN,uIACJ,EAGJ,GAAI,WAAY,GAAQ,EAAK,SAAW,IAAA,GAAW,CAC/C,GAAI,CAAC,EAAU,iBAAiB,EAAK,MAAM,EACvC,MAAM,IAAI,EAAA,IAEN,4GACJ,EAEJ,GAAI,IAAoB,IAAA,GACpB,MAAM,IAAI,EAAA,IAEN,qIACJ,EAEJ,EAAe,EAAK,MACxB,CACJ,CAEA,OAAO,EAAwB,EAAK,CAChC,WACA,UAAW,EACX,cACA,WACA,OAAQ,CACZ,CAAC,CACL"}

package/dist/node/decorators/SugarDecorators.cjs

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

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

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

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

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

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

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

package/dist/node/decorators/SugarDecorators.mjs

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

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

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