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

package/dist/node/infra/Error.d.cts

@@ -1,72 +0,0 @@
-import { StandardSchemaV1 } from "./StandardSchema.cjs";
-
-//#region src/infra/Error.d.ts
-declare enum EnvaptErrorCodes {
-  /** Thrown when an invalid fallback value is provided */
-  InvalidFallback = 101,
-  /** Thrown when fallback value type doesn't match expected converter type */
-  InvalidFallbackType = 102,
-  /** Thrown when array fallback contains elements of wrong type */
-  ArrayFallbackElementTypeMismatch = 103,
-  /** Thrown when fallback type doesn't match the specified converter */
-  FallbackConverterTypeMismatch = 104,
-  /** Thrown when a time-string fallback is malformed (does not match the required `<number><unit>` format) */
-  MalformedTimeFallback = 105,
-  /** Thrown when invalid array converter configuration is provided */
-  InvalidArrayConverterType = 201,
-  /** Thrown when an invalid built-in converter is specified */
-  InvalidBuiltInConverter = 202,
-  /** Thrown when a custom converter is not a function */
-  InvalidCustomConverter = 203,
-  /** Thrown when converter type is not recognized */
-  InvalidConverterType = 204,
-  /** Thrown when primitive type coercion on fallback value fails */
-  PrimitiveCoercionFailed = 205,
-  /** Thrown when an array element fails to convert to the configured element type */
-  ArrayElementConversionFailed = 206,
-  /** Thrown under strict mode when an array element is empty or whitespace only */
-  EmptyArrayElement = 207,
-  /** Thrown when a Standard Schema returns issues for a non-empty env value */
-  SchemaValidationFailed = 208,
-  /** Thrown when a Standard Schema's `validate` itself throws (e.g. a refinement that crashes) */
-  SchemaThrew = 209,
-  /** Thrown when delimiter is missing in array converter configuration */
-  MissingDelimiter = 301,
-  /** Thrown when invalid user-defined configuration is provided */
-  InvalidUserDefinedConfig = 302,
-  /** Thrown when specified environment files don't exist */
-  EnvFilesNotFound = 303,
-  /** Thrown when no valid environment key is provided */
-  InvalidKeyInput = 304,
-  /** Thrown when a required environment value is missing or empty (post-trim) */
-  MissingEnvValue = 305,
-  /** Thrown when a file-based API (envPaths, baseDir, configureProfiles) is used on a source without filesystem support */
-  FileApiUnsupported = 306,
-  /** Thrown when an environment value is read before a source is bound via Envapter.useSource */
-  NoSourceBound = 307
-}
-interface EnvaptErrorOptions {
-  issues?: readonly StandardSchemaV1.Issue[];
-  cause?: unknown;
-}
-/**
- * Custom error for better DX and debugging when using Envapt.
- *
- * @example
- * ```ts
- * throw new EnvaptError(EnvaptErrorCodes.InvalidFallback, "Invalid fallback value provided for environment variable.");
- * ```
- */
-declare class EnvaptError extends Error {
-  readonly code: EnvaptErrorCodes;
-  /**
-   * Populated only for {@link EnvaptErrorCodes.SchemaValidationFailed} (208). For every other
-   * code this is `undefined`. Lets callers do `if (err.code === 208) err.issues?.forEach(...)`
-   * without a type cast.
-   */
-  readonly issues: readonly StandardSchemaV1.Issue[] | undefined;
-  constructor(code: EnvaptErrorCodes, message: string, options?: EnvaptErrorOptions);
-}
-//#endregion
-export { EnvaptError, EnvaptErrorCodes };
-//# sourceMappingURL=Error.d.cts.map

package/dist/node/infra/Error.d.mts

@@ -1,74 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { StandardSchemaV1 } from "./StandardSchema.mjs";
-
-//#region src/infra/Error.d.ts
-declare enum EnvaptErrorCodes {
-  /** Thrown when an invalid fallback value is provided */
-  InvalidFallback = 101,
-  /** Thrown when fallback value type doesn't match expected converter type */
-  InvalidFallbackType = 102,
-  /** Thrown when array fallback contains elements of wrong type */
-  ArrayFallbackElementTypeMismatch = 103,
-  /** Thrown when fallback type doesn't match the specified converter */
-  FallbackConverterTypeMismatch = 104,
-  /** Thrown when a time-string fallback is malformed (does not match the required `<number><unit>` format) */
-  MalformedTimeFallback = 105,
-  /** Thrown when invalid array converter configuration is provided */
-  InvalidArrayConverterType = 201,
-  /** Thrown when an invalid built-in converter is specified */
-  InvalidBuiltInConverter = 202,
-  /** Thrown when a custom converter is not a function */
-  InvalidCustomConverter = 203,
-  /** Thrown when converter type is not recognized */
-  InvalidConverterType = 204,
-  /** Thrown when primitive type coercion on fallback value fails */
-  PrimitiveCoercionFailed = 205,
-  /** Thrown when an array element fails to convert to the configured element type */
-  ArrayElementConversionFailed = 206,
-  /** Thrown under strict mode when an array element is empty or whitespace only */
-  EmptyArrayElement = 207,
-  /** Thrown when a Standard Schema returns issues for a non-empty env value */
-  SchemaValidationFailed = 208,
-  /** Thrown when a Standard Schema's `validate` itself throws (e.g. a refinement that crashes) */
-  SchemaThrew = 209,
-  /** Thrown when delimiter is missing in array converter configuration */
-  MissingDelimiter = 301,
-  /** Thrown when invalid user-defined configuration is provided */
-  InvalidUserDefinedConfig = 302,
-  /** Thrown when specified environment files don't exist */
-  EnvFilesNotFound = 303,
-  /** Thrown when no valid environment key is provided */
-  InvalidKeyInput = 304,
-  /** Thrown when a required environment value is missing or empty (post-trim) */
-  MissingEnvValue = 305,
-  /** Thrown when a file-based API (envPaths, baseDir, configureProfiles) is used on a source without filesystem support */
-  FileApiUnsupported = 306,
-  /** Thrown when an environment value is read before a source is bound via Envapter.useSource */
-  NoSourceBound = 307
-}
-interface EnvaptErrorOptions {
-  issues?: readonly StandardSchemaV1.Issue[];
-  cause?: unknown;
-}
-/**
- * Custom error for better DX and debugging when using Envapt.
- *
- * @example
- * ```ts
- * throw new EnvaptError(EnvaptErrorCodes.InvalidFallback, "Invalid fallback value provided for environment variable.");
- * ```
- */
-declare class EnvaptError extends Error {
-  readonly code: EnvaptErrorCodes;
-  /**
-   * Populated only for {@link EnvaptErrorCodes.SchemaValidationFailed} (208). For every other
-   * code this is `undefined`. Lets callers do `if (err.code === 208) err.issues?.forEach(...)`
-   * without a type cast.
-   */
-  readonly issues: readonly StandardSchemaV1.Issue[] | undefined;
-  constructor(code: EnvaptErrorCodes, message: string, options?: EnvaptErrorOptions);
-}
-//#endregion
-export { EnvaptError, EnvaptErrorCodes };
-//# sourceMappingURL=Error.d.mts.map

package/dist/node/infra/StandardSchema.d.cts

@@ -1,59 +0,0 @@
-//#region src/infra/StandardSchema.d.ts
-/**
- * Standard Schema V1 interface. Inlined verbatim from the spec at https://standardschema.dev
- * so envapt has zero runtime peer dependencies on any specific schema library
- * (zod / valibot / arktype / etc).
- *
- * envapt narrows usage to SYNCHRONOUS schemas only: env loading is boot-time,
- * `validate` returning `Promise<Result>` is rejected at the type level (see
- * `SchemaMustBeSync` brand in `Types.ts`) and at runtime by the Parser dispatch.
- *
- * @public
- */
-interface StandardSchemaV1<Input = unknown, Output = Input> {
-  readonly '~standard': StandardSchemaV1.Props<Input, Output>;
-}
-declare namespace StandardSchemaV1 {
-  interface Props<Input = unknown, Output = Input> {
-    readonly version: 1;
-    readonly vendor: string;
-    readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
-    readonly types?: Types<Input, Output> | undefined;
-  }
-  type Result<Output> = SuccessResult<Output> | FailureResult;
-  interface SuccessResult<Output> {
-    readonly value: Output;
-    readonly issues?: undefined;
-  }
-  interface FailureResult {
-    readonly issues: readonly Issue[];
-  }
-  interface Issue {
-    readonly message: string;
-    readonly path?: readonly (PropertyKey | PathSegment)[] | undefined;
-  }
-  interface PathSegment {
-    readonly key: PropertyKey;
-  }
-  interface Types<Input = unknown, Output = Input> {
-    readonly input: Input;
-    readonly output: Output;
-  }
-  type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
-  type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
-}
-/**
- * Envapt-side alias for {@link StandardSchemaV1.InferOutput}. Re-exported under a friendlier
- * name so consumers writing `static readonly x: InferSchemaOutput<typeof mySchema>`
- * don't need the namespace path.
- * @public
- */
-type InferSchemaOutput<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;
-/**
- * Envapt-side alias for {@link StandardSchemaV1.InferInput}.
- * @public
- */
-type InferSchemaInput<Schema extends StandardSchemaV1> = StandardSchemaV1.InferInput<Schema>;
-//#endregion
-export { InferSchemaInput, InferSchemaOutput, StandardSchemaV1 };
-//# sourceMappingURL=StandardSchema.d.cts.map

package/dist/node/infra/StandardSchema.d.mts

@@ -1,61 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-//#region src/infra/StandardSchema.d.ts
-/**
- * Standard Schema V1 interface. Inlined verbatim from the spec at https://standardschema.dev
- * so envapt has zero runtime peer dependencies on any specific schema library
- * (zod / valibot / arktype / etc).
- *
- * envapt narrows usage to SYNCHRONOUS schemas only: env loading is boot-time,
- * `validate` returning `Promise<Result>` is rejected at the type level (see
- * `SchemaMustBeSync` brand in `Types.ts`) and at runtime by the Parser dispatch.
- *
- * @public
- */
-interface StandardSchemaV1<Input = unknown, Output = Input> {
-  readonly '~standard': StandardSchemaV1.Props<Input, Output>;
-}
-declare namespace StandardSchemaV1 {
-  interface Props<Input = unknown, Output = Input> {
-    readonly version: 1;
-    readonly vendor: string;
-    readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
-    readonly types?: Types<Input, Output> | undefined;
-  }
-  type Result<Output> = SuccessResult<Output> | FailureResult;
-  interface SuccessResult<Output> {
-    readonly value: Output;
-    readonly issues?: undefined;
-  }
-  interface FailureResult {
-    readonly issues: readonly Issue[];
-  }
-  interface Issue {
-    readonly message: string;
-    readonly path?: readonly (PropertyKey | PathSegment)[] | undefined;
-  }
-  interface PathSegment {
-    readonly key: PropertyKey;
-  }
-  interface Types<Input = unknown, Output = Input> {
-    readonly input: Input;
-    readonly output: Output;
-  }
-  type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
-  type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
-}
-/**
- * Envapt-side alias for {@link StandardSchemaV1.InferOutput}. Re-exported under a friendlier
- * name so consumers writing `static readonly x: InferSchemaOutput<typeof mySchema>`
- * don't need the namespace path.
- * @public
- */
-type InferSchemaOutput<Schema extends StandardSchemaV1> = StandardSchemaV1.InferOutput<Schema>;
-/**
- * Envapt-side alias for {@link StandardSchemaV1.InferInput}.
- * @public
- */
-type InferSchemaInput<Schema extends StandardSchemaV1> = StandardSchemaV1.InferInput<Schema>;
-//#endregion
-export { InferSchemaInput, InferSchemaOutput, StandardSchemaV1 };
-//# sourceMappingURL=StandardSchema.d.mts.map

package/dist/node/legacy.d.cts

@@ -1,4 +0,0 @@
-import { EnvaptFieldDecorator } from "./types/Decorator.cjs";
-import { Envapt } from "./decorators/legacy/Envapt.cjs";
-import { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl } from "./decorators/legacy/SugarDecorators.cjs";
-export { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl, Envapt, type EnvaptFieldDecorator };

package/dist/node/legacy.d.mts

@@ -1,6 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { EnvaptFieldDecorator } from "./types/Decorator.mjs";
-import { Envapt } from "./decorators/legacy/Envapt.mjs";
-import { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl } from "./decorators/legacy/SugarDecorators.mjs";
-export { EnvBool, EnvNum, EnvStr, EnvTime, EnvUrl, Envapt, type EnvaptFieldDecorator };

package/dist/node/sources/ManualEnvSource.d.cts

@@ -1,19 +0,0 @@
-import { BareEnvSource } from "../types/Source.cjs";
-
-//#region src/sources/ManualEnvSource.d.ts
-/**
- * Environment source seeded from an object you provide: the config your bundler injects into a browser
- * build (Vite's `import.meta.env`, a webpack `DefinePlugin` global), a test fixture, or any other plain
- * object. Pass it straight through; non-string values are JSON-stringified so the converters still apply.
- * It has no filesystem, so the `.env` cascade and file-based APIs do not apply.
- * @public
- */
-declare class ManualEnvSource implements BareEnvSource {
-  readonly supportsFiles = false;
-  private readonly vars;
-  constructor(vars: Record<string, unknown>);
-  readVars(): Record<string, string>;
-}
-//#endregion
-export { ManualEnvSource };
-//# sourceMappingURL=ManualEnvSource.d.cts.map

package/dist/node/sources/ManualEnvSource.d.mts

@@ -1,21 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { BareEnvSource } from "../types/Source.mjs";
-
-//#region src/sources/ManualEnvSource.d.ts
-/**
- * Environment source seeded from an object you provide: the config your bundler injects into a browser
- * build (Vite's `import.meta.env`, a webpack `DefinePlugin` global), a test fixture, or any other plain
- * object. Pass it straight through; non-string values are JSON-stringified so the converters still apply.
- * It has no filesystem, so the `.env` cascade and file-based APIs do not apply.
- * @public
- */
-declare class ManualEnvSource implements BareEnvSource {
-  readonly supportsFiles = false;
-  private readonly vars;
-  constructor(vars: Record<string, unknown>);
-  readVars(): Record<string, string>;
-}
-//#endregion
-export { ManualEnvSource };
-//# sourceMappingURL=ManualEnvSource.d.mts.map

package/dist/node/sources/NodeEnvSource.d.mts

@@ -1,22 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { FileEnvSource } from "../types/Source.mjs";
-
-//#region src/sources/NodeEnvSource.d.ts
-/**
- * Default environment source on Node, Bun, and Deno: a snapshot of `process.env`. Its
- * `supportsFiles` is `true`, so the engine also layers the `.env` cascade on top, resolves
- * `baseDir`, and can mirror loaded keys back to `process.env`.
- * @public
- */
-declare class NodeEnvSource implements FileEnvSource {
-  readonly supportsFiles = true;
-  readVars(): Record<string, string>;
-  readFile(path: string, encoding: string): string | undefined;
-  normalizeBaseDir(value: string | URL): string;
-  resolvePath(baseDir: string, candidate: string): string;
-  writeVars(vars: Record<string, string>): void;
-}
-//#endregion
-export { NodeEnvSource };
-//# sourceMappingURL=NodeEnvSource.d.mts.map

package/dist/node/sources/WorkerEnvSource.d.cts

@@ -1,19 +0,0 @@
-import { BareEnvSource } from "../types/Source.cjs";
-
-//#region src/sources/WorkerEnvSource.d.ts
-/**
- * Environment source for Cloudflare Workers, seeded from the `env` binding. String bindings pass
- * through; non-string bindings are JSON-stringified so the converters still apply, and so must be
- * JSON-serializable (a `bigint` or circular value throws). No filesystem, so the `.env` cascade and
- * file-based APIs do not apply.
- * @public
- */
-declare class WorkerEnvSource implements BareEnvSource {
-  readonly supportsFiles = false;
-  private readonly vars;
-  constructor(env: Record<string, unknown>);
-  readVars(): Record<string, string>;
-}
-//#endregion
-export { WorkerEnvSource };
-//# sourceMappingURL=WorkerEnvSource.d.cts.map

package/dist/node/sources/WorkerEnvSource.d.mts

@@ -1,21 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { BareEnvSource } from "../types/Source.mjs";
-
-//#region src/sources/WorkerEnvSource.d.ts
-/**
- * Environment source for Cloudflare Workers, seeded from the `env` binding. String bindings pass
- * through; non-string bindings are JSON-stringified so the converters still apply, and so must be
- * JSON-serializable (a `bigint` or circular value throws). No filesystem, so the `.env` cascade and
- * file-based APIs do not apply.
- * @public
- */
-declare class WorkerEnvSource implements BareEnvSource {
-  readonly supportsFiles = false;
-  private readonly vars;
-  constructor(env: Record<string, unknown>);
-  readVars(): Record<string, string>;
-}
-//#endregion
-export { WorkerEnvSource };
-//# sourceMappingURL=WorkerEnvSource.d.mts.map

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

@@ -1,123 +0,0 @@
-import { ArrayOf, ConverterToken, CustomElementConverter } from "../converters/Converters.cjs";
-
-//#region src/types/Conversion.d.ts
-/**
- * Scalar built-in converter tokens (e.g. `'number'`, `'time'`).
- * Excludes the array builder (see {@link ArrayOf}).
- * @public
- */
-type BuiltInConverter = ConverterToken;
-/**
- * Primitive types supported by Envapter
- * @public
- */
-type PrimitiveConstructor = typeof String | typeof Number | typeof Boolean | typeof BigInt | typeof Symbol;
-/**
- * String value from a .env file or environment variable
- * @public
- */
-type BaseInput = string | undefined;
-/**
- * Custom parser function type for environment variables
- * @param raw - Raw string value from environment
- * @param fallback - Fallback value if parsing fails
- * @returns Parsed value of type T
- * @public
- */
-type ConverterFunction<TFallback = unknown> = (raw: BaseInput, fallback?: TFallback) => TFallback;
-/**
- * Environment variable converter: a primitive constructor, a built-in scalar token, an `ArrayOf<...>`
- * produced by {@link Converters.array}, or a custom parser function.
- * @public
- */
-type EnvaptConverter<TFallback> = PrimitiveConstructor | BuiltInConverter | ArrayOf | ConverterFunction<TFallback>;
-type JsonPrimitive = string | number | boolean | null;
-type JsonArray = JsonValue[];
-interface JsonObject {
-  [key: string]: JsonValue;
-}
-/**
- * JSON value types for custom converters
- * @public
- */
-type JsonValue = JsonPrimitive | JsonArray | JsonObject;
-interface ConverterMap {
-  string: string;
-  number: number;
-  boolean: boolean;
-  bigint: bigint;
-  symbol: symbol;
-  integer: number;
-  float: number;
-  json: JsonValue;
-  url: URL;
-  regexp: RegExp;
-  date: Date;
-  time: number;
-}
-/**
- * Type mapping for built-in scalar converters to their return types
- * @internal
- */
-type BuiltInConverterReturnType<ConverterKey extends BuiltInConverter> = ConverterMap[ConverterKey];
-/**
- * Return type for built-in converter functions
- * @internal
- */
-type ReturnValuesOfConverterFunctions = ConverterMap[BuiltInConverter];
-/**
- * Function type for built-in converter functions
- * @internal
- */
-type BuiltInConverterFunction = (...args: Parameters<(...args: any[]) => ReturnValuesOfConverterFunctions>) => ReturnValuesOfConverterFunctions | undefined;
-/**
- * Map of built-in converter functions
- * @internal
- */
-type MapOfConverterFunctions = Record<BuiltInConverter, BuiltInConverterFunction>;
-/**
- * Time unit types for duration conversions
- * @internal
- */
-type TimeUnit = 'ms' | 's' | 'm' | 'h' | 'd' | 'w';
-/**
- * Fallback type for time duration conversions
- * @public
- */
-type TimeFallback = number | `${number}${TimeUnit}`;
-/**
- * Helper type for getter methods that conditionally return undefined based on whether a fallback is provided
- * If fallback is provided, return ReturnType. If no fallback (undefined), return ReturnType | undefined.
- * @internal
- */
-type ConditionalReturn<ReturnType, TFallback> = TFallback extends undefined ? ReturnType | undefined : ReturnType;
-/**
- * Inferred return type for a converter.
- *
- * - `ArrayOf<E>` resolves to the element type's return as an array. When `E` is a custom
- *   function, the function's return type drives the array element. When `E` is a scalar
- *   token, `ConverterMap` provides the element type.
- * - Bare scalar tokens resolve through `ConverterMap`.
- * @internal
- */
-type InferConverterReturnType<TConverter> = TConverter extends ArrayOf<infer Element> ? Element extends BuiltInConverter ? ConverterMap[Element][] : Element extends CustomElementConverter<infer Returned> ? Returned[] : never : TConverter extends BuiltInConverter ? BuiltInConverterReturnType<TConverter> : never;
-/**
- * Type inference for the *fallback* slot of a converter. `Converters.Time` (scalar or array
- * element) accepts {@link TimeFallback} / `TimeFallback[]`; everything else mirrors the
- * return type. Add future asymmetric fallback/return converters to this conditional.
- * @internal
- */
-type InferConverterFallbackType<TConverter> = TConverter extends 'time' ? TimeFallback : TConverter extends ArrayOf<infer Element> ? Element extends 'time' ? TimeFallback[] : InferConverterReturnType<TConverter> : InferConverterReturnType<TConverter>;
-/**
- * Complete type inference for advanced converter methods
- * @internal
- */
-type AdvancedConverterReturn<TConverter, TFallback = undefined> = ConditionalReturn<InferConverterReturnType<TConverter>, TFallback>;
-/**
- * Type inference for primitive constructor return types
- * @internal
- */
-type InferPrimitiveReturnType<TConstructor extends PrimitiveConstructor> = TConstructor extends typeof String ? string : TConstructor extends typeof Number ? number : TConstructor extends typeof Boolean ? boolean : TConstructor extends typeof BigInt ? bigint : TConstructor extends typeof Symbol ? symbol : never;
-//#endregion
-export type { AdvancedConverterReturn, BuiltInConverter, BuiltInConverterFunction, ConditionalReturn, ConverterFunction, EnvaptConverter, InferConverterFallbackType, InferConverterReturnType, InferPrimitiveReturnType, JsonValue, MapOfConverterFunctions, PrimitiveConstructor, TimeFallback, TimeUnit };
-//# sourceMappingURL=Conversion.d.cts.map

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

@@ -1,125 +0,0 @@
-import __tsdown_shims_path from 'node:path';
-import __tsdown_shims_url from 'node:url';
-import { ArrayOf, ConverterToken, CustomElementConverter } from "../converters/Converters.mjs";
-
-//#region src/types/Conversion.d.ts
-/**
- * Scalar built-in converter tokens (e.g. `'number'`, `'time'`).
- * Excludes the array builder (see {@link ArrayOf}).
- * @public
- */
-type BuiltInConverter = ConverterToken;
-/**
- * Primitive types supported by Envapter
- * @public
- */
-type PrimitiveConstructor = typeof String | typeof Number | typeof Boolean | typeof BigInt | typeof Symbol;
-/**
- * String value from a .env file or environment variable
- * @public
- */
-type BaseInput = string | undefined;
-/**
- * Custom parser function type for environment variables
- * @param raw - Raw string value from environment
- * @param fallback - Fallback value if parsing fails
- * @returns Parsed value of type T
- * @public
- */
-type ConverterFunction<TFallback = unknown> = (raw: BaseInput, fallback?: TFallback) => TFallback;
-/**
- * Environment variable converter: a primitive constructor, a built-in scalar token, an `ArrayOf<...>`
- * produced by {@link Converters.array}, or a custom parser function.
- * @public
- */
-type EnvaptConverter<TFallback> = PrimitiveConstructor | BuiltInConverter | ArrayOf | ConverterFunction<TFallback>;
-type JsonPrimitive = string | number | boolean | null;
-type JsonArray = JsonValue[];
-interface JsonObject {
-  [key: string]: JsonValue;
-}
-/**
- * JSON value types for custom converters
- * @public
- */
-type JsonValue = JsonPrimitive | JsonArray | JsonObject;
-interface ConverterMap {
-  string: string;
-  number: number;
-  boolean: boolean;
-  bigint: bigint;
-  symbol: symbol;
-  integer: number;
-  float: number;
-  json: JsonValue;
-  url: URL;
-  regexp: RegExp;
-  date: Date;
-  time: number;
-}
-/**
- * Type mapping for built-in scalar converters to their return types
- * @internal
- */
-type BuiltInConverterReturnType<ConverterKey extends BuiltInConverter> = ConverterMap[ConverterKey];
-/**
- * Return type for built-in converter functions
- * @internal
- */
-type ReturnValuesOfConverterFunctions = ConverterMap[BuiltInConverter];
-/**
- * Function type for built-in converter functions
- * @internal
- */
-type BuiltInConverterFunction = (...args: Parameters<(...args: any[]) => ReturnValuesOfConverterFunctions>) => ReturnValuesOfConverterFunctions | undefined;
-/**
- * Map of built-in converter functions
- * @internal
- */
-type MapOfConverterFunctions = Record<BuiltInConverter, BuiltInConverterFunction>;
-/**
- * Time unit types for duration conversions
- * @internal
- */
-type TimeUnit = 'ms' | 's' | 'm' | 'h' | 'd' | 'w';
-/**
- * Fallback type for time duration conversions
- * @public
- */
-type TimeFallback = number | `${number}${TimeUnit}`;
-/**
- * Helper type for getter methods that conditionally return undefined based on whether a fallback is provided
- * If fallback is provided, return ReturnType. If no fallback (undefined), return ReturnType | undefined.
- * @internal
- */
-type ConditionalReturn<ReturnType, TFallback> = TFallback extends undefined ? ReturnType | undefined : ReturnType;
-/**
- * Inferred return type for a converter.
- *
- * - `ArrayOf<E>` resolves to the element type's return as an array. When `E` is a custom
- *   function, the function's return type drives the array element. When `E` is a scalar
- *   token, `ConverterMap` provides the element type.
- * - Bare scalar tokens resolve through `ConverterMap`.
- * @internal
- */
-type InferConverterReturnType<TConverter> = TConverter extends ArrayOf<infer Element> ? Element extends BuiltInConverter ? ConverterMap[Element][] : Element extends CustomElementConverter<infer Returned> ? Returned[] : never : TConverter extends BuiltInConverter ? BuiltInConverterReturnType<TConverter> : never;
-/**
- * Type inference for the *fallback* slot of a converter. `Converters.Time` (scalar or array
- * element) accepts {@link TimeFallback} / `TimeFallback[]`; everything else mirrors the
- * return type. Add future asymmetric fallback/return converters to this conditional.
- * @internal
- */
-type InferConverterFallbackType<TConverter> = TConverter extends 'time' ? TimeFallback : TConverter extends ArrayOf<infer Element> ? Element extends 'time' ? TimeFallback[] : InferConverterReturnType<TConverter> : InferConverterReturnType<TConverter>;
-/**
- * Complete type inference for advanced converter methods
- * @internal
- */
-type AdvancedConverterReturn<TConverter, TFallback = undefined> = ConditionalReturn<InferConverterReturnType<TConverter>, TFallback>;
-/**
- * Type inference for primitive constructor return types
- * @internal
- */
-type InferPrimitiveReturnType<TConstructor extends PrimitiveConstructor> = TConstructor extends typeof String ? string : TConstructor extends typeof Number ? number : TConstructor extends typeof Boolean ? boolean : TConstructor extends typeof BigInt ? bigint : TConstructor extends typeof Symbol ? symbol : never;
-//#endregion
-export type { AdvancedConverterReturn, BuiltInConverter, BuiltInConverterFunction, ConditionalReturn, ConverterFunction, EnvaptConverter, InferConverterFallbackType, InferConverterReturnType, InferPrimitiveReturnType, JsonValue, MapOfConverterFunctions, PrimitiveConstructor, TimeFallback, TimeUnit };
-//# sourceMappingURL=Conversion.d.mts.map

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

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