@zeruxjs/validator 0.0.0-stage → 0.0.1

package/dist/integrations/http.d.ts

@@ -0,0 +1,27 @@
+import type { BaseIssue, BaseSchema, BaseSchemaAsync, InferOutput } from '../types/index.js';
+type AnySchema = BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>;
+export interface HttpValidationOptions {
+    maxBytes?: number;
+    maxQueryFields?: number;
+    maxQueryLength?: number;
+}
+export declare class HttpValidationError extends Error {
+    readonly status: 400 | 413 | 415 | 422;
+    readonly issues?: readonly {
+        path: string;
+        message: string;
+    }[] | undefined;
+    constructor(status: 400 | 413 | 415 | 422, message: string, issues?: readonly {
+        path: string;
+        message: string;
+    }[] | undefined);
+    toResponse(): Response;
+}
+/** Reads request bodies incrementally and enforces a hard byte limit before JSON parsing. */
+export declare function readJsonBody(request: Request, options?: HttpValidationOptions): Promise<unknown>;
+/** Validate JSON using sync or async schemas with a uniform typed result. */
+export declare function parseJsonRequest<TSchema extends AnySchema>(schema: TSchema, request: Request, options?: HttpValidationOptions): Promise<InferOutput<TSchema>>;
+export declare function parseQuery<TSchema extends AnySchema>(schema: TSchema, input: string | URL | Request, options?: HttpValidationOptions): Promise<InferOutput<TSchema>>;
+/** Framework-neutral validation middleware for Fetch-compatible handlers. */
+export declare function validatedJsonHandler<TSchema extends AnySchema>(schema: TSchema, handler: (body: InferOutput<TSchema>, request: Request) => Response | Promise<Response> | unknown, options?: HttpValidationOptions): (request: Request) => Promise<Response>;
+export {};

package/dist/integrations/http.js

@@ -0,0 +1,124 @@
+import { safeParseAsync } from '../methods/safeParseAsync.js';
+export class HttpValidationError extends Error {
+    status;
+    issues;
+    constructor(status, message, issues) {
+        super(message);
+        this.status = status;
+        this.issues = issues;
+        this.name = 'HttpValidationError';
+    }
+    toResponse() {
+        return Response.json({ error: this.message, issues: this.issues ?? [] }, {
+            status: this.status, headers: { 'Cache-Control': 'no-store' }
+        });
+    }
+}
+const checkLimit = (value, fallback) => {
+    const limit = value ?? fallback;
+    if (!Number.isSafeInteger(limit) || limit <= 0)
+        throw new Error('Invalid input size limit');
+    return limit;
+};
+/** Reads request bodies incrementally and enforces a hard byte limit before JSON parsing. */
+export async function readJsonBody(request, options = {}) {
+    const max = checkLimit(options.maxBytes, 1024 * 1024);
+    const contentType = request.headers.get('content-type')?.split(';')[0]?.trim().toLowerCase();
+    if (contentType !== 'application/json' && !(contentType?.startsWith('application/') && contentType.endsWith('+json')))
+        throw new HttpValidationError(415, 'Expected a JSON request');
+    const declared = request.headers.get('content-length');
+    if (declared !== null && (!/^\d+$/.test(declared) || Number(declared) > max))
+        throw new HttpValidationError(413, 'Request body too large');
+    const reader = request.body?.getReader();
+    if (!reader)
+        throw new HttpValidationError(400, 'Missing JSON request body');
+    const chunks = [];
+    let bytes = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            bytes += value.byteLength;
+            if (bytes > max)
+                throw new HttpValidationError(413, 'Request body too large');
+            chunks.push(value);
+        }
+    }
+    catch (error) {
+        try {
+            await reader.cancel();
+        }
+        catch { /* connection may already be closed */ }
+        throw error;
+    }
+    finally {
+        reader.releaseLock();
+    }
+    if (!bytes)
+        throw new HttpValidationError(400, 'Empty JSON request body');
+    const body = new Uint8Array(bytes);
+    let offset = 0;
+    for (const chunk of chunks) {
+        body.set(chunk, offset);
+        offset += chunk.length;
+    }
+    try {
+        return JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(body));
+    }
+    catch {
+        throw new HttpValidationError(400, 'Malformed JSON request body');
+    }
+}
+function formatIssues(issues) {
+    return issues.slice(0, 20).map(issue => ({
+        message: String(issue.message).slice(0, 300),
+        path: (issue.path ?? []).map((part) => String(part.key ?? '')).join('.').slice(0, 300)
+    }));
+}
+/** Validate JSON using sync or async schemas with a uniform typed result. */
+export async function parseJsonRequest(schema, request, options = {}) {
+    const json = await readJsonBody(request, options);
+    const checked = await safeParseAsync(schema, json);
+    if (!checked.success)
+        throw new HttpValidationError(422, 'Request validation failed', formatIssues(checked.issues ?? []));
+    return checked.output;
+}
+export async function parseQuery(schema, input, options = {}) {
+    const urlText = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+    if (urlText.length > checkLimit(options.maxQueryLength, 16384))
+        throw new HttpValidationError(413, 'Query URL too long');
+    const url = new URL(urlText);
+    const max = checkLimit(options.maxQueryFields, 200);
+    const query = Object.create(null);
+    let fields = 0;
+    for (const [key, value] of url.searchParams) {
+        if (++fields > max)
+            throw new HttpValidationError(413, 'Too many query parameters');
+        if (['__proto__', 'constructor', 'prototype'].includes(key))
+            throw new HttpValidationError(400, 'Unsafe query parameter');
+        const prior = query[key];
+        query[key] = prior === undefined ? value : Array.isArray(prior) ? [...prior, value] : [prior, value];
+    }
+    const checked = await safeParseAsync(schema, query);
+    if (!checked.success)
+        throw new HttpValidationError(422, 'Query validation failed', formatIssues(checked.issues ?? []));
+    return checked.output;
+}
+/** Framework-neutral validation middleware for Fetch-compatible handlers. */
+export function validatedJsonHandler(schema, handler, options = {}) {
+    return async (request) => {
+        let body;
+        try {
+            body = await parseJsonRequest(schema, request, options);
+        }
+        catch (error) {
+            if (error instanceof HttpValidationError)
+                return error.toResponse();
+            throw error;
+        }
+        const result = await handler(body, request);
+        return result instanceof Response ? result : result === undefined ? new Response(null, { status: 204 }) : Response.json(result);
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/integrations/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/integrations/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAM9D,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACvB;IAAyD;IAA9E,YAAqB,MAA6B,EAAE,OAAe,EAAW,MAAqD;QACjI,KAAK,CAAC,OAAO,CAAC,CAAC;QADI,WAAM,GAAN,MAAM,CAAuB;QAA4B,WAAM,GAAN,MAAM,CAA+C;QAEjI,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;IACD,UAAU;QACR,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE;YACvE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE;SAC9D,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,UAAU,GAAG,CAAC,KAAyB,EAAE,QAAgB,EAAE,EAAE;IACjE,MAAM,KAAK,GAAG,KAAK,IAAI,QAAQ,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC5F,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAgB,EAAE,UAAiC,EAAE;IACtF,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7F,IAAI,WAAW,KAAK,kBAAkB,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,cAAc,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC;IACrL,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACvD,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;IAC3I,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;YAC1B,IAAI,KAAK,GAAG,GAAG;gBAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;YAC9E,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YAAC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,sCAAsC,CAAC,CAAC;QAC/E,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IAAC,CAAC;IAChF,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAAC,CAAC;IAClF,MAAM,CAAC;QAAC,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,6BAA6B,CAAC,CAAC;IAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,MAAqC;IACzD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QAC5C,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;KAC5F,CAAC,CAAC,CAAC;AACN,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAA4B,MAAe,EAAE,OAAgB,EAAE,UAAiC,EAAE;IACtI,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,2BAA2B,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1H,OAAO,OAAO,CAAC,MAA8B,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAA4B,MAAe,EAAE,KAA6B,EAAE,UAAiC,EAAE;IAC7I,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;IACxG,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,KAAK,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IACzH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,KAAK,GAAsC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QAC5C,IAAI,EAAE,MAAM,GAAG,GAAG;YAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;QACpF,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;QAC1H,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,yBAAyB,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;IACxH,OAAO,OAAO,CAAC,MAA8B,CAAC;AAChD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAA4B,MAAe,EAAE,OAAiG,EAAE,UAAiC,EAAE;IACrN,OAAO,KAAK,EAAE,OAAgB,EAAqB,EAAE;QACnD,IAAI,IAA0B,CAAC;QAC/B,IAAI,CAAC;YAAC,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAAC,CAAC;QAChE,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,KAAK,YAAY,mBAAmB;gBAAE,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;QACnG,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,MAAM,YAAY,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClI,CAAC,CAAC;AACJ,CAAC"}

package/dist/methods/_LruCache.d.ts

@@ -0,0 +1,44 @@
+import type { BaseIssue, Config } from '../types/index.js';
+import type { Cache, CacheConfig } from './types/cache.js';
+/**
+ * Efficient LRU cache using Map iteration order.
+ */
+declare class _LruCache<TValue> implements Cache<TValue> {
+    #private;
+    private store;
+    private refIds;
+    private refCount;
+    private readonly maxSize;
+    private readonly maxAge;
+    private readonly hasMaxAge;
+    constructor(config?: CacheConfig);
+    /**
+     * Creates a cache key from input and config.
+     *
+     * @param input The input value.
+     * @param config The parse configuration.
+     *
+     * @returns The cache key.
+     */
+    key(input: unknown, config?: Config<BaseIssue<unknown>>): string;
+    /**
+     * Gets a value from the cache by key.
+     *
+     * @param key The cache key.
+     *
+     * @returns The cached value.
+     */
+    get(key: string): TValue | undefined;
+    /**
+     * Sets a value in the cache by key.
+     *
+     * @param key The cache key.
+     * @param value The cached value.
+     */
+    set(key: string, value: TValue): void;
+    /**
+     * Clears all entries from the cache.
+     */
+    clear(): void;
+}
+export { _LruCache };

package/dist/methods/_LruCache.js

@@ -0,0 +1,115 @@
+/**
+ * Efficient LRU cache using Map iteration order.
+ */
+class _LruCache {
+    // Stores [value, timestamp] tuples to avoid object allocation overhead
+    store;
+    // Assign stable IDs to references
+    refIds;
+    // Counter for tracking references
+    refCount = 0;
+    // Cache configuration
+    maxSize;
+    maxAge;
+    hasMaxAge;
+    constructor(config) {
+        this.maxSize = config?.maxSize ?? 1000;
+        this.maxAge = config?.maxAge ?? Infinity;
+        this.hasMaxAge = isFinite(this.maxAge);
+    }
+    /**
+     * Stringifies an unknown input to a cache key component.
+     *
+     * @param input The unknown input.
+     *
+     * @returns A cache key component.
+     */
+    #stringify(input) {
+        const type = typeof input;
+        if (type === 'string') {
+            return `"${input}"`;
+        }
+        if (type === 'number' || type === 'boolean') {
+            return `${input}`;
+        }
+        if (type === 'bigint') {
+            return `${input}n`;
+        }
+        if (type === 'object' || type === 'function') {
+            if (input) {
+                this.refIds ??= new WeakMap();
+                let id = this.refIds.get(input);
+                if (!id) {
+                    id = ++this.refCount;
+                    this.refIds.set(input, id);
+                }
+                return `#${id}`;
+            }
+            return 'null';
+        }
+        return type;
+    }
+    /**
+     * Creates a cache key from input and config.
+     *
+     * @param input The input value.
+     * @param config The parse configuration.
+     *
+     * @returns The cache key.
+     */
+    key(input, config = {}) {
+        return `${this.#stringify(input)}|${this.#stringify(config.lang)}|${this.#stringify(config.message)}|${this.#stringify(config.abortEarly)}|${this.#stringify(config.abortPipeEarly)}`;
+    }
+    /**
+     * Gets a value from the cache by key.
+     *
+     * @param key The cache key.
+     *
+     * @returns The cached value.
+     */
+    get(key) {
+        if (!this.store)
+            return undefined;
+        // Get entry tuple [value, timestamp]
+        const entry = this.store.get(key);
+        // Return undefined if not found
+        if (!entry)
+            return undefined;
+        // Delete stale entry if maxAge is exceeded
+        if (this.hasMaxAge && Date.now() - entry[1] > this.maxAge) {
+            this.store.delete(key);
+            return undefined;
+        }
+        // Reorder by deleting and re-inserting at end (most recently used)
+        this.store.delete(key);
+        this.store.set(key, entry);
+        // Return cached value
+        return entry[0];
+    }
+    /**
+     * Sets a value in the cache by key.
+     *
+     * @param key The cache key.
+     * @param value The cached value.
+     */
+    set(key, value) {
+        this.store ??= new Map();
+        // Delete first to ensure insertion at end for correct ordering
+        this.store.delete(key);
+        // Set value with current timestamp if maxAge is used
+        const timestamp = this.hasMaxAge ? Date.now() : 0;
+        this.store.set(key, [value, timestamp]);
+        // Evict oldest entry (first key) if over maxSize
+        if (this.store.size > this.maxSize) {
+            this.store.delete(this.store.keys().next().value);
+        }
+    }
+    /**
+     * Clears all entries from the cache.
+     */
+    clear() {
+        this.store?.clear();
+    }
+}
+export { _LruCache };
+//# sourceMappingURL=_LruCache.js.map

package/dist/methods/_LruCache.js.map

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

package/dist/methods/assert.d.ts

@@ -0,0 +1,9 @@
+import type { BaseIssue, BaseSchema, InferInput } from '../types/index.js';
+/**
+ * Checks if the input matches the schema. As this is an assertion function, it
+ * can be used as a type guard.
+ *
+ * @param schema The schema to be used.
+ * @param input The input to be tested.
+ */
+export declare function assert<const TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>>>(schema: TSchema, input: unknown): asserts input is InferInput<TSchema>;

package/dist/methods/assert.js

@@ -0,0 +1,15 @@
+import { ValidationError } from '../utils/index.js';
+/**
+ * Checks if the input matches the schema. As this is an assertion function, it
+ * can be used as a type guard.
+ *
+ * @param schema The schema to be used.
+ * @param input The input to be tested.
+ */
+export function assert(schema, input) {
+    const issues = schema['~run']({ value: input }, { abortEarly: true }).issues;
+    if (issues) {
+        throw new ValidationError(issues);
+    }
+}
+//# sourceMappingURL=assert.js.map

package/dist/methods/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/methods/assert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAEpB,MAAe,EAAE,KAAc;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC7E,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/methods/cache.d.ts

@@ -0,0 +1,49 @@
+import type { OutputDataset } from '../types/index.js';
+import type { BaseIssue, BaseSchema, InferIssue, InferOutput } from '../types/index.js';
+import type { Cache, CacheConfig } from './types/cache.js';
+/**
+ * Schema with cache type.
+ *
+ * @beta
+ */
+export type SchemaWithCache<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TCacheConfig extends CacheConfig | undefined> = TSchema & {
+    /**
+     * The cache config.
+     */
+    readonly cacheConfig: TCacheConfig;
+    /**
+     * The cache instance.
+     */
+    readonly cache: Cache<OutputDataset<InferOutput<TSchema>, InferIssue<TSchema>>>;
+};
+/**
+ * Caches the output of a schema.
+ *
+ * Hint: Primitive inputs are cached by value. Object and function inputs are
+ * cached by reference identity, so mutating input objects and reusing the same
+ * reference can return a stale cached dataset. Returned objects are also
+ * reused by reference, so mutating cached output can affect later cache hits.
+ *
+ * @param schema The schema to cache.
+ *
+ * @returns The cached schema.
+ *
+ * @beta
+ */
+export declare function cache<const TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>>>(schema: TSchema): SchemaWithCache<TSchema, undefined>;
+/**
+ * Caches the output of a schema.
+ *
+ * Hint: Primitive inputs are cached by value. Object and function inputs are
+ * cached by reference identity, so mutating input objects and reusing the same
+ * reference can return a stale cached dataset. Returned objects are also
+ * reused by reference, so mutating cached output can affect later cache hits.
+ *
+ * @param schema The schema to cache.
+ * @param config The cache config.
+ *
+ * @returns The cached schema.
+ *
+ * @beta
+ */
+export declare function cache<const TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, const TCacheConfig extends CacheConfig | undefined>(schema: TSchema, config: TCacheConfig): SchemaWithCache<TSchema, TCacheConfig>;

package/dist/methods/cache.js

@@ -0,0 +1,24 @@
+import { _cloneDataset, _getStandardProps } from '../utils/index.js';
+import { _LruCache } from './_LruCache.js';
+// @__NO_SIDE_EFFECTS__
+export function cache(schema, config) {
+    return {
+        ...schema,
+        cacheConfig: config,
+        cache: new _LruCache(config),
+        get '~standard'() {
+            return _getStandardProps(this);
+        },
+        '~run'(dataset, runConfig) {
+            const key = this.cache.key(dataset.value, runConfig);
+            let outputDataset = this.cache.get(key);
+            if (!outputDataset) {
+                this.cache.set(key, (outputDataset = schema['~run'](dataset, runConfig)));
+            }
+            // Hint: We clone the dataset before returning it so downstream pipe items
+            // do not mutate the cached dataset wrapper or issues array.
+            return _cloneDataset(outputDataset);
+        },
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/methods/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/methods/cache.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAiE3C,uBAAuB;AACvB,MAAM,UAAU,KAAK,CACnB,MAAwD,EACxD,MAAoB;IAKpB,OAAO;QACL,GAAG,MAAM;QACT,WAAW,EAAE,MAAM;QACnB,KAAK,EAAE,IAAI,SAAS,CAAC,MAAM,CAAC;QAC5B,IAAI,WAAW;YACb,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,SAAS;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YACrD,IAAI,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,CAAC,GAAG,CACZ,GAAG,EACH,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CACrD,CAAC;YACJ,CAAC;YACD,0EAA0E;YAC1E,4DAA4D;YAC5D,OAAO,aAAa,CAAC,aAAa,CAAC,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/methods/cacheAsync.d.ts

@@ -0,0 +1,69 @@
+import type { BaseIssue, BaseSchema, BaseSchemaAsync, Config, InferInput, InferIssue, InferOutput, OutputDataset, StandardProps, UnknownDataset } from '../types/index.js';
+import type { Cache, CacheConfig } from './types/cache.js';
+/**
+ * Schema with cache async type.
+ *
+ * @beta
+ */
+export type SchemaWithCacheAsync<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TCacheConfig extends CacheConfig | undefined> = Omit<TSchema, 'async' | '~standard' | '~run'> & {
+    /**
+     * Whether it's async.
+     */
+    readonly async: true;
+    /**
+     * The cache config.
+     */
+    readonly cacheConfig: TCacheConfig;
+    /**
+     * The cache instance.
+     */
+    readonly cache: Cache<OutputDataset<InferOutput<TSchema>, InferIssue<TSchema>>>;
+    /**
+     * The Standard Schema properties.
+     *
+     * @internal
+     */
+    readonly '~standard': StandardProps<InferInput<TSchema>, InferOutput<TSchema>>;
+    /**
+     * Parses unknown input values.
+     *
+     * @param dataset The input dataset.
+     * @param config The configuration.
+     *
+     * @returns The output dataset.
+     *
+     * @internal
+     */
+    readonly '~run': (dataset: UnknownDataset, config: Config<BaseIssue<unknown>>) => Promise<OutputDataset<InferOutput<TSchema>, InferIssue<TSchema>>>;
+};
+/**
+ * Caches the output of a schema.
+ *
+ * Hint: Primitive inputs are cached by value. Object and function inputs are
+ * cached by reference identity, so mutating input objects and reusing the same
+ * reference can return a stale cached dataset. Returned objects are also
+ * reused by reference, so mutating cached output can affect later cache hits.
+ *
+ * @param schema The schema to cache.
+ *
+ * @returns The cached schema.
+ *
+ * @beta
+ */
+export declare function cacheAsync<const TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>>(schema: TSchema): SchemaWithCacheAsync<TSchema, undefined>;
+/**
+ * Caches the output of a schema.
+ *
+ * Hint: Primitive inputs are cached by value. Object and function inputs are
+ * cached by reference identity, so mutating input objects and reusing the same
+ * reference can return a stale cached dataset. Returned objects are also
+ * reused by reference, so mutating cached output can affect later cache hits.
+ *
+ * @param schema The schema to cache.
+ * @param config The cache config.
+ *
+ * @returns The cached schema.
+ *
+ * @beta
+ */
+export declare function cacheAsync<const TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, const TCacheConfig extends CacheConfig | undefined>(schema: TSchema, config: TCacheConfig): SchemaWithCacheAsync<TSchema, TCacheConfig>;

package/dist/methods/cacheAsync.js

@@ -0,0 +1,46 @@
+import { _cloneDataset, _getStandardProps } from '../utils/index.js';
+import { _LruCache } from './_LruCache.js';
+// @__NO_SIDE_EFFECTS__
+export function cacheAsync(schema, config) {
+    let activeRuns;
+    return {
+        ...schema,
+        async: true,
+        cacheConfig: config,
+        cache: new _LruCache(config),
+        get '~standard'() {
+            return _getStandardProps(this);
+        },
+        async '~run'(dataset, runConfig) {
+            // Create cache key based on input and config
+            const key = this.cache.key(dataset.value, runConfig);
+            // Check and return cached output if exists
+            const cached = this.cache.get(key);
+            if (cached) {
+                // Hint: We clone the dataset before returning it so downstream pipe
+                // items do not mutate the cached dataset wrapper or issues array.
+                return _cloneDataset(cached);
+            }
+            // If not cached, check if a matching run is already in progress
+            let promise = activeRuns?.get(key);
+            if (!promise) {
+                activeRuns ??= new Map();
+                promise = Promise.resolve(schema['~run'](dataset, runConfig));
+                activeRuns.set(key, promise);
+            }
+            // Await pending promise, cache output and return
+            try {
+                const outputDataset = await promise;
+                this.cache.set(key, outputDataset);
+                // Hint: We clone the dataset before returning it so downstream pipe
+                // items do not mutate the cached dataset wrapper or issues array.
+                return _cloneDataset(outputDataset);
+                // Cleanup active runs map
+            }
+            finally {
+                activeRuns?.delete(key);
+            }
+        },
+    };
+}
+//# sourceMappingURL=cacheAsync.js.map

package/dist/methods/cacheAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheAsync.js","sourceRoot":"","sources":["../../src/methods/cacheAsync.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAuG3C,uBAAuB;AACvB,MAAM,UAAU,UAAU,CACxB,MAEyD,EACzD,MAAoB;IAMpB,IAAI,UAES,CAAC;IACd,OAAO;QACL,GAAG,MAAM;QACT,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,MAAM;QACnB,KAAK,EAAE,IAAI,SAAS,CAAC,MAAM,CAAC;QAC5B,IAAI,WAAW;YACb,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS;YAC7B,6CAA6C;YAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAErD,2CAA2C;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,MAAM,EAAE,CAAC;gBACX,oEAAoE;gBACpE,kEAAkE;gBAClE,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;YAED,gEAAgE;YAChE,IAAI,OAAO,GAAG,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,UAAU,KAAK,IAAI,GAAG,EAAE,CAAC;gBACzB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC9D,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC/B,CAAC;YAED,iDAAiD;YACjD,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC;gBACpC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;gBACnC,oEAAoE;gBACpE,kEAAkE;gBAClE,OAAO,aAAa,CAAC,aAAa,CAAC,CAAC;gBAEpC,0BAA0B;YAC5B,CAAC;oBAAS,CAAC;gBACT,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/methods/config.d.ts

@@ -0,0 +1,10 @@
+import type { BaseIssue, BaseSchema, BaseSchemaAsync, Config, InferIssue } from '../types/index.js';
+/**
+ * Changes the local configuration of a schema.
+ *
+ * @param schema The schema to configure.
+ * @param config The parse configuration.
+ *
+ * @returns The configured schema.
+ */
+export declare function config<const TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>>(schema: TSchema, config: Config<InferIssue<TSchema>>): TSchema;

package/dist/methods/config.js

@@ -0,0 +1,22 @@
+import { _getStandardProps } from '../utils/index.js';
+/**
+ * Changes the local configuration of a schema.
+ *
+ * @param schema The schema to configure.
+ * @param config The parse configuration.
+ *
+ * @returns The configured schema.
+ */
+// @__NO_SIDE_EFFECTS__
+export function config(schema, config) {
+    return {
+        ...schema,
+        get '~standard'() {
+            return _getStandardProps(this);
+        },
+        '~run'(dataset, config_) {
+            return schema['~run'](dataset, { ...config_, ...config });
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/methods/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/methods/config.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;GAOG;AACH,uBAAuB;AACvB,MAAM,UAAU,MAAM,CAIpB,MAAe,EAAE,MAAmC;IACpD,OAAO;QACL,GAAG,MAAM;QACT,IAAI,WAAW;YACb,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,OAAO;YACrB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/methods/fallback.d.ts

@@ -0,0 +1,23 @@
+import type { BaseIssue, BaseSchema, Config, InferIssue, InferOutput, MaybeDeepReadonly, OutputDataset } from '../types/index.js';
+/**
+ * Fallback type.
+ */
+export type Fallback<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>>> = MaybeDeepReadonly<InferOutput<TSchema>> | ((dataset?: OutputDataset<InferOutput<TSchema>, InferIssue<TSchema>>, config?: Config<InferIssue<TSchema>>) => MaybeDeepReadonly<InferOutput<TSchema>>);
+/**
+ * Schema with fallback type.
+ */
+export type SchemaWithFallback<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, TFallback extends Fallback<TSchema>> = TSchema & {
+    /**
+     * The fallback value.
+     */
+    readonly fallback: TFallback;
+};
+/**
+ * Returns a fallback value as output if the input does not match the schema.
+ *
+ * @param schema The schema to catch.
+ * @param fallback The fallback value.
+ *
+ * @returns The passed schema.
+ */
+export declare function fallback<const TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>>, const TFallback extends Fallback<TSchema>>(schema: TSchema, fallback: TFallback): SchemaWithFallback<TSchema, TFallback>;

package/dist/methods/fallback.js

@@ -0,0 +1,27 @@
+import { _getStandardProps } from '../utils/index.js';
+import { getFallback } from './getFallback.js';
+/**
+ * Returns a fallback value as output if the input does not match the schema.
+ *
+ * @param schema The schema to catch.
+ * @param fallback The fallback value.
+ *
+ * @returns The passed schema.
+ */
+// @__NO_SIDE_EFFECTS__
+export function fallback(schema, fallback) {
+    return {
+        ...schema,
+        fallback,
+        get '~standard'() {
+            return _getStandardProps(this);
+        },
+        '~run'(dataset, config) {
+            const outputDataset = schema['~run'](dataset, config);
+            return outputDataset.issues
+                ? { typed: true, value: getFallback(this, outputDataset, config) }
+                : outputDataset;
+        },
+    };
+}
+//# sourceMappingURL=fallback.js.map

package/dist/methods/fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../src/methods/fallback.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA2B/C;;;;;;;GAOG;AACH,uBAAuB;AACvB,MAAM,UAAU,QAAQ,CAItB,MAAe,EACf,QAAmB;IAEnB,OAAO;QACL,GAAG,MAAM;QACT,QAAQ;QACR,IAAI,WAAW;YACb,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,MAAM;YACpB,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACtD,OAAO,aAAa,CAAC,MAAM;gBACzB,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE;gBAClE,CAAC,CAAC,aAAa,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}