@adobe/data 0.2.1 → 0.2.2

package/dist/cache/functions/hashing/hashing.test.js

@@ -0,0 +1,95 @@
+/*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 { blobToHash } from "./blob-to-hash.js";
+import { jsonToHash } from "./json-to-hash.js";
+import { describe, expect, it } from "vitest";
+describe("test hashing", () => {
+    it("blobToHash should avoid collisions based on content and type", async () => {
+        const blobs = [
+            new Blob([
+                new Uint8Array([
+                    45, 255, 128, 0, 1, 33, 33, 85, 129, 250, 245, 12, 33, 89, 7,
+                ]),
+            ]),
+            new Blob([
+                new Uint8Array([
+                    45, 255, 128, 0, 1, 33, 33, 85, 129, 250, 245, 12, 33, 89, 8,
+                ]),
+            ]),
+            new Blob(["long text sample here"]),
+            new Blob(["long text sample here."]),
+            new Blob(["a"]),
+            new Blob(["b"]),
+            new Blob(["a"], { type: "octet/binary" }),
+            new Blob(["a"], { type: "text/plain" }),
+            //    empty blobs should work
+            new Blob([""]),
+            new Blob([""], { type: "octet/binary" }),
+            new Blob([""], { type: "text/plain" }),
+        ];
+        const hashPromises = blobs.map((blob) => blobToHash(blob));
+        const hashes = await Promise.all(hashPromises);
+        const unique = new Set(hashes);
+        const collisions = hashes.length - unique.size;
+        expect(collisions).toBe(0);
+    });
+    it("blobToHash should generate consistent hashes", async () => {
+        const blobs = [
+            new Blob(["long text sample here"], { type: "text/plain" }),
+            new Blob(["long text sample here"], { type: "text/plain" }),
+            new Blob(["long text sample here"], { type: "text/plain" }),
+        ];
+        const hashPromises = blobs.map((blob) => blobToHash(blob));
+        const hashes = await Promise.all(hashPromises);
+        const unique = new Set(hashes);
+        expect(unique.size).toBe(1);
+    });
+    it("jsonToHash should avoid collisions", async () => {
+        const values = [
+            "foo",
+            { a: 1 },
+            {},
+            [],
+            { a: 2 },
+            null,
+            "",
+            { alpha: "bravo" },
+        ];
+        const hashPromises = values.map((value) => jsonToHash(value));
+        const hashes = await Promise.all(hashPromises);
+        const unique = new Set(hashes);
+        const collisions = hashes.length - unique.size;
+        expect(collisions).toBe(0);
+    });
+    it("jsonToHash should generate consistent hashes", async () => {
+        const values = [
+            { a: 1, b: 2, foo: "bar" },
+            { a: 1, b: 2, foo: "bar" },
+            { a: 1, b: 2, foo: "bar" },
+        ];
+        const hashPromises = values.map((value) => jsonToHash(value));
+        const hashes = await Promise.all(hashPromises);
+        const unique = new Set(hashes);
+        expect(unique.size).toBe(1);
+    });
+});
+//# sourceMappingURL=hashing.test.js.map

package/dist/cache/functions/hashing/hashing.test.js.map

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

package/dist/cache/functions/hashing/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./blob-to-hash.js";
+export * from "./buffer-to-hash.js";
+export * from "./json-to-hash.js";
+export * from "./string-to-hash.js";

package/dist/cache/functions/hashing/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 "./blob-to-hash.js";
+export * from "./buffer-to-hash.js";
+export * from "./json-to-hash.js";
+export * from "./string-to-hash.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/functions/hashing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cache/functions/hashing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC"}

package/dist/cache/functions/hashing/json-to-hash.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Converts a JSON object to a hash using SHA-256.
+ */
+export declare function jsonToHash(value: unknown): Promise<string>;

package/dist/cache/functions/hashing/json-to-hash.js

@@ -0,0 +1,29 @@
+/*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 { stringToHash } from "./string-to-hash.js";
+/**
+ * Converts a JSON object to a hash using SHA-256.
+ */
+export async function jsonToHash(value) {
+    return stringToHash(JSON.stringify(value));
+}
+//# sourceMappingURL=json-to-hash.js.map

package/dist/cache/functions/hashing/json-to-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-to-hash.js","sourceRoot":"","sources":["../../../../src/cache/functions/hashing/json-to-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAc;IAC7C,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/cache/functions/hashing/string-to-hash.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Converts a string to a hash using SHA-256.
+ */
+export declare function stringToHash(value: string): Promise<string>;

package/dist/cache/functions/hashing/string-to-hash.js

@@ -0,0 +1,37 @@
+/*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 { bufferToHash } from "./buffer-to-hash.js";
+function stringToArrayBuffer(value) {
+    const buf = new ArrayBuffer(value.length * 2);
+    const view = new Uint16Array(buf);
+    for (let i = 0, strLen = value.length; i < strLen; i++) {
+        view[i] = value.charCodeAt(i);
+    }
+    return buf;
+}
+/**
+ * Converts a string to a hash using SHA-256.
+ */
+export async function stringToHash(value) {
+    return bufferToHash(stringToArrayBuffer(value));
+}
+//# sourceMappingURL=string-to-hash.js.map

package/dist/cache/functions/hashing/string-to-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-hash.js","sourceRoot":"","sources":["../../../../src/cache/functions/hashing/string-to-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AACX,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa;IAC9C,OAAO,YAAY,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/cache/functions/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./hashing/index.js";
+export * from "./memoize.js";
+export * from "./prevent-parallel-execution.js";
+export * from "./async-data-function.js";
+export * from "./get-cached.js";

package/dist/cache/functions/index.js

@@ -0,0 +1,27 @@
+/*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 "./hashing/index.js";
+export * from "./memoize.js";
+export * from "./prevent-parallel-execution.js";
+export * from "./async-data-function.js";
+export * from "./get-cached.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/functions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC"}

package/dist/cache/functions/memoize.d.ts

@@ -0,0 +1,12 @@
+import { AsyncDataFunction } from "./async-data-function.js";
+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.
+ */
+export declare function memoize<In extends Array<Data>, Out extends Data>(uniqueNameAndVersion: string, fn: AsyncDataFunction<In, Out>): AsyncDataFunction<In, Out>;

package/dist/cache/functions/memoize.js

@@ -0,0 +1,48 @@
+/*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 { preventParallelExecution } from "./prevent-parallel-execution.js";
+import { getDataCache } from "../index.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.
+ */
+export function memoize(uniqueNameAndVersion, fn) {
+    // synchronize the function to prevent executing same requests simultaneously.
+    fn = preventParallelExecution(fn);
+    const cache = getDataCache(uniqueNameAndVersion);
+    const memoized = async (...args) => {
+        const cachedResult = await cache.match(args);
+        if (cachedResult !== undefined) {
+            return cachedResult;
+        }
+        const result = await fn(...args);
+        await cache.put(args, result);
+        return result;
+    };
+    return memoized;
+}
+//# sourceMappingURL=memoize.js.map

package/dist/cache/functions/memoize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.js","sourceRoot":"","sources":["../../../src/cache/functions/memoize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAI3E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CACrB,oBAA4B,EAC5B,EAA8B;IAE9B,8EAA8E;IAC9E,EAAE,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAG,IAAiB,EAAiB,EAAE;QAC7D,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAI,IAAW,CAAC,CAAC;QACzC,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,OAAO,QAAiD,CAAC;AAC3D,CAAC"}

package/dist/cache/functions/omit.d.ts

@@ -0,0 +1 @@
+export declare function omit<T extends object, K extends keyof T>(obj: T, ...keys: K[]): Omit<T, K>;

package/dist/cache/functions/omit.js

@@ -0,0 +1,29 @@
+/*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 omit(obj, ...keys) {
+    const result = { ...obj };
+    for (const key of keys) {
+        delete result[key];
+    }
+    return result;
+}
+//# sourceMappingURL=omit.js.map

package/dist/cache/functions/omit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.js","sourceRoot":"","sources":["../../../src/cache/functions/omit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,MAAM,UAAU,IAAI,CAClB,GAAM,EACN,GAAG,IAAS;IAEZ,MAAM,MAAM,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cache/functions/prevent-parallel-execution.d.ts

@@ -0,0 +1,7 @@
+import { type AsyncDataFunction } from "./async-data-function.js";
+/**
+ * Returns an async function which can NOT be executed simultaneously with the same arguments.
+ * Any attempt to call again while a prior call with same args is executing will return the first promise.
+ * Once a promise completes, then a new call with same args could occur.
+ */
+export declare function preventParallelExecution<In extends Array<unknown>, Out>(fn: AsyncDataFunction<In, Out>): AsyncDataFunction<In, Out>;

package/dist/cache/functions/prevent-parallel-execution.js

@@ -0,0 +1,25 @@
+/**
+ * Returns an async function which can NOT be executed simultaneously with the same arguments.
+ * Any attempt to call again while a prior call with same args is executing will return the first promise.
+ * Once a promise completes, then a new call with same args could occur.
+ */
+export function preventParallelExecution(fn) {
+    const executing = new Map();
+    const synchronized = async (...args) => {
+        const key = JSON.stringify(args);
+        let promise = executing.get(key);
+        if (!promise) {
+            promise = fn(...args);
+            executing.set(key, promise);
+        }
+        try {
+            return await promise;
+        }
+        finally {
+            // we delete the key after execution to prevent memory leak.
+            executing.delete(key);
+        }
+    };
+    return synchronized;
+}
+//# sourceMappingURL=prevent-parallel-execution.js.map

package/dist/cache/functions/prevent-parallel-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prevent-parallel-execution.js","sourceRoot":"","sources":["../../../src/cache/functions/prevent-parallel-execution.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,EAA8B;IAE9B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAClD,MAAM,YAAY,GAAG,KAAK,EAAE,GAAG,IAAiB,EAAgB,EAAE;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,EAAE,CAAC,GAAI,IAAW,CAAC,CAAC;YAC9B,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC;QACvB,CAAC;gBAAS,CAAC;YACT,4DAA4D;YAC5D,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC;IACF,OAAO,YAAqD,CAAC;AAC/D,CAAC"}

package/dist/cache/functions/types.d.ts

@@ -0,0 +1 @@
+export type AsyncDataFunction<InputArgs extends Array<unknown>, Output> = (...args: InputArgs) => Promise<Output>;

package/dist/cache/functions/types.js

@@ -0,0 +1,23 @@
+/*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 {};
+//# sourceMappingURL=types.js.map

package/dist/cache/functions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cache/functions/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW"}

package/dist/cache/get-persistent-cache.d.ts

@@ -0,0 +1,12 @@
+import type { AsyncCache } from "./async-cache.js";
+/**
+ * Gets a managed persistent cache using both fast memory layer and slower storage layer.
+ * @param name The namespace for this persistent cache, used to isolate cache storage.
+ * @param maximumMemoryEntries
+ * @param maximumStorageEntries
+ * @returns
+ */
+export declare function getManagedPersistentCache(name: string, options: {
+    maximumMemoryEntries: number;
+    maximumStorageEntries: number;
+}): Promise<AsyncCache<Request, Response>>;

package/dist/cache/get-persistent-cache.js

@@ -0,0 +1,23 @@
+import { createFallbackAsyncCache } from "./fallback-async-cache.js";
+import { createManagedAsyncCache } from "./managed-async-cache.js";
+import { createMemoryAsyncCache } from "./memory-async-cache.js";
+/**
+ * Gets a persistent async cache.
+ * @param name the namespace name for the cache.
+ */
+async function getUnmanagedPersistentCache(name) {
+    return globalThis.caches.open(name);
+}
+/**
+ * Gets a managed persistent cache using both fast memory layer and slower storage layer.
+ * @param name The namespace for this persistent cache, used to isolate cache storage.
+ * @param maximumMemoryEntries
+ * @param maximumStorageEntries
+ * @returns
+ */
+export async function getManagedPersistentCache(name, options) {
+    const memoryCache = createManagedAsyncCache(createMemoryAsyncCache(), options.maximumMemoryEntries);
+    const storageCache = createManagedAsyncCache(await getUnmanagedPersistentCache(name), options.maximumStorageEntries);
+    return createFallbackAsyncCache(memoryCache, storageCache);
+}
+//# sourceMappingURL=get-persistent-cache.js.map

package/dist/cache/get-persistent-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-persistent-cache.js","sourceRoot":"","sources":["../../src/cache/get-persistent-cache.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;GAGG;AACH,KAAK,UAAU,2BAA2B,CACxC,IAAY;IAEZ,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAEjC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAAY,EACZ,OAGC;IAED,MAAM,WAAW,GAAG,uBAAuB,CACzC,sBAAsB,EAAE,EACxB,OAAO,CAAC,oBAAoB,CAC7B,CAAC;IACF,MAAM,YAAY,GAAG,uBAAuB,CAC1C,MAAM,2BAA2B,CAAC,IAAI,CAAC,EACvC,OAAO,CAAC,qBAAqB,CAC9B,CAAC;IACF,OAAO,wBAAwB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAC7D,CAAC"}

package/dist/cache/index.d.ts

@@ -0,0 +1,3 @@
+export { type BlobStore, type BlobRef, blobStore, isBlobRef, BlobRefSchema, } from "./blob-store.js";
+export { getDataCache, type DataCache } from "./data-cache.js";
+export * from "./functions/index.js";

package/dist/cache/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 { blobStore, isBlobRef, BlobRefSchema, } from "./blob-store.js";
+export { getDataCache } from "./data-cache.js";
+export * from "./functions/index.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;WAoBW;AAEX,OAAO,EAGL,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAkB,MAAM,iBAAiB,CAAC;AAC/D,cAAc,sBAAsB,CAAC"}

package/dist/cache/managed-array.d.ts

@@ -0,0 +1,23 @@
+import { MemoryAllocator } from "./memory-allocator.js";
+import { FromSchema, Schema } from "../schema/index.js";
+import { Data } from "../index.js";
+export interface NativeArray<T> {
+    readonly length: number;
+    [n: number]: T;
+}
+/**
+ * Represents an abstraction over Arrays, numeric TypedArrays and
+ * TypedArrays which contain tightly packed linear memory structures.
+ */
+export interface ManagedArray<T> {
+    get(index: number): T;
+    set(index: number, value: T): void;
+    readonly native?: NativeArray<T>;
+    readonly constant: boolean;
+    ensureCapacity(capacity: number): void;
+    slice(from: number, length: number): Array<T>;
+    move(from: number, to: number): void;
+    toJSON(length: number, allowEncoding?: boolean): Data;
+    fromJSON(data: Data, length: number): void;
+}
+export declare function createManagedArray<S extends Schema>(s: S, allocator: MemoryAllocator): ManagedArray<FromSchema<S>>;