guarden 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transform/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EACL,IAAI,EACJ,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,MAAM,EACN,OAAO,EACP,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/esm/transform/pipe.js

@@ -0,0 +1,14 @@
+// ============================================================================
+// Guarden — Type-Safe Pipe
+// ============================================================================
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function pipe(value, ...fns) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    return fns.reduce((acc, fn) => fn(acc), value);
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function flow(...fns) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+    return (value) => fns.reduce((acc, fn) => fn(acc), value);
+}
+//# sourceMappingURL=pipe.js.map

package/dist/esm/transform/pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../../../src/transform/pipe.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAmF/E,8DAA8D;AAC9D,MAAM,UAAU,IAAI,CAAC,KAAU,EAAE,GAAG,GAA0B;IAC5D,+DAA+D;IAC/D,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAmCD,8DAA8D;AAC9D,MAAM,UAAU,IAAI,CAAC,GAAG,GAA0B;IAChD,+DAA+D;IAC/D,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/esm/transform/sanitize.js

@@ -0,0 +1,195 @@
+// ============================================================================
+// Guarden — String Sanitization Utilities
+// ============================================================================
+/**
+ * Trim whitespace from both ends.
+ */
+export function trim(value) {
+    return value.trim();
+}
+/**
+ * Trim whitespace from the start.
+ */
+export function trimStart(value) {
+    return value.trimStart();
+}
+/**
+ * Trim whitespace from the end.
+ */
+export function trimEnd(value) {
+    return value.trimEnd();
+}
+/**
+ * Convert to lowercase.
+ */
+export function lowercase(value) {
+    return value.toLowerCase();
+}
+/**
+ * Convert to uppercase.
+ */
+export function uppercase(value) {
+    return value.toUpperCase();
+}
+/**
+ * Capitalize the first letter.
+ */
+export function capitalize(value) {
+    if (value.length === 0)
+        return value;
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}
+/**
+ * Capitalize the first letter of each word.
+ */
+export function titleCase(value) {
+    return value.replace(/\b\w/g, (char) => char.toUpperCase());
+}
+/**
+ * Convert to camelCase.
+ */
+export function camelCase(value) {
+    return value
+        .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''))
+        .replace(/^[A-Z]/, (c) => c.toLowerCase());
+}
+/**
+ * Convert to kebab-case.
+ */
+export function kebabCase(value) {
+    return value
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+/**
+ * Convert to snake_case.
+ */
+export function snakeCase(value) {
+    return value
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .replace(/[\s-]+/g, '_')
+        .toLowerCase();
+}
+/**
+ * Strip HTML tags from a string.
+ *
+ * @example
+ * ```ts
+ * stripHtml("<p>Hello <b>world</b></p>") // "Hello world"
+ * ```
+ */
+export function stripHtml(value) {
+    return value.replace(/<[^>]*>/g, '');
+}
+/**
+ * Escape HTML special characters to prevent XSS.
+ *
+ * @example
+ * ```ts
+ * escapeHtml('<script>alert("xss")</script>')
+ * // '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;'
+ * ```
+ */
+export function escapeHtml(value) {
+    const escapeMap = {
+        '&': '&amp;',
+        '<': '&lt;',
+        '>': '&gt;',
+        '"': '&quot;',
+        "'": '&#x27;',
+        '`': '&#x60;',
+    };
+    return value.replace(/[&<>"'`]/g, (char) => escapeMap[char] ?? char);
+}
+/**
+ * Unescape HTML entities.
+ */
+export function unescapeHtml(value) {
+    const unescapeMap = {
+        '&amp;': '&',
+        '&lt;': '<',
+        '&gt;': '>',
+        '&quot;': '"',
+        '&#x27;': "'",
+        '&#x60;': '`',
+    };
+    return value.replace(/&(?:amp|lt|gt|quot|#x27|#x60);/g, (entity) => unescapeMap[entity] ?? entity);
+}
+/**
+ * Truncate a string to a maximum length.
+ *
+ * @example
+ * ```ts
+ * truncate("Hello, World!", 8)        // "Hello..."
+ * truncate("Hello, World!", 8, "…")   // "Hello, …"
+ * ```
+ */
+export function truncate(value, maxLength, suffix = '...') {
+    if (value.length <= maxLength)
+        return value;
+    return value.slice(0, maxLength - suffix.length) + suffix;
+}
+/**
+ * Convert a string to a URL-friendly slug.
+ *
+ * @example
+ * ```ts
+ * slugify("Hello, World! 🌍")  // "hello-world"
+ * slugify("  Foo   BAR  baz ") // "foo-bar-baz"
+ * ```
+ */
+export function slugify(value) {
+    return value
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '') // Remove diacritics
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, '') // Remove non-alphanumeric
+        .replace(/[\s-]+/g, '-') // Replace spaces with hyphens
+        .replace(/^-+|-+$/g, ''); // Trim leading/trailing hyphens
+}
+/**
+ * Remove all whitespace from a string.
+ */
+export function removeWhitespace(value) {
+    return value.replace(/\s/g, '');
+}
+/**
+ * Collapse multiple spaces into a single space.
+ */
+export function collapseWhitespace(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Pad a string to a minimum length (left-pads by default).
+ */
+export function padStart(value, length, fillChar = ' ') {
+    return value.padStart(length, fillChar);
+}
+/**
+ * Pad a string to a minimum length (right-pads).
+ */
+export function padEnd(value, length, fillChar = ' ') {
+    return value.padEnd(length, fillChar);
+}
+/**
+ * Reverse a string (Unicode-aware).
+ */
+export function reverse(value) {
+    return [...value].reverse().join('');
+}
+/**
+ * Count occurrences of a substring.
+ */
+export function countOccurrences(value, search) {
+    if (search.length === 0)
+        return 0;
+    let count = 0;
+    let pos = 0;
+    while ((pos = value.indexOf(search, pos)) !== -1) {
+        count++;
+        pos += search.length;
+    }
+    return count;
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/esm/transform/sanitize.js.map

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

package/dist/esm/utils/errors.js

@@ -0,0 +1,84 @@
+// ============================================================================
+// Guarden — Custom Error Classes
+// ============================================================================
+/**
+ * Base error class for all Guarden errors.
+ * Provides clean stack traces and error identification.
+ */
+export 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);
+    }
+}
+/**
+ * Thrown when a runtime assertion fails.
+ */
+export class AssertionError extends GuardenError {
+    constructor(message) {
+        super(message, 'ERR_ASSERTION');
+        this.name = 'AssertionError';
+    }
+}
+/**
+ * Thrown when an invariant is violated.
+ * Indicates a bug in the program logic.
+ */
+export class InvariantError extends GuardenError {
+    constructor(message) {
+        super(`Invariant violation: ${message}`, 'ERR_INVARIANT');
+        this.name = 'InvariantError';
+    }
+}
+/**
+ * Thrown when type coercion fails.
+ */
+export 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;
+    }
+}
+/**
+ * Thrown when environment variable validation fails.
+ */
+export 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;
+    }
+}
+/**
+ * Thrown when multiple environment variables fail validation.
+ */
+export 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;
+    }
+}
+/**
+ * Thrown when code reaches a state that should be unreachable.
+ */
+export class UnreachableError extends GuardenError {
+    constructor(value) {
+        super(`Unreachable code reached with value: ${JSON.stringify(value)}`, 'ERR_UNREACHABLE');
+        this.name = 'UnreachableError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/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,MAAM,OAAO,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;AAED;;GAEG;AACH,MAAM,OAAO,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;AAED;;;GAGG;AACH,MAAM,OAAO,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;AAED;;GAEG;AACH,MAAM,OAAO,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;AAED;;GAEG;AACH,MAAM,OAAO,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;AAED;;GAEG;AACH,MAAM,OAAO,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;AAED;;GAEG;AACH,MAAM,OAAO,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"}

package/dist/esm/utils/types.js

@@ -0,0 +1,5 @@
+// ============================================================================
+// Guarden — Shared TypeScript Utility Types
+// ============================================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/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/types/assert/assertions.d.ts

@@ -0,0 +1,52 @@
+import type { Guard } from '../utils/types.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 declare function assert(condition: unknown, message?: string): asserts condition;
+/**
+ * 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 declare function assertDefined<T>(value: T, message?: string): asserts value is Exclude<T, undefined>;
+/**
+ * Assert that a value is not null and not undefined.
+ * Narrows away `null | undefined`.
+ *
+ * @example
+ * ```ts
+ * assertNonNull(result);
+ * result.doSomething(); // OK
+ * ```
+ */
+export declare function assertNonNull<T>(value: T, message?: string): asserts value is NonNullable<T>;
+/**
+ * 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 declare function assertType<T>(value: unknown, guard: Guard<T>, message?: string): asserts value is T;
+/**
+ * Assert that a value is truthy.
+ * Narrows away falsy values (false, 0, '', null, undefined, NaN).
+ */
+export declare function assertTruthy<T>(value: T, message?: string): asserts value is NonNullable<T>;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/types/assert/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../../src/assert/assertions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAI9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAIxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAMjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,CAAC,CAMpB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAMjC"}

package/dist/types/assert/index.d.ts

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

package/dist/types/assert/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/types/assert/invariant.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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 declare function invariant(condition: unknown, message: string): asserts condition;
+/**
+ * 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 declare function unreachable(value: never): never;
+//# sourceMappingURL=invariant.d.ts.map

package/dist/types/assert/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../../src/assert/invariant.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAIhF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C"}

package/dist/types/env/index.d.ts

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

package/dist/types/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/types/env/schema.d.ts

@@ -0,0 +1,131 @@
+type EnvValue = string | number | boolean;
+interface EnvFieldConfig<T extends EnvValue> {
+    type: 'string' | 'number' | 'boolean' | 'enum';
+    required: boolean;
+    defaultValue?: T;
+    validators: Array<(value: T) => string | null>;
+    transformer: (raw: string) => T;
+    enumValues?: readonly string[];
+}
+type InferEnvType<T> = T extends EnvField<infer U> ? U : never;
+type EnvSchema = Record<string, EnvField<EnvValue>>;
+type InferEnv<T extends EnvSchema> = {
+    [K in keyof T]: InferEnvType<T[K]>;
+};
+/**
+ * A builder for defining environment variable validation rules.
+ */
+export declare class EnvField<T extends EnvValue> {
+    /** @internal */
+    _config: EnvFieldConfig<T>;
+    constructor(config: EnvFieldConfig<T>);
+    /** Mark the field as required (default). */
+    required(): EnvField<T>;
+    /** Mark the field as optional with a default value. */
+    default(value: T): EnvField<T>;
+    /** Add a custom validation rule. */
+    validate(fn: (value: T) => string | null): EnvField<T>;
+}
+/**
+ * Define a string environment variable.
+ *
+ * @example
+ * ```ts
+ * const env = createEnv({
+ *   DATABASE_URL: envString().url().required(),
+ * });
+ * ```
+ */
+export declare function envString(): StringEnvField;
+declare class StringEnvField extends EnvField<string> {
+    /** Validate that the string is a valid URL. */
+    url(): StringEnvField;
+    /** Validate minimum length. */
+    minLength(min: number): StringEnvField;
+    /** Validate that the string matches a pattern. */
+    matches(pattern: RegExp): StringEnvField;
+    /** Set a default value. */
+    default(value: string): StringEnvField;
+    /** Mark as required. */
+    required(): StringEnvField;
+}
+/**
+ * Define a numeric environment variable.
+ * Automatically coerces the string value to a number.
+ *
+ * @example
+ * ```ts
+ * const env = createEnv({
+ *   PORT: envNumber().port().default(3000),
+ * });
+ * ```
+ */
+export declare function envNumber(): NumberEnvField;
+declare class NumberEnvField extends EnvField<number> {
+    /** Validate that the number is a valid port (1-65535). */
+    port(): NumberEnvField;
+    /** Validate minimum value. */
+    min(min: number): NumberEnvField;
+    /** Validate maximum value. */
+    max(max: number): NumberEnvField;
+    /** Set a default value. */
+    default(value: number): NumberEnvField;
+    /** Mark as required. */
+    required(): NumberEnvField;
+}
+/**
+ * Define a boolean environment variable.
+ * Recognizes: "true", "1", "yes", "on" as true.
+ *
+ * @example
+ * ```ts
+ * const env = createEnv({
+ *   DEBUG: envBoolean().default(false),
+ * });
+ * ```
+ */
+export declare function envBoolean(): BooleanEnvField;
+declare class BooleanEnvField extends EnvField<boolean> {
+    /** Set a default value. */
+    default(value: boolean): BooleanEnvField;
+    /** Mark as required. */
+    required(): BooleanEnvField;
+}
+/**
+ * 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 declare function envEnum<T extends readonly string[]>(values: T): EnvField<T[number]>;
+/**
+ * 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 declare function createEnv<T extends EnvSchema>(schema: T, source?: Record<string, string | undefined>): InferEnv<T>;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/types/env/schema.d.ts.map

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

package/dist/types/guards/advanced.d.ts

@@ -0,0 +1,101 @@
+import type { Guard } from '../utils/types.js';
+/**
+ * Check if a value is a non-empty string.
+ */
+export declare function isNonEmptyString(value: unknown): value is string;
+/**
+ * Check if a value is a string matching an email pattern.
+ */
+export declare function isEmail(value: unknown): value is string;
+/**
+ * Check if a value is a valid URL string.
+ */
+export declare function isURL(value: unknown): value is string;
+/**
+ * Check if a value is a valid UUID (v1-v5).
+ */
+export declare function isUUID(value: unknown): value is string;
+/**
+ * Check if a value is a valid ISO 8601 date string.
+ */
+export declare function isISO8601(value: unknown): value is string;
+/**
+ * Check if a value is a valid JSON string.
+ */
+export declare function isJSONString(value: unknown): value is string;
+/**
+ * Check if a value is a string matching a hex color (#fff or #ffffff).
+ */
+export declare function isHexColor(value: unknown): value is string;
+/**
+ * Check if a value is a positive number (> 0).
+ */
+export declare function isPositiveNumber(value: unknown): value is number;
+/**
+ * Check if a value is a negative number (< 0).
+ */
+export declare function isNegativeNumber(value: unknown): value is number;
+/**
+ * Check if a value is an integer.
+ */
+export declare function isInteger(value: unknown): value is number;
+/**
+ * Check if a value is a safe integer (within Number.MAX_SAFE_INTEGER bounds).
+ */
+export declare function isSafeInteger(value: unknown): value is number;
+/**
+ * Check if a value is a non-empty array.
+ */
+export declare function isNonEmptyArray<T = unknown>(value: unknown): value is [T, ...T[]];
+/**
+ * Create a guard that checks if a number is within a range [min, max].
+ *
+ * @example
+ * ```ts
+ * const isPercent = isInRange(0, 100);
+ * isPercent(50)   // true
+ * isPercent(150)  // false
+ * ```
+ */
+export declare function isInRange(min: number, max: number): Guard<number>;
+/**
+ * Create a guard that checks if a value is one of the specified values.
+ *
+ * @example
+ * ```ts
+ * const isDirection = isOneOf(['up', 'down', 'left', 'right'] as const);
+ * if (isDirection(input)) {
+ *   // input is 'up' | 'down' | 'left' | 'right'
+ * }
+ * ```
+ */
+export declare function isOneOf<T extends readonly unknown[]>(values: T): Guard<T[number]>;
+/**
+ * Create a guard that checks if a string matches a pattern.
+ *
+ * @example
+ * ```ts
+ * const isSlug = isMatch(/^[a-z0-9-]+$/);
+ * isSlug("hello-world") // true
+ * isSlug("Hello World") // false
+ * ```
+ */
+export declare function isMatch(pattern: RegExp): Guard<string>;
+/**
+ * Create a guard that checks if a string has a minimum length.
+ */
+export declare function isMinLength(min: number): Guard<string>;
+/**
+ * Create a guard that checks if a string has a maximum length.
+ */
+export declare function isMaxLength(max: number): Guard<string>;
+/**
+ * Check if a value is an instance of a given class.
+ *
+ * @example
+ * ```ts
+ * const isMyError = isInstanceOf(TypeError);
+ * ```
+ */
+export declare function isInstanceOf<T>(constructor: new (...args: unknown[]) => T): Guard<T>;
+//# sourceMappingURL=advanced.d.ts.map