@oyinlola141/lattice-schema 0.1.0

package/dist/schemaStructures/schemaArray.core.js

@@ -0,0 +1,105 @@
+/**
+ * @latticejs/schema/structures/array
+ *
+ * Array schema with item validation and length constraints.
+ */
+import { Schema } from "../schemaBase/index.js";
+import { addIssue, childContext } from "../schemaBase/index.js";
+import { SchemaIssueCode } from "@latticejs/constants";
+/**
+ * Schema for array values.
+ */
+export class ArraySchema extends Schema {
+    _type = "array";
+    _config;
+    constructor(config) {
+        super();
+        this._config = config;
+    }
+    _parse(ctx, input) {
+        if (!Array.isArray(input)) {
+            addIssue(ctx, {
+                code: SchemaIssueCode.INVALID_TYPE,
+                path: [...ctx.path],
+                message: `Expected array, received ${typeof input}`,
+                expected: "array",
+                received: typeof input,
+            });
+            throw new Error("Validation failed");
+        }
+        this._validateLength(ctx, input.length);
+        const result = [];
+        let failed = false;
+        for (let i = 0; i < input.length; i++) {
+            const childCtx = childContext(ctx, i);
+            try {
+                result.push(this._config.itemSchema._parse(childCtx, input[i]));
+            }
+            catch {
+                failed = true;
+            }
+        }
+        if (failed) {
+            throw new Error("Validation failed");
+        }
+        return result;
+    }
+    _validateLength(ctx, length) {
+        const c = this._config;
+        let failed = false;
+        if (c.min !== undefined && length < c.min) {
+            addIssue(ctx, {
+                code: SchemaIssueCode.TOO_SMALL,
+                path: [...ctx.path],
+                message: `Array must have at least ${c.min} items`,
+                expected: `>= ${c.min}`,
+                received: String(length),
+            });
+            failed = true;
+        }
+        if (c.max !== undefined && length > c.max) {
+            addIssue(ctx, {
+                code: SchemaIssueCode.TOO_LARGE,
+                path: [...ctx.path],
+                message: `Array must have at most ${c.max} items`,
+                expected: `<= ${c.max}`,
+                received: String(length),
+            });
+            failed = true;
+        }
+        if (c.length !== undefined && length !== c.length) {
+            addIssue(ctx, {
+                code: SchemaIssueCode.INVALID_LENGTH,
+                path: [...ctx.path],
+                message: `Array must have exactly ${c.length} items`,
+                expected: String(c.length),
+                received: String(length),
+            });
+            failed = true;
+        }
+        if (failed) {
+            throw new Error("Validation failed");
+        }
+    }
+    /** Minimum number of items (inclusive). */
+    min(min) {
+        return new ArraySchema({ ...this._config, min });
+    }
+    /** Maximum number of items (inclusive). */
+    max(max) {
+        return new ArraySchema({ ...this._config, max });
+    }
+    /** Exact number of items. */
+    length(length) {
+        return new ArraySchema({ ...this._config, length });
+    }
+    /** Array must have at least one item. */
+    nonempty() {
+        return new ArraySchema({ ...this._config, min: 1 });
+    }
+}
+/** Creates an array schema from an item schema. */
+export function arraySchema(itemSchema) {
+    return new ArraySchema({ itemSchema });
+}
+//# sourceMappingURL=schemaArray.core.js.map

package/dist/schemaStructures/schemaArray.core.js.map

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

package/dist/schemaStructures/schemaMapSet.core.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @oyinlola141/lattice-schema/structures/map-set
+ *
+ * Map and Set schemas.
+ */
+import { Schema } from "../schemaBase/index.js";
+import type { SchemaParseContext } from "../schemaBase/index.js";
+/**
+ * Schema for Map objects.
+ */
+export declare class MapSchema<TKey, TValue> extends Schema<Map<TKey, TValue>> {
+    private readonly _keySchema;
+    private readonly _valueSchema;
+    readonly _type = "map";
+    constructor(_keySchema: Schema<TKey>, _valueSchema: Schema<TValue>);
+    _parse(ctx: SchemaParseContext, input: unknown): Map<TKey, TValue>;
+}
+/**
+ * Schema for Set objects.
+ */
+export declare class SetSchema<TValue> extends Schema<Set<TValue>> {
+    private readonly _valueSchema;
+    readonly _type = "set";
+    constructor(_valueSchema: Schema<TValue>);
+    _parse(ctx: SchemaParseContext, input: unknown): Set<TValue>;
+}
+/** Creates a map schema from key and value schemas. */
+export declare function mapSchema<TKey, TValue>(keySchema: Schema<TKey>, valueSchema: Schema<TValue>): MapSchema<TKey, TValue>;
+/** Creates a set schema from a value schema. */
+export declare function setSchema<TValue>(valueSchema: Schema<TValue>): SetSchema<TValue>;
+//# sourceMappingURL=schemaMapSet.core.d.ts.map

package/dist/schemaStructures/schemaMapSet.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaMapSet.core.d.ts","sourceRoot":"","sources":["../../src/schemaStructures/schemaMapSet.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAIjE;;GAEG;AACH,qBAAa,SAAS,CAAC,IAAI,EAAE,MAAM,CAAE,SAAQ,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAIlE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ/B,SAAgB,KAAK,SAAS;IAE9B,YACmB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,EACxB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAG9C;IAEM,MAAM,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAoBxE;CACF;AAED;;GAEG;AACH,qBAAa,SAAS,CAAC,MAAM,CAAE,SAAQ,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAG5C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAFzC,SAAgB,KAAK,SAAS;IAE9B,YAA6B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAExD;IAEM,MAAM,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAkBlE;CACF;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EACpC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,EACvB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,GAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAEzB;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAEhF"}

package/dist/schemaStructures/schemaMapSet.core.js

@@ -0,0 +1,77 @@
+/**
+ * @latticejs/schema/structures/map-set
+ *
+ * Map and Set schemas.
+ */
+import { Schema } from "../schemaBase/index.js";
+import { addIssue } from "../schemaBase/index.js";
+import { SchemaIssueCode } from "@latticejs/constants";
+/**
+ * Schema for Map objects.
+ */
+export class MapSchema extends Schema {
+    _keySchema;
+    _valueSchema;
+    _type = "map";
+    constructor(_keySchema, _valueSchema) {
+        super();
+        this._keySchema = _keySchema;
+        this._valueSchema = _valueSchema;
+    }
+    _parse(ctx, input) {
+        if (!(input instanceof Map)) {
+            addIssue(ctx, {
+                code: SchemaIssueCode.INVALID_TYPE,
+                path: [...ctx.path],
+                message: `Expected Map, received ${typeof input}`,
+                expected: "Map",
+                received: typeof input,
+            });
+            throw new Error("Validation failed");
+        }
+        const result = new Map();
+        for (const [key, value] of input) {
+            const k = this._keySchema._parse(ctx, key);
+            const v = this._valueSchema._parse(ctx, value);
+            result.set(k, v);
+        }
+        return result;
+    }
+}
+/**
+ * Schema for Set objects.
+ */
+export class SetSchema extends Schema {
+    _valueSchema;
+    _type = "set";
+    constructor(_valueSchema) {
+        super();
+        this._valueSchema = _valueSchema;
+    }
+    _parse(ctx, input) {
+        if (!(input instanceof Set)) {
+            addIssue(ctx, {
+                code: SchemaIssueCode.INVALID_TYPE,
+                path: [...ctx.path],
+                message: `Expected Set, received ${typeof input}`,
+                expected: "Set",
+                received: typeof input,
+            });
+            throw new Error("Validation failed");
+        }
+        const result = new Set();
+        for (const value of input) {
+            result.add(this._valueSchema._parse(ctx, value));
+        }
+        return result;
+    }
+}
+/** Creates a map schema from key and value schemas. */
+export function mapSchema(keySchema, valueSchema) {
+    return new MapSchema(keySchema, valueSchema);
+}
+/** Creates a set schema from a value schema. */
+export function setSchema(valueSchema) {
+    return new SetSchema(valueSchema);
+}
+//# sourceMappingURL=schemaMapSet.core.js.map

package/dist/schemaStructures/schemaMapSet.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaMapSet.core.js","sourceRoot":"","sources":["../../src/schemaStructures/schemaMapSet.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,MAAM,OAAO,SAAwB,SAAQ,MAAyB;IAIjD,UAAU;IACV,YAAY;IAJf,KAAK,GAAG,KAAK,CAAC;IAE9B,YACmB,UAAwB,EACxB,YAA4B;QAE7C,KAAK,EAAE,CAAC;0BAHS,UAAU;4BACV,YAAY;IAG/B,CAAC;IAEM,MAAM,CAAC,GAAuB,EAAE,KAAc;QACnD,IAAI,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,GAAG,EAAE;gBACZ,IAAI,EAAE,eAAe,CAAC,YAAY;gBAClC,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,0BAA0B,OAAO,KAAK,EAAE;gBACjD,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,OAAO,KAAK;aACvB,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgB,CAAC;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,SAAkB,SAAQ,MAAmB;IAG3B,YAAY;IAFzB,KAAK,GAAG,KAAK,CAAC;IAE9B,YAA6B,YAA4B;QACvD,KAAK,EAAE,CAAC;4BADmB,YAAY;IAEzC,CAAC;IAEM,MAAM,CAAC,GAAuB,EAAE,KAAc;QACnD,IAAI,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,GAAG,EAAE;gBACZ,IAAI,EAAE,eAAe,CAAC,YAAY;gBAClC,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,0BAA0B,OAAO,KAAK,EAAE;gBACjD,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,OAAO,KAAK;aACvB,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,uDAAuD;AACvD,MAAM,UAAU,SAAS,CACvB,SAAuB,EACvB,WAA2B;IAE3B,OAAO,IAAI,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,SAAS,CAAS,WAA2B;IAC3D,OAAO,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC"}

package/dist/schemaStructures/schemaObject.core.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @oyinlola141/lattice-schema/structures/object
+ *
+ * Object schema with shape validation, unknown key handling, and composition methods.
+ */
+import { Schema } from "../schemaBase/index.js";
+import type { SchemaParseContext } from "../schemaBase/index.js";
+/** Shape type — record of property names to schemas. */
+export type SchemaShape = Record<string, Schema<unknown>>;
+/** Unknown keys handling strategy. */
+type UnknownKeyStrategy = "strip" | "strict" | "passthrough";
+/** Configuration for object schema. */
+interface ObjectSchemaConfig {
+    readonly shape: SchemaShape;
+    readonly unknownKeys?: UnknownKeyStrategy;
+    readonly requiredKeys?: ReadonlySet<string>;
+}
+/**
+ * Schema for object values with a defined shape.
+ */
+export declare class ObjectSchema<TOutput extends Record<string, unknown>> extends Schema<TOutput> {
+    readonly _type = "object";
+    private readonly _config;
+    private readonly _keys;
+    private readonly _keySet;
+    constructor(config: ObjectSchemaConfig);
+    _parse(ctx: SchemaParseContext, input: unknown): TOutput;
+    private _isOptional;
+    /** Creates a new schema with only the specified keys. */
+    pick<K extends keyof TOutput>(keys: readonly K[]): ObjectSchema<Pick<TOutput, K>>;
+    /** Creates a new schema without the specified keys. */
+    omit<K extends keyof TOutput>(keys: readonly K[]): ObjectSchema<Omit<TOutput, K>>;
+    /** Makes all properties optional. */
+    partial(): ObjectSchema<{
+        [K in keyof TOutput]?: TOutput[K];
+    }>;
+    /** Makes all properties required. */
+    required(): ObjectSchema<{
+        [K in keyof TOutput]-?: TOutput[K];
+    }>;
+    /** Merges another object schema's shape into this one. */
+    extend<TEnd extends Record<string, unknown>>(other: ObjectSchema<TEnd>): ObjectSchema<TOutput & TEnd>;
+    /** Merges two object schemas (last wins on conflicts). */
+    merge<TEnd extends Record<string, unknown>>(other: ObjectSchema<TEnd>): ObjectSchema<TOutput & TEnd>;
+    /** Sets unknown keys strategy to strip. */
+    strip(): ObjectSchema<TOutput>;
+    /** Sets unknown keys strategy to strict (reject unknown). */
+    strict(): ObjectSchema<TOutput>;
+    /** Sets unknown keys strategy to passthrough. */
+    passthrough(): ObjectSchema<TOutput>;
+}
+/**
+ * Wrapper schema that marks an inner schema as optional.
+ */
+export declare class OptionalSchema<T> extends Schema<T | undefined> {
+    readonly _inner: Schema<T>;
+    readonly _type = "optional";
+    constructor(_inner: Schema<T>);
+    _parse(ctx: SchemaParseContext, input: unknown): T | undefined;
+}
+/** Creates an object schema from a shape. */
+export declare function objectSchema<T extends Record<string, Schema<unknown>>>(shape: T): ObjectSchema<{
+    [K in keyof T]: T[K] extends Schema<infer U> ? U : never;
+}>;
+export {};
+//# sourceMappingURL=schemaObject.core.d.ts.map

package/dist/schemaStructures/schemaObject.core.d.ts.map

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

package/dist/schemaStructures/schemaObject.core.js

@@ -0,0 +1,184 @@
+/**
+ * @latticejs/schema/structures/object
+ *
+ * Object schema with shape validation, unknown key handling, and composition methods.
+ */
+import { Schema } from "../schemaBase/index.js";
+import { addIssue, childContext } from "../schemaBase/index.js";
+import { SchemaIssueCode, SCHEMA_FORBIDDEN_KEYS } from "@latticejs/constants";
+/**
+ * Schema for object values with a defined shape.
+ */
+export class ObjectSchema extends Schema {
+    _type = "object";
+    _config;
+    _keys;
+    _keySet;
+    constructor(config) {
+        super();
+        this._config = config;
+        this._keys = Object.keys(config.shape);
+        this._keySet = new Set(this._keys);
+    }
+    _parse(ctx, input) {
+        if (typeof input !== "object" || input === null || Array.isArray(input)) {
+            addIssue(ctx, {
+                code: SchemaIssueCode.INVALID_TYPE,
+                path: [...ctx.path],
+                message: `Expected object, received ${Array.isArray(input) ? "array" : typeof input}`,
+                expected: "object",
+                received: Array.isArray(input) ? "array" : typeof input,
+            });
+            throw new Error("Validation failed");
+        }
+        const obj = input;
+        const result = {};
+        // Check for prototype pollution keys
+        for (const key of Object.keys(obj)) {
+            if (SCHEMA_FORBIDDEN_KEYS.has(key)) {
+                addIssue(ctx, {
+                    code: SchemaIssueCode.INVALID_KEY,
+                    path: [...ctx.path],
+                    message: `Forbidden key: ${key}`,
+                });
+                throw new Error("Validation failed");
+            }
+        }
+        // Validate known properties
+        for (const key of this._keys) {
+            const childCtx = childContext(ctx, key);
+            const schema = this._config.shape[key];
+            if (!schema)
+                continue;
+            const value = obj[key];
+            if (value === undefined) {
+                if (this._config.requiredKeys?.has(key) || !this._isOptional(schema)) {
+                    addIssue(ctx, {
+                        code: SchemaIssueCode.REQUIRED,
+                        path: [...childCtx.path],
+                        message: `Required field missing: ${key}`,
+                    });
+                    if (ctx.options.abortEarly)
+                        break;
+                    continue;
+                }
+                result[key] = undefined;
+                continue;
+            }
+            try {
+                result[key] = schema._parse(childCtx, value);
+            }
+            catch {
+                if (ctx.options.abortEarly)
+                    break;
+            }
+        }
+        // Handle unknown keys
+        if (this._config.unknownKeys !== "passthrough") {
+            const extraKeys = Object.keys(obj).filter((k) => !this._keySet.has(k));
+            if (extraKeys.length > 0 && this._config.unknownKeys === "strict") {
+                for (const key of extraKeys) {
+                    addIssue(ctx, {
+                        code: SchemaIssueCode.UNKNOWN_KEYS,
+                        path: [...ctx.path],
+                        message: `Unknown key: ${key}`,
+                        details: { key },
+                    });
+                }
+                throw new Error("Validation failed");
+            }
+        }
+        return result;
+    }
+    _isOptional(schema) {
+        return schema._type === "optional";
+    }
+    // --- Composition methods ---
+    /** Creates a new schema with only the specified keys. */
+    pick(keys) {
+        const newShape = {};
+        for (const key of keys) {
+            const k = key;
+            if (this._config.shape[k]) {
+                newShape[k] = this._config.shape[k];
+            }
+        }
+        return new ObjectSchema({ shape: newShape, unknownKeys: "strip" });
+    }
+    /** Creates a new schema without the specified keys. */
+    omit(keys) {
+        const newShape = {};
+        for (const key of this._keys) {
+            if (!keys.includes(key) && this._config.shape[key]) {
+                newShape[key] = this._config.shape[key];
+            }
+        }
+        return new ObjectSchema({ shape: newShape, unknownKeys: "strip" });
+    }
+    /** Makes all properties optional. */
+    partial() {
+        const newShape = {};
+        for (const key of this._keys) {
+            const schema = this._config.shape[key];
+            if (schema) {
+                newShape[key] = schema._type === "optional" ? schema : new OptionalSchema(schema);
+            }
+        }
+        return new ObjectSchema({ shape: newShape, unknownKeys: this._config.unknownKeys });
+    }
+    /** Makes all properties required. */
+    required() {
+        const newShape = {};
+        for (const key of this._keys) {
+            const schema = this._config.shape[key];
+            if (!schema)
+                continue;
+            newShape[key] = schema._type === "optional"
+                ? schema._inner
+                : schema;
+        }
+        return new ObjectSchema({ shape: newShape, unknownKeys: this._config.unknownKeys });
+    }
+    /** Merges another object schema's shape into this one. */
+    extend(other) {
+        const newShape = { ...this._config.shape, ...other._config.shape };
+        return new ObjectSchema({ shape: newShape, unknownKeys: this._config.unknownKeys });
+    }
+    /** Merges two object schemas (last wins on conflicts). */
+    merge(other) {
+        return this.extend(other);
+    }
+    /** Sets unknown keys strategy to strip. */
+    strip() {
+        return new ObjectSchema({ ...this._config, unknownKeys: "strip" });
+    }
+    /** Sets unknown keys strategy to strict (reject unknown). */
+    strict() {
+        return new ObjectSchema({ ...this._config, unknownKeys: "strict" });
+    }
+    /** Sets unknown keys strategy to passthrough. */
+    passthrough() {
+        return new ObjectSchema({ ...this._config, unknownKeys: "passthrough" });
+    }
+}
+/**
+ * Wrapper schema that marks an inner schema as optional.
+ */
+export class OptionalSchema extends Schema {
+    _inner;
+    _type = "optional";
+    constructor(_inner) {
+        super();
+        this._inner = _inner;
+    }
+    _parse(ctx, input) {
+        if (input === undefined)
+            return undefined;
+        return this._inner._parse(ctx, input);
+    }
+}
+/** Creates an object schema from a shape. */
+export function objectSchema(shape) {
+    return new ObjectSchema({ shape: shape });
+}
+//# sourceMappingURL=schemaObject.core.js.map

package/dist/schemaStructures/schemaObject.core.js.map

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

package/dist/schemaStructures/schemaRecord.core.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @oyinlola141/lattice-schema/structures/record
+ *
+ * Record schema for objects with constrained keys and values.
+ */
+import { Schema } from "../schemaBase/index.js";
+import type { SchemaParseContext } from "../schemaBase/index.js";
+/**
+ * Schema for record objects with string keys and typed values.
+ */
+export declare class RecordSchema<TValue> extends Schema<Record<string, TValue>> {
+    private readonly _keySchema;
+    private readonly _valueSchema;
+    readonly _type = "record";
+    constructor(_keySchema: Schema<string>, _valueSchema: Schema<TValue>);
+    _parse(ctx: SchemaParseContext, input: unknown): Record<string, TValue>;
+}
+/** Creates a record schema. */
+export declare function recordSchema<TValue>(valueSchema: Schema<TValue>): RecordSchema<TValue>;
+//# sourceMappingURL=schemaRecord.core.d.ts.map

package/dist/schemaStructures/schemaRecord.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaRecord.core.d.ts","sourceRoot":"","sources":["../../src/schemaStructures/schemaRecord.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAKjE;;GAEG;AACH,qBAAa,YAAY,CAAC,MAAM,CAAE,SAAQ,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIpE,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ/B,SAAgB,KAAK,YAAY;IAEjC,YACmB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAG9C;IAEM,MAAM,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2C7E;CACF;AAED,+BAA+B;AAC/B,wBAAgB,YAAY,CAAC,MAAM,EACjC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,GAC1B,YAAY,CAAC,MAAM,CAAC,CAEtB"}

package/dist/schemaStructures/schemaRecord.core.js

@@ -0,0 +1,66 @@
+/**
+ * @latticejs/schema/structures/record
+ *
+ * Record schema for objects with constrained keys and values.
+ */
+import { Schema } from "../schemaBase/index.js";
+import { addIssue, childContext } from "../schemaBase/index.js";
+import { SchemaIssueCode, SCHEMA_FORBIDDEN_KEYS } from "@latticejs/constants";
+import { StringSchema } from "../schemaPrimitives/index.js";
+/**
+ * Schema for record objects with string keys and typed values.
+ */
+export class RecordSchema extends Schema {
+    _keySchema;
+    _valueSchema;
+    _type = "record";
+    constructor(_keySchema, _valueSchema) {
+        super();
+        this._keySchema = _keySchema;
+        this._valueSchema = _valueSchema;
+    }
+    _parse(ctx, input) {
+        if (typeof input !== "object" || input === null || Array.isArray(input)) {
+            addIssue(ctx, {
+                code: SchemaIssueCode.INVALID_TYPE,
+                path: [...ctx.path],
+                message: `Expected record, received ${Array.isArray(input) ? "array" : typeof input}`,
+                expected: "record",
+                received: Array.isArray(input) ? "array" : typeof input,
+            });
+            throw new Error("Validation failed");
+        }
+        const obj = input;
+        const result = {};
+        let failed = false;
+        for (const key of Object.keys(obj)) {
+            if (SCHEMA_FORBIDDEN_KEYS.has(key)) {
+                addIssue(ctx, {
+                    code: SchemaIssueCode.INVALID_KEY,
+                    path: [...ctx.path],
+                    message: `Forbidden key: ${key}`,
+                });
+                failed = true;
+                continue;
+            }
+            const keyCtx = childContext(ctx, key);
+            const valueCtx = childContext(ctx, key);
+            try {
+                this._keySchema._parse(keyCtx, key);
+                result[key] = this._valueSchema._parse(valueCtx, obj[key]);
+            }
+            catch {
+                failed = true;
+            }
+        }
+        if (failed) {
+            throw new Error("Validation failed");
+        }
+        return result;
+    }
+}
+/** Creates a record schema. */
+export function recordSchema(valueSchema) {
+    return new RecordSchema(new StringSchema(), valueSchema);
+}
+//# sourceMappingURL=schemaRecord.core.js.map

package/dist/schemaStructures/schemaRecord.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaRecord.core.js","sourceRoot":"","sources":["../../src/schemaStructures/schemaRecord.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D;;GAEG;AACH,MAAM,OAAO,YAAqB,SAAQ,MAA8B;IAInD,UAAU;IACV,YAAY;IAJf,KAAK,GAAG,QAAQ,CAAC;IAEjC,YACmB,UAA0B,EAC1B,YAA4B;QAE7C,KAAK,EAAE,CAAC;0BAHS,UAAU;4BACV,YAAY;IAG/B,CAAC;IAEM,MAAM,CAAC,GAAuB,EAAE,KAAc;QACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,QAAQ,CAAC,GAAG,EAAE;gBACZ,IAAI,EAAE,eAAe,CAAC,YAAY;gBAClC,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;gBACnB,OAAO,EAAE,6BAA6B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE;gBACrF,QAAQ,EAAE,QAAQ;gBAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK;aACxD,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,MAAM,GAA2B,EAAE,CAAC;QAE1C,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,QAAQ,CAAC,GAAG,EAAE;oBACZ,IAAI,EAAE,eAAe,CAAC,WAAW;oBACjC,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,kBAAkB,GAAG,EAAE;iBACjC,CAAC,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC;gBACd,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAExC,IAAI,CAAC;gBACH,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACpC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,+BAA+B;AAC/B,MAAM,UAAU,YAAY,CAC1B,WAA2B;IAE3B,OAAO,IAAI,YAAY,CAAC,IAAI,YAAY,EAAE,EAAE,WAAW,CAAC,CAAC;AAC3D,CAAC"}

package/dist/schemaStructures/schemaTuple.core.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @oyinlola141/lattice-schema/structures/tuple
+ *
+ * Tuple schema for fixed-length arrays with per-position types.
+ */
+import { Schema } from "../schemaBase/index.js";
+import type { SchemaParseContext } from "../schemaBase/index.js";
+/** Helper type to infer tuple output type. */
+type InferTuple<T extends readonly Schema<unknown>[]> = {
+    [K in keyof T]: T[K] extends Schema<infer U> ? U : never;
+};
+/**
+ * Schema for fixed-length tuples.
+ */
+export declare class TupleSchema<TSchemas extends readonly Schema<unknown>[]> extends Schema<InferTuple<TSchemas>> {
+    private readonly _schemas;
+    readonly _type = "tuple";
+    constructor(_schemas: TSchemas);
+    _parse(ctx: SchemaParseContext, input: unknown): InferTuple<TSchemas>;
+}
+/** Creates a tuple schema from an array of schemas. */
+export declare function tupleSchema<T extends readonly Schema<unknown>[]>(schemas: T): TupleSchema<T>;
+export {};
+//# sourceMappingURL=schemaTuple.core.d.ts.map

package/dist/schemaStructures/schemaTuple.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaTuple.core.d.ts","sourceRoot":"","sources":["../../src/schemaStructures/schemaTuple.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAIjE,8CAA8C;AAC9C,KAAK,UAAU,CAAC,CAAC,SAAS,SAAS,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI;KACrD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CACzD,CAAC;AAEF;;GAEG;AACH,qBAAa,WAAW,CAAC,QAAQ,SAAS,SAAS,MAAM,CAAC,OAAO,CAAC,EAAE,CAAE,SAAQ,MAAM,CAClF,UAAU,CAAC,QAAQ,CAAC,CACrB;IAGa,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,SAAgB,KAAK,WAAW;IAEhC,YAA6B,QAAQ,EAAE,QAAQ,EAE9C;IAEM,MAAM,CAAC,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,CAoC3E;CACF;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,MAAM,CAAC,OAAO,CAAC,EAAE,EAC9D,OAAO,EAAE,CAAC,GACT,WAAW,CAAC,CAAC,CAAC,CAEhB"}