@interop/was-react 0.18.1 → 0.20.0

package/dist/session/localWipe.d.ts

@@ -0,0 +1,144 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * The wipe enumeration: the one list of durable local state this library leaves
+ * on a browser, and the one executor that deletes it. Clearing data must leave
+ * nothing behind, and the failure it exists to prevent is an ORPHANED database
+ * -- one whose name is derived from an identity the clear itself destroyed, so
+ * no later run can name it, let alone delete it.
+ *
+ * Three rules keep that from happening:
+ *
+ * - Snapshot first. Every target is derived from live state BEFORE anything is
+ *   deleted ({@link snapshotWipeTargets}), so the order of the deletions that
+ *   follow cannot lose a name.
+ * - Delete by known name. Each replica's database name is computable from its
+ *   controller DID through `dbNameForController`, so it is deleted by that name
+ *   whether or not the engine can enumerate databases.
+ * - Treat `indexedDB.databases()` as discovery and verification, never as the
+ *   deletion gate. An engine that does not implement it still gets every named
+ *   database deleted; what it cannot confirm is reported as `unverified` rather
+ *   than counted toward an outcome that reads clean.
+ *
+ * What the prefix sweep reaches beyond the snapshot: anonymous replicas that
+ * earlier versions of this library already orphaned, and the replicas of other
+ * wallet identities on this browser. Both are this app's own databases under
+ * its own `dbName`, and removing them is what clearing data means.
+ *
+ * What no enumeration here reaches, stated plainly: data already synced to the
+ * WAS server (this is a local clear, not an account deletion), forensic
+ * recoverability of deleted IndexedDB data, and anything the app itself
+ * persisted outside this library.
+ */
+import type { RxStorage } from 'rxdb/plugins/core';
+/**
+ * Every durable local target of a wipe, derived up front.
+ */
+export interface WipeTargets {
+    /**
+     * The RxDB replica database names, one per controller DID the snapshot could
+     * reach (the connected identity, the anonymous one, or both).
+     */
+    replicaDbNames: string[];
+    /**
+     * The raw-IndexedDB seed stores: the session store (app-key seed, session
+     * record, descriptor cache) and the anonymous seed store.
+     */
+    seedStoreDbNames: string[];
+    /**
+     * The name prefixes the sweep matches: the app's own base `dbName` (the seed
+     * stores) and the RxDB/Dexie mangling of it (each replica collection is its
+     * own IndexedDB database, named `rxdb-dexie-<dbName>-<hash>--<v>--<name>`).
+     * Empty means no sweep: only the named targets and their Dexie sub-databases
+     * are deleted and verified.
+     */
+    idbNamePrefixes: string[];
+    /**
+     * The localStorage prefix whose writer id is cleared, or `null` to leave it
+     * in place (the logout grade: the user is expected to log back in on this
+     * browser, and the id is only an attribution stamp).
+     */
+    storageKeyPrefix: string | null;
+}
+/**
+ * What a wipe deleted, and what it could not confirm.
+ */
+export interface LocalWipeReport {
+    /**
+     * The database names the executor issued a delete for and, where the engine
+     * could confirm it, saw gone afterwards.
+     */
+    removed: string[];
+    /**
+     * Databases still present after the wipe, or whose delete threw.
+     */
+    failed: string[];
+    /**
+     * Deletions that were issued but could not be confirmed -- an engine without
+     * `indexedDB.databases()`, or a delete another tab is blocking. Neither a
+     * success nor a failure: a caller states the unconfirmed outcome rather than
+     * claiming a clean wipe.
+     */
+    unverified: string[];
+}
+/**
+ * Derives every wipe target from live state, before anything is deleted, at one
+ * of the two grades the library ships:
+ *
+ * - `logout` (log out and erase): the CONNECTED replica and the session store.
+ *   The anonymous replica and the writer id deliberately survive -- a
+ *   local-first app keeps working logged out, and the user is expected to log
+ *   back in on this browser -- so this grade runs no prefix sweep, which would
+ *   reach the anonymous replica it is meant to spare.
+ * - `clear` (clear data): everything this app ever wrote here -- both replicas,
+ *   both seed stores, the writer id -- plus a prefix sweep for whatever the
+ *   snapshot could not name.
+ *
+ * The anonymous controller DID must be resolved by the caller (re-derived from
+ * the persisted anonymous seed) while that seed still exists: once it is
+ * discarded, the database it names is unreachable.
+ *
+ * @param options {object}
+ * @param options.dbName {string}   the app's base database name
+ * @param options.grade {'logout' | 'clear'}
+ * @param [options.connectedControllerDid] {string | null}   the wallet-derived
+ *   controller DID, when a connected replica is open
+ * @param [options.anonControllerDid] {string | null}   the anonymous controller
+ *   DID (`clear` only; ignored at the `logout` grade)
+ * @param [options.storageKeyPrefix] {string}   the localStorage prefix whose
+ *   writer id the `clear` grade removes
+ * @returns {WipeTargets}
+ */
+export declare function snapshotWipeTargets({ dbName, grade, connectedControllerDid, anonControllerDid, storageKeyPrefix }: {
+    dbName: string;
+    grade: 'logout' | 'clear';
+    connectedControllerDid?: string | null;
+    anonControllerDid?: string | null;
+    storageKeyPrefix?: string;
+}): WipeTargets;
+/**
+ * Executes a wipe over a snapshot: the replica databases (through RxDB, so each
+ * one's internal metadata store goes with its collections), the seed stores,
+ * then a prefix sweep for anything the snapshot could not name, then the writer
+ * id. Every stage is best-effort and its failure is collected rather than
+ * aborting the rest, because a stage that throws must not leave the later
+ * stages' state behind.
+ *
+ * The live replica must already be torn down (an open database blocks its own
+ * deletion), which is the caller's job.
+ *
+ * @param options {object}
+ * @param options.targets {WipeTargets}
+ * @param [options.storage] {RxStorage<unknown, unknown>}   the RxDB storage the
+ *   replicas were created with (defaults to Dexie/IndexedDB)
+ * @param [options.idb] {IDBFactory}   the IndexedDB factory (defaults to the
+ *   global one; inject a fake for tests)
+ * @returns {Promise<LocalWipeReport>}
+ */
+export declare function executeLocalWipe({ targets, storage, idb }: {
+    targets: WipeTargets;
+    storage?: RxStorage<unknown, unknown>;
+    idb?: IDBFactory;
+}): Promise<LocalWipeReport>;
+//# sourceMappingURL=localWipe.d.ts.map

package/dist/session/localWipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localWipe.d.ts","sourceRoot":"","sources":["../../src/session/localWipe.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAKlD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,EACN,KAAK,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAA6C,EAC9C,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAA;IACzB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,WAAW,CAgBd;AAiDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,OAAO,EACP,OAAO,EACP,GAAe,EAChB,EAAE;IACD,OAAO,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACrC,GAAG,CAAC,EAAE,UAAU,CAAA;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2F3B"}

package/dist/session/localWipe.js

@@ -0,0 +1,190 @@
+import { DEFAULT_STORAGE_KEY_PREFIX } from '../config.js';
+import { LocalStore, dbNameForController } from '../storage/localStore.js';
+import { clearPersistedWriterId } from '../storage/writerId.js';
+/**
+ * Derives every wipe target from live state, before anything is deleted, at one
+ * of the two grades the library ships:
+ *
+ * - `logout` (log out and erase): the CONNECTED replica and the session store.
+ *   The anonymous replica and the writer id deliberately survive -- a
+ *   local-first app keeps working logged out, and the user is expected to log
+ *   back in on this browser -- so this grade runs no prefix sweep, which would
+ *   reach the anonymous replica it is meant to spare.
+ * - `clear` (clear data): everything this app ever wrote here -- both replicas,
+ *   both seed stores, the writer id -- plus a prefix sweep for whatever the
+ *   snapshot could not name.
+ *
+ * The anonymous controller DID must be resolved by the caller (re-derived from
+ * the persisted anonymous seed) while that seed still exists: once it is
+ * discarded, the database it names is unreachable.
+ *
+ * @param options {object}
+ * @param options.dbName {string}   the app's base database name
+ * @param options.grade {'logout' | 'clear'}
+ * @param [options.connectedControllerDid] {string | null}   the wallet-derived
+ *   controller DID, when a connected replica is open
+ * @param [options.anonControllerDid] {string | null}   the anonymous controller
+ *   DID (`clear` only; ignored at the `logout` grade)
+ * @param [options.storageKeyPrefix] {string}   the localStorage prefix whose
+ *   writer id the `clear` grade removes
+ * @returns {WipeTargets}
+ */
+export function snapshotWipeTargets({ dbName, grade, connectedControllerDid, anonControllerDid, storageKeyPrefix = DEFAULT_STORAGE_KEY_PREFIX }) {
+    const clearing = grade === 'clear';
+    const dids = [
+        connectedControllerDid,
+        ...(clearing ? [anonControllerDid] : [])
+    ].filter(did => !!did);
+    return {
+        replicaDbNames: [...new Set(dids)].map(controllerDid => dbNameForController({ dbName, controllerDid })),
+        seedStoreDbNames: clearing
+            ? [`${dbName}-session`, `${dbName}-anon`]
+            : [`${dbName}-session`],
+        idbNamePrefixes: clearing ? [`${dbName}-`, `rxdb-dexie-${dbName}-`] : [],
+        storageKeyPrefix: clearing ? storageKeyPrefix : null
+    };
+}
+/**
+ * Lists the IndexedDB database names, or `null` on an engine that does not
+ * implement `databases()` (or refuses the call).
+ *
+ * @param idb {IDBFactory}
+ * @returns {Promise<string[] | null>}
+ */
+async function listDatabaseNames(idb) {
+    if (typeof idb.databases !== 'function') {
+        return null;
+    }
+    try {
+        const listed = await idb.databases();
+        return listed.map(entry => entry.name).filter(name => !!name);
+    }
+    catch (err) {
+        console.warn('Could not enumerate IndexedDB databases:', err);
+        return null;
+    }
+}
+/**
+ * Deletes one IndexedDB database by name. A delete another connection is
+ * blocking is reported rather than awaited forever: the request stays pending
+ * in the engine, and the executor's verification probe is what decides whether
+ * it landed.
+ *
+ * @param options {object}
+ * @param options.name {string}
+ * @param options.idb {IDBFactory}
+ * @returns {Promise<{ blocked: boolean }>}
+ */
+async function deleteIdbDatabase({ name, idb }) {
+    return await new Promise((resolve, reject) => {
+        const request = idb.deleteDatabase(name);
+        request.onsuccess = () => resolve({ blocked: false });
+        request.onblocked = () => resolve({ blocked: true });
+        request.onerror = () => reject(request.error ?? new Error(`Could not delete database ${name}.`));
+    });
+}
+/**
+ * Executes a wipe over a snapshot: the replica databases (through RxDB, so each
+ * one's internal metadata store goes with its collections), the seed stores,
+ * then a prefix sweep for anything the snapshot could not name, then the writer
+ * id. Every stage is best-effort and its failure is collected rather than
+ * aborting the rest, because a stage that throws must not leave the later
+ * stages' state behind.
+ *
+ * The live replica must already be torn down (an open database blocks its own
+ * deletion), which is the caller's job.
+ *
+ * @param options {object}
+ * @param options.targets {WipeTargets}
+ * @param [options.storage] {RxStorage<unknown, unknown>}   the RxDB storage the
+ *   replicas were created with (defaults to Dexie/IndexedDB)
+ * @param [options.idb] {IDBFactory}   the IndexedDB factory (defaults to the
+ *   global one; inject a fake for tests)
+ * @returns {Promise<LocalWipeReport>}
+ */
+export async function executeLocalWipe({ targets, storage, idb = indexedDB }) {
+    const issued = new Set();
+    const failed = new Set();
+    const unverified = new Set();
+    // Deletes another connection is holding up. The engine keeps the request
+    // pending, so one of these still standing at the end is unconfirmed rather
+    // than failed.
+    const blockedNames = new Set();
+    for (const name of targets.replicaDbNames) {
+        try {
+            await LocalStore.removeDatabase({
+                dbName: name,
+                ...(storage && { storage })
+            });
+            issued.add(name);
+        }
+        catch (err) {
+            console.warn(`Could not remove the replica database ${name}:`, err);
+            failed.add(name);
+        }
+    }
+    for (const name of targets.seedStoreDbNames) {
+        try {
+            const { blocked } = await deleteIdbDatabase({ name, idb });
+            issued.add(name);
+            if (blocked) {
+                blockedNames.add(name);
+                unverified.add(name);
+            }
+        }
+        catch (err) {
+            console.warn(`Could not delete the seed store ${name}:`, err);
+            failed.add(name);
+        }
+    }
+    // What the sweep deletes and the verification probe looks for: anything
+    // under one of the app's prefixes, plus every named target and the Dexie
+    // sub-databases that embed its name. The second half is what makes RxDB's
+    // own removal complete -- `RxDatabase.remove()` clears each collection's
+    // table but leaves its IndexedDB database standing.
+    function matchesApp(name) {
+        return (targets.idbNamePrefixes.some(prefix => name.startsWith(prefix)) ||
+            [...targets.replicaDbNames, ...targets.seedStoreDbNames].some(target => name === target || name.includes(target)));
+    }
+    const listed = await listDatabaseNames(idb);
+    if (listed === null) {
+        // No enumeration: the named deletes above still ran, but nothing sweeps
+        // and nothing confirms, so every issued name is reported unconfirmed.
+        for (const name of issued) {
+            unverified.add(name);
+        }
+    }
+    else {
+        for (const name of listed.filter(matchesApp)) {
+            try {
+                const { blocked } = await deleteIdbDatabase({ name, idb });
+                issued.add(name);
+                if (blocked) {
+                    blockedNames.add(name);
+                    unverified.add(name);
+                }
+            }
+            catch (err) {
+                console.warn(`Could not delete the database ${name}:`, err);
+                failed.add(name);
+            }
+        }
+    }
+    if (targets.storageKeyPrefix !== null) {
+        clearPersistedWriterId({ storageKeyPrefix: targets.storageKeyPrefix });
+    }
+    const remaining = await listDatabaseNames(idb);
+    for (const name of (remaining ?? []).filter(matchesApp)) {
+        if (blockedNames.has(name)) {
+            continue;
+        }
+        unverified.delete(name);
+        failed.add(name);
+    }
+    return {
+        removed: [...issued].filter(name => !failed.has(name)),
+        failed: [...failed],
+        unverified: [...unverified]
+    };
+}
+//# sourceMappingURL=localWipe.js.map

package/dist/session/localWipe.js.map

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

package/dist/storage/adopt.d.ts

@@ -14,12 +14,15 @@ import type { LocalStore } from './localStore.js';
  * @param options.store {LocalStore}   the open connected replica
  * @param options.entities {Record<string, Array<{ id: string }>>}   decrypted
  *   payloads per collection key, as collected from the anonymous replica
+ * @param options.writerId {string}   the session's writer id, stamped onto
+ *   adopted payloads that carry no LWW fields
  * @returns {Promise<void>}
  */
-export declare function mergeAdopted({ store, entities }: {
+export declare function mergeAdopted({ store, entities, writerId }: {
     store: LocalStore;
     entities: Record<string, Array<{
         id: string;
     }>>;
+    writerId: string;
 }): Promise<void>;
 //# sourceMappingURL=adopt.d.ts.map

package/dist/storage/adopt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/storage/adopt.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGjD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,YAAY,CAAC,EACjC,KAAK,EACL,QAAQ,EACT,EAAE;IACD,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;CAChD,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB"}
+{"version":3,"file":"adopt.d.ts","sourceRoot":"","sources":["../../src/storage/adopt.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,QAAQ,EACT,EAAE;IACD,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAC/C,QAAQ,EAAE,MAAM,CAAA;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB"}

package/dist/storage/adopt.js

@@ -23,7 +23,6 @@
  * new one.
  */
 import { lwwFields, remotePayloadWins } from '../sync/lww.js';
-import { requireWriterId } from './storageManager.js';
 /**
  * Merges the collected anonymous-replica payloads into `store` (the already
  * open connected replica) under the per-uuid LWW policy above. Runs before the
@@ -39,9 +38,11 @@ import { requireWriterId } from './storageManager.js';
  * @param options.store {LocalStore}   the open connected replica
  * @param options.entities {Record<string, Array<{ id: string }>>}   decrypted
  *   payloads per collection key, as collected from the anonymous replica
+ * @param options.writerId {string}   the session's writer id, stamped onto
+ *   adopted payloads that carry no LWW fields
  * @returns {Promise<void>}
  */
-export async function mergeAdopted({ store, entities }) {
+export async function mergeAdopted({ store, entities, writerId }) {
     let stamp = null;
     // Collections are separate RxDB collections and each logical uuid appears at
     // most once per collection, so every write below is independent of every
@@ -54,7 +55,7 @@ export async function mergeAdopted({ store, entities }) {
             if (!adoptedLww) {
                 stamp ??= {
                     updatedAt: new Date().toISOString(),
-                    writerId: requireWriterId()
+                    writerId
                 };
                 adopted = { ...payload, ...stamp };
                 adoptedLww = stamp;

package/dist/storage/adopt.js.map

@@ -1 +1 @@
-{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../src/storage/adopt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EACjC,KAAK,EACL,QAAQ,EAIT;IACC,IAAI,KAAK,GAAmD,IAAI,CAAA;IAChE,6EAA6E;IAC7E,yEAAyE;IACzE,qEAAqE;IACrE,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,CAAC,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAC1D,CAAA;QACD,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;YAC3B,IAAI,OAAO,GAAG,OAAO,CAAA;YACrB,IAAI,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;YACnC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,KAAK,KAAK;oBACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,QAAQ,EAAE,eAAe,EAAE;iBAC5B,CAAA;gBACD,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,CAAA;gBAClC,UAAU,GAAG,KAAK,CAAA;YACpB,CAAC;YACD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YACxC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;gBACtC,OAAM;YACR,CAAC;YACD,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;YACrC,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC7D,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YACxC,CAAC;QACH,CAAC,CAAC,CACH,CAAA;IACH,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}
+{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../src/storage/adopt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAG7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EACjC,KAAK,EACL,QAAQ,EACR,QAAQ,EAKT;IACC,IAAI,KAAK,GAAmD,IAAI,CAAA;IAChE,6EAA6E;IAC7E,yEAAyE;IACzE,qEAAqE;IACrE,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,CAAC,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAC1D,CAAA;QACD,MAAM,OAAO,CAAC,GAAG,CACf,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAC,OAAO,EAAC,EAAE;YAC3B,IAAI,OAAO,GAAG,OAAO,CAAA;YACrB,IAAI,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;YACnC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,KAAK,KAAK;oBACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,QAAQ;iBACT,CAAA;gBACD,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,EAAE,CAAA;gBAClC,UAAU,GAAG,KAAK,CAAA;YACpB,CAAC;YACD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YACxC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;gBACtC,OAAM;YACR,CAAC;YACD,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;YACrC,IAAI,CAAC,UAAU,IAAI,iBAAiB,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC7D,MAAM,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YACxC,CAAC;QACH,CAAC,CAAC,CACH,CAAA;IACH,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/storage/entityStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entityStore.d.ts","sourceRoot":"","sources":["../../src/storage/entityStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAInE;;;;;GAKG;AACH,KAAK,eAAe,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IACnD;;OAEG;IACH,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B;;;;OAIG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD;;;OAGG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD;;OAEG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC;;;;;OAKG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,CAAA;IAC/B;;;;;;;OAOG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAA;IACvB;;;OAGG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACxD,aAAa,EAAE,MAAM,GACpB,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAqJzC"}
+{"version":3,"file":"entityStore.d.ts","sourceRoot":"","sources":["../../src/storage/entityStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAOnE;;;;;GAKG;AACH,KAAK,eAAe,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IACnD;;OAEG;IACH,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B;;;;OAIG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD;;;OAGG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD;;;;;;OAMG;IACH,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD;;OAEG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACvC;;;;;OAKG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,CAAA;IAC/B;;;;;;;OAOG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAA;IACvB;;;OAGG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACxD,aAAa,EAAE,MAAM,GACpB,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAqJzC"}

package/dist/storage/entityStore.js

@@ -22,6 +22,9 @@
  * local writes stay immediate so a single edit is snappy.
  */
 import { create } from 'zustand';
+// The verbs resolve the ACTIVE session's context on every call rather than
+// capturing one: an entity store is created at module level, before any
+// session exists, and outlives every session it serves.
 import { requireStore, requireRemoteStore, stampLww } from './storageManager.js';
 import { lwwFields, remotePayloadWins } from '../sync/lww.js';
 /**

package/dist/storage/entityStore.js.map

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

package/dist/storage/publicUrl.js

@@ -6,9 +6,9 @@
  * logical collection key and a document id, composes the stable,
  * world-readable resource URL of that document in a public (plaintext)
  * collection. It routes the logical key to its WAS collection id through the
- * process-wide holders exactly as {@link EntityStore.query} does, so it
- * requires an open {@link LocalStore} and a wallet-connected session (the
- * remote-store holder), and fails closed on non-public collections.
+ * active session's storage context exactly as {@link EntityStore.query} does,
+ * so it requires an open {@link LocalStore} and a wallet-connected session
+ * (a remote store), and fails closed on non-public collections.
  */
 import { requireStore, requireRemoteStore } from './storageManager.js';
 /**

package/dist/storage/storageContext.d.ts

@@ -0,0 +1,175 @@
+import type { StoreRegistry } from '../config.js';
+import type { Json } from '../sync/index.js';
+import type { LwwFields } from '../sync/lww.js';
+import type { LocalStore } from './localStore.js';
+import { type SyncStatusStore } from './syncStatusStore.js';
+import type { WasRemoteStore } from './wasRemoteStore.js';
+export declare class StorageContext {
+    #private;
+    /**
+     * The app's per-collection hydrate/patch handlers; the change patches and the
+     * scheduled re-hydrates route on it.
+     */
+    readonly registry: StoreRegistry;
+    /**
+     * This session's per-collection replication statuses.
+     */
+    readonly syncStatus: SyncStatusStore;
+    /**
+     * @param options {object}
+     * @param options.registry {StoreRegistry}
+     * @param options.writerId {string}   the resolved per-install writer id (see
+     *   `getWriterId`), the value every stamp of this session carries
+     */
+    constructor({ registry, writerId }: {
+        registry: StoreRegistry;
+        writerId: string;
+    });
+    /**
+     * The writer id this session stamps with: an unkeyed, clearable attribution
+     * label, never an identity.
+     *
+     * @returns {string}
+     */
+    get writerId(): string;
+    /**
+     * Replaces the in-memory writer id with a fresh one (the clear-data wipe,
+     * after `clearPersistedWriterId` removed the persisted one). The session
+     * keeps running over its new anonymous replica and its write verbs still
+     * have to stamp; nothing persists the new id, so the next run resolves and
+     * stores an id of its own.
+     *
+     * @returns {string}   the new id
+     */
+    resetWriterId(): string;
+    /**
+     * Stamps a payload with fresh last-write-wins fields: the current instant as
+     * `updatedAt` and this session's writer id. Any values the caller supplied
+     * are overwritten -- a stamp must describe THIS write, or a hydrated doc's
+     * older `updatedAt` would ride a later edit and lose the conflict.
+     *
+     * @param payload {object}
+     * @returns {object}   the payload with the LWW fields set
+     */
+    stampLww<T extends {
+        id: string;
+    }>(payload: T): T & LwwFields;
+    /**
+     * Installs the opened replica and makes this the process's active context
+     * (the one the app-facing facades and the entity-store verbs resolve to).
+     * Throws if ANOTHER context still has a replica attached: two live sessions
+     * in one process would write into each other's entity stores.
+     *
+     * @param store {LocalStore}
+     * @returns {void}
+     */
+    attachStore(store: LocalStore): void;
+    /**
+     * Releases the replica (the caller closes or deletes it) and cancels every
+     * pending re-hydrate; anything still in flight against the old replica sees
+     * the generation change and ends as a no-op.
+     *
+     * @returns {LocalStore | null}   the replica that was attached, if any
+     */
+    detachStore(): LocalStore | null;
+    /**
+     * Whether a replica is attached.
+     *
+     * @returns {boolean}
+     */
+    hasStore(): boolean;
+    /**
+     * The attached replica, or throws if none is open.
+     *
+     * @returns {LocalStore}
+     */
+    requireStore(): LocalStore;
+    /**
+     * Runs `op` against the replica attached now and resolves with its result
+     * only if that same replica is still attached when `op` settles. Resolves
+     * `undefined` when no replica is attached, or when it was detached or
+     * swapped meanwhile -- including when `op` rejected after the swap, since a
+     * read torn by its own teardown is expected noise, not an error. A rejection
+     * against a replica that is still attached propagates.
+     *
+     * @param op {(store: LocalStore) => Promise<T>}
+     * @returns {Promise<T | undefined>}
+     */
+    whileAttached<T>(op: (store: LocalStore) => Promise<T>): Promise<T | undefined>;
+    /**
+     * Installs the connected session's delegated remote store (once background
+     * sync has bootstrapped it from the granted zcaps).
+     *
+     * @param store {WasRemoteStore}
+     * @returns {void}
+     */
+    attachRemoteStore(store: WasRemoteStore): void;
+    /**
+     * Releases the remote store (logout / sync teardown).
+     *
+     * @returns {void}
+     */
+    detachRemoteStore(): void;
+    /**
+     * Whether a connected session's remote store is available.
+     *
+     * @returns {boolean}
+     */
+    hasRemoteStore(): boolean;
+    /**
+     * The connected session's remote store, or throws while no wallet-connected
+     * session is active (local-only mode, or sync has not bootstrapped yet).
+     *
+     * @returns {WasRemoteStore}
+     */
+    requireRemoteStore(): WasRemoteStore;
+    /**
+     * Hydrates every registered store from the attached replica.
+     *
+     * @returns {Promise<void>}
+     */
+    hydrateAll(): Promise<void>;
+    /**
+     * Empties every registered store (logout).
+     *
+     * @returns {void}
+     */
+    clearEntityStores(): void;
+    /**
+     * Patches ONE store from a single RxDB change event (per-doc, no
+     * whole-collection re-hydrate): decrypt the changed envelope, then upsert the
+     * payload (INSERT / UPDATE, including conflict-resolved rows) or drop it
+     * (DELETE / tombstone). The `uuid -> envelopeId` index is kept in step so a
+     * later local edit of a remotely-created doc still finds its envelope. Falls
+     * back to a debounced whole-collection re-hydrate if the envelope is missing
+     * or fails to decrypt.
+     *
+     * Fired floating off the RxDB change stream, so a logout/login teardown can
+     * detach or swap the replica while the decrypt is in flight; the decrypt runs
+     * under {@link StorageContext.whileAttached}, so an event that outlives its
+     * replica is dropped rather than patched into the next session's stores.
+     *
+     * @param collectionKey {string}
+     * @param event {object}   an RxDB change event (operation + documentData)
+     * @returns {Promise<void>}
+     */
+    patchFromChange(collectionKey: string, event: {
+        operation: string;
+        documentData?: {
+            id: string;
+            data?: Json;
+            _deleted?: boolean;
+        };
+    }): Promise<void>;
+    /**
+     * Schedules a debounced re-hydrate of one collection's store after a pull.
+     * A no-op without an attached replica, and the timer itself is bound to the
+     * replica attached now: a detach cancels it, and one that still fires after
+     * a swap finds the generation changed and does nothing.
+     *
+     * @param collectionKey {string}
+     * @returns {void}
+     */
+    scheduleRehydrate(collectionKey: string): void;
+}
+//# sourceMappingURL=storageContext.d.ts.map

package/dist/storage/storageContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageContext.d.ts","sourceRoot":"","sources":["../../src/storage/storageContext.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAOzD,qBAAa,cAAc;;IACzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,eAAe,CAA0B;IAU9D;;;;;OAKG;gBACS,EACV,QAAQ,EACR,QAAQ,EACT,EAAE;QACD,QAAQ,EAAE,aAAa,CAAA;QACvB,QAAQ,EAAE,MAAM,CAAA;KACjB;IAKD;;;;;OAKG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;;;;OAQG;IACH,aAAa,IAAI,MAAM;IAKvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAQ7D;;;;;;;;OAQG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAMpC;;;;;;OAMG;IACH,WAAW,IAAI,UAAU,GAAG,IAAI;IAWhC;;;;OAIG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,YAAY,IAAI,UAAU;IAO1B;;;;;;;;;;OAUG;IACG,aAAa,CAAC,CAAC,EACnB,EAAE,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GACpC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAkBzB;;;;;;OAMG;IACH,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAI9C;;;;OAIG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;;OAIG;IACH,cAAc,IAAI,OAAO;IAIzB;;;;;OAKG;IACH,kBAAkB,IAAI,cAAc;IASpC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;OAIG;IACH,iBAAiB,IAAI,IAAI;IAMzB;;;;;;;;;;;;;;;;;OAiBG;IACG,eAAe,CACnB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAA;QACjB,YAAY,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,IAAI,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAC/D,GACA,OAAO,CAAC,IAAI,CAAC;IAqDhB;;;;;;;;OAQG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;CAqB/C"}