@adobe/data 0.1.2

package/core/functions/deep-merge.d.ts

@@ -0,0 +1,31 @@
+import { type Data } from '../data.js';
+/**
+ * Uses datacache to store results so we can avoid expensive recomputations of the same input.
+ * This function also uses preventParallelExecution to prevent multiple executions of the same function at the same time with the same arguments.
+ * @param fn The function to memoize by storing results in the DataCache.
+ * @param version The version of this function. If the function changes this must also change
+ * to avoid returning stale results from an older version of the function.
+ * @param name The name of this function which should be application unique to avoid hash collisions.
+ * @returns A function with the same signature but memoized results.
+ */
+/**
+ * Recursively merges 2 pieces of `Data`, returns new `Data`.
+ * Inputs are not mutated.
+ *
+ * @param {Data} a First piece of `Data`.
+ * @param {Data} b The second piece of `Data`.
+ * @returns {Object} Returns new `Data`.
+ * @example
+ *
+ * const one = {
+ *   'a': [{ 'b': 2 }, { 'd': 4 }]
+ * };
+ *
+ * const other = {
+ *   'a': [{ 'c': 3 }, { 'e': 5 }]
+ * };
+ *
+ * deepMerge(one, other);
+ * // => { 'a': [{ 'b': 2, 'c': 3 }, { 'd': 4, 'e': 5 }] }
+ */
+export declare const deepMerge: <A extends Data, B extends Data>(a: A, b: B) => A & B;

package/core/functions/deep-merge.js

@@ -0,0 +1,51 @@
+/**
+ * Uses datacache to store results so we can avoid expensive recomputations of the same input.
+ * This function also uses preventParallelExecution to prevent multiple executions of the same function at the same time with the same arguments.
+ * @param fn The function to memoize by storing results in the DataCache.
+ * @param version The version of this function. If the function changes this must also change
+ * to avoid returning stale results from an older version of the function.
+ * @param name The name of this function which should be application unique to avoid hash collisions.
+ * @returns A function with the same signature but memoized results.
+ */
+/**
+ * Recursively merges 2 pieces of `Data`, returns new `Data`.
+ * Inputs are not mutated.
+ *
+ * @param {Data} a First piece of `Data`.
+ * @param {Data} b The second piece of `Data`.
+ * @returns {Object} Returns new `Data`.
+ * @example
+ *
+ * const one = {
+ *   'a': [{ 'b': 2 }, { 'd': 4 }]
+ * };
+ *
+ * const other = {
+ *   'a': [{ 'c': 3 }, { 'e': 5 }]
+ * };
+ *
+ * deepMerge(one, other);
+ * // => { 'a': [{ 'b': 2, 'c': 3 }, { 'd': 4, 'e': 5 }] }
+ */
+export const deepMerge = (a, b) => {
+    // Handle null/undefined cases
+    if (a == null)
+        return b;
+    // Handle primitive values
+    if (typeof a !== 'object' || typeof b !== 'object')
+        return b;
+    // Handle arrays
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return [...a, ...b];
+    }
+    // Handle objects
+    const result = { ...a };
+    for (const key in b) {
+        if (Object.prototype.hasOwnProperty.call(b, key)) {
+            const value = b[key];
+            result[key] = deepMerge(a[key], value);
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=deep-merge.js.map

package/core/functions/deep-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.js","sourceRoot":"","sources":["../../../src/core/functions/deep-merge.ts"],"names":[],"mappings":"AAuBA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAiC,CAAI,EAAE,CAAI,EAAS,EAAE;IAC3E,8BAA8B;IAC9B,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,CAAU,CAAC;IAEjC,0BAA0B;IAC1B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAU,CAAC;IAEtE,gBAAgB;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAqB,CAAC;IAC1C,CAAC;IAED,iBAAiB;IACjB,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,EAA0B,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;QACpB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,GAAI,CAA0B,CAAC,GAAG,CAAC,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAE,CAA0B,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IACD,OAAO,MAAe,CAAC;AACzB,CAAC,CAAC"}

package/core/functions/deep-merge.test.d.ts

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

package/core/functions/deep-merge.test.js

@@ -0,0 +1,94 @@
+/*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 { deepMerge } from './deep-merge.js';
+import { assert } from 'riteway/vitest';
+import { describe, test } from 'vitest';
+describe('deepMerge', () => {
+    test('should merge two objects', () => {
+        const a = { a: 1, b: 2 };
+        const b = { c: 3, d: 4 };
+        assert({
+            given: 'two objects without overlapping keys',
+            should: 'merge them',
+            actual: deepMerge(a, b),
+            expected: { a: 1, b: 2, c: 3, d: 4 },
+        });
+    });
+    test('should merge two objects with overlapping keys', () => {
+        const a = { a: 1, b: 2 };
+        const b = { b: 3, c: 4 };
+        assert({
+            given: 'two objects with overlapping keys',
+            should: 'merge them',
+            actual: deepMerge(a, b),
+            expected: { a: 1, b: 3, c: 4 },
+        });
+    });
+    test('should merge two objects with overlapping keys and arrays', () => {
+        const a = { a: 1, b: [1, 2] };
+        const b = { b: [3, 4], c: 4 };
+        assert({
+            given: 'two objects with overlapping keys and arrays',
+            should: 'merge them',
+            actual: deepMerge(a, b),
+            expected: { a: 1, b: [1, 2, 3, 4], c: 4 },
+        });
+    });
+    test('should merge two nested objects with overlapping keys', () => {
+        const a = { a: 1, b: { c: 2, d: 3 } };
+        const b = { b: { d: 4, e: 5 }, c: 6 };
+        assert({
+            given: 'two nested objects with overlapping keys',
+            should: 'merge them',
+            actual: deepMerge(a, b),
+            expected: { a: 1, b: { c: 2, d: 4, e: 5 }, c: 6 },
+        });
+    });
+    test('should merge two objects with null values', () => {
+        const a = { a: null, b: 2 };
+        const b = { b: null, c: 4 };
+        assert({
+            given: 'two objects with null values',
+            should: 'merge them',
+            actual: deepMerge(a, b),
+            expected: { a: null, b: null, c: 4 },
+        });
+    });
+    test('should merge two objects with undefined values', () => {
+        const a = { a: undefined, b: 2 };
+        const b = { b: undefined, c: 4 };
+        assert({
+            given: 'two objects with undefined values',
+            should: 'merge them',
+            actual: deepMerge(a, b),
+            expected: { a: undefined, b: undefined, c: 4 },
+        });
+    });
+    test('should not mutate the original objects', () => {
+        const a = { a: 1, b: 2 };
+        const b = { b: 3, c: 4 };
+        deepMerge(a, b);
+        assert({ given: 'the original objects', should: 'not be mutated', actual: a, expected: { a: 1, b: 2 } });
+        assert({ given: 'the original objects', should: 'not be mutated', actual: b, expected: { b: 3, c: 4 } });
+    });
+});
+//# sourceMappingURL=deep-merge.test.js.map

package/core/functions/deep-merge.test.js.map

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

package/core/functions/index.d.ts

@@ -0,0 +1,4 @@
+export * from './array-equals.js';
+export * from './is-async-generator.js';
+export * from './deep-merge.js';
+export * from './with-validation.js';

package/core/functions/index.js

@@ -0,0 +1,26 @@
+/*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.*/
+export * from './array-equals.js';
+export * from './is-async-generator.js';
+export * from './deep-merge.js';
+export * from './with-validation.js';
+//# sourceMappingURL=index.js.map

package/core/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/functions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA"}

package/core/functions/is-async-generator.d.ts

@@ -0,0 +1 @@
+export declare function isAsyncGenerator<T>(value: any): value is AsyncGenerator<T>;

package/core/functions/is-async-generator.js

@@ -0,0 +1,25 @@
+/*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.*/
+export function isAsyncGenerator(value) {
+    return value && typeof value[Symbol.asyncIterator] === 'function';
+}
+//# sourceMappingURL=is-async-generator.js.map

package/core/functions/is-async-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-async-generator.js","sourceRoot":"","sources":["../../../src/core/functions/is-async-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,MAAM,UAAU,gBAAgB,CAAI,KAAU;IAC1C,OAAO,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,UAAU,CAAC;AACtE,CAAC"}

package/core/functions/is-promise.d.ts

@@ -0,0 +1 @@
+export declare function isPromise<T = unknown>(obj: unknown): obj is Promise<T>;

package/core/functions/is-promise.js

@@ -0,0 +1,26 @@
+/*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.*/
+export function isPromise(obj) {
+    const maybePromise = obj;
+    return (!!maybePromise && (typeof maybePromise === 'object' || typeof maybePromise === 'function') && typeof maybePromise?.then === 'function');
+}
+//# sourceMappingURL=is-promise.js.map

package/core/functions/is-promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-promise.js","sourceRoot":"","sources":["../../../src/core/functions/is-promise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,MAAM,UAAU,SAAS,CAAc,GAAY;IAC/C,MAAM,YAAY,GAAG,GAAsC,CAAC;IAC5D,OAAO,CACH,CAAC,CAAC,YAAY,IAAI,CAAC,OAAO,YAAY,KAAK,QAAQ,IAAI,OAAO,YAAY,KAAK,UAAU,CAAC,IAAI,OAAO,YAAY,EAAE,IAAI,KAAK,UAAU,CACzI,CAAC;AACN,CAAC"}

package/core/functions/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/core/functions/with-validation.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';
+/**
+ * Creates a function which can wrap another function and validate the input against a JSON Schema.
+ */
+export function withValidation(schema) {
+    const validator = new Validator(schema);
+    return function (fn) {
+        return function (arg) {
+            const validation = validator.validate(arg);
+            if (!validation.valid) {
+                throw new Error(`Validation failed: ${JSON.stringify(validation.errors)}`);
+            }
+            return fn.call(this, arg);
+        };
+    };
+}
+//# sourceMappingURL=with-validation.js.map

package/core/functions/with-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-validation.js","sourceRoot":"","sources":["../../../src/core/functions/with-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,SAAS,EAAwB,MAAM,uBAAuB,CAAC;AAGxE;;GAEG;AACH,MAAM,UAAU,cAAc,CAAmB,MAAS;IACtD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,MAAoB,CAAC,CAAC;IAEtD,OAAO,UAAiD,EAAK;QACzD,OAAO,UAAqB,GAAkB;YAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAE3C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CACX,sBAAsB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAC5D,CAAC;YACN,CAAC;YAED,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAM,CAAC;IACX,CAAC,CAAC;AACN,CAAC"}

package/core/functions/with-validation.test.d.ts

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

package/core/functions/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

package/core/functions/with-validation.test.js.map

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

package/core/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./data.js";
+export * from "./schema.js";
+export * from "./functions/index.js";

package/core/index.js

@@ -0,0 +1,25 @@
+/*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.*/
+export * from "./data.js";
+export * from "./schema.js";
+export * from "./functions/index.js";
+//# sourceMappingURL=index.js.map

package/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAA"}

package/core/schema.d.ts

@@ -0,0 +1,86 @@
+import { DeepReadonly } from "../types/types.js";
+export type Schema = {
+    type?: 'number' | 'integer' | 'string' | 'boolean' | 'null' | 'array' | 'object';
+    minimum?: number;
+    precision?: 1 | 2;
+    default?: any;
+    maximum?: 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/core/schema.js

@@ -0,0 +1,33 @@
+/*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/core/schema.js.map

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

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

package/core/schema.test.js

@@ -0,0 +1,16 @@
+import { describe, it } from "vitest";
+describe("Schema", () => {
+    it("should provide compile time and runtime type validation", () => {
+        const mySchema = {
+            type: "object",
+            required: ["name", "aspect"],
+            properties: {
+                name: { type: "string" },
+                age: { type: "integer", minimum: 0 },
+                aspect: { enum: ["landscape", "portrait"] },
+            },
+            additionalProperties: false,
+        };
+    });
+});
+//# sourceMappingURL=schema.test.js.map

package/core/schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.test.js","sourceRoot":"","sources":["../../src/core/schema.test.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEtC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;YAC5B,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACxB,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;gBACpC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE;aAC5C;YACD,oBAAoB,EAAE,KAAK;SACF,CAAC;IAiB9B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}