rcs-js 0.0.1 → 1.0.2

package/core/schemas/builders/object/objectWithoutOptionalProperties.d.ts

@@ -0,0 +1,6 @@
+import { inferParsedPropertySchema, inferRawObjectFromPropertySchemas, ObjectSchema, PropertySchemas } from "./types";
+export declare function objectWithoutOptionalProperties<ParsedKeys extends string, T extends PropertySchemas<ParsedKeys>>(schemas: T): inferObjectWithoutOptionalPropertiesSchemaFromPropertySchemas<T>;
+export declare type inferObjectWithoutOptionalPropertiesSchemaFromPropertySchemas<T extends PropertySchemas<keyof T>> = ObjectSchema<inferRawObjectFromPropertySchemas<T>, inferParsedObjectWithoutOptionalPropertiesFromPropertySchemas<T>>;
+export declare type inferParsedObjectWithoutOptionalPropertiesFromPropertySchemas<T extends PropertySchemas<keyof T>> = {
+    [K in keyof T]: inferParsedPropertySchema<T[K]>;
+};

package/core/schemas/builders/object/objectWithoutOptionalProperties.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectWithoutOptionalProperties = void 0;
+const object_1 = require("./object");
+function objectWithoutOptionalProperties(schemas) {
+    return (0, object_1.object)(schemas);
+}
+exports.objectWithoutOptionalProperties = objectWithoutOptionalProperties;

package/core/schemas/builders/object/property.d.ts

@@ -0,0 +1,8 @@
+import { Schema } from "../../Schema";
+export declare function property<RawKey extends string, RawValue, ParsedValue>(rawKey: RawKey, valueSchema: Schema<RawValue, ParsedValue>): Property<RawKey, RawValue, ParsedValue>;
+export interface Property<RawKey extends string, RawValue, ParsedValue> {
+    rawKey: RawKey;
+    valueSchema: Schema<RawValue, ParsedValue>;
+    isProperty: true;
+}
+export declare function isProperty<O extends Property<any, any, any>>(maybeProperty: unknown): maybeProperty is O;

package/core/schemas/builders/object/property.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isProperty = exports.property = void 0;
+function property(rawKey, valueSchema) {
+    return {
+        rawKey,
+        valueSchema,
+        isProperty: true,
+    };
+}
+exports.property = property;
+function isProperty(maybeProperty) {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    return maybeProperty.isProperty;
+}
+exports.isProperty = isProperty;

package/core/schemas/builders/object/types.d.ts

@@ -0,0 +1,26 @@
+import { BaseSchema, inferParsed, inferRaw, Schema } from "../../Schema";
+import { addQuestionMarksToNullableProperties } from "../../utils/addQuestionMarksToNullableProperties";
+import { ObjectLikeUtils } from "../object-like";
+import { SchemaUtils } from "../schema-utils";
+import { Property } from "./property";
+export declare type ObjectSchema<Raw, Parsed> = BaseObjectSchema<Raw, Parsed> & ObjectLikeUtils<Raw, Parsed> & ObjectUtils<Raw, Parsed> & SchemaUtils<Raw, Parsed>;
+export interface BaseObjectSchema<Raw, Parsed> extends BaseSchema<Raw, Parsed> {
+    _getRawProperties: () => (keyof Raw)[];
+    _getParsedProperties: () => (keyof Parsed)[];
+}
+export interface ObjectUtils<Raw, Parsed> {
+    extend: <RawExtension, ParsedExtension>(schemas: ObjectSchema<RawExtension, ParsedExtension>) => ObjectSchema<Raw & RawExtension, Parsed & ParsedExtension>;
+}
+export declare type inferRawObject<O extends ObjectSchema<any, any>> = O extends ObjectSchema<infer Raw, any> ? Raw : never;
+export declare type inferParsedObject<O extends ObjectSchema<any, any>> = O extends ObjectSchema<any, infer Parsed> ? Parsed : never;
+export declare type inferObjectSchemaFromPropertySchemas<T extends PropertySchemas<keyof T>> = ObjectSchema<inferRawObjectFromPropertySchemas<T>, inferParsedObjectFromPropertySchemas<T>>;
+export declare type inferRawObjectFromPropertySchemas<T extends PropertySchemas<keyof T>> = addQuestionMarksToNullableProperties<{
+    [ParsedKey in keyof T as inferRawKey<ParsedKey, T[ParsedKey]>]: inferRawPropertySchema<T[ParsedKey]>;
+}>;
+export declare type inferParsedObjectFromPropertySchemas<T extends PropertySchemas<keyof T>> = addQuestionMarksToNullableProperties<{
+    [K in keyof T]: inferParsedPropertySchema<T[K]>;
+}>;
+export declare type PropertySchemas<ParsedKeys extends string | number | symbol> = Record<ParsedKeys, Property<any, any, any> | Schema<any, any>>;
+export declare type inferRawPropertySchema<P extends Property<any, any, any> | Schema<any, any>> = P extends Property<any, infer Raw, any> ? Raw : P extends Schema<any, any> ? inferRaw<P> : never;
+export declare type inferParsedPropertySchema<P extends Property<any, any, any> | Schema<any, any>> = P extends Property<any, any, infer Parsed> ? Parsed : P extends Schema<any, any> ? inferParsed<P> : never;
+export declare type inferRawKey<ParsedKey extends string | number | symbol, P extends Property<any, any, any> | Schema<any, any>> = P extends Property<infer Raw, any, any> ? Raw : ParsedKey;

package/core/schemas/builders/object/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/core/schemas/builders/object-like/getObjectLikeUtils.d.ts

@@ -0,0 +1,9 @@
+import { BaseSchema } from "../../Schema";
+import { ObjectLikeSchema, ObjectLikeUtils } from "./types";
+export declare function getObjectLikeUtils<Raw, Parsed>(schema: BaseSchema<Raw, Parsed>): ObjectLikeUtils<Raw, Parsed>;
+/**
+ * object-like utils are defined in one file to resolve issues with circular imports
+ */
+export declare function withParsedProperties<RawObjectShape, ParsedObjectShape, Properties>(objectLike: BaseSchema<RawObjectShape, ParsedObjectShape>, properties: {
+    [K in keyof Properties]: Properties[K] | ((parsed: ParsedObjectShape) => Properties[K]);
+}): ObjectLikeSchema<RawObjectShape, ParsedObjectShape & Properties>;

package/core/schemas/builders/object-like/getObjectLikeUtils.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withParsedProperties = exports.getObjectLikeUtils = void 0;
+const filterObject_1 = require("../../utils/filterObject");
+const getErrorMessageForIncorrectType_1 = require("../../utils/getErrorMessageForIncorrectType");
+const isPlainObject_1 = require("../../utils/isPlainObject");
+const schema_utils_1 = require("../schema-utils");
+function getObjectLikeUtils(schema) {
+    return {
+        withParsedProperties: (properties) => withParsedProperties(schema, properties),
+    };
+}
+exports.getObjectLikeUtils = getObjectLikeUtils;
+/**
+ * object-like utils are defined in one file to resolve issues with circular imports
+ */
+function withParsedProperties(objectLike, properties) {
+    const objectSchema = {
+        parse: (raw, opts) => {
+            const parsedObject = objectLike.parse(raw, opts);
+            if (!parsedObject.ok) {
+                return parsedObject;
+            }
+            const additionalProperties = Object.entries(properties).reduce((processed, [key, value]) => {
+                return Object.assign(Object.assign({}, processed), { [key]: typeof value === "function" ? value(parsedObject.value) : value });
+            }, {});
+            return {
+                ok: true,
+                value: Object.assign(Object.assign({}, parsedObject.value), additionalProperties),
+            };
+        },
+        json: (parsed, opts) => {
+            var _a;
+            if (!(0, isPlainObject_1.isPlainObject)(parsed)) {
+                return {
+                    ok: false,
+                    errors: [
+                        {
+                            path: (_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : [],
+                            message: (0, getErrorMessageForIncorrectType_1.getErrorMessageForIncorrectType)(parsed, "object"),
+                        },
+                    ],
+                };
+            }
+            // strip out added properties
+            const addedPropertyKeys = new Set(Object.keys(properties));
+            const parsedWithoutAddedProperties = (0, filterObject_1.filterObject)(parsed, Object.keys(parsed).filter((key) => !addedPropertyKeys.has(key)));
+            return objectLike.json(parsedWithoutAddedProperties, opts);
+        },
+        getType: () => objectLike.getType(),
+    };
+    return Object.assign(Object.assign(Object.assign({}, objectSchema), (0, schema_utils_1.getSchemaUtils)(objectSchema)), getObjectLikeUtils(objectSchema));
+}
+exports.withParsedProperties = withParsedProperties;

package/core/schemas/builders/object-like/index.d.ts

@@ -0,0 +1,2 @@
+export { getObjectLikeUtils, withParsedProperties } from "./getObjectLikeUtils";
+export type { ObjectLikeSchema, ObjectLikeUtils } from "./types";

package/core/schemas/builders/object-like/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withParsedProperties = exports.getObjectLikeUtils = void 0;
+var getObjectLikeUtils_1 = require("./getObjectLikeUtils");
+Object.defineProperty(exports, "getObjectLikeUtils", { enumerable: true, get: function () { return getObjectLikeUtils_1.getObjectLikeUtils; } });
+Object.defineProperty(exports, "withParsedProperties", { enumerable: true, get: function () { return getObjectLikeUtils_1.withParsedProperties; } });

package/core/schemas/builders/object-like/types.d.ts

@@ -0,0 +1,7 @@
+import { BaseSchema, Schema } from "../../Schema";
+export declare type ObjectLikeSchema<Raw, Parsed> = Schema<Raw, Parsed> & BaseSchema<Raw, Parsed> & ObjectLikeUtils<Raw, Parsed>;
+export interface ObjectLikeUtils<Raw, Parsed> {
+    withParsedProperties: <T extends Record<string, any>>(properties: {
+        [K in keyof T]: T[K] | ((parsed: Parsed) => T[K]);
+    }) => ObjectLikeSchema<Raw, Parsed & T>;
+}

package/core/schemas/builders/object-like/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/core/schemas/builders/primitives/any.d.ts

@@ -0,0 +1 @@
+export declare const any: () => import("../../Schema").Schema<any, any>;

package/core/schemas/builders/primitives/any.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.any = void 0;
+const Schema_1 = require("../../Schema");
+const createIdentitySchemaCreator_1 = require("../../utils/createIdentitySchemaCreator");
+exports.any = (0, createIdentitySchemaCreator_1.createIdentitySchemaCreator)(Schema_1.SchemaType.ANY, (value) => ({ ok: true, value }));

package/core/schemas/builders/primitives/boolean.d.ts

@@ -0,0 +1 @@
+export declare const boolean: () => import("../../Schema").Schema<boolean, boolean>;

package/core/schemas/builders/primitives/boolean.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.boolean = void 0;
+const Schema_1 = require("../../Schema");
+const createIdentitySchemaCreator_1 = require("../../utils/createIdentitySchemaCreator");
+const getErrorMessageForIncorrectType_1 = require("../../utils/getErrorMessageForIncorrectType");
+exports.boolean = (0, createIdentitySchemaCreator_1.createIdentitySchemaCreator)(Schema_1.SchemaType.BOOLEAN, (value, { breadcrumbsPrefix = [] } = {}) => {
+    if (typeof value === "boolean") {
+        return {
+            ok: true,
+            value,
+        };
+    }
+    else {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: (0, getErrorMessageForIncorrectType_1.getErrorMessageForIncorrectType)(value, "boolean"),
+                },
+            ],
+        };
+    }
+});

package/core/schemas/builders/primitives/index.d.ts

@@ -0,0 +1,5 @@
+export { any } from "./any";
+export { boolean } from "./boolean";
+export { number } from "./number";
+export { string } from "./string";
+export { unknown } from "./unknown";

package/core/schemas/builders/primitives/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unknown = exports.string = exports.number = exports.boolean = exports.any = void 0;
+var any_1 = require("./any");
+Object.defineProperty(exports, "any", { enumerable: true, get: function () { return any_1.any; } });
+var boolean_1 = require("./boolean");
+Object.defineProperty(exports, "boolean", { enumerable: true, get: function () { return boolean_1.boolean; } });
+var number_1 = require("./number");
+Object.defineProperty(exports, "number", { enumerable: true, get: function () { return number_1.number; } });
+var string_1 = require("./string");
+Object.defineProperty(exports, "string", { enumerable: true, get: function () { return string_1.string; } });
+var unknown_1 = require("./unknown");
+Object.defineProperty(exports, "unknown", { enumerable: true, get: function () { return unknown_1.unknown; } });

package/core/schemas/builders/primitives/number.d.ts

@@ -0,0 +1 @@
+export declare const number: () => import("../../Schema").Schema<number, number>;

package/core/schemas/builders/primitives/number.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.number = void 0;
+const Schema_1 = require("../../Schema");
+const createIdentitySchemaCreator_1 = require("../../utils/createIdentitySchemaCreator");
+const getErrorMessageForIncorrectType_1 = require("../../utils/getErrorMessageForIncorrectType");
+exports.number = (0, createIdentitySchemaCreator_1.createIdentitySchemaCreator)(Schema_1.SchemaType.NUMBER, (value, { breadcrumbsPrefix = [] } = {}) => {
+    if (typeof value === "number") {
+        return {
+            ok: true,
+            value,
+        };
+    }
+    else {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: (0, getErrorMessageForIncorrectType_1.getErrorMessageForIncorrectType)(value, "number"),
+                },
+            ],
+        };
+    }
+});

package/core/schemas/builders/primitives/string.d.ts

@@ -0,0 +1 @@
+export declare const string: () => import("../../Schema").Schema<string, string>;

package/core/schemas/builders/primitives/string.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.string = void 0;
+const Schema_1 = require("../../Schema");
+const createIdentitySchemaCreator_1 = require("../../utils/createIdentitySchemaCreator");
+const getErrorMessageForIncorrectType_1 = require("../../utils/getErrorMessageForIncorrectType");
+exports.string = (0, createIdentitySchemaCreator_1.createIdentitySchemaCreator)(Schema_1.SchemaType.STRING, (value, { breadcrumbsPrefix = [] } = {}) => {
+    if (typeof value === "string") {
+        return {
+            ok: true,
+            value,
+        };
+    }
+    else {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: (0, getErrorMessageForIncorrectType_1.getErrorMessageForIncorrectType)(value, "string"),
+                },
+            ],
+        };
+    }
+});

package/core/schemas/builders/primitives/unknown.d.ts

@@ -0,0 +1 @@
+export declare const unknown: () => import("../../Schema").Schema<unknown, unknown>;

package/core/schemas/builders/primitives/unknown.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unknown = void 0;
+const Schema_1 = require("../../Schema");
+const createIdentitySchemaCreator_1 = require("../../utils/createIdentitySchemaCreator");
+exports.unknown = (0, createIdentitySchemaCreator_1.createIdentitySchemaCreator)(Schema_1.SchemaType.UNKNOWN, (value) => ({ ok: true, value }));

package/core/schemas/builders/record/index.d.ts

@@ -0,0 +1,2 @@
+export { record } from "./record";
+export type { BaseRecordSchema, RecordSchema } from "./types";

package/core/schemas/builders/record/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.record = void 0;
+var record_1 = require("./record");
+Object.defineProperty(exports, "record", { enumerable: true, get: function () { return record_1.record; } });

package/core/schemas/builders/record/record.d.ts

@@ -0,0 +1,3 @@
+import { Schema } from "../../Schema";
+import { RecordSchema } from "./types";
+export declare function record<RawKey extends string | number, RawValue, ParsedValue, ParsedKey extends string | number>(keySchema: Schema<RawKey, ParsedKey>, valueSchema: Schema<RawValue, ParsedValue>): RecordSchema<RawKey, RawValue, ParsedKey, ParsedValue>;

package/core/schemas/builders/record/record.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.record = void 0;
+const Schema_1 = require("../../Schema");
+const entries_1 = require("../../utils/entries");
+const getErrorMessageForIncorrectType_1 = require("../../utils/getErrorMessageForIncorrectType");
+const isPlainObject_1 = require("../../utils/isPlainObject");
+const maybeSkipValidation_1 = require("../../utils/maybeSkipValidation");
+const schema_utils_1 = require("../schema-utils");
+function record(keySchema, valueSchema) {
+    const baseSchema = {
+        parse: (raw, opts) => {
+            return validateAndTransformRecord({
+                value: raw,
+                isKeyNumeric: keySchema.getType() === Schema_1.SchemaType.NUMBER,
+                transformKey: (key) => {
+                    var _a;
+                    return keySchema.parse(key, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `${key} (key)`] }));
+                },
+                transformValue: (value, key) => {
+                    var _a;
+                    return valueSchema.parse(value, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `${key}`] }));
+                },
+                breadcrumbsPrefix: opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix,
+            });
+        },
+        json: (parsed, opts) => {
+            return validateAndTransformRecord({
+                value: parsed,
+                isKeyNumeric: keySchema.getType() === Schema_1.SchemaType.NUMBER,
+                transformKey: (key) => {
+                    var _a;
+                    return keySchema.json(key, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `${key} (key)`] }));
+                },
+                transformValue: (value, key) => {
+                    var _a;
+                    return valueSchema.json(value, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `${key}`] }));
+                },
+                breadcrumbsPrefix: opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix,
+            });
+        },
+        getType: () => Schema_1.SchemaType.RECORD,
+    };
+    return Object.assign(Object.assign({}, (0, maybeSkipValidation_1.maybeSkipValidation)(baseSchema)), (0, schema_utils_1.getSchemaUtils)(baseSchema));
+}
+exports.record = record;
+function validateAndTransformRecord({ value, isKeyNumeric, transformKey, transformValue, breadcrumbsPrefix = [], }) {
+    if (!(0, isPlainObject_1.isPlainObject)(value)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: (0, getErrorMessageForIncorrectType_1.getErrorMessageForIncorrectType)(value, "object"),
+                },
+            ],
+        };
+    }
+    return (0, entries_1.entries)(value).reduce((accPromise, [stringKey, value]) => {
+        // skip nullish keys
+        if (value == null) {
+            return accPromise;
+        }
+        const acc = accPromise;
+        let key = stringKey;
+        if (isKeyNumeric) {
+            const numberKey = stringKey.length > 0 ? Number(stringKey) : NaN;
+            if (!isNaN(numberKey)) {
+                key = numberKey;
+            }
+        }
+        const transformedKey = transformKey(key);
+        const transformedValue = transformValue(value, key);
+        if (acc.ok && transformedKey.ok && transformedValue.ok) {
+            return {
+                ok: true,
+                value: Object.assign(Object.assign({}, acc.value), { [transformedKey.value]: transformedValue.value }),
+            };
+        }
+        const errors = [];
+        if (!acc.ok) {
+            errors.push(...acc.errors);
+        }
+        if (!transformedKey.ok) {
+            errors.push(...transformedKey.errors);
+        }
+        if (!transformedValue.ok) {
+            errors.push(...transformedValue.errors);
+        }
+        return {
+            ok: false,
+            errors,
+        };
+    }, { ok: true, value: {} });
+}

package/core/schemas/builders/record/types.d.ts

@@ -0,0 +1,4 @@
+import { BaseSchema } from "../../Schema";
+import { SchemaUtils } from "../schema-utils";
+export declare type RecordSchema<RawKey extends string | number, RawValue, ParsedKey extends string | number, ParsedValue> = BaseRecordSchema<RawKey, RawValue, ParsedKey, ParsedValue> & SchemaUtils<Record<RawKey, RawValue>, Record<ParsedKey, ParsedValue>>;
+export declare type BaseRecordSchema<RawKey extends string | number, RawValue, ParsedKey extends string | number, ParsedValue> = BaseSchema<Record<RawKey, RawValue>, Record<ParsedKey, ParsedValue>>;

package/core/schemas/builders/record/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/core/schemas/builders/schema-utils/JsonError.d.ts

@@ -0,0 +1,5 @@
+import { ValidationError } from "../../Schema";
+export declare class JsonError extends Error {
+    readonly errors: ValidationError[];
+    constructor(errors: ValidationError[]);
+}

package/core/schemas/builders/schema-utils/JsonError.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonError = void 0;
+const stringifyValidationErrors_1 = require("./stringifyValidationErrors");
+class JsonError extends Error {
+    constructor(errors) {
+        super(errors.map(stringifyValidationErrors_1.stringifyValidationError).join("; "));
+        this.errors = errors;
+        Object.setPrototypeOf(this, JsonError.prototype);
+    }
+}
+exports.JsonError = JsonError;

package/core/schemas/builders/schema-utils/ParseError.d.ts

@@ -0,0 +1,5 @@
+import { ValidationError } from "../../Schema";
+export declare class ParseError extends Error {
+    readonly errors: ValidationError[];
+    constructor(errors: ValidationError[]);
+}

package/core/schemas/builders/schema-utils/ParseError.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseError = void 0;
+const stringifyValidationErrors_1 = require("./stringifyValidationErrors");
+class ParseError extends Error {
+    constructor(errors) {
+        super(errors.map(stringifyValidationErrors_1.stringifyValidationError).join("; "));
+        this.errors = errors;
+        Object.setPrototypeOf(this, ParseError.prototype);
+    }
+}
+exports.ParseError = ParseError;

package/core/schemas/builders/schema-utils/getSchemaUtils.d.ts

@@ -0,0 +1,17 @@
+import { BaseSchema, Schema, SchemaOptions } from "../../Schema";
+export interface SchemaUtils<Raw, Parsed> {
+    optional: () => Schema<Raw | null | undefined, Parsed | undefined>;
+    transform: <Transformed>(transformer: SchemaTransformer<Parsed, Transformed>) => Schema<Raw, Transformed>;
+    parseOrThrow: (raw: unknown, opts?: SchemaOptions) => Parsed;
+    jsonOrThrow: (raw: unknown, opts?: SchemaOptions) => Raw;
+}
+export interface SchemaTransformer<Parsed, Transformed> {
+    transform: (parsed: Parsed) => Transformed;
+    untransform: (transformed: any) => Parsed;
+}
+export declare function getSchemaUtils<Raw, Parsed>(schema: BaseSchema<Raw, Parsed>): SchemaUtils<Raw, Parsed>;
+/**
+ * schema utils are defined in one file to resolve issues with circular imports
+ */
+export declare function optional<Raw, Parsed>(schema: BaseSchema<Raw, Parsed>): Schema<Raw | null | undefined, Parsed | undefined>;
+export declare function transform<Raw, Parsed, Transformed>(schema: BaseSchema<Raw, Parsed>, transformer: SchemaTransformer<Parsed, Transformed>): Schema<Raw, Transformed>;

package/core/schemas/builders/schema-utils/getSchemaUtils.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transform = exports.optional = exports.getSchemaUtils = void 0;
+const Schema_1 = require("../../Schema");
+const JsonError_1 = require("./JsonError");
+const ParseError_1 = require("./ParseError");
+function getSchemaUtils(schema) {
+    return {
+        optional: () => optional(schema),
+        transform: (transformer) => transform(schema, transformer),
+        parseOrThrow: (raw, opts) => {
+            const parsed = schema.parse(raw, opts);
+            if (parsed.ok) {
+                return parsed.value;
+            }
+            throw new ParseError_1.ParseError(parsed.errors);
+        },
+        jsonOrThrow: (parsed, opts) => {
+            const raw = schema.json(parsed, opts);
+            if (raw.ok) {
+                return raw.value;
+            }
+            throw new JsonError_1.JsonError(raw.errors);
+        },
+    };
+}
+exports.getSchemaUtils = getSchemaUtils;
+/**
+ * schema utils are defined in one file to resolve issues with circular imports
+ */
+function optional(schema) {
+    const baseSchema = {
+        parse: (raw, opts) => {
+            if (raw == null) {
+                return {
+                    ok: true,
+                    value: undefined,
+                };
+            }
+            return schema.parse(raw, opts);
+        },
+        json: (parsed, opts) => {
+            if ((opts === null || opts === void 0 ? void 0 : opts.omitUndefined) && parsed === undefined) {
+                return {
+                    ok: true,
+                    value: undefined,
+                };
+            }
+            if (parsed == null) {
+                return {
+                    ok: true,
+                    value: null,
+                };
+            }
+            return schema.json(parsed, opts);
+        },
+        getType: () => Schema_1.SchemaType.OPTIONAL,
+    };
+    return Object.assign(Object.assign({}, baseSchema), getSchemaUtils(baseSchema));
+}
+exports.optional = optional;
+function transform(schema, transformer) {
+    const baseSchema = {
+        parse: (raw, opts) => {
+            const parsed = schema.parse(raw, opts);
+            if (!parsed.ok) {
+                return parsed;
+            }
+            return {
+                ok: true,
+                value: transformer.transform(parsed.value),
+            };
+        },
+        json: (transformed, opts) => {
+            const parsed = transformer.untransform(transformed);
+            return schema.json(parsed, opts);
+        },
+        getType: () => schema.getType(),
+    };
+    return Object.assign(Object.assign({}, baseSchema), getSchemaUtils(baseSchema));
+}
+exports.transform = transform;

package/core/schemas/builders/schema-utils/index.d.ts

@@ -0,0 +1,4 @@
+export { getSchemaUtils, optional, transform } from "./getSchemaUtils";
+export type { SchemaUtils } from "./getSchemaUtils";
+export { JsonError } from "./JsonError";
+export { ParseError } from "./ParseError";

package/core/schemas/builders/schema-utils/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseError = exports.JsonError = exports.transform = exports.optional = exports.getSchemaUtils = void 0;
+var getSchemaUtils_1 = require("./getSchemaUtils");
+Object.defineProperty(exports, "getSchemaUtils", { enumerable: true, get: function () { return getSchemaUtils_1.getSchemaUtils; } });
+Object.defineProperty(exports, "optional", { enumerable: true, get: function () { return getSchemaUtils_1.optional; } });
+Object.defineProperty(exports, "transform", { enumerable: true, get: function () { return getSchemaUtils_1.transform; } });
+var JsonError_1 = require("./JsonError");
+Object.defineProperty(exports, "JsonError", { enumerable: true, get: function () { return JsonError_1.JsonError; } });
+var ParseError_1 = require("./ParseError");
+Object.defineProperty(exports, "ParseError", { enumerable: true, get: function () { return ParseError_1.ParseError; } });

package/core/schemas/builders/schema-utils/stringifyValidationErrors.d.ts

@@ -0,0 +1,2 @@
+import { ValidationError } from "../../Schema";
+export declare function stringifyValidationError(error: ValidationError): string;

package/core/schemas/builders/schema-utils/stringifyValidationErrors.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringifyValidationError = void 0;
+function stringifyValidationError(error) {
+    if (error.path.length === 0) {
+        return error.message;
+    }
+    return `${error.path.join(" -> ")}: ${error.message}`;
+}
+exports.stringifyValidationError = stringifyValidationError;

package/core/schemas/builders/set/index.d.ts

@@ -0,0 +1 @@
+export { set } from "./set";

package/core/schemas/builders/set/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.set = void 0;
+var set_1 = require("./set");
+Object.defineProperty(exports, "set", { enumerable: true, get: function () { return set_1.set; } });

package/core/schemas/builders/set/set.d.ts

@@ -0,0 +1,2 @@
+import { Schema } from "../../Schema";
+export declare function set<Raw, Parsed>(schema: Schema<Raw, Parsed>): Schema<Raw[], Set<Parsed>>;