envapt 6.0.2 → 7.0.0-next.1

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

@@ -1,123 +0,0 @@
-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/workerd/types/Env.d.mts

@@ -1,17 +0,0 @@
-//#region src/types/Env.d.ts
-/**
- * Accepted shape for environment variable lookups. Either a single key or an ordered list of keys.
- * @public
- */
-type EnvKeyInput = string | readonly [string, ...string[]];
-/**
- * @internal
- */
-interface EnvapterService {
-  getRaw(key: EnvKeyInput): string | undefined;
-  get(key: EnvKeyInput, def?: string): string | undefined;
-  isStrict(): boolean;
-}
-//#endregion
-export type { EnvKeyInput, EnvapterService };
-//# sourceMappingURL=Env.d.mts.map

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

@@ -1,39 +0,0 @@
-import { EnvaptConverter } from "./Conversion.mjs";
-import { Environment } from "../core/EnvironmentMethods.mjs";
-
-//#region src/types/Options.d.ts
-/**
- * Options for the \@Envapt decorator (modern API). `required: true` is mutually exclusive
- * with `fallback`; see the per-converter overloads in `Envapt.ts` for the type-level mutex.
- * @public
- */
-interface EnvaptOptions<TFallback = string> {
-  fallback?: TFallback;
-  converter?: EnvaptConverter<TFallback>;
-  required?: boolean;
-}
-/**
- * Per-environment profile entry passed to `Envapter.configureProfiles`.
- * @public
- */
-interface EnvProfile {
-  /** One or more `.env` paths to load for this environment. Order matters: earlier paths take precedence. */
-  paths: string | string[];
-}
-/**
- * Configuration object for `Envapter.configureProfiles`. Maps each `Environment` to an optional
- * profile override. Unspecified environments fall through to the default cascade behavior
- * (`.env.${env}.local`, `.env.local`, `.env.${env}`, `.env`).
- * @public
- */
-type ProfilesConfig = Partial<Record<Environment, EnvProfile>> & {
-  /**
-   * When `false`, disables the default dotenv-flow cascade entirely. Only the explicitly
-   * configured paths are loaded. Defaults to `true` (cascade still runs, configured paths
-   * are layered on top with higher precedence).
-   */
-  useDefaults?: boolean;
-};
-//#endregion
-export type { EnvProfile, EnvaptOptions, ProfilesConfig };
-//# sourceMappingURL=Options.d.mts.map

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

@@ -1,12 +0,0 @@
-import { StandardSchemaV1 } from "../StandardSchema.mjs";
-
-//#region src/types/Schema.d.ts
-declare const _envaptErrBrand: unique symbol;
-type Err<Msg extends string> = Msg & {
-  readonly [_envaptErrBrand]: never;
-};
-type SchemaMustBeSync = Err<'Schema must be synchronous. envapt is boot-time config loading; async refinements (validate returning `Promise<Result>`) belong outside the env layer.'>;
-type SchemaConstraint<Schema extends StandardSchemaV1> = ReturnType<Schema['~standard']['validate']> extends Promise<unknown> ? SchemaMustBeSync : Schema;
-//#endregion
-export type { Err, SchemaConstraint, SchemaMustBeSync };
-//# sourceMappingURL=Schema.d.mts.map

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

@@ -1,44 +0,0 @@
-//#region src/types/Source.d.ts
-/**
- * A source with no filesystem: an injected object on the browser, or the Cloudflare `env` binding on
- * Workers. The `.env` cascade, profiles, and the `envPaths`/`baseDir`/`configureProfiles` APIs do not
- * apply; only `readVars()` populates the cache.
- * @public
- */
-interface BareEnvSource {
-  /** Return every variable this source provides, as plain strings. */
-  readVars(): Record<string, string>;
-  /** Leave unset (or `false`); a bare source has no filesystem. */
-  readonly supportsFiles?: false;
-}
-/**
- * A filesystem-backed source, like the default {@link NodeEnvSource}. Setting `supportsFiles` to
- * `true` requires all four file capabilities, so the engine can load the `.env` cascade, resolve
- * `baseDir`, and mirror loaded keys back to the ambient environment.
- * @public
- */
-interface FileEnvSource {
-  /** Return every variable this source provides, as plain strings. */
-  readVars(): Record<string, string>;
-  /** When `true`, the engine loads the `.env` cascade, profiles, and `envPaths` through the methods below. */
-  readonly supportsFiles: true;
-  /** Read a file's text, or `undefined` when it is absent or unreadable. Backs the loader and existence checks. */
-  readFile(path: string, encoding: string): string | undefined;
-  /** Join a relative `.env` path onto `baseDir`; absolute paths are returned unchanged. */
-  resolvePath(baseDir: string, candidate: string): string;
-  /** Normalize a `baseDir` value (a directory path, or a module / `file:` URL) to an absolute directory path. */
-  normalizeBaseDir(value: string | URL): string;
-  /** Mirror loaded keys back to the ambient environment (e.g. `process.env`); backs `Envapter.syncProcessEnv`. */
-  writeVars(vars: Record<string, string>): void;
-}
-/**
- * A pluggable source of environment variables. The default {@link NodeEnvSource} (a
- * {@link FileEnvSource}) reads `process.env` plus the `.env` cascade; a {@link BareEnvSource} lets the
- * same engine run where there is no ambient environment (an injected object on the browser, the
- * Cloudflare `env` binding on Workers). Bind one with `Envapter.useSource`.
- * @public
- */
-type EnvSource = BareEnvSource | FileEnvSource;
-//#endregion
-export type { BareEnvSource, EnvSource, FileEnvSource };
-//# sourceMappingURL=Source.d.mts.map