arkenv 0.9.2 → 0.10.0

package/dist/{create-env-D7N4rUVE.d.cts → index-bSO6Cmhi.d.cts}

@@ -1,8 +1,90 @@
 import * as arktype_internal_keywords_string_ts0 from "arktype/internal/keywords/string.ts";
 import * as arktype_internal_attributes_ts0 from "arktype/internal/attributes.ts";
 import * as arktype0 from "arktype";
-import { Type, distill, type } from "arktype";
+import { Type, type } from "arktype";
 
+//#region ../internal/scope/dist/index.d.ts
+
+//#region src/root.d.ts
+/**
+ * The root scope for the ArkEnv library,
+ * containing extensions to the ArkType scopes with ArkEnv-specific types
+ * like `string.host` and `number.port`.
+ */
+declare const $: arktype0.Scope<{
+  string: arktype0.Submodule<{
+    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    root: string;
+    alpha: string;
+    alphanumeric: string;
+    hex: string;
+    base64: arktype0.Submodule<{
+      root: string;
+      url: string;
+    } & {
+      " arkInferred": string;
+    }>;
+    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    creditCard: string;
+    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {
+      " arkInferred": string;
+    }>;
+    digits: string;
+    email: string;
+    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {
+      " arkInferred": string;
+    }>;
+    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {
+      " arkInferred": string;
+    }>;
+    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {
+      " arkInferred": string;
+    }>;
+    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {
+      " arkInferred": string;
+    }>;
+    regex: string;
+    semver: string;
+    upper: arktype0.Submodule<{
+      root: (In: string) => arktype_internal_attributes_ts0.To<string>;
+      preformatted: string;
+    } & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {
+      " arkInferred": string;
+    }>;
+    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {
+      " arkInferred": string;
+    }>;
+    " arkInferred": string;
+    host: string;
+  }>;
+  number: arktype0.Submodule<{
+    NaN: number;
+    Infinity: number;
+    root: number;
+    integer: number;
+    " arkInferred": number;
+    epoch: number;
+    safe: number;
+    NegativeInfinity: number;
+    port: number;
+  }>;
+}>;
+type $ = (typeof $)["t"];
+//#endregion
+//#endregion
 //#region ../internal/types/dist/helpers.d.ts
 type Dict<T> = Record<string, T | undefined>;
 //#endregion
@@ -103,87 +185,6 @@ type InferType<T> = T extends StandardSchemaV1<infer _Input, infer Output> ? Out
   t: infer U;
 } ? U : T extends type.Any<infer U, infer _Scope> ? U : never;
 //#endregion
-//#region ../internal/scope/dist/index.d.ts
-//#region src/root.d.ts
-/**
- * The root scope for the ArkEnv library,
- * containing extensions to the ArkType scopes with ArkEnv-specific types
- * like `string.host` and `number.port`.
- */
-declare const $: arktype0.Scope<{
-  string: arktype0.Submodule<{
-    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
-    }>;
-    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
-    }>;
-    root: string;
-    alpha: string;
-    alphanumeric: string;
-    hex: string;
-    base64: arktype0.Submodule<{
-      root: string;
-      url: string;
-    } & {
-      " arkInferred": string;
-    }>;
-    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
-    }>;
-    creditCard: string;
-    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {
-      " arkInferred": string;
-    }>;
-    digits: string;
-    email: string;
-    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {
-      " arkInferred": string;
-    }>;
-    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {
-      " arkInferred": string;
-    }>;
-    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {
-      " arkInferred": string;
-    }>;
-    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
-    }>;
-    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {
-      " arkInferred": string;
-    }>;
-    regex: string;
-    semver: string;
-    upper: arktype0.Submodule<{
-      root: (In: string) => arktype_internal_attributes_ts0.To<string>;
-      preformatted: string;
-    } & {
-      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
-    }>;
-    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {
-      " arkInferred": string;
-    }>;
-    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {
-      " arkInferred": string;
-    }>;
-    " arkInferred": string;
-    host: string;
-  }>;
-  number: arktype0.Submodule<{
-    NaN: number;
-    Infinity: number;
-    root: number;
-    integer: number;
-    " arkInferred": number;
-    epoch: number;
-    safe: number;
-    NegativeInfinity: number;
-    port: number;
-  }>;
-}>;
-type $ = (typeof $)["t"];
-//#endregion
-//#endregion
 //#region ../internal/types/dist/schema.d.ts
 type SchemaShape = Record<string, unknown>;
 /**
@@ -200,88 +201,7 @@ type SchemaShape = Record<string, unknown>;
  */
 type CompiledEnvSchema = Type<SchemaShape, $>;
 //#endregion
-//#region src/create-env.d.ts
-/**
- * Declarative environment schema definition accepted by ArkEnv.
- *
- * Represents a declarative schema object mapping environment
- * variable names to schema definitions (e.g. ArkType DSL strings
- * or Standard Schema validators).
- *
- * This type is used to validate that a schema object is compatible with
- * ArkEnv’s validator scope before being compiled or parsed.
- *
- * Most users will provide schemas in this form.
- *
- * @template def - The schema shape object
- */
-type EnvSchema<def> = type.validate<def, $>;
-type RuntimeEnvironment = Dict<string>;
-/**
- * Configuration options for `createEnv`
- */
-type ArkEnvConfig = {
-  /**
-   * The environment variables to parse. Defaults to `process.env`
-   */
-  env?: RuntimeEnvironment;
-  /**
-   * Whether to coerce environment variables to their defined types. Defaults to `true`
-   */
-  coerce?: boolean;
-  /**
-   * Control how ArkEnv handles environment variables that are not defined in your schema.
-   *
-   * Defaults to `'delete'` to ensure your output object only contains
-   * keys you've explicitly declared. This differs from ArkType's standard behavior, which
-   * mirrors TypeScript by defaulting to `'ignore'`.
-   *
-   * - `delete` (ArkEnv default): Undeclared keys are allowed on input but stripped from the output.
-   * - `ignore` (ArkType default): Undeclared keys are allowed and preserved in the output.
-   * - `reject`: Undeclared keys will cause validation to fail.
-   *
-   * @default "delete"
-   * @see https://arktype.io/docs/configuration#onundeclaredkey
-   */
-  onUndeclaredKey?: "ignore" | "delete" | "reject";
-  /**
-   * The format to use for array parsing when coercion is enabled.
-   *
-   * - `comma` (default): Strings are split by comma and trimmed.
-   * - `json`: Strings are parsed as JSON.
-   *
-   * @default "comma"
-   */
-  arrayFormat?: "comma" | "json";
-  /**
-   * Choose the validator engine to use.
-   *
-   * - `arktype` (default): Uses ArkType for all validation and coercion.
-   * - `standard`: Uses Standard Schema 1.0 directly for validation. Coercion is not supported in this mode.
-   *
-   * @default "arktype"
-   */
-  validator?: "arktype" | "standard";
-};
-/**
- * TODO: `SchemaShape` is basically `Record<string, unknown>`.
- * If possible, find a better type than "const T extends Record<string, unknown>",
- * and be as close as possible to the type accepted by ArkType's `type`.
- */
-/**
- * Utility to parse environment variables using ArkType or Standard Schema
- * @param def - The schema definition
- * @param config - The evaluation configuration
- * @returns The parsed environment variables
- * @throws An {@link ArkEnvError | error} if the environment variables are invalid.
- */
-declare function createEnv<const T extends Record<string, StandardSchemaV1>>(def: T, config: ArkEnvConfig & {
-  validator: "standard";
-}): { [K in keyof T]: StandardSchemaV1.InferOutput<T[K]> };
-declare function createEnv<const T extends SchemaShape>(def: EnvSchema<T>, config?: ArkEnvConfig): distill.Out<type.infer<T, $>>;
-declare function createEnv<T extends CompiledEnvSchema>(def: T, config?: ArkEnvConfig): InferType<T>;
-//#endregion
-export { SchemaShape as i, EnvSchema as n, createEnv as r, ArkEnvConfig as t };
+export { Dict as a, StandardSchemaV1 as i, SchemaShape as n, $ as o, InferType as r, CompiledEnvSchema as t };
 
 // CJS Interop Shim
 if (module.exports && module.exports.default) {
@@ -289,4 +209,4 @@ if (module.exports && module.exports.default) {
     module.exports = module.exports.default;
 }
       
-//# sourceMappingURL=create-env-D7N4rUVE.d.cts.map
+//# sourceMappingURL=index-bSO6Cmhi.d.cts.map

package/dist/index-bSO6Cmhi.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-bSO6Cmhi.d.cts","names":["arktype0","arktype_internal_keywords_string_ts0","arktype_internal_attributes_ts0","$","trim","To","Submodule","normalize","capitalize","stringDate","stringInteger","ip","stringJson","lower","stringNumeric","url","uuid","Scope","Dict","T","Record","StandardTypedV1","Input","Output","Props","Schema","Types","NonNullable","StandardSchemaV1","Options","Result","Promise","SuccessResult","FailureResult","Record","Issue","ReadonlyArray","PropertyKey","PathSegment","InferInput","InferOutput","StandardJSONSchemaV1","Converter","Target","type","StandardSchemaV1","InferType","T","Record","errors","Any","$","Type","SchemaShape","Record","CompiledEnvSchema"],"sources":["../../internal/scope/dist/index.d.ts","../../internal/types/dist/helpers.d.ts","../../internal/types/dist/standard-schema.d.ts","../../internal/types/dist/infer-type.d.ts","../../internal/types/dist/schema.d.ts"],"sourcesContent":["import * as arktype0 from \"arktype\";\nimport * as arktype_internal_keywords_string_ts0 from \"arktype/internal/keywords/string.ts\";\nimport * as arktype_internal_attributes_ts0 from \"arktype/internal/attributes.ts\";\n\n//#region src/root.d.ts\n/**\n * The root scope for the ArkEnv library,\n * containing extensions to the ArkType scopes with ArkEnv-specific types\n * like `string.host` and `number.port`.\n */\ndeclare const $: arktype0.Scope<{\n  string: arktype0.Submodule<{\n    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    root: string;\n    alpha: string;\n    alphanumeric: string;\n    hex: string;\n    base64: arktype0.Submodule<{\n      root: string;\n      url: string;\n    } & {\n      \" arkInferred\": string;\n    }>;\n    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    creditCard: string;\n    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {\n      \" arkInferred\": string;\n    }>;\n    digits: string;\n    email: string;\n    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {\n      \" arkInferred\": string;\n    }>;\n    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {\n      \" arkInferred\": string;\n    }>;\n    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {\n      \" arkInferred\": string;\n    }>;\n    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {\n      \" arkInferred\": string;\n    }>;\n    regex: string;\n    semver: string;\n    upper: arktype0.Submodule<{\n      root: (In: string) => arktype_internal_attributes_ts0.To<string>;\n      preformatted: string;\n    } & {\n      \" arkInferred\": (In: string) => arktype_internal_attributes_ts0.To<string>;\n    }>;\n    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {\n      \" arkInferred\": string;\n    }>;\n    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {\n      \" arkInferred\": string;\n    }>;\n    \" arkInferred\": string;\n    host: string;\n  }>;\n  number: arktype0.Submodule<{\n    NaN: number;\n    Infinity: number;\n    root: number;\n    integer: number;\n    \" arkInferred\": number;\n    epoch: number;\n    safe: number;\n    NegativeInfinity: number;\n    port: number;\n  }>;\n}>;\ntype $ = (typeof $)[\"t\"];\n//#endregion\nexport { $ };\n//# sourceMappingURL=index.d.ts.map","export type Dict<T> = Record<string, T | undefined>;\n//# sourceMappingURL=helpers.d.ts.map","/**\n * @see https://github.com/standard-schema/standard-schema/tree/3130ce43fdd848d9ab49dbb0458d04f18459961c/packages/spec\n *\n * Copied from standard-schema (MIT License)\n * Copyright (c) 2024 Colin McDannell\n */\n/** The Standard Typed interface. This is a base type extended by other specs. */\nexport interface StandardTypedV1<Input = unknown, Output = Input> {\n    /** The Standard properties. */\n    readonly \"~standard\": StandardTypedV1.Props<Input, Output>;\n}\nexport declare namespace StandardTypedV1 {\n    /** The Standard Typed properties interface. */\n    interface Props<Input = unknown, Output = Input> {\n        /** The version number of the standard. */\n        readonly version: 1;\n        /** The vendor name of the schema library. */\n        readonly vendor: string;\n        /** Inferred types associated with the schema. */\n        readonly types?: Types<Input, Output> | undefined;\n    }\n    /** The Standard Typed types interface. */\n    interface Types<Input = unknown, Output = Input> {\n        /** The input type of the schema. */\n        readonly input: Input;\n        /** The output type of the schema. */\n        readonly output: Output;\n    }\n    /** Infers the input type of a Standard Typed. */\n    type InferInput<Schema extends StandardTypedV1> = NonNullable<Schema[\"~standard\"][\"types\"]>[\"input\"];\n    /** Infers the output type of a Standard Typed. */\n    type InferOutput<Schema extends StandardTypedV1> = NonNullable<Schema[\"~standard\"][\"types\"]>[\"output\"];\n}\n/** The Standard Schema interface. */\nexport interface StandardSchemaV1<Input = unknown, Output = Input> {\n    /** The Standard Schema properties. */\n    readonly \"~standard\": StandardSchemaV1.Props<Input, Output>;\n}\nexport declare namespace StandardSchemaV1 {\n    /** The Standard Schema properties interface. */\n    interface Props<Input = unknown, Output = Input> extends StandardTypedV1.Props<Input, Output> {\n        /** Validates unknown input values. */\n        readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;\n    }\n    /** The result interface of the validate function. */\n    type Result<Output> = SuccessResult<Output> | FailureResult;\n    /** The result interface if validation succeeds. */\n    interface SuccessResult<Output> {\n        /** The typed output value. */\n        readonly value: Output;\n        /** A falsy value for `issues` indicates success. */\n        readonly issues?: undefined;\n    }\n    interface Options {\n        /** Explicit support for additional vendor-specific parameters, if needed. */\n        readonly libraryOptions?: Record<string, unknown> | undefined;\n    }\n    /** The result interface if validation fails. */\n    interface FailureResult {\n        /** The issues of failed validation. */\n        readonly issues: ReadonlyArray<Issue>;\n    }\n    /** The issue interface of the failure output. */\n    interface Issue {\n        /** The error message of the issue. */\n        readonly message: string;\n        /** The path of the issue, if any. */\n        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;\n    }\n    /** The path segment interface of the issue. */\n    interface PathSegment {\n        /** The key representing a path segment. */\n        readonly key: PropertyKey;\n    }\n    /** The Standard types interface. */\n    interface Types<Input = unknown, Output = Input> extends StandardTypedV1.Types<Input, Output> {\n    }\n    /** Infers the input type of a Standard. */\n    type InferInput<Schema extends StandardTypedV1> = StandardTypedV1.InferInput<Schema>;\n    /** Infers the output type of a Standard. */\n    type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;\n}\n/** The Standard JSON Schema interface. */\nexport interface StandardJSONSchemaV1<Input = unknown, Output = Input> {\n    /** The Standard JSON Schema properties. */\n    readonly \"~standard\": StandardJSONSchemaV1.Props<Input, Output>;\n}\nexport declare namespace StandardJSONSchemaV1 {\n    /** The Standard JSON Schema properties interface. */\n    interface Props<Input = unknown, Output = Input> extends StandardTypedV1.Props<Input, Output> {\n        /** Methods for generating the input/output JSON Schema. */\n        readonly jsonSchema: StandardJSONSchemaV1.Converter;\n    }\n    /** The Standard JSON Schema converter interface. */\n    interface Converter {\n        /** Converts the input type to JSON Schema. May throw if conversion is not supported. */\n        readonly input: (options: StandardJSONSchemaV1.Options) => Record<string, unknown>;\n        /** Converts the output type to JSON Schema. May throw if conversion is not supported. */\n        readonly output: (options: StandardJSONSchemaV1.Options) => Record<string, unknown>;\n    }\n    /**\n     * The target version of the generated JSON Schema.\n     *\n     * It is *strongly recommended* that implementers support `\"draft-2020-12\"` and `\"draft-07\"`, as they are both in wide use. All other targets can be implemented on a best-effort basis. Libraries should throw if they don't support a specified target.\n     *\n     * The `\"openapi-3.0\"` target is intended as a standardized specifier for OpenAPI 3.0 which is a superset of JSON Schema `\"draft-04\"`.\n     */\n    type Target = \"draft-2020-12\" | \"draft-07\" | \"openapi-3.0\" | ({} & string);\n    /** The options for the input/output methods. */\n    interface Options {\n        /** Specifies the target version of the generated JSON Schema. Support for all versions is on a best-effort basis. If a given version is not supported, the library should throw. */\n        readonly target: Target;\n        /** Explicit support for additional vendor-specific parameters, if needed. */\n        readonly libraryOptions?: Record<string, unknown> | undefined;\n    }\n    /** The Standard types interface. */\n    interface Types<Input = unknown, Output = Input> extends StandardTypedV1.Types<Input, Output> {\n    }\n    /** Infers the input type of a Standard. */\n    type InferInput<Schema extends StandardTypedV1> = StandardTypedV1.InferInput<Schema>;\n    /** Infers the output type of a Standard. */\n    type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;\n}\n//# sourceMappingURL=standard-schema.d.ts.map","import type { type } from \"arktype\";\nimport type { StandardSchemaV1 } from \"./standard-schema\";\n/**\n * Extract the inferred type from a schema definition.\n * Supports both ArkType type definitions and Standard Schema 1.0 validators.\n *\n * For Standard Schema validators (e.g., Zod, Valibot), extracts the output type.\n * For ArkType definitions, checks the call signature or type properties.\n *\n * @template T - The schema definition to infer from\n */\nexport type InferType<T> = T extends StandardSchemaV1<infer _Input, infer Output> ? Output : T extends (value: Record<string, string | undefined>) => infer R ? R extends type.errors ? never : R : T extends {\n    t: infer U;\n} ? U : T extends type.Any<infer U, infer _Scope> ? U : never;\n//# sourceMappingURL=infer-type.d.ts.map","import type { $ } from \"@repo/scope\";\nimport type { Type } from \"arktype\";\nexport type SchemaShape = Record<string, unknown>;\n/**\n * @internal\n *\n * Compiled ArkType schema accepted by ArkEnv.\n * Produced by `arktype.type(...)` or `scope(...)`.\n *\n * Represents an already-constructed ArkType `Type` instance that\n * defines the full environment schema.\n *\n * This form bypasses schema validation and is intended for advanced\n * or programmatic use cases where schemas are constructed dynamically.\n */\nexport type CompiledEnvSchema = Type<SchemaShape, $>;\n//# sourceMappingURL=schema.d.ts.map"],"mappings":"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"}

package/dist/index.cjs

@@ -1,4 +1,4 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./errors-BtUS5QYF.cjs`);let t=require(`node:module`);function n(t,n){let{env:r=process.env,onUndeclaredKey:i=`delete`}=n,a={},o=[],s=new Set(Object.keys(r));for(let e in t){let n=t[e],i=r[e];if(!n||typeof n!=`object`||!(`~standard`in n))throw Error(`Invalid schema for key "${e}": expected a Standard Schema 1.0 validator (e.g. Zod, Valibot) in "standard" mode.`);let c=n[`~standard`].validate(i);if(c instanceof Promise)throw Error(`Async validation is not supported for key "${e}". ArkEnv is synchronous.`);if(c.issues)for(let t of c.issues)o.push({path:e,message:t.message});else a[e]=c.value;s.delete(e)}if(i!==`delete`)for(let e of s)i===`reject`?o.push({path:e,message:`Undeclared key`}):i===`ignore`&&(a[e]=r[e]);if(o.length>0)throw new e.t(o);return a}function r(e){return typeof e==`object`&&!!e&&`message`in e&&typeof e.message==`string`}function i(){let e=(()=>{try{let e={};if(e?.url)return(0,t.createRequire)(e.url)}catch{}try{let e=typeof module<`u`?module:void 0;if(e?.require)return e.require.bind(e)}catch{}try{return(0,t.createRequire)(`${process.cwd()}/index.js`)}catch{}})();if(!e)throw Error(`ArkEnv was unable to load the ArkType validator because neither 'createRequire' nor 'require' are available in this environment.`);let n=[`arkenv/arktype`,`./arktype.cjs`,`../arktype.cjs`,`./arktype/index.cjs`,`../arktype/index.cjs`,`./arktype`,`../arktype`,`./arktype/index.ts`,`../arktype/index.ts`],i;for(let t of n)try{return e(t)}catch(e){if(i=e,r(e)&&e.code===`MODULE_NOT_FOUND`){let n=e.message||``;if((n.includes(`'arktype'`)||n.includes(`"arktype"`)||n.includes(`Cannot find module 'arktype'`))&&!n.includes(t))break}}let a=r(i)?i.message:``;throw r(i)&&i.code===`MODULE_NOT_FOUND`&&(a.includes(`'arktype'`)||a.includes(`"arktype"`)||a.includes(`Cannot find module 'arktype'`))&&!a.includes(`./arktype`)&&!a.includes(`../arktype`)?Error(`The 'arktype' package is required when using the default validator mode. Please install it (npm install arktype) or set 'validator: "standard"' in your config if you only intend to use Standard Schema validators (like Zod or Valibot).`):i}function a(t,r={}){if((r.validator??`arktype`)===`standard`){if(!t||typeof t!=`object`||Array.isArray(t))throw new e.t([{path:``,message:`Invalid schema: expected an object mapping in "standard" mode.`}]);for(let n in t){let r=t[n];if(typeof r==`string`)throw new e.t([{path:n,message:`ArkType DSL strings are not supported in "standard" mode. Use a Standard Schema validator (e.g., Zod, Valibot) or set validator: "arktype".`}]);if(!r||typeof r!=`object`||!(`~standard`in r))throw new e.t([{path:n,message:`Invalid validator: expected a Standard Schema 1.0 validator (must have "~standard" property). ArkType validators are not supported in "standard" mode. Use validator: "arktype" for ArkType schemas.`}])}return n(t,r)}let{parse:a}=i();return a(t,r)}const o=a;var s=o;exports.ArkEnvError=e.t,exports.createEnv=a,exports.default=s;
+Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./core-Byznlywt.cjs`);let t=require(`arktype`);const n=(0,t.type)(`0 <= number.integer <= 65535`),r=(0,t.type)(`string.ip | 'localhost'`),i=(0,t.scope)({string:t.type.module({...t.type.keywords.string,host:r}),number:t.type.module({...t.type.keywords.number,port:n})}),a=e=>{if(typeof e==`number`||typeof e!=`string`)return e;let t=e.trim();if(t===``)return e;if(t===`NaN`)return NaN;let n=Number(t);return Number.isNaN(n)?e:n},o=e=>e===`true`?!0:e===`false`?!1:e,s=e=>{if(typeof e!=`string`)return e;let t=e.trim();if(!t.startsWith(`{`)&&!t.startsWith(`[`))return e;try{return JSON.parse(t)}catch{return e}},c=`*`,l=(e,t=[])=>{let n=[];if(typeof e==`boolean`)return n;if(`const`in e&&(typeof e.const==`number`||typeof e.const==`boolean`)&&n.push({path:[...t],type:`primitive`}),`enum`in e&&e.enum&&e.enum.some(e=>typeof e==`number`||typeof e==`boolean`)&&n.push({path:[...t],type:`primitive`}),`type`in e)if(e.type===`number`||e.type===`integer`)n.push({path:[...t],type:`primitive`});else if(e.type===`boolean`)n.push({path:[...t],type:`primitive`});else if(e.type===`object`){if(`properties`in e&&e.properties&&Object.keys(e.properties).length>0&&n.push({path:[...t],type:`object`}),`properties`in e&&e.properties)for(let[r,i]of Object.entries(e.properties))n.push(...l(i,[...t,r]))}else e.type===`array`&&(n.push({path:[...t],type:`array`}),`items`in e&&e.items&&(Array.isArray(e.items)?e.items.forEach((e,r)=>{n.push(...l(e,[...t,`${r}`]))}):n.push(...l(e.items,[...t,`*`]))));if(`anyOf`in e&&e.anyOf)for(let r of e.anyOf)n.push(...l(r,t));if(`allOf`in e&&e.allOf)for(let r of e.allOf)n.push(...l(r,t));if(`oneOf`in e&&e.oneOf)for(let r of e.oneOf)n.push(...l(r,t));let r=new Set;return n.filter(e=>{let t=JSON.stringify(e.path)+e.type;return r.has(t)?!1:(r.add(t),!0)})},u=(e,t,n={})=>{let{arrayFormat:r=`comma`}=n,i=e=>{if(r===`json`)try{return JSON.parse(e)}catch{return e}return e.trim()?e.split(`,`).map(e=>e.trim()):[]};if(typeof e!=`object`||!e){if(t.some(e=>e.path.length===0)){let n=t.find(e=>e.path.length===0);if(n?.type===`object`&&typeof e==`string`)return s(e);if(n?.type===`array`&&typeof e==`string`)return i(e);let r=a(e);return typeof r==`number`?r:o(e)}return e}let c=[...t].sort((e,t)=>e.path.length-t.path.length),l=(e,t,n)=>{if(!e||typeof e!=`object`||t.length===0)return;if(t.length===1){let r=t[0];if(r===`*`){if(Array.isArray(e))for(let t=0;t<e.length;t++){let r=e[t];if(n===`primitive`){let n=a(r);typeof n==`number`?e[t]=n:e[t]=o(r)}else n===`object`&&(e[t]=s(r))}return}let c=e;if(Object.prototype.hasOwnProperty.call(c,r)){let e=c[r];if(n===`array`&&typeof e==`string`){c[r]=i(e);return}if(n===`object`&&typeof e==`string`){c[r]=s(e);return}if(Array.isArray(e)){if(n===`primitive`)for(let t=0;t<e.length;t++){let n=e[t],r=a(n);typeof r==`number`?e[t]=r:e[t]=o(n)}}else if(n===`primitive`){let t=a(e);typeof t==`number`?c[r]=t:c[r]=o(e)}}return}let[r,...c]=t;if(r===`*`){if(Array.isArray(e))for(let t of e)l(t,c,n);return}l(e[r],c,n)};for(let t of c)l(e,t.path,t.type);return e};function d(e,t,n){let r=l(t.in.toJsonSchema({fallback:e=>e.base}));return r.length===0?t:e(`unknown`).pipe(e=>u(e,r,n)).pipe(t)}function f(t){return Object.entries(t.byPath).map(([t,n])=>{let r=n.message,i=r.trimStart();if(i.length>0&&`:.-`.includes(i[0])&&(i=i.slice(1).trimStart()),i.toLowerCase().startsWith(t.toLowerCase())){let e=i.slice(t.length).trimStart();e.length>0&&`:.-`.includes(e[0])&&(e=e.slice(1)),r=e.trimStart()}let a=r.match(/\(was (.*)\)/);if(a?.[1]){let t=a[1];t.includes(`\x1B[`)||(r=r.replace(`(was ${t})`,`(was ${e.r(`cyan`,t)})`))}return{path:t,message:r}})}function p(n,r){let{env:a=process.env,coerce:o=!0,onUndeclaredKey:s=`delete`,arrayFormat:c=`comma`}=r,l=(typeof n==`function`&&`assert`in n?n:i.type.raw(n)).onUndeclaredKey(s),u=l;o&&(u=d(i.type,l,{arrayFormat:c}));let p=u(a);if(p instanceof t.ArkErrors)throw new e.t(f(p));return p}function m(e,t={}){return p(e,t)}const h=i.type,g=m;var _=g;exports.ArkEnvError=e.t,exports.createEnv=m,exports.default=_,exports.type=h;
 
 // CJS Interop Shim
 if (module.exports && module.exports.default) {

package/dist/index.d.cts

@@ -1,38 +1,163 @@
-import { n as EnvSchema, r as createEnv, t as ArkEnvConfig } from "./create-env-D7N4rUVE.cjs";
-import { ArkErrors } from "arktype";
+import { ArkEnvError } from "./core.cjs";
+import { a as Dict, n as SchemaShape, o as $, r as InferType, t as CompiledEnvSchema } from "./index-bSO6Cmhi.cjs";
+import * as arktype_internal_keywords_string_ts0 from "arktype/internal/keywords/string.ts";
+import * as arktype_internal_attributes_ts0 from "arktype/internal/attributes.ts";
+import * as arktype0 from "arktype";
+import { distill, type as type$1 } from "arktype";
+import * as arktype_internal_type_ts0 from "arktype/internal/type.ts";
+
+//#region src/create-env.d.ts
 
-//#region src/errors.d.ts
-type InternalValidationError = {
-  path: string;
-  message: string;
-};
 /**
- * Error thrown when environment variable validation fails.
+ * Declarative environment schema definition accepted by ArkEnv.
  *
- * This error extends the native `Error` class and provides formatted error messages
- * that clearly indicate which environment variables are invalid and why.
+ * Represents a declarative schema object mapping environment
+ * variable names to schema definitions (e.g. ArkType DSL strings
+ * or Standard Schema validators).
  *
- * @example
- * ```ts
- * import { createEnv, ArkEnvError } from 'arkenv';
+ * This type is used to validate that a schema object is compatible with
+ * ArkEnv’s validator scope before being compiled or parsed.
  *
- * try {
- *   const env = createEnv({
- *     PORT: 'number.port',
- *     HOST: 'string.host',
- *   });
- * } catch (error) {
- *   if (error instanceof ArkEnvError) {
- *     console.error('Environment validation failed:', error.message);
- *   }
- * }
- * ```
+ * Most users will provide schemas in this form.
+ *
+ * @template def - The schema shape object
  */
-declare class ArkEnvError extends Error {
-  constructor(errors: ArkErrors | InternalValidationError[], message?: string);
-}
+type EnvSchema<def$1> = type$1.validate<def$1, $>;
+type RuntimeEnvironment = Dict<string>;
+/**
+ * Configuration options for `createEnv`
+ */
+type ArkEnvConfig = {
+  /**
+   * The environment variables to parse. Defaults to `process.env`
+   */
+  env?: RuntimeEnvironment;
+  /**
+   * Whether to coerce environment variables to their defined types. Defaults to `true`
+   */
+  coerce?: boolean;
+  /**
+   * Control how ArkEnv handles environment variables that are not defined in your schema.
+   *
+   * Defaults to `'delete'` to ensure your output object only contains
+   * keys you've explicitly declared. This differs from ArkType's standard behavior, which
+   * mirrors TypeScript by defaulting to `'ignore'`.
+   *
+   * - `delete` (ArkEnv default): Undeclared keys are allowed on input but stripped from the output.
+   * - `ignore` (ArkType default): Undeclared keys are allowed and preserved in the output.
+   * - `reject`: Undeclared keys will cause validation to fail.
+   *
+   * @default "delete"
+   * @see https://arktype.io/docs/configuration#onundeclaredkey
+   */
+  onUndeclaredKey?: "ignore" | "delete" | "reject";
+  /**
+   * The format to use for array parsing when coercion is enabled.
+   *
+   * - `comma` (default): Strings are split by comma and trimmed.
+   * - `json`: Strings are parsed as JSON.
+   *
+   * @default "comma"
+   */
+  arrayFormat?: "comma" | "json";
+};
+/**
+ * TODO: `SchemaShape` is basically `Record<string, unknown>`.
+ * If possible, find a better type than "const T extends Record<string, unknown>",
+ * and be as close as possible to the type accepted by ArkType's `type`.
+ */
+/**
+ * Utility to parse environment variables using ArkType or Standard Schema
+ * @param def - The schema definition
+ * @param config - The evaluation configuration
+ * @returns The parsed environment variables
+ * @throws An {@link ArkEnvError | error} if the environment variables are invalid.
+ */
+declare function createEnv<const T extends SchemaShape>(def: EnvSchema<T>, config?: ArkEnvConfig): distill.Out<type$1.infer<T, $>>;
+declare function createEnv<T extends CompiledEnvSchema>(def: T, config?: ArkEnvConfig): InferType<T>;
+declare function createEnv<const T extends SchemaShape>(def: EnvSchema<T> | CompiledEnvSchema, config?: ArkEnvConfig): distill.Out<type$1.infer<T, $>> | InferType<typeof def>;
 //#endregion
 //#region src/index.d.ts
+/**
+ * Like ArkType's `type`, but with ArkEnv's extra keywords, such as:
+ *
+ * - `string.host` – a hostname (e.g. `"localhost"`, `"127.0.0.1"`)
+ * - `number.port` – a port number (e.g. `8080`)
+ *
+ * See ArkType's docs for the full API:
+ * https://arktype.io/docs/type-api
+ */
+declare const type: arktype_internal_type_ts0.TypeParser<{
+  string: arktype0.Submodule<{
+    trim: arktype0.Submodule<arktype_internal_keywords_string_ts0.trim.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    normalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.normalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    root: string;
+    alpha: string;
+    alphanumeric: string;
+    hex: string;
+    base64: arktype0.Submodule<{
+      root: string;
+      url: string;
+    } & {
+      " arkInferred": string;
+    }>;
+    capitalize: arktype0.Submodule<arktype_internal_keywords_string_ts0.capitalize.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    creditCard: string;
+    date: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringDate.$ & {
+      " arkInferred": string;
+    }>;
+    digits: string;
+    email: string;
+    integer: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringInteger.$ & {
+      " arkInferred": string;
+    }>;
+    ip: arktype0.Submodule<arktype_internal_keywords_string_ts0.ip.$ & {
+      " arkInferred": string;
+    }>;
+    json: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringJson.$ & {
+      " arkInferred": string;
+    }>;
+    lower: arktype0.Submodule<arktype_internal_keywords_string_ts0.lower.$ & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    numeric: arktype0.Submodule<arktype_internal_keywords_string_ts0.stringNumeric.$ & {
+      " arkInferred": string;
+    }>;
+    regex: string;
+    semver: string;
+    upper: arktype0.Submodule<{
+      root: (In: string) => arktype_internal_attributes_ts0.To<string>;
+      preformatted: string;
+    } & {
+      " arkInferred": (In: string) => arktype_internal_attributes_ts0.To<string>;
+    }>;
+    url: arktype0.Submodule<arktype_internal_keywords_string_ts0.url.$ & {
+      " arkInferred": string;
+    }>;
+    uuid: arktype0.Submodule<arktype_internal_keywords_string_ts0.uuid.$ & {
+      " arkInferred": string;
+    }>;
+    " arkInferred": string;
+    host: string;
+  }>;
+  number: arktype0.Submodule<{
+    NaN: number;
+    Infinity: number;
+    root: number;
+    integer: number;
+    " arkInferred": number;
+    epoch: number;
+    safe: number;
+    NegativeInfinity: number;
+    port: number;
+  }>;
+}>;
 /**
  * ArkEnv's main export, an alias for {@link createEnv}
  *
@@ -40,7 +165,7 @@ declare class ArkEnvError extends Error {
  */
 declare const arkenv: typeof createEnv;
 //#endregion
-export { type ArkEnvConfig, ArkEnvError, type EnvSchema, createEnv, arkenv as default };
+export { type ArkEnvConfig, ArkEnvError, type EnvSchema, createEnv, arkenv as default, type };
 
 // CJS Interop Shim
 if (module.exports && module.exports.default) {

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;KAIY,uBAAA;;;AAAZ,CAAA;;ACA0C;;;;;;;;;;;;;;;;;;;;;cDyF7B,WAAA,SAAoB,KAAA;sBAEvB,YAAY;;;;AA3FtB;AAyFA;;;;cClFM,MDkFgC,EAAA,OClF1B,SDkF0B"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/create-env.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;AAyBA;;;;;AAAiD;AAMjD;AAiDA;AAA0C,KAvD9B,SAuD8B,CAAA,KAAA,CAAA,GAvDb,MAAA,CAAG,QAuDU,CAvDD,KAuDC,EAvDI,CAuDJ,CAAA;KAtDrC,kBAAA,GAAqB,IAuDV,CAAA,MAAA,CAAA;;;;AAEW,KApDf,YAAA,GAoDe;EAAZ;;;EACC,GAAA,CAAA,EAjDT,kBAiDkB;EAAW;;;EAGvB,MAAA,CAAA,EAAA,OAAA;EAAV;;AACH;;;;;;;;;;;;EAG0C,eAAA,CAAA,EAAA,QAAA,GAAA,QAAA,GAAA,QAAA;;;;AC9E1C;;;;;;;;;;;;;;;;;;;iBDmEgB,0BAA0B,kBACpC,UAAU,aACN,eACP,OAAA,CAAQ,IAAI,MAAA,CAAG,MAAM,GAAG;iBACX,oBAAoB,wBAC9B,YACI,eACP,UAAU;iBACG,0BAA0B,kBACpC,UAAU,KAAK,4BACX,eACP,OAAA,CAAQ,IAAI,MAAA,CAAG,MAAM,GAAG,MAAM,iBAAiB;;;;;;;;;;AAlElD;;AAA8C,cCZjC,IDYiC,4BCZ7B,UDY6B,CAAA;EAAjB,MAAG,oBAAA,CAAA;IAAQ,IAAA,oBAAA,+CAAA;MACnC,cAAkB,EAAA,CAAA,EAAA,EAAA,MAAG,EAAI,qCAAA,CAAA,MAAA,CAAA;IAKlB,CAAA,CAAA;IAiDI,SAAS,oBAAA,oDAAA;MAAiB,cAAA,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,qCAAA,CAAA,MAAA,CAAA;IAC1B,CAAA,CAAA;IAAV,IAAA,EAAA,MAAA;IACI,KAAA,EAAA,MAAA;IACc,YAAA,EAAA,MAAA;IAAG,GAAA,EAAA,MAAA;IAAT,MAAA,oBAAA,CAAA;MAAP,IAAA,EAAA,MAAA;MAAG,GAAA,EAAA,MAAA;IACE,CAAA,GAAA;MAAoB,cAAA,EAAA,MAAA;IAC9B,CAAA,CAAA;IACI,UAAA,oBAAA,qDAAA;MACG,cAAA,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,qCAAA,CAAA,MAAA,CAAA;IAAV,CAAA,CAAA;IAAS,UAAA,EAAA,MAAA;IACI,IAAA,oBAAS,qDAAA;MAAiB,cAAA,EAAA,MAAA;IAC1B,CAAA,CAAA;IAAV,MAAA,EAAA,MAAA;IAAe,KAAA,EAAA,MAAA;IACX,OAAA,oBAAA,wDAAA;MACc,cAAA,EAAA,MAAA;IAAG,CAAA,CAAA;IAAT,EAAA,oBAAA,6CAAA;MAAP,cAAA,EAAA,MAAA;IAAuC,CAAA,CAAA;IAAjB,IAAA,oBAAA,qDAAA;MAAS,cAAA,EAAA,MAAA;;;;IC9E7B,CAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE+C;;;;;cAOtD,eAAM"}