@truefoundry/trueforge-sdk 0.0.0 → 0.1.0-rc.0

package/dist/esm/core/runtime/runtime.mjs

@@ -0,0 +1,172 @@
+/**
+ * A constant that indicates which environment and version the SDK is running in.
+ */
+export const RUNTIME = evaluateRuntime();
+function evaluateRuntime() {
+    var _a, _b, _c, _d, _e, _f, _g;
+    /**
+     * A constant that indicates whether the environment the code is running is a Web Browser.
+     */
+    const isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+    if (isBrowser) {
+        return {
+            type: "browser",
+            version: window.navigator.userAgent,
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Cloudflare.
+     * https://developers.cloudflare.com/workers/runtime-apis/web-standards/#navigatoruseragent
+     */
+    const isCloudflare = typeof globalThis !== "undefined" && ((_a = globalThis === null || globalThis === void 0 ? void 0 : globalThis.navigator) === null || _a === void 0 ? void 0 : _a.userAgent) === "Cloudflare-Workers";
+    if (isCloudflare) {
+        return {
+            type: "workerd",
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Edge Runtime.
+     * https://vercel.com/docs/functions/runtimes/edge-runtime#check-if-you're-running-on-the-edge-runtime
+     */
+    const isEdgeRuntime = typeof EdgeRuntime === "string";
+    if (isEdgeRuntime) {
+        return {
+            type: "edge-runtime",
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is a Web Worker.
+     */
+    const isWebWorker = typeof self === "object" &&
+        typeof (self === null || self === void 0 ? void 0 : self.importScripts) === "function" &&
+        (((_b = self.constructor) === null || _b === void 0 ? void 0 : _b.name) === "DedicatedWorkerGlobalScope" ||
+            ((_c = self.constructor) === null || _c === void 0 ? void 0 : _c.name) === "ServiceWorkerGlobalScope" ||
+            ((_d = self.constructor) === null || _d === void 0 ? void 0 : _d.name) === "SharedWorkerGlobalScope");
+    if (isWebWorker) {
+        return {
+            type: "web-worker",
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Deno.
+     * FYI Deno spoofs process.versions.node, see https://deno.land/std@0.177.0/node/process.ts?s=versions
+     */
+    const isDeno = typeof Deno !== "undefined" && typeof Deno.version !== "undefined" && typeof Deno.version.deno !== "undefined";
+    if (isDeno) {
+        return {
+            type: "deno",
+            version: Deno.version.deno,
+            os: (_e = Deno.build) === null || _e === void 0 ? void 0 : _e.os,
+            arch: (_f = Deno.build) === null || _f === void 0 ? void 0 : _f.arch,
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Bun.sh.
+     */
+    const isBun = typeof Bun !== "undefined" && typeof Bun.version !== "undefined";
+    if (isBun) {
+        return {
+            type: "bun",
+            version: Bun.version,
+            os: typeof process !== "undefined" ? process.platform : undefined,
+            arch: typeof process !== "undefined" ? process.arch : undefined,
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is in React-Native.
+     * This check should come before Node.js detection since React Native may have a process polyfill.
+     * https://github.com/facebook/react-native/blob/main/packages/react-native/Libraries/Core/setUpNavigator.js
+     */
+    const isReactNative = typeof navigator !== "undefined" && (navigator === null || navigator === void 0 ? void 0 : navigator.product) === "ReactNative";
+    if (isReactNative) {
+        return {
+            type: "react-native",
+        };
+    }
+    /**
+     * A constant that indicates whether the environment the code is running is Node.JS.
+     *
+     * We assign `process` to a local variable first to avoid being flagged by
+     * bundlers that perform static analysis on `process.versions` (e.g. Next.js
+     * Edge Runtime warns about Node.js APIs even when they are guarded).
+     */
+    const _process = typeof process !== "undefined" ? process : undefined;
+    const isNode = typeof _process !== "undefined" && typeof ((_g = _process.versions) === null || _g === void 0 ? void 0 : _g.node) === "string";
+    if (isNode) {
+        return {
+            type: "node",
+            version: _process.versions.node,
+            parsedVersion: Number(_process.versions.node.split(".")[0]),
+            os: _process.platform,
+            arch: _process.arch,
+        };
+    }
+    return {
+        type: "unknown",
+    };
+}
+/**
+ * Display names for the language runtimes whose version is meaningful to encode
+ * in a User-Agent. Environments where a version string is not useful (e.g.
+ * browsers, where `version` is the full navigator UA) are intentionally mapped
+ * to `undefined` so they are omitted from the User-Agent.
+ */
+const RUNTIME_DISPLAY_NAMES = {
+    node: "Node",
+    deno: "Deno",
+    bun: "Bun",
+    browser: undefined,
+    "web-worker": undefined,
+    "react-native": undefined,
+    workerd: undefined,
+    "edge-runtime": undefined,
+    unknown: undefined,
+};
+/**
+ * CPU architecture aliases that all refer to 64-bit x86. They are normalized to
+ * the single canonical token `x86_64` so the User-Agent architecture label is
+ * consistent regardless of which runtime reports it (Node reports `x64`, others
+ * report `amd64` or `x86_64`).
+ */
+const X86_64_ARCH_ALIASES = new Set(["x64", "amd64", "x86_64"]);
+/**
+ * Normalizes a CPU architecture token, collapsing the 64-bit x86 aliases
+ * (`x64`, `amd64`, `x86_64`) to `x86_64`. Other architectures are returned
+ * unchanged.
+ */
+function normalizeArch(arch) {
+    if (arch == null) {
+        return arch;
+    }
+    return X86_64_ARCH_ALIASES.has(arch.toLowerCase()) ? "x86_64" : arch;
+}
+/**
+ * Percent-encodes the `@` and `/` characters in an npm package name so the
+ * User-Agent product token stays within the RFC 7230 token grammar. The
+ * original scoped package name can be recovered by URL-decoding (e.g.
+ * `@dummy/sdk` becomes `%40dummy%2Fsdk`).
+ */
+function encodeProductName(sdkName) {
+    return sdkName.replace(/@/g, "%40").replace(/\//g, "%2F");
+}
+/**
+ * Builds a structured User-Agent string of the form
+ *   `{sdkName}/{sdkVersion} ({os}; {arch}) {runtime}/{runtimeVersion}`
+ * where the platform group and runtime segment are omitted gracefully when the
+ * underlying values cannot be determined (e.g. in a browser).
+ */
+export function getUserAgent(sdkName, sdkVersion) {
+    let userAgent = `${encodeProductName(sdkName)}/${sdkVersion}`;
+    const platform = [RUNTIME.os, normalizeArch(RUNTIME.arch)].filter((part) => part != null && part.length > 0);
+    if (platform.length > 0) {
+        userAgent += ` (${platform.join("; ")})`;
+    }
+    const runtimeName = RUNTIME_DISPLAY_NAMES[RUNTIME.type];
+    if (runtimeName != null) {
+        userAgent += ` ${runtimeName}`;
+        if (RUNTIME.version != null && RUNTIME.version.length > 0) {
+            userAgent += `/${RUNTIME.version}`;
+        }
+    }
+    return userAgent;
+}

package/dist/esm/core/schemas/Schema.d.mts

@@ -0,0 +1,88 @@
+import type { SchemaUtils } from "./builders/index.mjs";
+export type Schema<Raw = unknown, Parsed = unknown> = BaseSchema<Raw, Parsed> & SchemaUtils<Raw, Parsed>;
+export type inferRaw<S extends Schema> = S extends Schema<infer Raw, any> ? Raw : never;
+export type inferParsed<S extends Schema> = S extends Schema<any, infer Parsed> ? Parsed : never;
+export interface BaseSchema<Raw, Parsed> {
+    parse: (raw: unknown, opts?: SchemaOptions) => MaybeValid<Parsed>;
+    json: (parsed: unknown, opts?: SchemaOptions) => MaybeValid<Raw>;
+    getType: () => SchemaType | SchemaType;
+}
+export declare const SchemaType: {
+    readonly BIGINT: "bigint";
+    readonly DATE: "date";
+    readonly ENUM: "enum";
+    readonly LIST: "list";
+    readonly STRING_LITERAL: "stringLiteral";
+    readonly BOOLEAN_LITERAL: "booleanLiteral";
+    readonly OBJECT: "object";
+    readonly ANY: "any";
+    readonly BOOLEAN: "boolean";
+    readonly NUMBER: "number";
+    readonly STRING: "string";
+    readonly UNKNOWN: "unknown";
+    readonly NEVER: "never";
+    readonly RECORD: "record";
+    readonly SET: "set";
+    readonly UNION: "union";
+    readonly UNDISCRIMINATED_UNION: "undiscriminatedUnion";
+    readonly NULLABLE: "nullable";
+    readonly OPTIONAL: "optional";
+    readonly OPTIONAL_NULLABLE: "optionalNullable";
+};
+export type SchemaType = (typeof SchemaType)[keyof typeof SchemaType];
+export type MaybeValid<T> = Valid<T> | Invalid;
+export interface Valid<T> {
+    ok: true;
+    value: T;
+}
+export interface Invalid {
+    ok: false;
+    errors: ValidationError[];
+}
+export interface ValidationError {
+    path: string[];
+    message: string;
+}
+export interface SchemaOptions {
+    /**
+     * how to handle unrecognized keys in objects
+     *
+     * @default "fail"
+     */
+    unrecognizedObjectKeys?: "fail" | "passthrough" | "strip";
+    /**
+     * whether to fail when an unrecognized discriminant value is
+     * encountered in a union
+     *
+     * @default false
+     */
+    allowUnrecognizedUnionMembers?: boolean;
+    /**
+     * whether to fail when an unrecognized enum value is encountered
+     *
+     * @default false
+     */
+    allowUnrecognizedEnumValues?: boolean;
+    /**
+     * whether to allow data that doesn't conform to the schema.
+     * invalid data is passed through without transformation.
+     *
+     * when this is enabled, .parse() and .json() will always
+     * return `ok: true`. `.parseOrThrow()` and `.jsonOrThrow()`
+     * will never fail.
+     *
+     * @default false
+     */
+    skipValidation?: boolean;
+    /**
+     * each validation failure contains a "path" property, which is
+     * the breadcrumbs to the offending node in the JSON. you can supply
+     * a prefix that is prepended to all the errors' paths. this can be
+     * helpful for zurg's internal debug logging.
+     */
+    breadcrumbsPrefix?: string[];
+    /**
+     * whether to send 'null' for optional properties explicitly set to 'undefined'.
+     */
+    omitUndefined?: boolean;
+}

package/dist/esm/core/schemas/Schema.mjs

@@ -0,0 +1,22 @@
+export const SchemaType = {
+    BIGINT: "bigint",
+    DATE: "date",
+    ENUM: "enum",
+    LIST: "list",
+    STRING_LITERAL: "stringLiteral",
+    BOOLEAN_LITERAL: "booleanLiteral",
+    OBJECT: "object",
+    ANY: "any",
+    BOOLEAN: "boolean",
+    NUMBER: "number",
+    STRING: "string",
+    UNKNOWN: "unknown",
+    NEVER: "never",
+    RECORD: "record",
+    SET: "set",
+    UNION: "union",
+    UNDISCRIMINATED_UNION: "undiscriminatedUnion",
+    NULLABLE: "nullable",
+    OPTIONAL: "optional",
+    OPTIONAL_NULLABLE: "optionalNullable",
+};

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

@@ -0,0 +1,2 @@
+import { type Schema } from "../../Schema.mjs";
+export declare function bigint(): Schema<bigint | number, bigint>;

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

@@ -0,0 +1,50 @@
+import { SchemaType } from "../../Schema.mjs";
+import { getErrorMessageForIncorrectType } from "../../utils/getErrorMessageForIncorrectType.mjs";
+import { maybeSkipValidation } from "../../utils/maybeSkipValidation.mjs";
+import { getSchemaUtils } from "../schema-utils/index.mjs";
+export function bigint() {
+    const baseSchema = {
+        parse: (raw, { breadcrumbsPrefix = [] } = {}) => {
+            if (typeof raw === "bigint") {
+                return {
+                    ok: true,
+                    value: raw,
+                };
+            }
+            if (typeof raw === "number") {
+                return {
+                    ok: true,
+                    value: BigInt(raw),
+                };
+            }
+            return {
+                ok: false,
+                errors: [
+                    {
+                        path: breadcrumbsPrefix,
+                        message: getErrorMessageForIncorrectType(raw, "bigint | number"),
+                    },
+                ],
+            };
+        },
+        json: (bigint, { breadcrumbsPrefix = [] } = {}) => {
+            if (typeof bigint !== "bigint") {
+                return {
+                    ok: false,
+                    errors: [
+                        {
+                            path: breadcrumbsPrefix,
+                            message: getErrorMessageForIncorrectType(bigint, "bigint"),
+                        },
+                    ],
+                };
+            }
+            return {
+                ok: true,
+                value: bigint,
+            };
+        },
+        getType: () => SchemaType.BIGINT,
+    };
+    return Object.assign(Object.assign({}, maybeSkipValidation(baseSchema)), getSchemaUtils(baseSchema));
+}

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

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

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

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

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

@@ -0,0 +1,2 @@
+import { type Schema } from "../../Schema.mjs";
+export declare function date(): Schema<string, Date>;

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

@@ -0,0 +1,59 @@
+import { SchemaType } from "../../Schema.mjs";
+import { getErrorMessageForIncorrectType } from "../../utils/getErrorMessageForIncorrectType.mjs";
+import { maybeSkipValidation } from "../../utils/maybeSkipValidation.mjs";
+import { getSchemaUtils } from "../schema-utils/index.mjs";
+// https://stackoverflow.com/questions/12756159/regex-and-iso8601-formatted-datetime
+const ISO_8601_REGEX = /^([+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6])))([T\s]((([01]\d|2[0-3])((:?)[0-5]\d)?|24:?00)([.,]\d+(?!:))?)?(\17[0-5]\d([.,]\d+)?)?([zZ]|([+-])([01]\d|2[0-3]):?([0-5]\d)?)?)?)?$/;
+export function date() {
+    const baseSchema = {
+        parse: (raw, { breadcrumbsPrefix = [] } = {}) => {
+            if (typeof raw !== "string") {
+                return {
+                    ok: false,
+                    errors: [
+                        {
+                            path: breadcrumbsPrefix,
+                            message: getErrorMessageForIncorrectType(raw, "string"),
+                        },
+                    ],
+                };
+            }
+            if (!ISO_8601_REGEX.test(raw)) {
+                return {
+                    ok: false,
+                    errors: [
+                        {
+                            path: breadcrumbsPrefix,
+                            message: getErrorMessageForIncorrectType(raw, "ISO 8601 date string"),
+                        },
+                    ],
+                };
+            }
+            return {
+                ok: true,
+                value: new Date(raw),
+            };
+        },
+        json: (date, { breadcrumbsPrefix = [] } = {}) => {
+            if (date instanceof Date) {
+                return {
+                    ok: true,
+                    value: date.toISOString(),
+                };
+            }
+            else {
+                return {
+                    ok: false,
+                    errors: [
+                        {
+                            path: breadcrumbsPrefix,
+                            message: getErrorMessageForIncorrectType(date, "Date object"),
+                        },
+                    ],
+                };
+            }
+        },
+        getType: () => SchemaType.DATE,
+    };
+    return Object.assign(Object.assign({}, maybeSkipValidation(baseSchema)), getSchemaUtils(baseSchema));
+}

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

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

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

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

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

@@ -0,0 +1,3 @@
+import { type Schema } from "../../Schema.mjs";
+export declare function enum_<U extends string, E extends U[]>(values: E): Schema<E[number], E[number]>;
+export declare function forwardCompatibleEnum_<U extends string, E extends U[]>(values: E): Schema<E[number], string>;

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

@@ -0,0 +1,41 @@
+import { SchemaType } from "../../Schema.mjs";
+import { createIdentitySchemaCreator } from "../../utils/createIdentitySchemaCreator.mjs";
+import { getErrorMessageForIncorrectType } from "../../utils/getErrorMessageForIncorrectType.mjs";
+export function enum_(values) {
+    const validValues = new Set(values);
+    const schemaCreator = createIdentitySchemaCreator(SchemaType.ENUM, (value, { allowUnrecognizedEnumValues, breadcrumbsPrefix = [] } = {}) => {
+        if (typeof value !== "string") {
+            return {
+                ok: false,
+                errors: [
+                    {
+                        path: breadcrumbsPrefix,
+                        message: getErrorMessageForIncorrectType(value, "string"),
+                    },
+                ],
+            };
+        }
+        if (!validValues.has(value) && !allowUnrecognizedEnumValues) {
+            return {
+                ok: false,
+                errors: [
+                    {
+                        path: breadcrumbsPrefix,
+                        message: getErrorMessageForIncorrectType(value, "enum"),
+                    },
+                ],
+            };
+        }
+        return {
+            ok: true,
+            value: value,
+        };
+    });
+    return schemaCreator();
+}
+export function forwardCompatibleEnum_(values) {
+    return enum_(values).transform({
+        transform: (val) => val,
+        untransform: (val) => val,
+    });
+}

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

@@ -0,0 +1 @@
+export { enum_, forwardCompatibleEnum_ } from "./enum.mjs";

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

@@ -0,0 +1 @@
+export { enum_, forwardCompatibleEnum_ } from "./enum.mjs";

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

@@ -0,0 +1,14 @@
+export * from "./bigint/index.mjs";
+export * from "./date/index.mjs";
+export * from "./enum/index.mjs";
+export * from "./lazy/index.mjs";
+export * from "./list/index.mjs";
+export * from "./literals/index.mjs";
+export * from "./object/index.mjs";
+export * from "./object-like/index.mjs";
+export * from "./primitives/index.mjs";
+export * from "./record/index.mjs";
+export * from "./schema-utils/index.mjs";
+export * from "./set/index.mjs";
+export * from "./undiscriminated-union/index.mjs";
+export * from "./union/index.mjs";

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

@@ -0,0 +1,14 @@
+export * from "./bigint/index.mjs";
+export * from "./date/index.mjs";
+export * from "./enum/index.mjs";
+export * from "./lazy/index.mjs";
+export * from "./list/index.mjs";
+export * from "./literals/index.mjs";
+export * from "./object/index.mjs";
+export * from "./object-like/index.mjs";
+export * from "./primitives/index.mjs";
+export * from "./record/index.mjs";
+export * from "./schema-utils/index.mjs";
+export * from "./set/index.mjs";
+export * from "./undiscriminated-union/index.mjs";
+export * from "./union/index.mjs";

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

@@ -0,0 +1,3 @@
+export type { SchemaGetter } from "./lazy.mjs";
+export { lazy } from "./lazy.mjs";
+export { lazyObject } from "./lazyObject.mjs";

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

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

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

@@ -0,0 +1,5 @@
+import type { BaseSchema, Schema } from "../../Schema.mjs";
+export type SchemaGetter<SchemaType extends Schema<any, any>> = () => SchemaType;
+export declare function lazy<Raw, Parsed>(getter: SchemaGetter<Schema<Raw, Parsed>>): Schema<Raw, Parsed>;
+export declare function constructLazyBaseSchema<Raw, Parsed>(getter: SchemaGetter<Schema<Raw, Parsed>>): BaseSchema<Raw, Parsed>;
+export declare function getMemoizedSchema<SchemaType extends Schema<any, any>>(getter: SchemaGetter<SchemaType>): SchemaType;

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

@@ -0,0 +1,19 @@
+import { getSchemaUtils } from "../schema-utils/index.mjs";
+export function lazy(getter) {
+    const baseSchema = constructLazyBaseSchema(getter);
+    return Object.assign(Object.assign({}, baseSchema), getSchemaUtils(baseSchema));
+}
+export function constructLazyBaseSchema(getter) {
+    return {
+        parse: (raw, opts) => getMemoizedSchema(getter).parse(raw, opts),
+        json: (parsed, opts) => getMemoizedSchema(getter).json(parsed, opts),
+        getType: () => getMemoizedSchema(getter).getType(),
+    };
+}
+export function getMemoizedSchema(getter) {
+    const castedGetter = getter;
+    if (castedGetter.__zurg_memoized == null) {
+        castedGetter.__zurg_memoized = getter();
+    }
+    return castedGetter.__zurg_memoized;
+}

package/dist/esm/core/schemas/builders/lazy/lazyObject.d.mts

@@ -0,0 +1,3 @@
+import type { ObjectSchema } from "../object/types.mjs";
+import { type SchemaGetter } from "./lazy.mjs";
+export declare function lazyObject<Raw, Parsed>(getter: SchemaGetter<ObjectSchema<Raw, Parsed>>): ObjectSchema<Raw, Parsed>;

package/dist/esm/core/schemas/builders/lazy/lazyObject.mjs

@@ -0,0 +1,8 @@
+import { getObjectUtils } from "../object/index.mjs";
+import { getObjectLikeUtils } from "../object-like/index.mjs";
+import { getSchemaUtils } from "../schema-utils/index.mjs";
+import { constructLazyBaseSchema, getMemoizedSchema } from "./lazy.mjs";
+export function lazyObject(getter) {
+    const baseSchema = Object.assign(Object.assign({}, constructLazyBaseSchema(getter)), { _getRawProperties: () => getMemoizedSchema(getter)._getRawProperties(), _getParsedProperties: () => getMemoizedSchema(getter)._getParsedProperties() });
+    return Object.assign(Object.assign(Object.assign(Object.assign({}, baseSchema), getSchemaUtils(baseSchema)), getObjectLikeUtils(baseSchema)), getObjectUtils(baseSchema));
+}

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

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

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

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

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

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

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

@@ -0,0 +1,46 @@
+import { SchemaType } from "../../Schema.mjs";
+import { getErrorMessageForIncorrectType } from "../../utils/getErrorMessageForIncorrectType.mjs";
+import { maybeSkipValidation } from "../../utils/maybeSkipValidation.mjs";
+import { getSchemaUtils } from "../schema-utils/index.mjs";
+export function list(schema) {
+    const baseSchema = {
+        parse: (raw, opts) => validateAndTransformArray(raw, (item, index) => {
+            var _a;
+            return schema.parse(item, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `[${index}]`] }));
+        }),
+        json: (parsed, opts) => validateAndTransformArray(parsed, (item, index) => {
+            var _a;
+            return schema.json(item, Object.assign(Object.assign({}, opts), { breadcrumbsPrefix: [...((_a = opts === null || opts === void 0 ? void 0 : opts.breadcrumbsPrefix) !== null && _a !== void 0 ? _a : []), `[${index}]`] }));
+        }),
+        getType: () => SchemaType.LIST,
+    };
+    return Object.assign(Object.assign({}, maybeSkipValidation(baseSchema)), getSchemaUtils(baseSchema));
+}
+function validateAndTransformArray(value, transformItem) {
+    if (!Array.isArray(value)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    message: getErrorMessageForIncorrectType(value, "list"),
+                    path: [],
+                },
+            ],
+        };
+    }
+    const result = [];
+    const errors = [];
+    for (let i = 0; i < value.length; i++) {
+        const item = transformItem(value[i], i);
+        if (item.ok) {
+            result.push(item.value);
+        }
+        else {
+            errors.push(...item.errors);
+        }
+    }
+    if (errors.length === 0) {
+        return { ok: true, value: result };
+    }
+    return { ok: false, errors };
+}

package/dist/esm/core/schemas/builders/literals/booleanLiteral.d.mts

@@ -0,0 +1,2 @@
+import { type Schema } from "../../Schema.mjs";
+export declare function booleanLiteral<V extends boolean>(literal: V): Schema<V, V>;

package/dist/esm/core/schemas/builders/literals/booleanLiteral.mjs

@@ -0,0 +1,25 @@
+import { SchemaType } from "../../Schema.mjs";
+import { createIdentitySchemaCreator } from "../../utils/createIdentitySchemaCreator.mjs";
+import { getErrorMessageForIncorrectType } from "../../utils/getErrorMessageForIncorrectType.mjs";
+export function booleanLiteral(literal) {
+    const schemaCreator = createIdentitySchemaCreator(SchemaType.BOOLEAN_LITERAL, (value, { breadcrumbsPrefix = [] } = {}) => {
+        if (value === literal) {
+            return {
+                ok: true,
+                value: literal,
+            };
+        }
+        else {
+            return {
+                ok: false,
+                errors: [
+                    {
+                        path: breadcrumbsPrefix,
+                        message: getErrorMessageForIncorrectType(value, `${literal.toString()}`),
+                    },
+                ],
+            };
+        }
+    });
+    return schemaCreator();
+}

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

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

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

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

package/dist/esm/core/schemas/builders/literals/stringLiteral.d.mts

@@ -0,0 +1,2 @@
+import { type Schema } from "../../Schema.mjs";
+export declare function stringLiteral<V extends string>(literal: V): Schema<V, V>;