@adobe/data-persistence 0.9.90

package/dist/transport/router.js

@@ -0,0 +1,146 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Entity } from "@adobe/data/ecs";
+// One entity-location file per persistent quadrant (document = 0, settings = 2),
+// each indexed by the entity's per-quadrant local index so it packs fully
+// densely with no gaps.
+const entityLocationFile = (quadrant) => `entity-location-${quadrant}.bin`;
+const JOURNAL_FILE = "journal.bin";
+const META_FILE = "meta.json";
+// Packed entity-location entry: u32 (archetypeId + 1, so 0 = empty) + u32
+// rowIndex. 8 bytes per persistent entity. An unwritten slot reads as the zero
+// (empty) entry; deletions write a zero entry.
+const ELT_STRIDE = 8;
+const columnPath = (archetypeId, component) => `archetypes/${archetypeId}/${component}.bin`;
+export const createPersistRouter = (backend) => {
+    const fileCache = new Map();
+    // Concurrent opens for the same path must share a single in-flight
+    // backend.open promise; otherwise each caller gets its own handle
+    // and writes interleave (the snapshotting memory backend in
+    // particular surfaces this as lost data).
+    const inflightOpens = new Map();
+    const openCached = (relPath) => {
+        const existing = fileCache.get(relPath);
+        if (existing !== undefined)
+            return Promise.resolve(existing);
+        const inflight = inflightOpens.get(relPath);
+        if (inflight !== undefined)
+            return inflight;
+        const pending = backend.open(relPath).then((file) => {
+            fileCache.set(relPath, file);
+            inflightOpens.delete(relPath);
+            return file;
+        });
+        inflightOpens.set(relPath, pending);
+        return pending;
+    };
+    const handle = async (op) => {
+        switch (op.kind) {
+            case "writeColumnSlice": {
+                const file = await openCached(columnPath(op.archetypeId, op.component));
+                await file.writeAt(op.rowOffset, new Uint8Array(op.bytes));
+                return undefined;
+            }
+            case "appendJournal": {
+                const file = await openCached(JOURNAL_FILE);
+                return file.appendAt(new Uint8Array(op.bytes));
+            }
+            case "writeEntityLocation": {
+                if (Entity.isNonPersistent(op.entity)) {
+                    throw new Error(`writeEntityLocation: non-persistent entity not persistable (entity=${op.entity})`);
+                }
+                const file = await openCached(entityLocationFile(Entity.quadrantOf(op.entity)));
+                const entry = new ArrayBuffer(ELT_STRIDE);
+                const view = new DataView(entry);
+                // Store archetypeId biased by +1 so a zero-filled (never-written)
+                // slot reads as "empty" rather than a valid archetype 0 (the
+                // backend zero-fills any gap left before the first write).
+                view.setUint32(0, op.archetypeId + 1, true);
+                view.setUint32(4, op.rowIndex, true);
+                await file.writeAt(Entity.toLocalIndex(op.entity) * ELT_STRIDE, new Uint8Array(entry));
+                return undefined;
+            }
+            case "deleteEntityLocation": {
+                if (Entity.isNonPersistent(op.entity)) {
+                    throw new Error(`deleteEntityLocation: non-persistent entity not persistable (entity=${op.entity})`);
+                }
+                const file = await openCached(entityLocationFile(Entity.quadrantOf(op.entity)));
+                // Zero entry = empty slot (biased archetype 0 means "absent").
+                const tombstone = new Uint8Array(ELT_STRIDE);
+                await file.writeAt(Entity.toLocalIndex(op.entity) * ELT_STRIDE, tombstone);
+                return undefined;
+            }
+            case "writeJournalSnapshot": {
+                // Always a full rewrite at offset 0; truncate removes any
+                // stale tail from a previous checkpoint with more rows.
+                const path = columnPath(op.archetypeId, op.component);
+                const file = await openCached(path);
+                const bytes = new Uint8Array(op.bytes);
+                await file.writeAt(0, bytes);
+                await file.truncate(bytes.byteLength);
+                return undefined;
+            }
+            case "checkpoint": {
+                // Atomic-ish: write the manifest to a temp file, then rename.
+                // OPFS rename is implemented as copy+delete in our backend
+                // (lossy of atomicity); on POSIX the rename is atomic.
+                const text = JSON.stringify(op.manifest);
+                const bytes = new TextEncoder().encode(text);
+                const tmp = META_FILE + ".tmp";
+                const tmpFile = await backend.open(tmp);
+                await tmpFile.truncate(0);
+                await tmpFile.writeAt(0, bytes);
+                await tmpFile.sync();
+                await tmpFile.close();
+                await backend.remove(META_FILE);
+                await backend.rename(tmp, META_FILE);
+                // Truncate the journal once the new manifest is durable.
+                const journal = await openCached(JOURNAL_FILE);
+                await journal.truncate(0);
+                await journal.sync();
+                return undefined;
+            }
+            case "readFile": {
+                // Open via openCached so subsequent writes share the handle.
+                // Backends create-on-open (matching POSIX O_CREAT semantics);
+                // non-existence is signaled by a zero-byte size. Callers that
+                // need to distinguish missing from empty should use `listDir`.
+                const file = await openCached(op.path);
+                const size = await file.size();
+                if (size === 0)
+                    return { bytes: new ArrayBuffer(0) };
+                const data = await file.readAt(0, size);
+                // Copy into a fresh ArrayBuffer so it is transferable
+                // across postMessage and never aliases an internal buffer.
+                const out = new ArrayBuffer(data.byteLength);
+                new Uint8Array(out).set(data);
+                return { bytes: out };
+            }
+            case "listDir": {
+                try {
+                    const entries = await backend.list(op.path);
+                    return { entries };
+                }
+                catch {
+                    return { entries: [] };
+                }
+            }
+            default: {
+                const exhaustive = op;
+                throw new Error(`Unknown PersistOp kind: ${exhaustive.kind}`);
+            }
+        }
+    };
+    const close = async () => {
+        for (const file of fileCache.values()) {
+            await file.close();
+        }
+        fileCache.clear();
+        // Release process-wide backend resources (lock files, etc.) AFTER
+        // file handles are closed: backends that use a sync access handle
+        // as their lock would otherwise see a stale handle still open
+        // when they try to release it.
+        await backend.dispose?.();
+    };
+    return { handle, close };
+};
+//# sourceMappingURL=router.js.map

package/dist/transport/router.js.map

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

package/dist/transport/transport.d.ts

@@ -0,0 +1,105 @@
+import type { Manifest } from "../encoder/types.js";
+/**
+ * Operations sent from the ECS thread to the persistence worker. The
+ * worker is a dumb byte router; all semantic mapping (component → file,
+ * row → byte offset) is done by the encoder on the ECS thread before
+ * the op is posted.
+ */
+export type PersistOp = {
+    readonly id: number;
+    readonly kind: "writeColumnSlice";
+    readonly archetypeId: number;
+    readonly component: string;
+    readonly rowOffset: number;
+    readonly bytes: ArrayBuffer;
+} | {
+    readonly id: number;
+    readonly kind: "appendJournal";
+    readonly bytes: ArrayBuffer;
+} | {
+    readonly id: number;
+    readonly kind: "writeEntityLocation";
+    readonly entity: number;
+    readonly archetypeId: number;
+    readonly rowIndex: number;
+} | {
+    readonly id: number;
+    readonly kind: "deleteEntityLocation";
+    readonly entity: number;
+} | {
+    readonly id: number;
+    readonly kind: "checkpoint";
+    readonly manifest: Manifest;
+} | {
+    readonly id: number;
+    readonly kind: "writeJournalSnapshot";
+    readonly archetypeId: number;
+    readonly component: string;
+    /** Full snapshot buffer from encodeJournalSnapshot — always written at offset 0 and truncated to this length. */
+    readonly bytes: ArrayBuffer;
+} | {
+    readonly id: number;
+    readonly kind: "readFile";
+    readonly path: string;
+} | {
+    readonly id: number;
+    readonly kind: "listDir";
+    readonly path: string;
+};
+/**
+ * Reply payload for `readFile` requests. Carries the entire file
+ * contents as an ArrayBuffer (zero-length for empty or non-existent
+ * files; callers detect existence separately via `listDir`).
+ * Returned via `transport.request()`.
+ */
+export interface ReadFileResult {
+    readonly bytes: ArrayBuffer;
+}
+/**
+ * Reply payload for `listDir` requests. Returns directory entry names
+ * (not full paths). Empty array when the directory does not exist.
+ */
+export interface ListDirResult {
+    readonly entries: readonly string[];
+}
+/** Acknowledgement message sent from worker back to the ECS thread. */
+export interface AckMessage {
+    readonly kind: "ack";
+    readonly id: number;
+    readonly value?: unknown;
+    readonly error?: string;
+}
+export type PersistMessage = AckMessage;
+/**
+ * The transport layer between the ECS thread and the persistence
+ * worker. Three implementations exist:
+ *
+ *   - InprocessTransport   - direct in-thread call (Node servers, tests)
+ *   - BrowserWorkerTransport - DOM Worker + postMessage
+ *   - NodeWorkerTransport    - node:worker_threads + parentPort
+ */
+export interface Transport {
+    /**
+     * Send an operation that does not require a response.
+     */
+    send(op: PersistOp, transfer?: readonly Transferable[]): void;
+    /**
+     * Send an operation and await its acknowledgement.
+     */
+    request<T = unknown>(op: PersistOp, transfer?: readonly Transferable[]): Promise<T>;
+    /**
+     * Subscribe to incoming messages from the worker side. Returns an
+     * unsubscribe function.
+     */
+    onMessage(handler: (msg: PersistMessage) => void): () => void;
+    /**
+     * Wait for all currently-enqueued operations (sent via `send` or
+     * `request`) to complete. Used by the service to drain pending
+     * writes before checkpoints, snapshots, or shutdown.
+     */
+    flush(): Promise<void>;
+    /**
+     * Tear down the transport. Pending requests reject.
+     */
+    close(): Promise<void>;
+}

package/dist/transport/transport.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/transport/transport.js.map

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

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@adobe/data-persistence",
+  "version": "0.9.90",
+  "description": "Worker-based incremental persistence layer for @adobe/data ECS over OPFS (browser) and node:fs (server).",
+  "type": "module",
+  "sideEffects": false,
+  "private": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@adobe/data": "0.9.90"
+  },
+  "devDependencies": {
+    "@vitest/browser": "^1.6.0",
+    "playwright": "^1.46.1",
+    "typescript": "^5.8.3",
+    "vite": "^5.1.1",
+    "vitest": "^1.6.0"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./node": {
+      "import": "./dist/node/index.js",
+      "types": "./dist/node/index.d.ts"
+    },
+    "./browser": {
+      "import": "./dist/browser/index.js",
+      "types": "./dist/browser/index.d.ts"
+    },
+    "./browser-worker": {
+      "import": "./dist/browser/browser-worker-bootstrap.js",
+      "types": "./dist/browser/browser-worker-bootstrap.d.ts"
+    },
+    "./node-worker": {
+      "import": "./dist/node/node-worker-bootstrap.js",
+      "types": "./dist/node/node-worker-bootstrap.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "cp ../../LICENSE . 2>/dev/null || true; tsc -b",
+    "clean": "rm -rf dist node_modules",
+    "dev": "tsc -b -w --preserveWatchOutput",
+    "test": "pnpm exec playwright install chromium && vitest --run",
+    "test:node": "vitest --run --project=node",
+    "test:browser": "vitest --run --project=browser",
+    "perf": "tsc -b && node --expose-gc dist/perftest/run.js",
+    "typecheck": "tsc -b"
+  }
+}