guarden 1.0.0

package/dist/cjs/utils/errors.js

@@ -0,0 +1,94 @@
+"use strict";
+// ============================================================================
+// Guarden — Custom Error Classes
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnreachableError = exports.EnvConfigError = exports.EnvValidationError = exports.CoercionError = exports.InvariantError = exports.AssertionError = exports.GuardenError = void 0;
+/**
+ * Base error class for all Guarden errors.
+ * Provides clean stack traces and error identification.
+ */
+class GuardenError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'GuardenError';
+        this.code = code;
+        // Fix prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.GuardenError = GuardenError;
+/**
+ * Thrown when a runtime assertion fails.
+ */
+class AssertionError extends GuardenError {
+    constructor(message) {
+        super(message, 'ERR_ASSERTION');
+        this.name = 'AssertionError';
+    }
+}
+exports.AssertionError = AssertionError;
+/**
+ * Thrown when an invariant is violated.
+ * Indicates a bug in the program logic.
+ */
+class InvariantError extends GuardenError {
+    constructor(message) {
+        super(`Invariant violation: ${message}`, 'ERR_INVARIANT');
+        this.name = 'InvariantError';
+    }
+}
+exports.InvariantError = InvariantError;
+/**
+ * Thrown when type coercion fails.
+ */
+class CoercionError extends GuardenError {
+    originalValue;
+    targetType;
+    constructor(value, targetType) {
+        super(`Cannot coerce ${typeof value} (${String(value)}) to ${targetType}`, 'ERR_COERCION');
+        this.name = 'CoercionError';
+        this.originalValue = value;
+        this.targetType = targetType;
+    }
+}
+exports.CoercionError = CoercionError;
+/**
+ * Thrown when environment variable validation fails.
+ */
+class EnvValidationError extends GuardenError {
+    variableName;
+    errors;
+    constructor(variableName, errors) {
+        super(`Environment variable "${variableName}" validation failed:\n  - ${errors.join('\n  - ')}`, 'ERR_ENV_VALIDATION');
+        this.name = 'EnvValidationError';
+        this.variableName = variableName;
+        this.errors = errors;
+    }
+}
+exports.EnvValidationError = EnvValidationError;
+/**
+ * Thrown when multiple environment variables fail validation.
+ */
+class EnvConfigError extends GuardenError {
+    validationErrors;
+    constructor(errors) {
+        const summary = errors.map((e) => `  ${e.variableName}: ${e.errors.join(', ')}`).join('\n');
+        super(`Environment configuration is invalid:\n${summary}`, 'ERR_ENV_CONFIG');
+        this.name = 'EnvConfigError';
+        this.validationErrors = errors;
+    }
+}
+exports.EnvConfigError = EnvConfigError;
+/**
+ * Thrown when code reaches a state that should be unreachable.
+ */
+class UnreachableError extends GuardenError {
+    constructor(value) {
+        super(`Unreachable code reached with value: ${JSON.stringify(value)}`, 'ERR_UNREACHABLE');
+        this.name = 'UnreachableError';
+    }
+}
+exports.UnreachableError = UnreachableError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;;;AAE/E;;;GAGG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrB,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,4CAA4C;QAC5C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAVD,oCAUC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,YAAY;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED;;;GAGG;AACH,MAAa,cAAe,SAAQ,YAAY;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,wBAAwB,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,YAAY;IAC7B,aAAa,CAAU;IACvB,UAAU,CAAS;IAEnC,YAAY,KAAc,EAAE,UAAkB;QAC5C,KAAK,CACH,iBAAiB,OAAO,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,QAAQ,UAAU,EAAE,EACnE,cAAc,CACf,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAbD,sCAaC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,YAAY;IAClC,YAAY,CAAS;IACrB,MAAM,CAAW;IAEjC,YAAY,YAAoB,EAAE,MAAgB;QAChD,KAAK,CACH,yBAAyB,YAAY,6BAA6B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EACzF,oBAAoB,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAbD,gDAaC;AAED;;GAEG;AACH,MAAa,cAAe,SAAQ,YAAY;IAC9B,gBAAgB,CAAuB;IAEvD,YAAY,MAA4B;QACtC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5F,KAAK,CAAC,0CAA0C,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC7E,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC;IACjC,CAAC;CACF;AATD,wCASC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,YAAY;IAChD,YAAY,KAAY;QACtB,KAAK,CACH,wCAAwC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAC/D,iBAAiB,CAClB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AARD,4CAQC"}

package/dist/cjs/utils/types.js

@@ -0,0 +1,6 @@
+"use strict";
+// ============================================================================
+// Guarden — Shared TypeScript Utility Types
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E"}

package/dist/esm/assert/assertions.js

@@ -0,0 +1,75 @@
+// ============================================================================
+// Guarden — Runtime Assertions
+// ============================================================================
+import { AssertionError } from '../utils/errors.js';
+/**
+ * Assert that a condition is true. Throws `AssertionError` if false.
+ * Narrows the condition to `true` in the subsequent code.
+ *
+ * @example
+ * ```ts
+ * assert(user !== null, 'User must exist');
+ * user.name; // OK — TypeScript knows user is not null
+ * ```
+ */
+export function assert(condition, message) {
+    if (!condition) {
+        throw new AssertionError(message ?? 'Assertion failed');
+    }
+}
+/**
+ * Assert that a value is defined (not undefined).
+ * Narrows away `undefined`.
+ *
+ * @example
+ * ```ts
+ * const val: string | undefined = getConfig('key');
+ * assertDefined(val, 'Config key is required');
+ * val.toUpperCase(); // OK
+ * ```
+ */
+export function assertDefined(value, message) {
+    if (value === undefined) {
+        throw new AssertionError(message ?? 'Expected value to be defined, but got undefined');
+    }
+}
+/**
+ * Assert that a value is not null and not undefined.
+ * Narrows away `null | undefined`.
+ *
+ * @example
+ * ```ts
+ * assertNonNull(result);
+ * result.doSomething(); // OK
+ * ```
+ */
+export function assertNonNull(value, message) {
+    if (value === null || value === undefined) {
+        throw new AssertionError(message ?? `Expected non-null value, but got ${value === null ? 'null' : 'undefined'}`);
+    }
+}
+/**
+ * Assert that a value passes a type guard.
+ * Narrows to the guarded type.
+ *
+ * @example
+ * ```ts
+ * assertType(input, isString, 'Expected string input');
+ * input.toUpperCase(); // OK — narrowed to string
+ * ```
+ */
+export function assertType(value, guard, message) {
+    if (!guard(value)) {
+        throw new AssertionError(message ?? `Type assertion failed: value ${JSON.stringify(value)} did not pass guard`);
+    }
+}
+/**
+ * Assert that a value is truthy.
+ * Narrows away falsy values (false, 0, '', null, undefined, NaN).
+ */
+export function assertTruthy(value, message) {
+    if (!value) {
+        throw new AssertionError(message ?? `Expected truthy value, but got ${JSON.stringify(value)}`);
+    }
+}
+//# sourceMappingURL=assertions.js.map

package/dist/esm/assert/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../../../src/assert/assertions.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,OAAgB;IACzD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CAAC,OAAO,IAAI,kBAAkB,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAQ,EACR,OAAgB;IAEhB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,cAAc,CAAC,OAAO,IAAI,iDAAiD,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAQ,EACR,OAAgB;IAEhB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,oCAAoC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CACvF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACxB,KAAc,EACd,KAAe,EACf,OAAgB;IAEhB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,gCAAgC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,qBAAqB,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAQ,EACR,OAAgB;IAEhB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,cAAc,CACtB,OAAO,IAAI,kCAAkC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/esm/assert/index.js

@@ -0,0 +1,3 @@
+export { assert, assertDefined, assertNonNull, assertType, assertTruthy, } from './assertions.js';
+export { invariant, unreachable } from './invariant.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/assert/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/assert/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/assert/invariant.js

@@ -0,0 +1,39 @@
+// ============================================================================
+// Guarden — Invariants & Unreachable
+// ============================================================================
+import { InvariantError, UnreachableError } from '../utils/errors.js';
+/**
+ * Assert an invariant condition. Throws `InvariantError` if violated.
+ * Use this for conditions that indicate a bug in your code if broken.
+ *
+ * @example
+ * ```ts
+ * invariant(items.length > 0, 'items should never be empty at this point');
+ * ```
+ */
+export function invariant(condition, message) {
+    if (!condition) {
+        throw new InvariantError(message);
+    }
+}
+/**
+ * Mark code as unreachable. Useful for exhaustive switch/if checks.
+ * Throws `UnreachableError` at runtime if reached.
+ *
+ * @example
+ * ```ts
+ * type Direction = 'up' | 'down';
+ *
+ * function move(dir: Direction) {
+ *   switch (dir) {
+ *     case 'up':    return goUp();
+ *     case 'down':  return goDown();
+ *     default:      unreachable(dir); // TypeScript error if case missing
+ *   }
+ * }
+ * ```
+ */
+export function unreachable(value) {
+    throw new UnreachableError(value);
+}
+//# sourceMappingURL=invariant.js.map

package/dist/esm/assert/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../../../src/assert/invariant.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,SAAkB,EAAE,OAAe;IAC3D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/esm/env/index.js

@@ -0,0 +1,2 @@
+export { createEnv, envString, envNumber, envBoolean, envEnum, EnvField, } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,GACT,MAAM,aAAa,CAAC"}

package/dist/esm/env/schema.js

@@ -0,0 +1,304 @@
+// ============================================================================
+// Guarden — Environment Variable Validation
+// ============================================================================
+import { EnvValidationError, EnvConfigError } from '../utils/errors.js';
+// -- Field Builder -----------------------------------------------------------
+/**
+ * A builder for defining environment variable validation rules.
+ */
+export class EnvField {
+    /** @internal */
+    _config;
+    constructor(config) {
+        this._config = config;
+    }
+    /** Mark the field as required (default). */
+    required() {
+        return new EnvField({ ...this._config, required: true });
+    }
+    /** Mark the field as optional with a default value. */
+    default(value) {
+        return new EnvField({ ...this._config, required: false, defaultValue: value });
+    }
+    /** Add a custom validation rule. */
+    validate(fn) {
+        return new EnvField({
+            ...this._config,
+            validators: [...this._config.validators, fn],
+        });
+    }
+}
+// -- Field Constructors ------------------------------------------------------
+/**
+ * Define a string environment variable.
+ *
+ * @example
+ * ```ts
+ * const env = createEnv({
+ *   DATABASE_URL: envString().url().required(),
+ * });
+ * ```
+ */
+export function envString() {
+    return new StringEnvField({
+        type: 'string',
+        required: true,
+        validators: [],
+        transformer: (raw) => raw,
+    });
+}
+class StringEnvField extends EnvField {
+    /** Validate that the string is a valid URL. */
+    url() {
+        return new StringEnvField({
+            ...this._config,
+            validators: [
+                ...this._config.validators,
+                (value) => {
+                    try {
+                        new URL(value);
+                        return null;
+                    }
+                    catch {
+                        return `must be a valid URL`;
+                    }
+                },
+            ],
+        });
+    }
+    /** Validate minimum length. */
+    minLength(min) {
+        return new StringEnvField({
+            ...this._config,
+            validators: [
+                ...this._config.validators,
+                (value) => value.length >= min ? null : `must be at least ${min} characters`,
+            ],
+        });
+    }
+    /** Validate that the string matches a pattern. */
+    matches(pattern) {
+        return new StringEnvField({
+            ...this._config,
+            validators: [
+                ...this._config.validators,
+                (value) => pattern.test(value) ? null : `must match pattern ${pattern.toString()}`,
+            ],
+        });
+    }
+    /** Set a default value. */
+    default(value) {
+        return new StringEnvField({
+            ...this._config,
+            required: false,
+            defaultValue: value,
+        });
+    }
+    /** Mark as required. */
+    required() {
+        return new StringEnvField({ ...this._config, required: true });
+    }
+}
+/**
+ * Define a numeric environment variable.
+ * Automatically coerces the string value to a number.
+ *
+ * @example
+ * ```ts
+ * const env = createEnv({
+ *   PORT: envNumber().port().default(3000),
+ * });
+ * ```
+ */
+export function envNumber() {
+    return new NumberEnvField({
+        type: 'number',
+        required: true,
+        validators: [],
+        transformer: (raw) => {
+            const n = Number(raw);
+            if (Number.isNaN(n))
+                throw new Error(`Cannot parse "${raw}" as number`);
+            return n;
+        },
+    });
+}
+class NumberEnvField extends EnvField {
+    /** Validate that the number is a valid port (1-65535). */
+    port() {
+        return new NumberEnvField({
+            ...this._config,
+            validators: [
+                ...this._config.validators,
+                (value) => Number.isInteger(value) && value >= 1 && value <= 65535
+                    ? null
+                    : `must be a valid port (1-65535)`,
+            ],
+        });
+    }
+    /** Validate minimum value. */
+    min(min) {
+        return new NumberEnvField({
+            ...this._config,
+            validators: [
+                ...this._config.validators,
+                (value) => (value >= min ? null : `must be at least ${min}`),
+            ],
+        });
+    }
+    /** Validate maximum value. */
+    max(max) {
+        return new NumberEnvField({
+            ...this._config,
+            validators: [
+                ...this._config.validators,
+                (value) => (value <= max ? null : `must be at most ${max}`),
+            ],
+        });
+    }
+    /** Set a default value. */
+    default(value) {
+        return new NumberEnvField({
+            ...this._config,
+            required: false,
+            defaultValue: value,
+        });
+    }
+    /** Mark as required. */
+    required() {
+        return new NumberEnvField({ ...this._config, required: true });
+    }
+}
+/**
+ * Define a boolean environment variable.
+ * Recognizes: "true", "1", "yes", "on" as true.
+ *
+ * @example
+ * ```ts
+ * const env = createEnv({
+ *   DEBUG: envBoolean().default(false),
+ * });
+ * ```
+ */
+export function envBoolean() {
+    return new BooleanEnvField({
+        type: 'boolean',
+        required: true,
+        validators: [],
+        transformer: (raw) => {
+            const lower = raw.trim().toLowerCase();
+            return ['true', '1', 'yes', 'on'].includes(lower);
+        },
+    });
+}
+class BooleanEnvField extends EnvField {
+    /** Set a default value. */
+    default(value) {
+        return new BooleanEnvField({
+            ...this._config,
+            required: false,
+            defaultValue: value,
+        });
+    }
+    /** Mark as required. */
+    required() {
+        return new BooleanEnvField({ ...this._config, required: true });
+    }
+}
+/**
+ * Define an enum environment variable.
+ * Value must be one of the specified options.
+ *
+ * @example
+ * ```ts
+ * const env = createEnv({
+ *   NODE_ENV: envEnum(['development', 'production', 'test'] as const),
+ * });
+ * // env.NODE_ENV is 'development' | 'production' | 'test'
+ * ```
+ */
+export function envEnum(values) {
+    return new EnvField({
+        type: 'enum',
+        required: true,
+        validators: [
+            (value) => values.includes(value)
+                ? null
+                : `must be one of: ${values.join(', ')}`,
+        ],
+        transformer: (raw) => raw,
+        enumValues: values,
+    });
+}
+// -- createEnv ---------------------------------------------------------------
+/**
+ * Validate and type-safe environment variables.
+ * Throws `EnvConfigError` at startup if validation fails.
+ *
+ * @example
+ * ```ts
+ * import { createEnv, envString, envNumber, envBoolean, envEnum } from 'guarden/env';
+ *
+ * export const env = createEnv({
+ *   DATABASE_URL: envString().url().required(),
+ *   PORT: envNumber().port().default(3000),
+ *   DEBUG: envBoolean().default(false),
+ *   NODE_ENV: envEnum(['development', 'production', 'test']),
+ * });
+ *
+ * // Fully typed!
+ * env.DATABASE_URL // string
+ * env.PORT         // number
+ * env.DEBUG        // boolean
+ * env.NODE_ENV     // 'development' | 'production' | 'test'
+ * ```
+ */
+export function createEnv(schema, source) {
+    const envSource = source ?? (typeof process !== 'undefined' ? process.env : {});
+    const result = {};
+    const errors = [];
+    for (const [key, field] of Object.entries(schema)) {
+        const raw = envSource[key];
+        const config = field._config;
+        // Check if required
+        if (raw === undefined || raw === '') {
+            if (config.required) {
+                errors.push(new EnvValidationError(key, ['is required but not set']));
+                continue;
+            }
+            if (config.defaultValue !== undefined) {
+                result[key] = config.defaultValue;
+                continue;
+            }
+        }
+        // Transform
+        let value;
+        try {
+            value = config.transformer(raw ?? '');
+        }
+        catch (e) {
+            errors.push(new EnvValidationError(key, [
+                `transformation failed: ${e instanceof Error ? e.message : String(e)}`,
+            ]));
+            continue;
+        }
+        // Validate
+        const fieldErrors = [];
+        for (const validator of config.validators) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const error = validator(value);
+            if (error)
+                fieldErrors.push(error);
+        }
+        if (fieldErrors.length > 0) {
+            errors.push(new EnvValidationError(key, fieldErrors));
+            continue;
+        }
+        result[key] = value;
+    }
+    if (errors.length > 0) {
+        throw new EnvConfigError(errors);
+    }
+    return result;
+}
+//# sourceMappingURL=schema.js.map

package/dist/esm/env/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/env/schema.ts"],"names":[],"mappings":"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"}