@adobe/data 0.9.54 → 0.9.56

package/dist/cache/blob-store.browser.test.d.ts

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

package/dist/cache/blob-store.browser.test.js

@@ -0,0 +1,122 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { createBlobStore } from "./blob-store.js";
+describe("blobStore", () => {
+    // Mock URL.createObjectURL and URL.revokeObjectURL
+    const mockCreateObjectURL = vi.fn((blob) => `blob:${Math.random()}`);
+    const mockRevokeObjectURL = vi.fn();
+    let testBlobStore;
+    let createdUrl;
+    beforeEach(async () => {
+        // Setup URL mock functions
+        const originalCreateObjectURL = URL.createObjectURL;
+        const originalRevokeObjectURL = URL.revokeObjectURL;
+        // Ensure we create a non-http URL
+        mockCreateObjectURL.mockImplementation((blob) => {
+            createdUrl = `blob:${Math.random()}`;
+            return createdUrl;
+        });
+        URL.createObjectURL = mockCreateObjectURL;
+        URL.revokeObjectURL = mockRevokeObjectURL;
+        // Clear mock call history
+        mockCreateObjectURL.mockClear();
+        mockRevokeObjectURL.mockClear();
+        testBlobStore = await createBlobStore();
+        return () => {
+            URL.createObjectURL = originalCreateObjectURL;
+            URL.revokeObjectURL = originalRevokeObjectURL;
+        };
+    });
+    afterEach(() => {
+        // Clean up any remaining borrowed URLs
+        mockCreateObjectURL.mockReset();
+        mockRevokeObjectURL.mockReset();
+    });
+    describe("URL reference counting", () => {
+        it("should reuse the same URL for multiple borrows of the same blob", async () => {
+            // Create a test blob
+            const testBlob = new Blob(["test"], { type: "text/plain" });
+            const blobRef = await testBlobStore.getRef(testBlob);
+            // Borrow the URL multiple times
+            const url1 = await testBlobStore.borrowUrl(blobRef);
+            const url2 = await testBlobStore.borrowUrl(blobRef);
+            const url3 = await testBlobStore.borrowUrl(blobRef);
+            expect(url1).toBeTruthy();
+            expect(url1).toBe(url2);
+            expect(url2).toBe(url3);
+            expect(url1).toMatch(/^blob:/); // Verify it's a blob URL
+            // createObjectURL should only be called once
+            expect(mockCreateObjectURL).toHaveBeenCalledTimes(1);
+            // Clean up
+            testBlobStore.returnUrl(url1);
+            testBlobStore.returnUrl(url2);
+            testBlobStore.returnUrl(url3);
+        });
+        it("should only revoke URL when all references are returned", async () => {
+            const testBlob = new Blob(["test"], { type: "text/plain" });
+            const blobRef = await testBlobStore.getRef(testBlob);
+            // Borrow the URL three times
+            const url1 = await testBlobStore.borrowUrl(blobRef);
+            const url2 = await testBlobStore.borrowUrl(blobRef);
+            const url3 = await testBlobStore.borrowUrl(blobRef);
+            expect(url1).toMatch(/^blob:/); // Verify it's a blob URL
+            // Return URLs one by one
+            testBlobStore.returnUrl(url1);
+            expect(mockRevokeObjectURL).not.toHaveBeenCalled();
+            testBlobStore.returnUrl(url2);
+            expect(mockRevokeObjectURL).not.toHaveBeenCalled();
+            testBlobStore.returnUrl(url3);
+            expect(mockRevokeObjectURL).toHaveBeenCalledTimes(1);
+            expect(mockRevokeObjectURL).toHaveBeenCalledWith(createdUrl);
+        });
+        it("should handle remote URLs correctly", async () => {
+            const remoteRef = testBlobStore.createRemoteBlobRef("http://example.com/image.jpg");
+            // Borrow remote URL multiple times
+            const url1 = await testBlobStore.borrowUrl(remoteRef);
+            const url2 = await testBlobStore.borrowUrl(remoteRef);
+            expect(url1).toBe("http://example.com/image.jpg");
+            expect(url2).toBe("http://example.com/image.jpg");
+            expect(mockCreateObjectURL).not.toHaveBeenCalled();
+            // Return URLs
+            testBlobStore.returnUrl(url1);
+            testBlobStore.returnUrl(url2);
+            // Should not revoke remote URLs
+            expect(mockRevokeObjectURL).not.toHaveBeenCalled();
+        });
+        it("should handle null inputs gracefully", async () => {
+            const nullUrl = await testBlobStore.borrowUrl(null);
+            expect(nullUrl).toBeNull();
+            // Should not throw when returning null
+            expect(() => testBlobStore.returnUrl(null)).not.toThrow();
+        });
+        it('demonstrates race condition in borrowUrl', async () => {
+            const store = testBlobStore;
+            const testBlob = new Blob(['test data'], { type: 'text/plain' });
+            const blobRef = await store.getRef(testBlob);
+            // Create an artificially delayed getBlob to simulate network latency
+            const originalGetBlob = store.getBlob;
+            store.getBlob = async (ref) => {
+                await new Promise(resolve => setTimeout(resolve, 50)); // Add delay
+                return originalGetBlob(ref);
+            };
+            // Make two parallel borrowUrl calls
+            const [url1, url2] = await Promise.all([
+                store.borrowUrl(blobRef),
+                store.borrowUrl(blobRef)
+            ]);
+            expect(url1).toBe(url2); // Same URL should be returned
+            // Return one of the URLs
+            store.returnUrl(url1);
+            // Verify that the borrow count is still 1 since we borrowed twice and returned once
+            expect(store._testGetBorrowCount(blobRef)).toBe(1);
+            // Return the second URL
+            store.returnUrl(url2);
+            // Verify the borrow count is now 0
+            expect(store._testGetBorrowCount(blobRef)).toBe(0);
+            // Verify the URL was revoked
+            expect(mockRevokeObjectURL).toHaveBeenCalledTimes(1);
+            expect(mockRevokeObjectURL).toHaveBeenCalledWith(url1);
+        });
+    });
+});
+//# sourceMappingURL=blob-store.browser.test.js.map

package/dist/cache/blob-store.browser.test.js.map

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

package/dist/cache/data-cache.browser.test.d.ts

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

package/dist/cache/data-cache.browser.test.js

@@ -0,0 +1,41 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { dataCache, getDataCache } from "./data-cache.js";
+import { beforeAll, describe, expect, it } from "vitest";
+describe("DataCache", () => {
+    beforeAll(() => { });
+    it("dataCache is not a top-level await", () => {
+        expect(typeof dataCache.then === "undefined");
+    });
+    it("dataCache is lazily initialized and supports put/match/delete directly", async () => {
+        const key = { test: "lazy-init", n: Date.now() };
+        const value = { hello: "world" };
+        await dataCache.put(key, value);
+        expect(await dataCache.match(key)).toEqual(value);
+        await dataCache.delete(key);
+        expect(await dataCache.match(key)).toBeUndefined();
+    });
+    it("should allow storing and retrieving values in namespaced/versioned caches", async () => {
+        //  get a namespaced cache
+        const cache = await getDataCache("test:v1");
+        //  create some keys and values to store
+        const key = { foo: 1, bar: [{ baz: 12 }] };
+        const valueIn = { alpha: "bet", bar: ["a", "b"] };
+        //  store a key/value pair
+        await cache.put(key, valueIn);
+        //  retrieve the value
+        const valueOut = await cache.match(key);
+        //  output is NOT identical
+        expect(valueOut !== valueIn).toBe(true);
+        //  output IS structurally equal
+        expect(valueOut).toEqual(valueIn);
+        //  output from structurally equivalent key is the same
+        expect(await cache.match(JSON.parse(JSON.stringify(key)))).toEqual(valueIn);
+        //  output from equivalent cache (constructed with same name/version) is the same.
+        expect(await (await getDataCache("test:v1")).match(key)).toEqual(valueIn);
+        //  output from different named cache is undefined
+        expect(await (await getDataCache("test2:v1")).match(key)).toEqual(undefined);
+        //  output from different cache version is undefined
+        expect(await (await getDataCache("test:v2")).match(key)).toEqual(undefined);
+    });
+});
+//# sourceMappingURL=data-cache.browser.test.js.map

package/dist/cache/data-cache.browser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-cache.browser.test.js","sourceRoot":"","sources":["../../src/cache/data-cache.browser.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEzD,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,SAAS,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpB,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,OAAQ,SAAiB,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAEjC,MAAM,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAElD,MAAM,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,0BAA0B;QAC1B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;QAE5C,wCAAwC;QACxC,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAElD,0BAA0B;QAC1B,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE9B,sBAAsB;QACtB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAExC,2BAA2B;QAC3B,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAExC,gCAAgC;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAElC,uDAAuD;QACvD,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE5E,kFAAkF;QAClF,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE1E,kDAAkD;QAClD,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAC/D,SAAS,CACV,CAAC;QAEF,oDAAoD;QACpD,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cache/expiring-data-cache.browser.test.d.ts

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

package/dist/cache/expiring-data-cache.browser.test.js

@@ -0,0 +1,42 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { createExpiringDataCache } from "./expiring-data-cache.js"; // Adjust the import path as necessary
+import { describe, expect, it } from "vitest";
+import { createDataCache } from "./data-cache.js";
+import { getManagedPersistentCache } from "./get-persistent-cache.js";
+describe("ExpiringDataCache", () => {
+    it("should store and retrieve an item before it expires", async () => {
+        const time = Date.now();
+        let timePassed = 0;
+        const getTime = () => time + timePassed;
+        const cache = createExpiringDataCache(createDataCache(await getManagedPersistentCache("expiring-data-cache-test", {
+            maximumMemoryEntries: 10,
+            maximumStorageEntries: 100,
+        })), getTime);
+        cache.put("key1", "value1", { maximumDuration: 1000 }); // Expires in 1000ms
+        expect(await cache.match("key1")).toBe("value1");
+        timePassed = 500;
+        expect(await cache.match("key1")).toBe("value1");
+        timePassed = 999;
+        expect(await cache.match("key1")).toBe("value1");
+        timePassed = 1000;
+        expect(await cache.match("key1")).toBeUndefined();
+        timePassed = 1001;
+        expect(await cache.match("key1")).toBeUndefined();
+        timePassed = 2000;
+        expect(await cache.match("key1")).toBeUndefined();
+    });
+    it("should immediately expire items when maximumDuration is 0", async () => {
+        const time = Date.now();
+        let timePassed = 0;
+        const getTime = () => time + timePassed;
+        const cache = createExpiringDataCache(createDataCache(await getManagedPersistentCache("expiring-data-cache-test", {
+            maximumMemoryEntries: 10,
+            maximumStorageEntries: 100,
+        })), getTime);
+        cache.put("key1", "value1", { maximumDuration: 0 }); // Expires immediately
+        expect(await cache.match("key1")).toBeUndefined();
+        timePassed = 1000;
+        expect(await cache.match("key1")).toBeUndefined();
+    });
+});
+//# sourceMappingURL=expiring-data-cache.browser.test.js.map

package/dist/cache/expiring-data-cache.browser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expiring-data-cache.browser.test.js","sourceRoot":"","sources":["../../src/cache/expiring-data-cache.browser.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC,CAAC,sCAAsC;AAC1G,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,GAAG,UAAU,CAAC;QACxC,MAAM,KAAK,GAAG,uBAAuB,CACnC,eAAe,CACb,MAAM,yBAAyB,CAAC,0BAA0B,EAAE;YAC1D,oBAAoB,EAAE,EAAE;YACxB,qBAAqB,EAAE,GAAG;SAC3B,CAAC,CACH,EACD,OAAO,CACR,CAAC;QAEF,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,oBAAoB;QAC5E,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEjD,UAAU,GAAG,GAAG,CAAC;QACjB,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEjD,UAAU,GAAG,GAAG,CAAC;QACjB,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEjD,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAElD,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAElD,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,GAAG,UAAU,CAAC;QACxC,MAAM,KAAK,GAAG,uBAAuB,CACnC,eAAe,CACb,MAAM,yBAAyB,CAAC,0BAA0B,EAAE;YAC1D,oBAAoB,EAAE,EAAE;YACxB,qBAAqB,EAAE,GAAG;SAC3B,CAAC,CACH,EACD,OAAO,CACR,CAAC;QAEF,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,sBAAsB;QAC3E,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAElD,UAAU,GAAG,IAAI,CAAC;QAClB,MAAM,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cache/functions/functions.browser.test.d.ts

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

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

@@ -0,0 +1,72 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { memoize } from "./memoize.js";
+import { preventParallelExecution } from "./prevent-parallel-execution.js";
+import { describe, expect, it } from "vitest";
+describe("Function", () => {
+    describe("prevent parallel execution", () => {
+        it("should block parallel execution and return same promise", async () => {
+            let addCallCount = 0;
+            async function add(a, b) {
+                addCallCount++;
+                return new Promise((resolve) => {
+                    setTimeout(() => {
+                        resolve(a + b);
+                    }, 100);
+                });
+            }
+            async function testAddBlocksParallelExecution(addFn) {
+                addCallCount = 0;
+                const promises = [addFn(1, 2), addFn(1, 2), addFn(1, 2)];
+                const results = await Promise.all(promises);
+                expect(results).toEqual([3, 3, 3]);
+            }
+            const addFn = preventParallelExecution(add);
+            await testAddBlocksParallelExecution(addFn);
+            // after all have completed... then another can execute
+            addCallCount = 0;
+            expect(await addFn(1, 2)).toEqual(3);
+            expect(addCallCount).toEqual(1);
+        });
+    });
+    describe("memoize", () => {
+        it("should block parallel execution and return same promise", async () => {
+            let addCallCount = 0;
+            async function add(a, b) {
+                addCallCount++;
+                return new Promise((resolve) => {
+                    setTimeout(() => {
+                        resolve(a + b);
+                    }, 100);
+                });
+            }
+            async function testAddBlocksParallelExecution(addFn) {
+                addCallCount = 0;
+                const promises = [addFn(1, 2), addFn(1, 2), addFn(1, 2)];
+                const results = await Promise.all(promises);
+                expect(results).toEqual([3, 3, 3]);
+            }
+            //  now memoize the addFn and verify that it is cached.
+            const addFn = memoize("addFn-v1", add);
+            await testAddBlocksParallelExecution(addFn);
+            // after all have completed... then another can execute
+            addCallCount = 0;
+            expect(await addFn(1, 2)).toEqual(3);
+            // with memoize, the count should be 0 because we get a cached result.
+            expect(addCallCount).toEqual(0);
+        });
+        it("should reuse cached result for repeated object references", () => {
+            let callCount = 0;
+            const multiply = memoize(({ value }) => {
+                callCount++;
+                return value * 2;
+            });
+            const input = { value: 2 };
+            expect(multiply(input)).toEqual(4);
+            expect(multiply(input)).toEqual(4);
+            expect(callCount).toEqual(1);
+            expect(multiply({ value: 2 })).toEqual(4);
+            expect(callCount).toEqual(2);
+        });
+    });
+});
+//# sourceMappingURL=functions.browser.test.js.map

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

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

package/dist/data.d.ts

@@ -6,6 +6,6 @@
  * It also allows us to strongly define contracts between our application and external services.
  * Validation of input arguments and output results allows strict enforcement of agreed upon contracts.
  */
-export type Data = string | number | boolean | null | undefined | ReadonlyArray<Data> | {
+export type Data = string | number | boolean | null | ReadonlyArray<Data> | {
     readonly [K in string]?: Data;
 } | Blob;

package/dist/ecs/database/public/create-database-scheduler.browser.test.d.ts

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

package/dist/ecs/database/public/create-database-scheduler.browser.test.js

@@ -0,0 +1,67 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { Database } from "../database.js";
+import { scheduler } from "../../plugins/scheduler/scheduler.js";
+describe("createDatabase with scheduler plugin extension", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("should have all systems in functions when scheduler executes", async () => {
+        // This test reproduces the bug: when a plugin extends scheduler,
+        // the scheduler's executeFrame is called immediately during system creation,
+        // but db.system.functions is still empty at that point because it's only
+        // populated after all systems are created. This causes the error:
+        // "db.system.functions[name] is not a function"
+        const basePlugin = scheduler;
+        const extendedPlugin = Database.Plugin.create({
+            extends: basePlugin,
+            transactions: {
+                stopScheduler(store) {
+                    store.resources.schedulerState = "disposed";
+                }
+            },
+            systems: {
+                testSystem: {
+                    create: (db) => () => {
+                        // Test system
+                    }
+                }
+            },
+        });
+        // The bug: Database.create should not throw even though scheduler
+        // executeFrame is called during system initialization
+        const db = Database.create(extendedPlugin);
+        // Verify all systems are in functions (this should pass after fix)
+        const allSystemNames = new Set();
+        for (const tier of db.system.order) {
+            for (const name of tier) {
+                allSystemNames.add(name);
+            }
+        }
+        // Check that all systems in order exist in functions
+        for (const name of allSystemNames) {
+            expect(db.system.functions[name]).toBeDefined();
+            expect(typeof db.system.functions[name]).toBe("function");
+        }
+        // Also verify the reverse: all functions are in the order
+        const functionNames = new Set(Object.keys(db.system.functions));
+        const orderNames = new Set();
+        for (const tier of db.system.order) {
+            for (const name of tier) {
+                orderNames.add(name);
+            }
+        }
+        // All functions should be in order
+        for (const name of functionNames) {
+            expect(orderNames.has(name)).toBe(true);
+        }
+        // Stop the scheduler
+        db.transactions.stopScheduler();
+        // Advance timers to let any pending RAF callbacks execute
+        await vi.runAllTimersAsync();
+    });
+});
+//# sourceMappingURL=create-database-scheduler.browser.test.js.map

package/dist/ecs/database/public/create-database-scheduler.browser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-database-scheduler.browser.test.js","sourceRoot":"","sources":["../../../../src/ecs/database/public/create-database-scheduler.browser.test.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEjE,QAAQ,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC5D,UAAU,CAAC,GAAG,EAAE;QACZ,EAAE,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACX,EAAE,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC1E,iEAAiE;QACjE,6EAA6E;QAC7E,yEAAyE;QACzE,kEAAkE;QAClE,gDAAgD;QAEhD,MAAM,UAAU,GAAG,SAAS,CAAC;QAE7B,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;YAC1C,OAAO,EAAE,UAAU;YACnB,YAAY,EAAE;gBACV,aAAa,CAAC,KAAK;oBACf,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,UAAU,CAAC;gBAChD,CAAC;aACJ;YACD,OAAO,EAAE;gBACL,UAAU,EAAE;oBACR,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE;wBACjB,cAAc;oBAClB,CAAC;iBACJ;aACJ;SACJ,CAAC,CAAC;QAEH,kEAAkE;QAClE,sDAAsD;QACtD,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAE3C,mEAAmE;QACnE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;gBACtB,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAChC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAwC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACpF,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAwC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClG,CAAC;QAED,0DAA0D;QAC1D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;gBACtB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;QACL,CAAC;QAED,mCAAmC;QACnC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YAC/B,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,qBAAqB;QACrB,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,CAAC;QAEhC,0DAA0D;QAC1D,MAAM,EAAE,CAAC,iBAAiB,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/ecs/database/public/create-database.test.js

@@ -352,8 +352,12 @@ describe("createDatabase", () => {
                 yield { position: { x: 3, y: 3, z: 3 }, name: "Yield3" };
                 throw new Error("Sequential transaction failed");
             }
-            // Start the transaction
+            // Start the transaction. At runtime the database returns a Promise when the
+            // provider is an async generator, but the static type is number (entity id).
+            // Cast so we can attach a no-op .catch immediately — without it Node fires
+            // unhandledRejection during the wait below, before our try/catch runs.
             const transactionPromise = store.transactions.createPositionNameEntity(() => multiYieldErrorStream());
+            void transactionPromise.catch(() => { });
             // Wait a bit to let some yields process
             await new Promise(resolve => setTimeout(resolve, 5));
             // Take a snapshot during processing; persistence should not expose