@adobe/data-persistence 0.9.90

package/dist/service/persistence-complexity.test.js

@@ -0,0 +1,275 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+//
+// Persistence complexity contract.
+//
+// The promise the design makes:
+//
+//   The cost of persisting a transaction T is O(changes), where
+//   "changes" means the number of (entity, component) pairs that T
+//   actually touched — plus a small constant per affected entity
+//   (entity-location update, commit marker, etc).
+//
+// Crucially, it must NOT depend on:
+//
+//   - the total number of entities in the world
+//   - the row capacity of the affected archetype
+//   - the number of archetypes registered
+//
+// We assert this by counting the PersistOp messages emitted per
+// transaction across worlds of widely varying size and confirming the
+// op count is identical (and small).
+//
+// We assert OP COUNT, not wall time, because:
+//
+//   - wall time fluctuates with GC, JIT warmup, and OS scheduling
+//   - op count is the closed-form algorithmic invariant — if op count
+//     is flat, time-per-op is bounded by per-op work (which is itself
+//     O(stride) per write, not O(world))
+//
+// World sizes deliberately stay small (10 / 100 / 500) — larger numbers
+// don't add confidence to the invariant (which is binary: flat or not)
+// but do add seconds of test time with no benefit.
+import { Database } from "@adobe/data/ecs";
+import { F32, Vec3 } from "@adobe/data/math";
+import { describe, expect, it } from "vitest";
+import { createMemoryBackend } from "../backend/memory-backend.js";
+import { createInprocessTransport } from "../transport/inprocess-transport.js";
+import { createWorkerPersistenceService } from "./create-worker-persistence-service.js";
+const createTestDb = () => {
+    const plugin = Database.Plugin.create({
+        components: {
+            position: Vec3.schema,
+            velocity: Vec3.schema,
+            mass: F32.schema,
+        },
+        archetypes: {
+            Particle: ["position", "velocity", "mass"],
+        },
+        transactions: {
+            spawn(t, args) {
+                return t.archetypes.Particle.insert({
+                    position: [args.x, args.y, args.z],
+                    velocity: [0, 0, 0],
+                    mass: args.mass,
+                });
+            },
+            move(t, args) {
+                t.update(args.entity, { position: [args.x, args.y, args.z] });
+            },
+            kill(t, entity) {
+                t.delete(entity);
+            },
+            updateAll(t, args) {
+                t.update(args.entity, {
+                    position: [args.x, args.y, args.z],
+                    velocity: [args.vx, args.vy, args.vz],
+                    mass: args.mass,
+                });
+            },
+        },
+    });
+    return Database.create(plugin);
+};
+/**
+ * Wrap an in-process transport so every PersistOp issued through
+ * `send()` and `request()` is recorded into `ops`. Returns the spy
+ * transport plus the recording array.
+ */
+const spyTransport = (inner) => {
+    const ops = [];
+    const transport = {
+        send(op, transfer) {
+            ops.push(op);
+            inner.send(op, transfer);
+        },
+        request(op, transfer) {
+            ops.push(op);
+            return inner.request(op, transfer);
+        },
+        onMessage: inner.onMessage.bind(inner),
+        flush: inner.flush.bind(inner),
+        close: inner.close.bind(inner),
+    };
+    return { transport, ops };
+};
+describe("persistence complexity contract: O(changes), not O(world)", () => {
+    /**
+     * For each world size N, populate N entities, then run an
+     * identical small transaction and count the PersistOps it emitted.
+     * The count must be equal across N.
+     */
+    const measureOpsForOneMove = async (N) => {
+        const db = createTestDb();
+        const backend = createMemoryBackend();
+        const inner = createInprocessTransport(backend);
+        const { transport, ops } = spyTransport(inner);
+        const service = await createWorkerPersistenceService({
+            database: db,
+            backend,
+            transport,
+            // Disable auto-checkpoint so it never sneaks an extra op
+            // burst into our measurement window.
+            checkpoint: { everyNTransactions: 0, idleMs: 0 },
+        });
+        // Populate N entities.
+        const ids = [];
+        for (let i = 0; i < N; i++) {
+            const id = db.transactions.spawn({ x: i, y: i, z: i, mass: 1 });
+            ids.push(id);
+        }
+        await service.flush();
+        // Snapshot op count, then run a single tiny tx that updates
+        // one component on one entity in the middle of the world.
+        const opsBefore = ops.length;
+        db.transactions.move({ entity: ids[Math.floor(N / 2)], x: 1, y: 2, z: 3 });
+        await service.flush();
+        const opsForOneMove = ops.length - opsBefore;
+        await service.dispose();
+        await transport.close();
+        return opsForOneMove;
+    };
+    it("a single-component update emits the same op count regardless of world size", async () => {
+        const counts = [
+            await measureOpsForOneMove(10),
+            await measureOpsForOneMove(100),
+            await measureOpsForOneMove(500),
+        ];
+        // All three must be identical: the per-tx op count is a
+        // function of the diff (1 entity × 1 component touched), not N.
+        expect(counts[0]).toBe(counts[1]);
+        expect(counts[1]).toBe(counts[2]);
+        // And it should be tiny — concretely:
+        //   1 journal entry  (position update)
+        // + 1 column slice   (position bytes)
+        // + 1 ELT update     (entity location)
+        // + 1 commit entry
+        // = 4 ops per single-component, single-entity transaction.
+        expect(counts[0]).toBe(4);
+    });
+    it("a multi-component update on one entity emits ops proportional to touched columns, not world size", async () => {
+        const measure = async (N) => {
+            const db = createTestDb();
+            const backend = createMemoryBackend();
+            const inner = createInprocessTransport(backend);
+            const { transport, ops } = spyTransport(inner);
+            const service = await createWorkerPersistenceService({
+                database: db,
+                backend,
+                transport,
+                checkpoint: { everyNTransactions: 0, idleMs: 0 },
+            });
+            const ids = [];
+            for (let i = 0; i < N; i++) {
+                ids.push(db.transactions.spawn({ x: i, y: i, z: i, mass: 1 }));
+            }
+            await service.flush();
+            const opsBefore = ops.length;
+            db.transactions.updateAll({
+                entity: ids[Math.floor(N / 2)],
+                x: 1, y: 2, z: 3,
+                vx: 4, vy: 5, vz: 6,
+                mass: 7,
+            });
+            await service.flush();
+            const out = ops.length - opsBefore;
+            await service.dispose();
+            await transport.close();
+            return out;
+        };
+        const counts = [
+            await measure(10),
+            await measure(100),
+            await measure(500),
+        ];
+        expect(counts[0]).toBe(counts[1]);
+        expect(counts[1]).toBe(counts[2]);
+        // 3 columns touched (position, velocity, mass) → 3 journal entries
+        // + 3 column slices + 1 ELT update + 1 commit = 8 ops.
+        expect(counts[0]).toBe(8);
+    });
+    it("an insert emits ops proportional to columns in the destination archetype, not world size", async () => {
+        const measure = async (N) => {
+            const db = createTestDb();
+            const backend = createMemoryBackend();
+            const inner = createInprocessTransport(backend);
+            const { transport, ops } = spyTransport(inner);
+            const service = await createWorkerPersistenceService({
+                database: db,
+                backend,
+                transport,
+                checkpoint: { everyNTransactions: 0, idleMs: 0 },
+            });
+            for (let i = 0; i < N; i++) {
+                db.transactions.spawn({ x: i, y: i, z: i, mass: 1 });
+            }
+            await service.flush();
+            const opsBefore = ops.length;
+            db.transactions.spawn({ x: 0, y: 0, z: 0, mass: 0 });
+            await service.flush();
+            const out = ops.length - opsBefore;
+            await service.dispose();
+            await transport.close();
+            return out;
+        };
+        const counts = [
+            await measure(10),
+            await measure(100),
+            await measure(500),
+        ];
+        expect(counts[0]).toBe(counts[1]);
+        expect(counts[1]).toBe(counts[2]);
+        // Insert writes all destination columns + ELT + commit:
+        //   3 journal entries + 3 column slices + 1 ELT + 1 commit = 8 ops.
+        expect(counts[0]).toBe(8);
+    });
+    it("a delete emits ops proportional to (1 + swap-remove side effects), not world size", async () => {
+        // Important: this measures the steady-state delete cost, where
+        // an entity's removal causes ONE swap-move side effect (the
+        // last row backfills the vacated row). We want the cost to
+        // depend on that constant, not on N.
+        const measure = async (N) => {
+            const db = createTestDb();
+            const backend = createMemoryBackend();
+            const inner = createInprocessTransport(backend);
+            const { transport, ops } = spyTransport(inner);
+            const service = await createWorkerPersistenceService({
+                database: db,
+                backend,
+                transport,
+                checkpoint: { everyNTransactions: 0, idleMs: 0 },
+            });
+            const ids = [];
+            for (let i = 0; i < N; i++) {
+                ids.push(db.transactions.spawn({ x: i, y: i, z: i, mass: 1 }));
+            }
+            await service.flush();
+            const opsBefore = ops.length;
+            // Delete an entity in the middle: the table swap-removes
+            // by moving the LAST row into the vacated row. The
+            // persistence service detects that move and emits a
+            // synthetic "all columns" update for the swapped-in entity.
+            db.transactions.kill(ids[Math.floor(N / 2)]);
+            await service.flush();
+            const out = ops.length - opsBefore;
+            await service.dispose();
+            await transport.close();
+            return out;
+        };
+        const counts = [
+            await measure(10),
+            await measure(100),
+            await measure(500),
+        ];
+        expect(counts[0]).toBe(counts[1]);
+        expect(counts[1]).toBe(counts[2]);
+        // Delete cost:
+        //   1 journal "delete" entry
+        // + 1 ELT delete
+        // + (swap-remove of last row → 3 journal entries + 3 column
+        //    slices + 1 ELT update for the moved entity)
+        // + 1 commit
+        // = 10 ops.
+        expect(counts[0]).toBe(10);
+    });
+});
+//# sourceMappingURL=persistence-complexity.test.js.map

package/dist/service/persistence-complexity.test.js.map

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

package/dist/service/worker-persistence-service.d.ts

@@ -0,0 +1,24 @@
+export type { IncrementalPersistenceService, IncrementalPersistenceServiceOptions, } from "./incremental-persistence-service.js";
+export type { ProviderMountOptions as _ProviderMountOptions } from "../provider/persistence-provider.js";
+import type { IncrementalPersistenceService, IncrementalPersistenceServiceOptions } from "./incremental-persistence-service.js";
+import type { PersistenceMount, ProviderMountOptions } from "../provider/persistence-provider.js";
+import type { Database } from "@adobe/data/ecs";
+/**
+ * @deprecated Use `IncrementalPersistenceService` instead.
+ */
+export type WorkerPersistenceService = IncrementalPersistenceService;
+/**
+ * @deprecated Use `IncrementalPersistenceServiceOptions` instead.
+ */
+export type WorkerPersistenceServiceOptions = IncrementalPersistenceServiceOptions;
+/**
+ * @deprecated Use `PersistenceMount` from `@adobe/data-persistence` instead.
+ */
+export type { PersistenceMount };
+/**
+ * @deprecated Use `ProviderMountOptions` instead.
+ */
+export interface MountOptions<R extends string | FileSystemDirectoryHandle> extends ProviderMountOptions {
+    readonly root: R;
+    readonly database: Database<any, any, any, any, any, any, any, any>;
+}

package/dist/service/worker-persistence-service.js

@@ -0,0 +1,8 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+//
+// Backwards-compatibility shim. New code should import from
+// `./incremental-persistence-service.js` or from `@adobe/data-persistence`
+// directly. The names below are deprecated and will be removed in a future
+// release.
+export {};
+//# sourceMappingURL=worker-persistence-service.js.map

package/dist/service/worker-persistence-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-persistence-service.js","sourceRoot":"","sources":["../../src/service/worker-persistence-service.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,4DAA4D;AAC5D,2EAA2E;AAC3E,2EAA2E;AAC3E,WAAW"}

package/dist/transport/inprocess-transport.d.ts

@@ -0,0 +1,15 @@
+import type { PersistenceBackend } from "../backend/persistence-backend.js";
+import type { Transport } from "./transport.js";
+/**
+ * In-process transport. Delegates directly to a {@link PersistRouter}
+ * created from the given backend. Intended for:
+ *
+ *   - tests (no worker startup, no message-channel overhead)
+ *   - Node servers that already absorb fs I/O on libuv and do not need
+ *     a dedicated thread
+ *
+ * No `Transferable` semantics — the same ArrayBuffer reference is
+ * shared with the router. Callers that wish to enforce
+ * transfer-style hand-off should use the worker transports instead.
+ */
+export declare const createInprocessTransport: (backend: PersistenceBackend) => Transport;

package/dist/transport/inprocess-transport.js

@@ -0,0 +1,64 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { createPersistRouter } from "./router.js";
+/**
+ * In-process transport. Delegates directly to a {@link PersistRouter}
+ * created from the given backend. Intended for:
+ *
+ *   - tests (no worker startup, no message-channel overhead)
+ *   - Node servers that already absorb fs I/O on libuv and do not need
+ *     a dedicated thread
+ *
+ * No `Transferable` semantics — the same ArrayBuffer reference is
+ * shared with the router. Callers that wish to enforce
+ * transfer-style hand-off should use the worker transports instead.
+ */
+export const createInprocessTransport = (backend) => {
+    const router = createPersistRouter(backend);
+    const handlers = new Set();
+    // Track in-flight router operations so flush() can drain them
+    // without a polling loop. Each op is added on dispatch and removed
+    // on settle.
+    const pending = new Set();
+    let closed = false;
+    const dispatchAck = (ack) => {
+        for (const h of handlers)
+            h(ack);
+    };
+    const track = (p) => {
+        pending.add(p);
+        const remove = () => { pending.delete(p); };
+        p.then(remove, remove);
+        return p;
+    };
+    return {
+        send(op) {
+            if (closed)
+                throw new Error("Transport is closed");
+            // Fire-and-forget; surface errors as ack messages.
+            track(router.handle(op).then((value) => dispatchAck({ kind: "ack", id: op.id, value }), (err) => dispatchAck({ kind: "ack", id: op.id, error: String(err instanceof Error ? err.message : err) })));
+        },
+        async request(op) {
+            if (closed)
+                throw new Error("Transport is closed");
+            return track(router.handle(op));
+        },
+        onMessage(handler) {
+            handlers.add(handler);
+            return () => handlers.delete(handler);
+        },
+        async flush() {
+            // Loop because settling a pending op may itself enqueue another
+            // (e.g. an ack handler that triggers a follow-up write).
+            while (pending.size > 0) {
+                await Promise.allSettled([...pending]);
+            }
+        },
+        async close() {
+            closed = true;
+            await this.flush();
+            handlers.clear();
+            await router.close();
+        },
+    };
+};
+//# sourceMappingURL=inprocess-transport.js.map

package/dist/transport/inprocess-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inprocess-transport.js","sourceRoot":"","sources":["../../src/transport/inprocess-transport.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAGvD,OAAO,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAC;AAGtE;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACpC,OAA2B,EAClB,EAAE;IACX,MAAM,MAAM,GAAkB,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC1D,8DAA8D;IAC9D,mEAAmE;IACnE,aAAa;IACb,MAAM,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC5C,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,MAAM,WAAW,GAAG,CAAC,GAAe,EAAQ,EAAE;QAC1C,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAI,CAAa,EAAc,EAAE;QAC3C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,GAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvB,OAAO,CAAC,CAAC;IACb,CAAC,CAAC;IAEF,OAAO;QACH,IAAI,CAAC,EAAa;YACd,IAAI,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACnD,mDAAmD;YACnD,KAAK,CACD,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAClB,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EACzD,CAAC,GAAY,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CACrH,CACJ,CAAC;QACN,CAAC;QACD,KAAK,CAAC,OAAO,CAAc,EAAa;YACpC,IAAI,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACnD,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAe,CAAC;QAClD,CAAC;QACD,SAAS,CAAC,OAAO;YACb,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,KAAK;YACP,gEAAgE;YAChE,yDAAyD;YACzD,OAAO,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;YAC3C,CAAC;QACL,CAAC;QACD,KAAK,CAAC,KAAK;YACP,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;KACJ,CAAC;AACN,CAAC,CAAC"}

package/dist/transport/inprocess-transport.test.d.ts

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

package/dist/transport/inprocess-transport.test.js

@@ -0,0 +1,100 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { describe, expect, it } from "vitest";
+import { createMemoryBackend } from "../backend/memory-backend.js";
+import { createInprocessTransport } from "./inprocess-transport.js";
+describe("createInprocessTransport", () => {
+    it("routes writeColumnSlice to the backend", async () => {
+        const backend = createMemoryBackend();
+        const transport = createInprocessTransport(backend);
+        try {
+            const bytes = new Uint8Array([1, 2, 3, 4]).buffer.slice(0);
+            await transport.request({
+                id: 1,
+                kind: "writeColumnSlice",
+                archetypeId: 7,
+                component: "position",
+                rowOffset: 0,
+                bytes,
+            });
+            const file = await backend.open("archetypes/7/position.bin");
+            const read = await file.readAt(0, 4);
+            expect(Array.from(read)).toEqual([1, 2, 3, 4]);
+            await file.close();
+        }
+        finally {
+            await transport.close();
+        }
+    });
+    it("appends to the journal and returns the new size", async () => {
+        const backend = createMemoryBackend();
+        const transport = createInprocessTransport(backend);
+        try {
+            const a = new Uint8Array([1, 2, 3]).buffer.slice(0);
+            const b = new Uint8Array([4, 5]).buffer.slice(0);
+            const sizeAfterA = await transport.request({ id: 1, kind: "appendJournal", bytes: a });
+            const sizeAfterB = await transport.request({ id: 2, kind: "appendJournal", bytes: b });
+            expect(sizeAfterA).toBe(3);
+            expect(sizeAfterB).toBe(5);
+        }
+        finally {
+            await transport.close();
+        }
+    });
+    it("delivers ack messages for fire-and-forget sends", async () => {
+        const backend = createMemoryBackend();
+        const transport = createInprocessTransport(backend);
+        try {
+            const acks = [];
+            const off = transport.onMessage(msg => {
+                if (msg.kind === "ack")
+                    acks.push({ id: msg.id, error: msg.error });
+            });
+            // entity 4 is persistent (quadrant 0); a non-persistent id would be rejected.
+            transport.send({ id: 42, kind: "writeEntityLocation", entity: 4, archetypeId: 5, rowIndex: 3 });
+            await new Promise(resolve => setTimeout(resolve, 0));
+            expect(acks).toEqual([{ id: 42, error: undefined }]);
+            off();
+        }
+        finally {
+            await transport.close();
+        }
+    });
+    it("delivers error acks when the router rejects", async () => {
+        const backend = createMemoryBackend();
+        const transport = createInprocessTransport(backend);
+        try {
+            const acks = [];
+            transport.onMessage(msg => {
+                if (msg.kind === "ack")
+                    acks.push({ id: msg.id, error: msg.error });
+            });
+            // writeEntityLocation rejects negative ("ephemeral")
+            // entities by design. Use it as the trigger to verify the
+            // router surfaces the rejection as an ack message with
+            // `error` populated rather than an unhandled rejection.
+            transport.send({
+                id: 7,
+                kind: "writeEntityLocation",
+                entity: -1,
+                archetypeId: 0,
+                rowIndex: 0,
+            });
+            // Wait one microtask + one macrotask to let the async
+            // dispatch settle.
+            await new Promise(resolve => setTimeout(resolve, 0));
+            expect(acks.length).toBe(1);
+            expect(acks[0].id).toBe(7);
+            expect(acks[0].error).toBeDefined();
+        }
+        finally {
+            await transport.close();
+        }
+    });
+    it("rejects sends after close", async () => {
+        const backend = createMemoryBackend();
+        const transport = createInprocessTransport(backend);
+        await transport.close();
+        expect(() => transport.send({ id: 1, kind: "writeEntityLocation", entity: 1, archetypeId: 0, rowIndex: 0 })).toThrow();
+    });
+});
+//# sourceMappingURL=inprocess-transport.test.js.map

package/dist/transport/inprocess-transport.test.js.map

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

package/dist/transport/router.d.ts

@@ -0,0 +1,12 @@
+import type { PersistenceBackend } from "../backend/persistence-backend.js";
+import type { PersistOp } from "./transport.js";
+/**
+ * Worker-side router that translates {@link PersistOp} messages into
+ * {@link PersistenceBackend} operations. Owns a small handle cache so
+ * repeated writes to the same column reuse one open file.
+ */
+export interface PersistRouter {
+    handle(op: PersistOp): Promise<unknown>;
+    close(): Promise<void>;
+}
+export declare const createPersistRouter: (backend: PersistenceBackend) => PersistRouter;