@zeruxjs/validator 0.0.0-stage → 0.0.2

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"}

package/dist/methods/fallbackAsync.d.ts

@@ -0,0 +1,44 @@
+import type { BaseIssue, BaseSchema, BaseSchemaAsync, Config, InferInput, InferIssue, InferOutput, MaybeDeepReadonly, MaybePromise, OutputDataset, StandardProps, UnknownDataset } from '../types/index.js';
+/**
+ * Fallback async type.
+ */
+export type FallbackAsync<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>> = MaybeDeepReadonly<InferOutput<TSchema>> | ((dataset?: OutputDataset<InferOutput<TSchema>, InferIssue<TSchema>>, config?: Config<InferIssue<TSchema>>) => MaybePromise<MaybeDeepReadonly<InferOutput<TSchema>>>);
+/**
+ * Schema with fallback async type.
+ */
+export type SchemaWithFallbackAsync<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, TFallback extends FallbackAsync<TSchema>> = Omit<TSchema, 'async' | '~standard' | '~run'> & {
+    /**
+     * The fallback value.
+     */
+    readonly fallback: TFallback;
+    /**
+     * Whether it's async.
+     */
+    readonly async: true;
+    /**
+     * 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>>>;
+};
+/**
+ * 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 fallbackAsync<const TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>, const TFallback extends FallbackAsync<TSchema>>(schema: TSchema, fallback: TFallback): SchemaWithFallbackAsync<TSchema, TFallback>;

package/dist/methods/fallbackAsync.js

@@ -0,0 +1,31 @@
+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 fallbackAsync(schema, fallback) {
+    return {
+        ...schema,
+        fallback,
+        async: true,
+        get '~standard'() {
+            return _getStandardProps(this);
+        },
+        async '~run'(dataset, config) {
+            const outputDataset = await schema['~run'](dataset, config);
+            return outputDataset.issues
+                ? {
+                    typed: true,
+                    value: await getFallback(this, outputDataset, config),
+                }
+                : outputDataset;
+        },
+    };
+}
+//# sourceMappingURL=fallbackAsync.js.map

package/dist/methods/fallbackAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackAsync.js","sourceRoot":"","sources":["../../src/methods/fallbackAsync.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA0D/C;;;;;;;GAOG;AACH,uBAAuB;AACvB,MAAM,UAAU,aAAa,CAM3B,MAAe,EACf,QAAmB;IAEnB,OAAO;QACL,GAAG,MAAM;QACT,QAAQ;QACR,KAAK,EAAE,IAAI;QACX,IAAI,WAAW;YACb,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM;YAC1B,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5D,OAAO,aAAa,CAAC,MAAM;gBACzB,CAAC,CAAC;oBACA,KAAK,EAAE,IAAI;oBACX,KAAK,EAAE,MAAM,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC;iBACtD;gBACD,CAAC,CAAC,aAAa,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/methods/flatten.d.ts

@@ -0,0 +1,48 @@
+import type { BaseIssue, BaseSchema, BaseSchemaAsync, InferIssue, IssueDotPath, Prettify } from '../types/index.js';
+/**
+ * Flat errors type.
+ */
+export type FlatErrors<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>> | undefined> = Prettify<{
+    /**
+     * The root errors.
+     *
+     * Hint: The error messages of issues without a path that belong to the root
+     * of the schema are added to this key.
+     */
+    readonly root?: [string, ...string[]];
+    /**
+     * The nested errors.
+     *
+     * Hint: The error messages of issues with a path that belong to the nested
+     * parts of the schema and can be converted to a dot path are added to this
+     * key.
+     */
+    readonly nested?: Prettify<Readonly<Partial<Record<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>> ? IssueDotPath<TSchema> : string, [
+        string,
+        ...string[]
+    ]>>>>;
+    /**
+     * The other errors.
+     *
+     * Hint: Some issue paths, for example for complex data types like `Set` and
+     * `Map`, have no key or a key that cannot be converted to a dot path. These
+     * error messages are added to this key.
+     */
+    readonly other?: [string, ...string[]];
+}>;
+/**
+ * Flatten the error messages of issues.
+ *
+ * @param issues The list of issues.
+ *
+ * @returns A flat error object.
+ */
+export declare function flatten(issues: [BaseIssue<unknown>, ...BaseIssue<unknown>[]]): FlatErrors<undefined>;
+/**
+ * Flatten the error messages of issues.
+ *
+ * @param issues The list of issues.
+ *
+ * @returns A flat error object.
+ */
+export declare function flatten<TSchema extends BaseSchema<unknown, unknown, BaseIssue<unknown>> | BaseSchemaAsync<unknown, unknown, BaseIssue<unknown>>>(issues: [InferIssue<TSchema>, ...InferIssue<TSchema>[]]): FlatErrors<TSchema>;

package/dist/methods/flatten.js

@@ -0,0 +1,51 @@
+import { getDotPath } from '../utils/index.js';
+// @__NO_SIDE_EFFECTS__
+export function flatten(issues) {
+    // Create flat errors object
+    const flatErrors = {};
+    // Add message of each issue to flat errors object
+    for (const issue of issues) {
+        // If issue has path, add message to nested or other errors
+        if (issue.path) {
+            // Get dot path from issue
+            const dotPath = getDotPath(issue);
+            // If path has valid keys, add message to nested errors
+            if (dotPath) {
+                if (!flatErrors.nested) {
+                    // @ts-expect-error
+                    flatErrors.nested = {};
+                }
+                if (flatErrors.nested[dotPath]) {
+                    flatErrors.nested[dotPath].push(issue.message);
+                }
+                else {
+                    // @ts-expect-error
+                    flatErrors.nested[dotPath] = [issue.message];
+                }
+                // Otherwise, add message to other errors
+            }
+            else {
+                if (flatErrors.other) {
+                    flatErrors.other.push(issue.message);
+                }
+                else {
+                    // @ts-expect-error
+                    flatErrors.other = [issue.message];
+                }
+            }
+            // Otherwise, add message to root errors
+        }
+        else {
+            if (flatErrors.root) {
+                flatErrors.root.push(issue.message);
+            }
+            else {
+                // @ts-expect-error
+                flatErrors.root = [issue.message];
+            }
+        }
+    }
+    // Return flat errors object
+    return flatErrors;
+}
+//# sourceMappingURL=flatten.js.map

package/dist/methods/flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.js","sourceRoot":"","sources":["../../src/methods/flatten.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAyE/C,uBAAuB;AACvB,MAAM,UAAU,OAAO,CACrB,MAAqD;IAErD,4BAA4B;IAC5B,MAAM,UAAU,GAA0B,EAAE,CAAC;IAE7C,kDAAkD;IAClD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,2DAA2D;QAC3D,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,0BAA0B;YAC1B,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAElC,uDAAuD;YACvD,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;oBACvB,mBAAmB;oBACnB,UAAU,CAAC,MAAM,GAAG,EAAE,CAAC;gBACzB,CAAC;gBACD,IAAI,UAAU,CAAC,MAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBAChC,UAAU,CAAC,MAAO,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACnD,CAAC;qBAAM,CAAC;oBACN,mBAAmB;oBACnB,UAAU,CAAC,MAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAChD,CAAC;gBAED,yCAAyC;YAC3C,CAAC;iBAAM,CAAC;gBACN,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;oBACrB,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,mBAAmB;oBACnB,UAAU,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YAED,wCAAwC;QAC1C,CAAC;aAAM,CAAC;YACN,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;gBACpB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,mBAAmB;gBACnB,UAAU,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/methods/forward.d.ts

@@ -0,0 +1,11 @@
+import type { BaseIssue, BaseValidation } from '../types/index.js';
+import type { RequiredPath, ValidPath } from './types/forward.js';
+/**
+ * Forwards the issues of the passed validation action.
+ *
+ * @param action The validation action.
+ * @param path The path to forward the issues to.
+ *
+ * @returns The modified action.
+ */
+export declare function forward<TInput extends Record<string, unknown> | ArrayLike<unknown>, TIssue extends BaseIssue<unknown>, const TPath extends RequiredPath>(action: BaseValidation<TInput, TInput, TIssue>, path: ValidPath<TInput, TPath>): BaseValidation<TInput, TInput, TIssue>;