@adobe/data 0.9.56 → 0.9.58

package/references/data-lit-tictactoe/src/elements/tictactoe-hud/tictactoe-hud-presentation.ts

@@ -4,12 +4,20 @@ import { html } from "lit";
 
 export function render(args: {
   statusText: string;
+  xWins: number;
+  oWins: number;
+  draws: number;
   restartGame: () => void;
 }) {
-  const { statusText, restartGame } = args;
+  const { statusText, xWins, oWins, draws, restartGame } = args;
   return html`
     <div class="hud">
-      <span>${statusText}</span>
+      <div class="score">
+        <span class="score-cell score-x">X <strong>${xWins}</strong></span>
+        <span class="score-cell score-draw">= <strong>${draws}</strong></span>
+        <span class="score-cell score-o">O <strong>${oWins}</strong></span>
+      </div>
+      <span class="status">${statusText}</span>
       <button type="button" @click=${restartGame}>Restart</button>
     </div>
   `;

package/references/data-lit-tictactoe/src/elements/tictactoe-hud/tictactoe-hud.css.ts

@@ -8,11 +8,46 @@ export const styles = css`
     font-family: system-ui, sans-serif;
     display: flex;
     align-items: center;
-    gap: 0.5rem;
+    gap: 0.75rem;
+  }
+
+  .score {
+    display: flex;
+    gap: 0;
+    border-radius: 6px;
+    overflow: hidden;
+    border: 1px solid #ddd;
+    font-size: 0.82rem;
+    flex-shrink: 0;
+  }
+
+  .score-cell {
+    padding: 0.2rem 0.55rem;
+    display: flex;
+    align-items: center;
+    gap: 0.3rem;
+    letter-spacing: 0.02em;
+  }
+
+  .score-x    { background: #fff0f0; color: #c0392b; }
+  .score-draw { background: #f5f5f5; color: #555; }
+  .score-o    { background: #f0f4ff; color: #2563eb; }
+
+  .score-cell strong {
+    font-weight: 700;
+    min-width: 1ch;
+    text-align: right;
+  }
+
+  .status {
+    flex: 1;
+    font-size: 0.9rem;
+    color: #333;
   }
 
   .hud button {
     padding: 0.25rem 0.75rem;
     cursor: pointer;
+    flex-shrink: 0;
   }
 `;

package/references/data-lit-tictactoe/src/elements/tictactoe-hud/tictactoe-hud.ts

@@ -1,44 +1,8 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 
-import { customElement } from "lit/decorators.js";
-import { useObservableValues } from "@adobe/data-lit";
-import { BoardState } from "../../types/board-state/board-state.js";
-import { TictactoeElement } from "../../tictactoe-element.js";
-import { styles } from "./tictactoe-hud.css.js";
-import * as presentation from "./tictactoe-hud-presentation.js";
+import { html, type TemplateResult } from "lit";
 
-export const tagName = "tictactoe-hud";
-
-@customElement(tagName)
-export class TictactoeHud extends TictactoeElement {
-  static styles = styles;
-
-  render() {
-    const values = useObservableValues(
-      () => ({
-        board: this.service.observe.resources.board,
-        firstPlayer: this.service.observe.resources.firstPlayer,
-      }),
-      [],
-    );
-
-    const board = values?.board ?? "         ";
-    const firstPlayer = values?.firstPlayer ?? "X";
-
-    const currentPlayer = BoardState.currentPlayer(board, firstPlayer);
-    const status = BoardState.deriveStatus(board);
-    const winner = BoardState.getWinner(board);
-
-    const statusText =
-      status === "won" && winner !== null
-        ? `Winner: ${winner}`
-        : status === "draw"
-          ? "Draw"
-          : `Current Player: ${currentPlayer}`;
-
-    return presentation.render({
-      statusText,
-      restartGame: () => this.service.transactions.restartGame(),
-    });
-  }
-}
+export const TictactoeHud = (): TemplateResult => {
+    void import("./tictactoe-hud-element.js");
+    return html`<tictactoe-hud></tictactoe-hud>`;
+};

package/references/data-lit-tictactoe/src/index.ts

@@ -0,0 +1,16 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+//
+// Library entry point for data-lit-tictactoe.
+// Consumers (e.g. data-p2p-tictactoe) import from this barrel.
+
+export { tictactoePlugin } from "./state/tictactoe-plugin.js";
+export type { TictactoeDatabase } from "./state/tictactoe-plugin.js";
+
+export { agentPlugin } from "./state/agent-plugin.js";
+
+export { Tictactoe } from "./elements/tictactoe-app/tictactoe-app.js";
+export { TictactoeElement } from "./tictactoe-element.js";
+
+export { BoardState } from "./types/board-state/board-state.js";
+export { PlayerMark } from "./types/player-mark/player-mark.js";
+export { PlayMoveArgs } from "./types/play-move-args/play-move-args.js";

package/references/data-lit-tictactoe/src/main.ts

@@ -1,9 +1,15 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 
-import "./elements/tictactoe-app/tictactoe-app.js";
+import { render } from "lit";
+import { Database } from "@adobe/data/ecs";
+import { Tictactoe } from "./elements/tictactoe-app/tictactoe-app.js";
+import { agentPlugin } from "./state/agent-plugin.js";
 
 const app = document.getElementById("app");
 if (app) {
-  const el = document.createElement("tictactoe-app");
-  app.appendChild(el);
+    // The agent plugin extends tictactoePlugin with AI services. Built once
+    // here and passed to the lazy wrapper so the upgraded element receives
+    // the agent-extended database.
+    const service = Database.create(agentPlugin);
+    render(Tictactoe({ service }), app);
 }

package/references/data-lit-tictactoe/src/state/tictactoe-plugin.ts

@@ -3,13 +3,16 @@
 import { Database } from "@adobe/data/ecs";
 import { Observe } from "@adobe/data/observe";
 import { BoardState } from "../types/board-state/board-state";
-import type { PlayerMark } from "../types/player-mark/player-mark";
+import { PlayerMark } from "../types/player-mark/player-mark";
 import { PlayMoveArgs } from "../types/play-move-args/play-move-args";
 
 export const tictactoePlugin = Database.Plugin.create({
   resources: {
     board: { default: BoardState.createInitialBoard() },
-    firstPlayer: { default: "X" as PlayerMark },
+    firstPlayer: { default: PlayerMark.values[0] },
+    xWins: { default: 0 as number },
+    oWins: { default: 0 as number },
+    draws: { default: 0 as number },
   },
   computed: {
     currentPlayer: (db) =>
@@ -29,26 +32,31 @@ export const tictactoePlugin = Database.Plugin.create({
   },
   transactions: {
     restartGame: (t) => {
-      t.resources.firstPlayer =
-        t.resources.firstPlayer === "X" ? "O" : "X";
+      const winner = BoardState.getWinner(t.resources.board);
+      const status = BoardState.deriveStatus(t.resources.board);
+      if (winner === "X") t.resources.xWins = t.resources.xWins + 1;
+      else if (winner === "O") t.resources.oWins = t.resources.oWins + 1;
+      else if (status === "draw") t.resources.draws = t.resources.draws + 1;
+      t.resources.firstPlayer = PlayerMark.opponent[t.resources.firstPlayer];
       t.resources.board = BoardState.createInitialBoard();
     },
     playMove: (t, { index }: PlayMoveArgs) => {
+      const mark = BoardState.currentPlayer(
+        t.resources.board,
+        t.resources.firstPlayer,
+      );
+      // When userId is set (sync/P2P mode) a peer may only play their own mark.
+      if (t.userId !== undefined && t.userId !== mark) return;
       const validation = PlayMoveArgs.canPlayMove({
         board: t.resources.board,
         index,
       });
       if (!validation.ok) return;
-      const mark = BoardState.currentPlayer(
-        t.resources.board,
-        t.resources.firstPlayer,
-      );
-      const nextBoard = BoardState.setBoardCell({
+      t.resources.board = BoardState.setBoardCell({
         board: t.resources.board,
         index,
         mark,
       });
-      t.resources.board = nextBoard;
     },
   },
 });

package/references/data-lit-tictactoe/src/tictactoe-element.ts

@@ -1,10 +1,15 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 
 import { DatabaseElement } from "@adobe/data-lit";
-import { agentPlugin } from "./state/agent-plugin.js";
+import { tictactoePlugin } from "./state/tictactoe-plugin.js";
 
-export class TictactoeElement extends DatabaseElement<typeof agentPlugin> {
+/**
+ * Base class for all Tic-Tac-Toe elements. Typed on the minimal
+ * `tictactoePlugin` surface so that any database extending that plugin (e.g.
+ * one that adds AI agents or presence) can be injected as `.service`.
+ */
+export class TictactoeElement extends DatabaseElement<typeof tictactoePlugin> {
   get plugin() {
-    return agentPlugin;
+    return tictactoePlugin;
   }
 }

package/references/data-lit-tictactoe/src/types/board-state/current-player.ts

@@ -1,7 +1,7 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 
 import type { BoardState } from "./board-state";
-import type { PlayerMark } from "../player-mark/player-mark";
+import { PlayerMark } from "../player-mark/player-mark";
 
 export const currentPlayer = (
   board: BoardState,
@@ -9,5 +9,5 @@ export const currentPlayer = (
 ): PlayerMark => {
   const xCount = (board.match(/X/g) ?? []).length;
   const oCount = (board.match(/O/g) ?? []).length;
-  return xCount === oCount ? firstPlayer : firstPlayer === "X" ? "O" : "X";
+  return xCount === oCount ? firstPlayer : PlayerMark.opponent[firstPlayer];
 };

package/references/data-lit-tictactoe/src/types/player-mark/is.ts

@@ -0,0 +1,8 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { PlayerMark } from "./player-mark";
+import { schema } from "./schema";
+
+const set: ReadonlySet<unknown> = new Set(schema.enum);
+
+export const is = (value: unknown): value is PlayerMark => set.has(value);

package/references/data-lit-tictactoe/src/types/player-mark/mark-color.ts

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { PlayerMark } from "./player-mark";
+
+/**
+ * Visual identity colour for each mark. Used by HUDs, badges, and overlays
+ * (e.g. the P2P presence cursors) — anything that needs a per-mark accent.
+ */
+export const markColor: Record<PlayerMark, string> = {
+    X: "#6c63ff",
+    O: "#ff6363",
+};

package/references/data-lit-tictactoe/src/types/player-mark/opponent.ts

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { PlayerMark } from "./player-mark";
+
+/**
+ * Maps each `PlayerMark` to its opponent. Use anywhere code needs to
+ * "swap to the other player" without naming members at the call site.
+ */
+export const opponent: Record<PlayerMark, PlayerMark> = {
+    X: "O",
+    O: "X",
+};

package/references/data-lit-tictactoe/src/types/player-mark/public.ts

@@ -1,3 +1,7 @@
 // © 2026 Adobe. MIT License. See /LICENSE for details.
 
 export { schema } from "./schema";
+export { is } from "./is";
+export { values } from "./values";
+export { markColor } from "./mark-color";
+export { opponent } from "./opponent";

package/references/data-lit-tictactoe/src/types/player-mark/values.ts

@@ -0,0 +1,6 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+
+import type { PlayerMark } from "./player-mark";
+import { schema } from "./schema";
+
+export const values: readonly PlayerMark[] = schema.enum;

package/references/data-react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/data-react",
-  "version": "0.9.56",
+  "version": "0.9.58",
   "description": "Adobe data React bindings — hooks and context for ECS database",
   "type": "module",
   "private": false,

package/references/data-react-hello/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-react-hello",
-  "version": "0.9.56",
+  "version": "0.9.58",
   "description": "Hello World sample - click counter using @adobe/data-react",
   "type": "module",
   "private": true,

package/references/data-react-pixie/package.json

@@ -1,6 +1,6 @@
 {
   "name": "data-react-pixie",
-  "version": "0.9.56",
+  "version": "0.9.58",
   "description": "PixiJS React sample - ECS sprites (bunny, fox) with @adobe/data-react",
   "type": "module",
   "private": true,

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

@@ -1,122 +0,0 @@
-// © 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.test.js.map

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

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

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

@@ -1,41 +0,0 @@
-// © 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.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"data-cache.test.js","sourceRoot":"","sources":["../../src/cache/data-cache.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.test.js

@@ -1,42 +0,0 @@
-// © 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.test.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"expiring-data-cache.test.js","sourceRoot":"","sources":["../../src/cache/expiring-data-cache.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.test.d.ts

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

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

@@ -1,72 +0,0 @@
-// © 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.test.js.map