truefoundry-gateway-sdk 0.0.2 → 0.1.0

package/dist/esm/core/schemas/builders/record/record.d.mts

@@ -0,0 +1,4 @@
+import { type Schema } from "../../Schema.mjs";
+import type { PartialRecordSchema, RecordSchema } from "./types.mjs";
+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>;
+export declare function partialRecord<RawKey extends string | number, RawValue, ParsedValue, ParsedKey extends string | number>(keySchema: Schema<RawKey, ParsedKey>, valueSchema: Schema<RawValue, ParsedValue>): PartialRecordSchema<RawKey, RawValue, ParsedKey, ParsedValue>;

package/dist/esm/core/schemas/builders/record/record.mjs

@@ -0,0 +1,127 @@
+import { SchemaType } from "../../Schema.mjs";
+import { getErrorMessageForIncorrectType } from "../../utils/getErrorMessageForIncorrectType.mjs";
+import { isPlainObject } from "../../utils/isPlainObject.mjs";
+import { maybeSkipValidation } from "../../utils/maybeSkipValidation.mjs";
+import { getSchemaUtils } from "../schema-utils/index.mjs";
+// eslint-disable-next-line @typescript-eslint/unbound-method
+const _hasOwn = Object.prototype.hasOwnProperty;
+export function record(keySchema, valueSchema) {
+    const baseSchema = {
+        parse: (raw, opts) => {
+            return validateAndTransformRecord({
+                value: raw,
+                isKeyNumeric: keySchema.getType() === 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() === 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: () => SchemaType.RECORD,
+    };
+    return Object.assign(Object.assign({}, maybeSkipValidation(baseSchema)), getSchemaUtils(baseSchema));
+}
+export function partialRecord(keySchema, valueSchema) {
+    const baseSchema = {
+        parse: (raw, opts) => {
+            return validateAndTransformRecord({
+                value: raw,
+                isKeyNumeric: keySchema.getType() === 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() === 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: () => SchemaType.RECORD,
+    };
+    return Object.assign(Object.assign({}, maybeSkipValidation(baseSchema)), getSchemaUtils(baseSchema));
+}
+function validateAndTransformRecord({ value, isKeyNumeric, transformKey, transformValue, breadcrumbsPrefix = [], }) {
+    if (!isPlainObject(value)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: getErrorMessageForIncorrectType(value, "object"),
+                },
+            ],
+        };
+    }
+    const result = {};
+    const errors = [];
+    for (const stringKey in value) {
+        if (!_hasOwn.call(value, stringKey)) {
+            continue;
+        }
+        const entryValue = value[stringKey];
+        if (entryValue === undefined) {
+            continue;
+        }
+        let key = stringKey;
+        if (isKeyNumeric) {
+            const numberKey = stringKey.length > 0 ? Number(stringKey) : NaN;
+            if (!Number.isNaN(numberKey)) {
+                key = numberKey;
+            }
+        }
+        const transformedKey = transformKey(key);
+        const transformedValue = transformValue(entryValue, key);
+        if (transformedKey.ok && transformedValue.ok) {
+            result[transformedKey.value] = transformedValue.value;
+        }
+        else {
+            if (!transformedKey.ok) {
+                errors.push(...transformedKey.errors);
+            }
+            if (!transformedValue.ok) {
+                errors.push(...transformedValue.errors);
+            }
+        }
+    }
+    if (errors.length === 0) {
+        return { ok: true, value: result };
+    }
+    return { ok: false, errors };
+}

package/dist/esm/core/schemas/builders/record/types.d.mts

@@ -0,0 +1,6 @@
+import type { BaseSchema } from "../../Schema.mjs";
+import type { SchemaUtils } from "../schema-utils/index.mjs";
+export 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 type BaseRecordSchema<RawKey extends string | number, RawValue, ParsedKey extends string | number, ParsedValue> = BaseSchema<Record<RawKey, RawValue>, Record<ParsedKey, ParsedValue>>;
+export type PartialRecordSchema<RawKey extends string | number, RawValue, ParsedKey extends string | number, ParsedValue> = BasePartialRecordSchema<RawKey, RawValue, ParsedKey, ParsedValue> & SchemaUtils<Record<RawKey, RawValue>, Partial<Record<ParsedKey, ParsedValue>>>;
+export type BasePartialRecordSchema<RawKey extends string | number, RawValue, ParsedKey extends string | number, ParsedValue> = BaseSchema<Record<RawKey, RawValue>, Partial<Record<ParsedKey, ParsedValue>>>;

package/dist/esm/core/schemas/builders/record/types.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/schemas/builders/schema-utils/JsonError.d.mts

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

package/dist/esm/core/schemas/builders/schema-utils/JsonError.mjs

@@ -0,0 +1,9 @@
+import { stringifyValidationError } from "./stringifyValidationErrors.mjs";
+export class JsonError extends Error {
+    constructor(errors) {
+        super(errors.map(stringifyValidationError).join("; "));
+        this.errors = errors;
+        Object.setPrototypeOf(this, JsonError.prototype);
+        this.name = "JsonError";
+    }
+}

package/dist/esm/core/schemas/builders/schema-utils/ParseError.d.mts

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

package/dist/esm/core/schemas/builders/schema-utils/ParseError.mjs

@@ -0,0 +1,9 @@
+import { stringifyValidationError } from "./stringifyValidationErrors.mjs";
+export class ParseError extends Error {
+    constructor(errors) {
+        super(errors.map(stringifyValidationError).join("; "));
+        this.errors = errors;
+        Object.setPrototypeOf(this, ParseError.prototype);
+        this.name = "ParseError";
+    }
+}

package/dist/esm/core/schemas/builders/schema-utils/getSchemaUtils.d.mts

@@ -0,0 +1,21 @@
+import { type BaseSchema, type Schema, type SchemaOptions } from "../../Schema.mjs";
+export interface SchemaUtils<Raw, Parsed> {
+    nullable: () => Schema<Raw | null, Parsed | null>;
+    optional: () => Schema<Raw | null | undefined, Parsed | undefined>;
+    optionalNullable: () => Schema<Raw | null | undefined, Parsed | null | 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 nullable<Raw, Parsed>(schema: BaseSchema<Raw, Parsed>): Schema<Raw | null, Parsed | null>;
+export declare function optional<Raw, Parsed>(schema: BaseSchema<Raw, Parsed>): Schema<Raw | null | undefined, Parsed | undefined>;
+export declare function optionalNullable<Raw, Parsed>(schema: BaseSchema<Raw, Parsed>): Schema<Raw | null | undefined, Parsed | null | undefined>;
+export declare function transform<Raw, Parsed, Transformed>(schema: BaseSchema<Raw, Parsed>, transformer: SchemaTransformer<Parsed, Transformed>): Schema<Raw, Transformed>;

package/dist/esm/core/schemas/builders/schema-utils/getSchemaUtils.mjs

@@ -0,0 +1,138 @@
+import { SchemaType } from "../../Schema.mjs";
+import { JsonError } from "./JsonError.mjs";
+import { ParseError } from "./ParseError.mjs";
+export function getSchemaUtils(schema) {
+    return {
+        nullable: () => nullable(schema),
+        optional: () => optional(schema),
+        optionalNullable: () => optionalNullable(schema),
+        transform: (transformer) => transform(schema, transformer),
+        parseOrThrow: (raw, opts) => {
+            const parsed = schema.parse(raw, opts);
+            if (parsed.ok) {
+                return parsed.value;
+            }
+            throw new ParseError(parsed.errors);
+        },
+        jsonOrThrow: (parsed, opts) => {
+            const raw = schema.json(parsed, opts);
+            if (raw.ok) {
+                return raw.value;
+            }
+            throw new JsonError(raw.errors);
+        },
+    };
+}
+/**
+ * schema utils are defined in one file to resolve issues with circular imports
+ */
+export function nullable(schema) {
+    const baseSchema = {
+        parse: (raw, opts) => {
+            if (raw == null) {
+                return {
+                    ok: true,
+                    value: null,
+                };
+            }
+            return schema.parse(raw, opts);
+        },
+        json: (parsed, opts) => {
+            if (parsed == null) {
+                return {
+                    ok: true,
+                    value: null,
+                };
+            }
+            return schema.json(parsed, opts);
+        },
+        getType: () => SchemaType.NULLABLE,
+    };
+    return Object.assign(Object.assign({}, baseSchema), getSchemaUtils(baseSchema));
+}
+export 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: () => SchemaType.OPTIONAL,
+    };
+    return Object.assign(Object.assign({}, baseSchema), getSchemaUtils(baseSchema));
+}
+export function optionalNullable(schema) {
+    const baseSchema = {
+        parse: (raw, opts) => {
+            if (raw === undefined) {
+                return {
+                    ok: true,
+                    value: undefined,
+                };
+            }
+            if (raw === null) {
+                return {
+                    ok: true,
+                    value: null,
+                };
+            }
+            return schema.parse(raw, opts);
+        },
+        json: (parsed, opts) => {
+            if (parsed === undefined) {
+                return {
+                    ok: true,
+                    value: undefined,
+                };
+            }
+            if (parsed === null) {
+                return {
+                    ok: true,
+                    value: null,
+                };
+            }
+            return schema.json(parsed, opts);
+        },
+        getType: () => SchemaType.OPTIONAL_NULLABLE,
+    };
+    return Object.assign(Object.assign({}, baseSchema), getSchemaUtils(baseSchema));
+}
+export 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));
+}

package/dist/esm/core/schemas/builders/schema-utils/index.d.mts

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

package/dist/esm/core/schemas/builders/schema-utils/index.mjs

@@ -0,0 +1,3 @@
+export { getSchemaUtils, optional, transform } from "./getSchemaUtils.mjs";
+export { JsonError } from "./JsonError.mjs";
+export { ParseError } from "./ParseError.mjs";

package/dist/esm/core/schemas/builders/schema-utils/stringifyValidationErrors.d.mts

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

package/dist/esm/core/schemas/builders/schema-utils/stringifyValidationErrors.mjs

@@ -0,0 +1,6 @@
+export function stringifyValidationError(error) {
+    if (error.path.length === 0) {
+        return error.message;
+    }
+    return `${error.path.join(" -> ")}: ${error.message}`;
+}

package/dist/esm/core/schemas/builders/set/index.d.mts

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

package/dist/esm/core/schemas/builders/set/index.mjs

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

package/dist/esm/core/schemas/builders/set/set.d.mts

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

package/dist/esm/core/schemas/builders/set/set.mjs

@@ -0,0 +1,40 @@
+import { SchemaType } from "../../Schema.mjs";
+import { getErrorMessageForIncorrectType } from "../../utils/getErrorMessageForIncorrectType.mjs";
+import { maybeSkipValidation } from "../../utils/maybeSkipValidation.mjs";
+import { list } from "../list/index.mjs";
+import { getSchemaUtils } from "../schema-utils/index.mjs";
+export function set(schema) {
+    const listSchema = list(schema);
+    const baseSchema = {
+        parse: (raw, opts) => {
+            const parsedList = listSchema.parse(raw, opts);
+            if (parsedList.ok) {
+                return {
+                    ok: true,
+                    value: new Set(parsedList.value),
+                };
+            }
+            else {
+                return parsedList;
+            }
+        },
+        json: (parsed, opts) => {
+            var _a;
+            if (!(parsed instanceof Set)) {
+                return {
+                    ok: false,
+                    errors: [
+                        {
+                            path: (_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : [],
+                            message: getErrorMessageForIncorrectType(parsed, "Set"),
+                        },
+                    ],
+                };
+            }
+            const jsonList = listSchema.json([...parsed], opts);
+            return jsonList;
+        },
+        getType: () => SchemaType.SET,
+    };
+    return Object.assign(Object.assign({}, maybeSkipValidation(baseSchema)), getSchemaUtils(baseSchema));
+}

package/dist/esm/core/schemas/builders/undiscriminated-union/index.d.mts

@@ -0,0 +1,2 @@
+export type { inferParsedUnidiscriminatedUnionSchema, inferRawUnidiscriminatedUnionSchema, UndiscriminatedUnionSchema, } from "./types.mjs";
+export { undiscriminatedUnion } from "./undiscriminatedUnion.mjs";

package/dist/esm/core/schemas/builders/undiscriminated-union/index.mjs

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

package/dist/esm/core/schemas/builders/undiscriminated-union/types.d.mts

@@ -0,0 +1,4 @@
+import type { inferParsed, inferRaw, Schema } from "../../Schema.mjs";
+export type UndiscriminatedUnionSchema<Schemas extends [...Schema[]]> = Schema<inferRawUnidiscriminatedUnionSchema<Schemas>, inferParsedUnidiscriminatedUnionSchema<Schemas>>;
+export type inferRawUnidiscriminatedUnionSchema<Schemas extends [...Schema[]]> = inferRaw<Schemas[number]>;
+export type inferParsedUnidiscriminatedUnionSchema<Schemas extends [...Schema[]]> = inferParsed<Schemas[number]>;

package/dist/esm/core/schemas/builders/undiscriminated-union/types.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/schemas/builders/undiscriminated-union/undiscriminatedUnion.d.mts

@@ -0,0 +1,3 @@
+import { type Schema } from "../../Schema.mjs";
+import type { inferParsedUnidiscriminatedUnionSchema, inferRawUnidiscriminatedUnionSchema } from "./types.mjs";
+export declare function undiscriminatedUnion<Schemas extends [Schema<any, any>, ...Schema<any, any>[]]>(schemas: Schemas): Schema<inferRawUnidiscriminatedUnionSchema<Schemas>, inferParsedUnidiscriminatedUnionSchema<Schemas>>;

package/dist/esm/core/schemas/builders/undiscriminated-union/undiscriminatedUnion.mjs

@@ -0,0 +1,36 @@
+import { SchemaType, } from "../../Schema.mjs";
+import { maybeSkipValidation } from "../../utils/maybeSkipValidation.mjs";
+import { getSchemaUtils } from "../schema-utils/index.mjs";
+export function undiscriminatedUnion(schemas) {
+    const baseSchema = {
+        parse: (raw, opts) => {
+            return validateAndTransformUndiscriminatedUnion((schema, opts) => schema.parse(raw, opts), schemas, opts);
+        },
+        json: (parsed, opts) => {
+            return validateAndTransformUndiscriminatedUnion((schema, opts) => schema.json(parsed, opts), schemas, opts);
+        },
+        getType: () => SchemaType.UNDISCRIMINATED_UNION,
+    };
+    return Object.assign(Object.assign({}, maybeSkipValidation(baseSchema)), getSchemaUtils(baseSchema));
+}
+function validateAndTransformUndiscriminatedUnion(transform, schemas, opts) {
+    const errors = [];
+    for (const [index, schema] of schemas.entries()) {
+        const transformed = transform(schema, Object.assign(Object.assign({}, opts), { skipValidation: false }));
+        if (transformed.ok) {
+            return transformed;
+        }
+        else {
+            for (const error of transformed.errors) {
+                errors.push({
+                    path: error.path,
+                    message: `[Variant ${index}] ${error.message}`,
+                });
+            }
+        }
+    }
+    return {
+        ok: false,
+        errors,
+    };
+}

package/dist/esm/core/schemas/builders/union/discriminant.d.mts

@@ -0,0 +1,5 @@
+export declare function discriminant<RawDiscriminant extends string, ParsedDiscriminant extends string>(parsedDiscriminant: ParsedDiscriminant, rawDiscriminant: RawDiscriminant): Discriminant<RawDiscriminant, ParsedDiscriminant>;
+export interface Discriminant<RawDiscriminant extends string, ParsedDiscriminant extends string> {
+    parsedDiscriminant: ParsedDiscriminant;
+    rawDiscriminant: RawDiscriminant;
+}

package/dist/esm/core/schemas/builders/union/discriminant.mjs

@@ -0,0 +1,6 @@
+export function discriminant(parsedDiscriminant, rawDiscriminant) {
+    return {
+        parsedDiscriminant,
+        rawDiscriminant,
+    };
+}

package/dist/esm/core/schemas/builders/union/index.d.mts

@@ -0,0 +1,4 @@
+export type { Discriminant } from "./discriminant.mjs";
+export { discriminant } from "./discriminant.mjs";
+export type { inferParsedDiscriminant, inferParsedUnion, inferRawDiscriminant, inferRawUnion, UnionSubtypes, } from "./types.mjs";
+export { union } from "./union.mjs";

package/dist/esm/core/schemas/builders/union/index.mjs

@@ -0,0 +1,2 @@
+export { discriminant } from "./discriminant.mjs";
+export { union } from "./union.mjs";

package/dist/esm/core/schemas/builders/union/types.d.mts

@@ -0,0 +1,13 @@
+import type { inferParsedObject, inferRawObject, ObjectSchema } from "../object/index.mjs";
+import type { Discriminant } from "./discriminant.mjs";
+export type UnionSubtypes<DiscriminantValues extends string | number | symbol> = {
+    [K in DiscriminantValues]: ObjectSchema<any, any>;
+};
+export type inferRawUnion<D extends string | Discriminant<any, any>, U extends UnionSubtypes<keyof U>> = {
+    [K in keyof U]: Record<inferRawDiscriminant<D>, K> & inferRawObject<U[K]>;
+}[keyof U];
+export type inferParsedUnion<D extends string | Discriminant<any, any>, U extends UnionSubtypes<keyof U>> = {
+    [K in keyof U]: Record<inferParsedDiscriminant<D>, K> & inferParsedObject<U[K]>;
+}[keyof U];
+export type inferRawDiscriminant<D extends string | Discriminant<any, any>> = D extends string ? D : D extends Discriminant<infer Raw, any> ? Raw : never;
+export type inferParsedDiscriminant<D extends string | Discriminant<any, any>> = D extends string ? D : D extends Discriminant<any, infer Parsed> ? Parsed : never;

package/dist/esm/core/schemas/builders/union/types.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/schemas/builders/union/union.d.mts

@@ -0,0 +1,4 @@
+import { type ObjectLikeSchema } from "../object-like/index.mjs";
+import type { Discriminant } from "./discriminant.mjs";
+import type { inferParsedUnion, inferRawUnion, UnionSubtypes } from "./types.mjs";
+export declare function union<D extends string | Discriminant<any, any>, U extends UnionSubtypes<any>>(discriminant: D, union: U): ObjectLikeSchema<inferRawUnion<D, U>, inferParsedUnion<D, U>>;

package/dist/esm/core/schemas/builders/union/union.mjs

@@ -0,0 +1,123 @@
+import { SchemaType } from "../../Schema.mjs";
+import { getErrorMessageForIncorrectType } from "../../utils/getErrorMessageForIncorrectType.mjs";
+import { isPlainObject } from "../../utils/isPlainObject.mjs";
+import { keys } from "../../utils/keys.mjs";
+import { maybeSkipValidation } from "../../utils/maybeSkipValidation.mjs";
+import { enum_ } from "../enum/index.mjs";
+import { getObjectLikeUtils } from "../object-like/index.mjs";
+import { getSchemaUtils } from "../schema-utils/index.mjs";
+// eslint-disable-next-line @typescript-eslint/unbound-method
+const _hasOwn = Object.prototype.hasOwnProperty;
+export function union(discriminant, union) {
+    const rawDiscriminant = typeof discriminant === "string" ? discriminant : discriminant.rawDiscriminant;
+    const parsedDiscriminant = typeof discriminant === "string"
+        ? discriminant
+        : discriminant.parsedDiscriminant;
+    const discriminantValueSchema = enum_(keys(union));
+    const baseSchema = {
+        parse: (raw, opts) => {
+            return transformAndValidateUnion({
+                value: raw,
+                discriminant: rawDiscriminant,
+                transformedDiscriminant: parsedDiscriminant,
+                transformDiscriminantValue: (discriminantValue) => {
+                    var _a;
+                    return discriminantValueSchema.parse(discriminantValue, {
+                        allowUnrecognizedEnumValues: opts === null || opts === void 0 ? void 0 : opts.allowUnrecognizedUnionMembers,
+                        breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), rawDiscriminant],
+                    });
+                },
+                getAdditionalPropertiesSchema: (discriminantValue) => union[discriminantValue],
+                allowUnrecognizedUnionMembers: opts === null || opts === void 0 ? void 0 : opts.allowUnrecognizedUnionMembers,
+                transformAdditionalProperties: (additionalProperties, additionalPropertiesSchema) => additionalPropertiesSchema.parse(additionalProperties, opts),
+                breadcrumbsPrefix: opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix,
+            });
+        },
+        json: (parsed, opts) => {
+            return transformAndValidateUnion({
+                value: parsed,
+                discriminant: parsedDiscriminant,
+                transformedDiscriminant: rawDiscriminant,
+                transformDiscriminantValue: (discriminantValue) => {
+                    var _a;
+                    return discriminantValueSchema.json(discriminantValue, {
+                        allowUnrecognizedEnumValues: opts === null || opts === void 0 ? void 0 : opts.allowUnrecognizedUnionMembers,
+                        breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), parsedDiscriminant],
+                    });
+                },
+                getAdditionalPropertiesSchema: (discriminantValue) => union[discriminantValue],
+                allowUnrecognizedUnionMembers: opts === null || opts === void 0 ? void 0 : opts.allowUnrecognizedUnionMembers,
+                transformAdditionalProperties: (additionalProperties, additionalPropertiesSchema) => additionalPropertiesSchema.json(additionalProperties, opts),
+                breadcrumbsPrefix: opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix,
+            });
+        },
+        getType: () => SchemaType.UNION,
+    };
+    return Object.assign(Object.assign(Object.assign({}, maybeSkipValidation(baseSchema)), getSchemaUtils(baseSchema)), getObjectLikeUtils(baseSchema));
+}
+function transformAndValidateUnion({ value, discriminant, transformedDiscriminant, transformDiscriminantValue, getAdditionalPropertiesSchema, allowUnrecognizedUnionMembers = false, transformAdditionalProperties, breadcrumbsPrefix = [], }) {
+    if (!isPlainObject(value)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: getErrorMessageForIncorrectType(value, "object"),
+                },
+            ],
+        };
+    }
+    const discriminantValue = value[discriminant];
+    const additionalProperties = {};
+    for (const key in value) {
+        if (_hasOwn.call(value, key) && key !== discriminant) {
+            additionalProperties[key] = value[key];
+        }
+    }
+    if (discriminantValue == null) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: `Missing discriminant ("${discriminant}")`,
+                },
+            ],
+        };
+    }
+    const transformedDiscriminantValue = transformDiscriminantValue(discriminantValue);
+    if (!transformedDiscriminantValue.ok) {
+        return {
+            ok: false,
+            errors: transformedDiscriminantValue.errors,
+        };
+    }
+    const additionalPropertiesSchema = getAdditionalPropertiesSchema(transformedDiscriminantValue.value);
+    if (additionalPropertiesSchema == null) {
+        if (allowUnrecognizedUnionMembers) {
+            return {
+                ok: true,
+                value: Object.assign({ [transformedDiscriminant]: transformedDiscriminantValue.value }, additionalProperties),
+            };
+        }
+        else {
+            return {
+                ok: false,
+                errors: [
+                    {
+                        path: [...breadcrumbsPrefix, discriminant],
+                        message: "Unexpected discriminant value",
+                    },
+                ],
+            };
+        }
+    }
+    const transformedAdditionalProperties = transformAdditionalProperties(additionalProperties, additionalPropertiesSchema);
+    if (!transformedAdditionalProperties.ok) {
+        return transformedAdditionalProperties;
+    }
+    return {
+        ok: true,
+        value: Object.assign({ [transformedDiscriminant]: discriminantValue }, transformedAdditionalProperties.value),
+    };
+}