@adobe/data 0.4.5 → 0.4.7

package/dist/core/schema/schema.d.ts

@@ -0,0 +1,122 @@
+import { DeepReadonly } from "../../types/types.js";
+type JSONPath = string;
+type JSONMergePatch = unknown;
+/**
+ * Conditional patch applied to the path when the enclosing schema branch is active
+ * and `match` is not present or validates against the root.
+ * This is used for dynamic schemas which change in response to the value of the data.
+ */
+export type Conditional = {
+    match?: Schema;
+    path: JSONPath;
+    value: JSONMergePatch;
+};
+export interface UIProperties {
+    name?: string;
+    icon?: string;
+    summary?: string;
+    premium?: boolean;
+    placeholder?: string;
+    details?: string;
+    visible?: boolean;
+    enabled?: boolean;
+    infoUrl?: string;
+    group?: string;
+    order?: number;
+    groups?: {
+        readonly [key: string]: UIProperties;
+    };
+}
+export interface Schema {
+    type?: 'number' | 'integer' | 'string' | 'boolean' | 'null' | 'array' | 'object';
+    conditionals?: readonly Conditional[];
+    ui?: UIProperties;
+    default?: any;
+    precision?: 1 | 2;
+    multipleOf?: number;
+    mediaType?: string;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    pattern?: string;
+    minItems?: number;
+    maxItems?: number;
+    items?: Schema;
+    properties?: {
+        readonly [key: string]: Schema;
+    };
+    required?: readonly string[];
+    additionalProperties?: boolean | Schema;
+    oneOf?: readonly Schema[];
+    const?: any;
+    enum?: readonly any[];
+}
+export type FromSchema<T, Depth extends number = 5> = DeepReadonly<Depth extends 0 ? any : T extends {
+    const: infer Const;
+} ? Const : T extends {
+    enum: infer Enum;
+} ? Enum extends ReadonlyArray<any> ? Enum[number] : never : T extends {
+    oneOf: infer Schemas;
+} ? Schemas extends ReadonlyArray<Schema> ? FromOneOfSchema<Schemas, Decrement<Depth>> : never : T extends {
+    type: 'number' | 'integer';
+} ? number : T extends {
+    type: 'string';
+} ? string : T extends {
+    type: 'boolean';
+} ? boolean : T extends {
+    type: 'null';
+} ? null : T extends {
+    type: 'array';
+} | {
+    items: any;
+} ? FromSchemaArray<T, Decrement<Depth>> : T extends {
+    type: 'object';
+} | {
+    properties: any;
+} ? FromSchemaObject<T, Decrement<Depth>> : any>;
+type Decrement<N extends number> = ((...x: any[]) => void) extends (arg: any, ...rest: infer R) => void ? R['length'] : never;
+type FromSchemaArray<T, Depth extends number> = T extends {
+    items: infer Items;
+} ? T extends {
+    minItems: infer Min;
+    maxItems: infer Max;
+} ? Equal<Min, Max> extends true ? BuildTuple<FromSchema<Items, Depth>, Min> : FromSchema<Items, Depth>[] : FromSchema<Items, Depth>[] : any[];
+type BuildTuple<T, N, R extends unknown[] = []> = R['length'] extends N ? R : BuildTuple<T, N, [...R, T]>;
+type FromSchemaObject<T extends Schema, Depth extends number> = T extends {
+    properties: infer P;
+} ? Simplify<{
+    [K in RequiredKeys<T>]: FromSchema<P[K], Depth>;
+} & {
+    [K in OptionalKeys<T>]?: FromSchema<P[K], Depth>;
+} & (T extends {
+    additionalProperties: infer AP;
+} ? AP extends false ? {} : AP extends Schema ? {
+    [key: string]: FromSchema<AP, Depth>;
+} : {
+    [key: string]: any;
+} : {
+    [key: string]: any;
+})> : T extends {
+    additionalProperties: infer AP;
+} ? AP extends Schema ? {
+    [key: string]: FromSchema<AP, Depth>;
+} : {
+    [key: string]: any;
+} : {
+    [key: string]: any;
+};
+type RequiredKeys<T> = T extends {
+    required: infer R;
+} ? R extends readonly (infer K)[] ? K extends string ? K : never : never : never;
+type OptionalKeys<T> = T extends {
+    properties: infer P;
+} ? Exclude<keyof P, RequiredKeys<T>> : never;
+type Equal<A, B> = (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2 ? true : false;
+type Simplify<T> = T extends infer O ? {
+    [K in keyof O]: O[K];
+} : never;
+type FromOneOfSchema<Schemas extends ReadonlyArray<Schema>, Depth extends number> = Schemas[number] extends infer S ? S extends Schema ? FromSchema<S, Depth> : never : never;
+export {};

package/dist/core/schema/schema.js

@@ -0,0 +1,34 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+;
+const mySchema = {
+    type: 'object',
+    properties: {
+        a: { type: 'number' },
+        b: { type: 'string' },
+        c: { enum: [1, 2, 3] }
+    },
+    required: ['a', 'c'],
+    additionalProperties: false,
+};
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/core/schema/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/core/schema/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AA6DV,CAAC;AAiIF,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACrB,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;KACvB;IACD,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;IACpB,oBAAoB,EAAE,KAAK;CACF,CAAC"}

package/dist/core/schema/schemas.d.ts

@@ -0,0 +1,45 @@
+import { Schema } from "../index.js";
+export declare function Nullable<T extends Schema>(schema: T): {
+    oneOf: [T, {
+        type: "null";
+    }];
+};
+export declare function Tuple<T extends Schema, N extends number>(items: T, length: N): {
+    readonly type: "array";
+    readonly items: T;
+    readonly minItems: N;
+    readonly maxItems: N;
+};
+export declare const TrueSchema: {
+    readonly const: true;
+};
+export declare const BooleanSchema: {
+    readonly type: "boolean";
+};
+export declare const Float32Schema: {
+    readonly type: "number";
+    readonly precision: 1;
+};
+export declare const Float64Schema: {
+    readonly type: "number";
+    readonly precision: 2;
+};
+export declare const TimeSchema: {
+    readonly type: "number";
+    readonly precision: 2;
+};
+export declare const Uint8Schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 255;
+};
+export declare const Uint16Schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 65535;
+};
+export declare const Uint32Schema: {
+    readonly type: "integer";
+    readonly minimum: 0;
+    readonly maximum: 4294967295;
+};

package/dist/core/schema/schemas.js

@@ -0,0 +1,39 @@
+export function Nullable(schema) {
+    return {
+        oneOf: [schema, { type: "null" }],
+    };
+}
+export function Tuple(items, length) {
+    return { type: "array", items, minItems: length, maxItems: length };
+}
+export const TrueSchema = {
+    const: true,
+};
+export const BooleanSchema = {
+    type: "boolean",
+};
+export const Float32Schema = {
+    type: "number",
+    precision: 1,
+};
+export const Float64Schema = {
+    type: "number",
+    precision: 2,
+};
+export const TimeSchema = Float64Schema;
+export const Uint8Schema = {
+    type: "integer",
+    minimum: 0,
+    maximum: 0xff,
+};
+export const Uint16Schema = {
+    type: "integer",
+    minimum: 0,
+    maximum: 0xffff,
+};
+export const Uint32Schema = {
+    type: "integer",
+    minimum: 0,
+    maximum: 0xffffffff,
+};
+//# sourceMappingURL=schemas.js.map

package/dist/core/schema/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/core/schema/schemas.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,QAAQ,CACtB,MAAS;IAET,OAAO;QACL,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,KAAK,CAAqC,KAAQ,EAAE,MAAS;IAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAA4B,CAAC;AAChG,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,IAAI;CACc,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,SAAS;CACU,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC;CACa,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,CAAC;CACa,CAAC;AAE5B,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,IAAI;CACY,CAAC;AAE5B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,MAAM;CACU,CAAC;AAE5B,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,UAAU;CACM,CAAC"}

package/dist/core/schema/ui-schema.d.ts

@@ -0,0 +1,25 @@
+import { Schema } from "./schema.js";
+export type UIProperties = {
+    name?: string;
+    icon?: string;
+    summary?: string;
+    placeholder?: string;
+    details?: string;
+    visible?: boolean;
+    enabled?: boolean;
+    infoUrl?: string;
+    group?: string;
+    order?: number;
+    groups?: {
+        readonly [key: string]: UIProperties;
+    };
+};
+export type UISchema = Schema & {
+    items?: UISchema;
+    ui?: UIProperties;
+    properties?: {
+        readonly [key: string]: UISchema;
+    };
+    additionalProperties?: boolean | UISchema;
+    oneOf?: readonly UISchema[];
+};

package/dist/core/schema/ui-schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ui-schema.js.map

package/dist/core/schema/ui-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-schema.js","sourceRoot":"","sources":["../../../src/core/schema/ui-schema.ts"],"names":[],"mappings":""}

package/dist/core/schema/validation/is-valid.d.ts

@@ -0,0 +1,2 @@
+import { Schema } from "../schema.js";
+export declare function isValid(schema: Schema, data: any): boolean;

package/dist/core/schema/validation/is-valid.js

@@ -0,0 +1,14 @@
+import { validate } from "./validate.js";
+export function isValid(schema, data) {
+    if (data === undefined) {
+        debugger;
+    }
+    try {
+        return validate(schema, data ?? null).length === 0;
+    }
+    catch (error) {
+        console.error(`Error during validation:`, error);
+        return false;
+    }
+}
+//# sourceMappingURL=is-valid.js.map

package/dist/core/schema/validation/is-valid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid.js","sourceRoot":"","sources":["../../../../src/core/schema/validation/is-valid.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,IAAS;IAC7C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,QAAQ,CAAC;IACb,CAAC;IACD,IAAI,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}

package/dist/core/schema/validation/is-valid.test.d.ts

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

package/dist/{functions/serialization.test.js → core/schema/validation/is-valid.test.js}

@@ -19,26 +19,22 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.*/
-import { serialize, deserialize } from './serialization/serialization.js';
 import { describe, it, expect } from 'vitest';
-describe('serialize/deserialize', () => {
-    it('round-trips objects with typed arrays', () => {
-        const original = {
-            a: 1,
-            b: new Int32Array([1, 2, 3]),
-            nested: {
-                c: 3,
-                d: new Uint32Array([4, 5]),
-            },
-            e: new Float32Array([1.5, 2.5, 3.5]),
-            d: [new Uint32Array([1])],
-            f: new Float64Array([5.5, 6.5, 7.5]),
-        };
-        const payload = serialize(original);
-        expect(payload.json).toBeTypeOf('string');
-        expect(payload.binary).toBeInstanceOf(Array);
-        const roundTrip = deserialize(payload);
-        expect(roundTrip).toEqual(original);
+import { isValid } from './is-valid.js';
+describe('isValid', () => {
+    const schema = {
+        type: 'object',
+        properties: {
+            foo: { type: 'string' }
+        },
+        required: ['foo']
+    };
+    it('returns true for valid data', () => {
+        expect(isValid(schema, { foo: 'bar' })).toBe(true);
+    });
+    it('returns false for invalid data', () => {
+        expect(isValid(schema, { foo: 123 })).toBe(false);
+        expect(isValid(schema, {})).toBe(false);
     });
 });
-//# sourceMappingURL=serialization.test.js.map
+//# sourceMappingURL=is-valid.test.js.map

package/dist/core/schema/validation/is-valid.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-valid.test.js","sourceRoot":"","sources":["../../../../src/core/schema/validation/is-valid.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACrB,MAAM,MAAM,GAAW;QACnB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC1B;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KACpB,CAAC;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/core/schema/validation/validate.d.ts

@@ -0,0 +1,2 @@
+import { Schema } from "../schema.js";
+export declare function validate(schema: Schema, data: any): string[];

package/dist/core/schema/validation/validate.js

@@ -0,0 +1,38 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { Validator } from '@cfworker/json-schema';
+// Cache of validators using WeakMap to avoid memory leaks
+const validatorCache = new WeakMap();
+export function validate(schema, data) {
+    // Get or create validator from cache
+    let validator = validatorCache.get(schema);
+    if (!validator) {
+        validator = new Validator(schema);
+        validatorCache.set(schema, validator);
+    }
+    const result = validator.validate(data);
+    if (result.valid) {
+        return [];
+    }
+    return result.errors.map((error) => error.error);
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/schema/validation/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../../src/core/schema/validation/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,SAAS,EAAwB,MAAM,uBAAuB,CAAC;AAGxE,0DAA0D;AAC1D,MAAM,cAAc,GAAG,IAAI,OAAO,EAAqB,CAAC;AAExD,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,IAAS;IAC9C,qCAAqC;IACrC,IAAI,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,SAAS,GAAG,IAAI,SAAS,CAAC,MAAoB,CAAC,CAAC;QAChD,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC"}

package/dist/core/schema/validation/validate.test.d.ts

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

package/dist/core/schema/validation/validate.test.js

@@ -0,0 +1,106 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { describe, it, expect } from 'vitest';
+import { validate } from './validate.js';
+describe('validate', () => {
+    const userSchema = {
+        type: 'object',
+        properties: {
+            name: { type: 'string' },
+            age: { type: 'number' },
+            email: { type: 'string', pattern: '^[^@]+@[^@]+\\.[^@]+$' }
+        },
+        required: ['name', 'age', 'email']
+    };
+    it('should return empty array for valid data', () => {
+        const validData = {
+            name: 'John Doe',
+            age: 30,
+            email: 'john@example.com'
+        };
+        const errors = validate(userSchema, validData);
+        expect(errors).toEqual([]);
+    });
+    it('should return validation errors for invalid data', () => {
+        const invalidData = {
+            name: 'John Doe',
+            age: '30', // Should be a number
+            email: 'not-an-email'
+        };
+        const errors = validate(userSchema, invalidData);
+        expect(errors.length).toBeGreaterThan(0);
+        expect(errors).toContain('Property "age" does not match schema.');
+        expect(errors).toContain('Instance type "string" is invalid. Expected "number".');
+    });
+    it('should return errors for missing required fields', () => {
+        const incompleteData = {
+            name: 'John Doe'
+            // Missing age and email
+        };
+        const errors = validate(userSchema, incompleteData);
+        expect(errors.length).toBeGreaterThan(0);
+        expect(errors).toContain('Instance does not have required property "age".');
+        expect(errors).toContain('Instance does not have required property "email".');
+    });
+    it('should reuse validator instance for the same schema', () => {
+        const data1 = { name: 'John', age: 30, email: 'john@example.com' };
+        const data2 = { name: 'Jane', age: 25, email: 'jane@example.com' };
+        // First validation
+        const errors1 = validate(userSchema, data1);
+        expect(errors1).toEqual([]);
+        // Second validation with same schema
+        const errors2 = validate(userSchema, data2);
+        expect(errors2).toEqual([]);
+        // The validator should be reused from the WeakMap cache
+        // We can verify this by checking that the schema object is still the same reference
+        expect(userSchema).toBe(userSchema);
+    });
+    it('should handle nested schema validation', () => {
+        const nestedSchema = {
+            type: 'object',
+            properties: {
+                user: userSchema,
+                metadata: {
+                    type: 'object',
+                    properties: {
+                        createdAt: { type: 'string', pattern: '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$' }
+                    },
+                    required: ['createdAt']
+                }
+            },
+            required: ['user', 'metadata']
+        };
+        const validNestedData = {
+            user: {
+                name: 'John Doe',
+                age: 30,
+                email: 'john@example.com'
+            },
+            metadata: {
+                createdAt: '2024-03-20T12:00:00Z'
+            }
+        };
+        const errors = validate(nestedSchema, validNestedData);
+        expect(errors).toEqual([]);
+    });
+});
+//# sourceMappingURL=validate.test.js.map

package/dist/core/schema/validation/validate.test.js.map

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

package/dist/core/schema/validation/with-validation.d.ts

@@ -0,0 +1,5 @@
+import { Schema, FromSchema } from '../index.js';
+/**
+ * Creates a function which can wrap another function and validate the input against a JSON Schema.
+ */
+export declare function withValidation<T extends Schema>(schema: T): <F extends (arg: FromSchema<T>) => any>(fn: F) => F;

package/dist/core/schema/validation/with-validation.js

@@ -0,0 +1,16 @@
+import { validate } from './validate.js';
+/**
+ * Creates a function which can wrap another function and validate the input against a JSON Schema.
+ */
+export function withValidation(schema) {
+    return function (fn) {
+        return function (arg) {
+            const errors = validate(schema, arg);
+            if (errors.length > 0) {
+                throw new Error(`Validation failed: ${JSON.stringify(errors)}`);
+            }
+            return fn.call(this, arg);
+        };
+    };
+}
+//# sourceMappingURL=with-validation.js.map

package/dist/core/schema/validation/with-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-validation.js","sourceRoot":"","sources":["../../../../src/core/schema/validation/with-validation.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAmB,MAAS;IACtD,OAAO,UAAiD,EAAK;QACzD,OAAO,UAAqB,GAAkB;YAC1C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAErC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CACX,sBAAsB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CACjD,CAAC;YACN,CAAC;YAED,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAM,CAAC;IACX,CAAC,CAAC;AACN,CAAC"}

package/dist/core/schema/validation/with-validation.test.d.ts

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

package/dist/core/schema/validation/with-validation.test.js

@@ -0,0 +1,96 @@
+/*MIT License
+
+© Copyright 2025 Adobe. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.*/
+import { describe, it, expect } from 'vitest';
+import { withValidation } from './with-validation.js';
+// Define a test schema
+const userSchema = {
+    type: 'object',
+    properties: {
+        name: { type: 'string' },
+        age: { type: 'number' },
+        foo: { type: 'string' },
+        email: { type: 'string', format: 'email' }
+    },
+    required: ['name', 'age', 'email']
+};
+describe('withValidation', () => {
+    it('should pass validation for valid input', () => {
+        const createUser = withValidation(userSchema)((user) => user);
+        const validUser = {
+            name: 'John Doe',
+            age: 30,
+            email: 'john@example.com'
+        };
+        expect(() => createUser(validUser)).not.toThrow();
+        expect(createUser(validUser)).toEqual(validUser);
+    });
+    it('should throw error for invalid input', () => {
+        const createUser = withValidation(userSchema)((user) => user);
+        const invalidUser = {
+            name: 'John Doe',
+            age: '30', // Should be a number
+            email: 'not-an-email'
+        };
+        expect(() => createUser(invalidUser)).toThrow(/Validation failed/);
+    });
+    it('should throw error for missing required fields', () => {
+        const createUser = withValidation(userSchema)((user) => user);
+        const incompleteUser = {
+            name: 'John Doe',
+            // Missing age and email
+        };
+        expect(() => createUser(incompleteUser)).toThrow(/Validation failed/);
+    });
+    it('should preserve function return type', () => {
+        const processUser = withValidation(userSchema)((user) => ({
+            ...user,
+            processed: true
+        }));
+        const result = processUser({
+            name: 'John Doe',
+            age: 30,
+            email: 'john@example.com'
+        });
+        expect(result).toEqual({
+            name: 'John Doe',
+            age: 30,
+            email: 'john@example.com',
+            processed: true
+        });
+    });
+    it("should pass 'this' context to the wrapped function", () => {
+        const context = { value: 42 };
+        const fn = function (user) {
+            return this.value;
+        };
+        const wrapped = withValidation(userSchema)(fn);
+        const validUser = {
+            name: 'Jane Doe',
+            age: 25,
+            email: 'jane@example.com'
+        };
+        // Bind context and call
+        const result = wrapped.call(context, validUser);
+        expect(result).toBe(42);
+    });
+});
+//# sourceMappingURL=with-validation.test.js.map