@interop/was-react 0.18.1 → 0.20.0

package/dist/storage/storageManager.js

@@ -1,175 +1,105 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
+let active = null;
 /**
- * The storage manager: a thin process-wide holder for the one {@link LocalStore}
- * instance, the per-session {@link WasRemoteStore}, plus the per-install writer
- * id. Entity stores reach for the stores through {@link requireStore} /
- * {@link requireRemoteStore} inside their verbs rather than importing them
- * directly, which keeps this module free of store imports (no cycle) and lets
- * the app own the init/hydrate ordering.
+ * Makes `context` the active one (called by the session store at creation, so
+ * the facades resolve before any replica opens, again right before it opens a
+ * replica, and by {@link StorageContext.attachStore}). Idempotent for the
+ * context already active; throws while a DIFFERENT context still has a replica
+ * attached.
  *
- * It also owns the writer-id concern end to end: {@link getWriterId} resolves
- * the per-install id, {@link setWriterId} installs the session's resolved value,
- * and {@link stampLww} is the one place a payload's last-write-wins fields are
- * minted, so no caller has to remember to stamp.
- */
-import { uuidv7 } from 'uuidv7';
-import { DEFAULT_STORAGE_KEY_PREFIX } from '../config.js';
-let localStore = null;
-let remoteStore = null;
-/**
- * Installs the opened store (called once by the app bootstrap).
- *
- * @param store {LocalStore}
+ * @param context {StorageContext}
  * @returns {void}
  */
-export function setLocalStore(store) {
-    localStore = store;
-}
-/**
- * The opened store, or throws if the app has not bootstrapped yet.
- *
- * @returns {LocalStore}
- */
-export function requireStore() {
-    if (!localStore) {
-        throw new Error('LocalStore is not initialized; open it first.');
+export function activateStorageContext(context) {
+    if (active && active !== context && active.hasStore()) {
+        throw new Error('Another storage context still has a replica attached; ' +
+            'one process hosts one live session (one provider) at a time.');
     }
-    return localStore;
+    active = context;
 }
 /**
- * Whether the store has been opened.
- *
- * @returns {boolean}
- */
-export function hasStore() {
-    return localStore !== null;
-}
-/**
- * Releases the held store reference (logout; the caller closes the db).
+ * Releases the active pointer if `context` holds it (a torn-down session); a
+ * no-op for any other context.
  *
+ * @param context {StorageContext}
  * @returns {void}
  */
-export function clearLocalStore() {
-    localStore = null;
+export function deactivateStorageContext(context) {
+    if (active === context) {
+        active = null;
+    }
 }
 /**
- * Installs the per-session delegated remote store (set once background sync
- * has bootstrapped it from the granted zcaps).
+ * Whether a storage context is active.
  *
- * @param store {WasRemoteStore}
- * @returns {void}
+ * @returns {boolean}
  */
-export function setRemoteStore(store) {
-    remoteStore = store;
+export function hasStorageContext() {
+    return active !== null;
 }
 /**
- * The connected session's remote store, or throws while no wallet-connected
- * session is active (local-only mode, or sync has not bootstrapped yet).
+ * The active storage context, or throws if no session store has been created.
  *
- * @returns {WasRemoteStore}
+ * @returns {StorageContext}
  */
-export function requireRemoteStore() {
-    if (!remoteStore) {
-        throw new Error('No WAS remote store is available; connect a wallet session first.');
+export function requireStorageContext() {
+    if (!active) {
+        throw new Error('No storage context is active; create the session store first.');
     }
-    return remoteStore;
+    return active;
 }
 /**
- * Whether a connected session's remote store is available.
+ * The active session's opened replica, or throws if none is open.
  *
- * @returns {boolean}
+ * @returns {LocalStore}
  */
-export function hasRemoteStore() {
-    return remoteStore !== null;
+export function requireStore() {
+    return requireStorageContext().requireStore();
 }
 /**
- * Releases the held remote store reference (logout / sync teardown).
+ * Whether the active session has a replica open.
  *
- * @returns {void}
+ * @returns {boolean}
  */
-export function clearRemoteStore() {
-    remoteStore = null;
+export function hasStore() {
+    return active?.hasStore() ?? false;
 }
 /**
- * The unpersisted fallback writer id for environments without `localStorage`
- * (tests, SSR): process-stable, so every stamp within one run agrees, minted
- * fresh on the next run.
- */
-let fallbackWriterId = null;
-/**
- * A stable per-install writer id (the last-write-wins tiebreak stamped into
- * every payload), persisted in localStorage under `<prefix>writerId`. In an
- * environment without `localStorage` it falls back to a process-stable
- * unpersisted id instead of throwing.
+ * The active session's remote store, or throws while no wallet-connected
+ * session is active.
  *
- * The id is an unkeyed, clearable attribution label -- never an identity. On a
- * miss it adopts a value left under the pre-rename `<prefix>clientId` key and
- * removes the old one, so an existing install keeps stamping the same id
- * across the rename rather than looking like a second writer.
- *
- * @param [options] {object}
- * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
- *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
- * @returns {string}
+ * @returns {WasRemoteStore}
  */
-export function getWriterId({ storageKeyPrefix = DEFAULT_STORAGE_KEY_PREFIX } = {}) {
-    const writerIdKey = `${storageKeyPrefix}writerId`;
-    const legacyKey = `${storageKeyPrefix}clientId`;
-    try {
-        let id = localStorage.getItem(writerIdKey);
-        if (!id) {
-            id = localStorage.getItem(legacyKey) || uuidv7();
-            localStorage.setItem(writerIdKey, id);
-            localStorage.removeItem(legacyKey);
-        }
-        return id;
-    }
-    catch {
-        fallbackWriterId ??= uuidv7();
-        return fallbackWriterId;
-    }
+export function requireRemoteStore() {
+    return requireStorageContext().requireRemoteStore();
 }
-let resolvedWriterId = null;
 /**
- * Installs the session's resolved writer id (called once by the session store,
- * under the app's configured `storageKeyPrefix`, before any replica opens).
+ * Whether the active session has a remote store available.
  *
- * @param id {string}
- * @returns {void}
+ * @returns {boolean}
  */
-export function setWriterId(id) {
-    resolvedWriterId = id;
+export function hasRemoteStore() {
+    return active?.hasRemoteStore() ?? false;
 }
 /**
- * The session's resolved writer id, or throws if it has not been installed
- * yet. Deliberately never falls back to {@link getWriterId}: that would resolve
- * under the DEFAULT key prefix, so an app with a custom `storageKeyPrefix`
- * would silently stamp a second writer id.
+ * The active session's writer id, or throws if no session store exists yet.
+ * Deliberately never falls back to `getWriterId`: that would resolve under the
+ * DEFAULT key prefix, so an app with a custom `storageKeyPrefix` would silently
+ * stamp a second writer id.
  *
  * @returns {string}
  */
 export function requireWriterId() {
-    if (!resolvedWriterId) {
-        throw new Error('Writer id is not resolved; create the session store first.');
-    }
-    return resolvedWriterId;
+    return requireStorageContext().writerId;
 }
 /**
- * Stamps a payload with fresh last-write-wins fields: the current instant as
- * `updatedAt` and the session's resolved 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.
+ * Stamps a payload with fresh last-write-wins fields under the active session
+ * (see {@link StorageContext.stampLww}); the entity-store write verbs call it
+ * on every write, and an app writing through `LocalStore` directly does too.
  *
  * @param payload {object}
  * @returns {object}   the payload with the LWW fields set
  */
 export function stampLww(payload) {
-    return {
-        ...payload,
-        updatedAt: new Date().toISOString(),
-        writerId: requireWriterId()
-    };
+    return requireStorageContext().stampLww(payload);
 }
 //# sourceMappingURL=storageManager.js.map

package/dist/storage/storageManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"storageManager.js","sourceRoot":"","sources":["../../src/storage/storageManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AAKzD,IAAI,UAAU,GAAsB,IAAI,CAAA;AACxC,IAAI,WAAW,GAA0B,IAAI,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,UAAU,GAAG,KAAK,CAAA;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,UAAU,KAAK,IAAI,CAAA;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,UAAU,GAAG,IAAI,CAAA;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqB;IAClD,WAAW,GAAG,KAAK,CAAA;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAA;IACH,CAAC;IACD,OAAO,WAAW,CAAA;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,KAAK,IAAI,CAAA;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,WAAW,GAAG,IAAI,CAAA;AACpB,CAAC;AAED;;;;GAIG;AACH,IAAI,gBAAgB,GAAkB,IAAI,CAAA;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,gBAAgB,GAAG,0BAA0B,KACZ,EAAE;IACnC,MAAM,WAAW,GAAG,GAAG,gBAAgB,UAAU,CAAA;IACjD,MAAM,SAAS,GAAG,GAAG,gBAAgB,UAAU,CAAA;IAC/C,IAAI,CAAC;QACH,IAAI,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAC1C,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,MAAM,EAAE,CAAA;YAChD,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;YACrC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;QACpC,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB,KAAK,MAAM,EAAE,CAAA;QAC7B,OAAO,gBAAgB,CAAA;IACzB,CAAC;AACH,CAAC;AAED,IAAI,gBAAgB,GAAkB,IAAI,CAAA;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,gBAAgB,GAAG,EAAE,CAAA;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAA;IACH,CAAC;IACD,OAAO,gBAAgB,CAAA;AACzB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAA2B,OAAU;IAC3D,OAAO;QACL,GAAG,OAAO;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,eAAe,EAAE;KAC5B,CAAA;AACH,CAAC"}
+{"version":3,"file":"storageManager.js","sourceRoot":"","sources":["../../src/storage/storageManager.ts"],"names":[],"mappings":"AAyBA,IAAI,MAAM,GAA0B,IAAI,CAAA;AAExC;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,IAAI,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,wDAAwD;YACtD,8DAA8D,CACjE,CAAA;IACH,CAAC;IACD,MAAM,GAAG,OAAO,CAAA;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAuB;IAC9D,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,MAAM,GAAG,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,KAAK,IAAI,CAAA;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,qBAAqB,EAAE,CAAC,YAAY,EAAE,CAAA;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,EAAE,QAAQ,EAAE,IAAI,KAAK,CAAA;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,qBAAqB,EAAE,CAAC,kBAAkB,EAAE,CAAA;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,EAAE,cAAc,EAAE,IAAI,KAAK,CAAA;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,qBAAqB,EAAE,CAAC,QAAQ,CAAA;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAA2B,OAAU;IAC3D,OAAO,qBAAqB,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AAClD,CAAC"}

package/dist/storage/syncController.d.ts

@@ -3,6 +3,7 @@ import { type SyncedDoc } from '../sync/index.js';
 import { type WasCollectionConfig, type WasSyncConfig } from '../config.js';
 import type { LocalStore } from './localStore.js';
 import type { WasRemoteStore } from './wasRemoteStore.js';
+import type { SyncStatusStore } from './syncStatusStore.js';
 /**
  * Whether a replication error signals expired/revoked storage access. Every WAS
  * request the replication makes funnels through the sync port, which maps a
@@ -24,8 +25,16 @@ export declare function isAuthError(err: unknown): boolean;
  */
 export declare class SyncController {
     #private;
-    constructor({ collections, sync }: {
+    /**
+     * @param options {object}
+     * @param options.collections {WasCollectionConfig[]}
+     * @param options.syncStatus {SyncStatusStore}   the session's per-collection
+     *   status store this controller reports into
+     * @param [options.sync] {WasSyncConfig}
+     */
+    constructor({ collections, syncStatus, sync }: {
         collections: WasCollectionConfig[];
+        syncStatus: SyncStatusStore;
         sync?: WasSyncConfig;
     });
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"syncController.d.ts","sourceRoot":"","sources":["../../src/storage/syncController.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAML,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAQzD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA+BjD;AAED;;GAEG;AACH,qBAAa,cAAc;;gBAYb,EACV,WAAW,EACX,IAAI,EACL,EAAE;QACD,WAAW,EAAE,mBAAmB,EAAE,CAAA;QAClC,IAAI,CAAC,EAAE,aAAa,CAAA;KACrB;IAKD;;;;;;;;;;;;;OAaG;IACG,KAAK,CAAC,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,WAAW,EACZ,EAAE;QACD,WAAW,EAAE,cAAc,CAAA;QAC3B,UAAU,EAAE,UAAU,CAAA;QACtB,cAAc,CAAC,EAAE,CACf,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,KAC5B,IAAI,CAAA;QACT,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;KACzB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgIjB;;;;;OAKG;IACH,MAAM,IAAI,IAAI;IAMd;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B"}
+{"version":3,"file":"syncController.d.ts","sourceRoot":"","sources":["../../src/storage/syncController.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAML,KAAK,SAAS,EACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EACnB,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAO3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA+BjD;AAED;;GAEG;AACH,qBAAa,cAAc;;IAazB;;;;;;OAMG;gBACS,EACV,WAAW,EACX,UAAU,EACV,IAAI,EACL,EAAE;QACD,WAAW,EAAE,mBAAmB,EAAE,CAAA;QAClC,UAAU,EAAE,eAAe,CAAA;QAC3B,IAAI,CAAC,EAAE,aAAa,CAAA;KACrB;IAMD;;;;;;;;;;;;;OAaG;IACG,KAAK,CAAC,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,WAAW,EACZ,EAAE;QACD,WAAW,EAAE,cAAc,CAAA;QAC3B,UAAU,EAAE,UAAU,CAAA;QACtB,cAAc,CAAC,EAAE,CACf,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,KAC5B,IAAI,CAAA;QACT,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;KACzB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgIjB;;;;;OAKG;IACH,MAAM,IAAI,IAAI;IAMd;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B"}

package/dist/storage/syncController.js

@@ -1,6 +1,5 @@
 import { createWasReplication, createWasSyncPort, withFeedMasterRead, WasSyncAuthError } from '../sync/index.js';
 import { DEFAULT_SYNC_POLL_MS } from '../config.js';
-import { useSyncStatusStore } from './syncStatusStore.js';
 /**
  * Whether a replication error signals expired/revoked storage access. Every WAS
  * request the replication makes funnels through the sync port, which maps a
@@ -48,13 +47,22 @@ export function isAuthError(err) {
 export class SyncController {
     #collections;
     #sync;
+    #syncStatus;
     #replications = [];
     #onlineHandler;
     #pollTimer;
     #started = false;
     #stopped = false;
-    constructor({ collections, sync }) {
+    /**
+     * @param options {object}
+     * @param options.collections {WasCollectionConfig[]}
+     * @param options.syncStatus {SyncStatusStore}   the session's per-collection
+     *   status store this controller reports into
+     * @param [options.sync] {WasSyncConfig}
+     */
+    constructor({ collections, syncStatus, sync }) {
         this.#collections = collections;
+        this.#syncStatus = syncStatus;
         this.#sync = sync ?? {};
     }
     /**
@@ -79,7 +87,7 @@ export class SyncController {
             return;
         }
         this.#started = true;
-        const setStatus = useSyncStatusStore.getState().setStatus;
+        const setStatus = this.#syncStatus.getState().setStatus;
         const batchSize = this.#sync.batchSize;
         const retryMs = this.#sync.retryMs;
         const pollMs = this.#sync.pollMs ?? DEFAULT_SYNC_POLL_MS;
@@ -211,7 +219,7 @@ export class SyncController {
         // bootstrap) sees the controller as terminally stopped and bails.
         this.#stopped = true;
         await this.#teardownReplications();
-        useSyncStatusStore.getState().reset();
+        this.#syncStatus.getState().reset();
         this.#started = false;
     }
 }

package/dist/storage/syncController.js.map

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

package/dist/storage/syncStatusStore.d.ts

@@ -1,3 +1,15 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * The per-collection replication status store, mirroring the WAS per-replica
+ * sync-status vocabulary, keyed by the registry's logical collection key. One
+ * is created per {@link StorageContext} (so per session provider, never
+ * process-wide): the sync controller writes to it off the RxDB replication
+ * `active$` / `error$` streams, and `useSyncStatus` reads it through the
+ * provider. In-memory only, like the session -- reset on logout.
+ */
+import { type StoreApi } from 'zustand/vanilla';
 /**
  * A single collection's replication status:
  * - `idle`    -- configured but no cycle has run yet
@@ -6,7 +18,7 @@
  * - `error`   -- last cycle failed (RxDB is backing off / will retry)
  */
 export type SyncStatus = 'idle' | 'syncing' | 'synced' | 'error';
-export declare const useSyncStatusStore: import("zustand").UseBoundStore<import("zustand").StoreApi<{
+interface SyncStatusState {
     /**
      * Keyed by the registry's LOGICAL collection key (`WasCollectionConfig.key`,
      * e.g. `actionItems`), not the WAS wire id. Two registry entries may share one
@@ -17,7 +29,15 @@ export declare const useSyncStatusStore: import("zustand").UseBoundStore<import(
     statuses: Record<string, SyncStatus>;
     setStatus: (collectionKey: string, status: SyncStatus) => void;
     reset: () => void;
-}>>;
+}
+export type SyncStatusStore = StoreApi<SyncStatusState>;
+/**
+ * Creates one session's sync status store (a vanilla zustand store; subscribe
+ * to it from React with zustand's `useStore`).
+ *
+ * @returns {SyncStatusStore}
+ */
+export declare function createSyncStatusStore(): SyncStatusStore;
 /**
  * The aggregate replication status derived from the per-collection statuses:
  * `offline` when no replication is running (local-only), otherwise rolled up as
@@ -41,4 +61,5 @@ export declare function deriveSyncRollup(statuses: SyncStatus[]): {
     label: string;
     title: string;
 };
+export {};
 //# sourceMappingURL=syncStatusStore.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"syncStatusStore.d.ts","sourceRoot":"","sources":["../../src/storage/syncStatusStore.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEhE,eAAO,MAAM,kBAAkB;IAC7B;;;;;;OAMG;cACO,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;eACzB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI;WACvD,MAAM,IAAI;GAQhB,CAAA;AAEH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEnE;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG;IACxD,KAAK,EAAE,UAAU,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd,CA2BA"}
+{"version":3,"file":"syncStatusStore.d.ts","sourceRoot":"","sources":["../../src/storage/syncStatusStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;GAOG;AACH,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEhE,UAAU,eAAe;IACvB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACpC,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IAC9D,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAA;AAEvD;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CASvD;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEnE;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG;IACxD,KAAK,EAAE,UAAU,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd,CA2BA"}

package/dist/storage/syncStatusStore.js

@@ -2,20 +2,29 @@
  * Copyright (c) 2026 Interop Alliance. All rights reserved.
  */
 /**
- * Zustand store holding per-collection replication status, mirroring the WAS
- * per-replica sync-status vocabulary, keyed by the registry's logical collection
- * key. The sync controller writes to it off the RxDB replication `active$` /
- * `error$` streams; UI (e.g. a header indicator or a settings page) reads from
- * it. In-memory only, like the session -- cleared on logout.
+ * The per-collection replication status store, mirroring the WAS per-replica
+ * sync-status vocabulary, keyed by the registry's logical collection key. One
+ * is created per {@link StorageContext} (so per session provider, never
+ * process-wide): the sync controller writes to it off the RxDB replication
+ * `active$` / `error$` streams, and `useSyncStatus` reads it through the
+ * provider. In-memory only, like the session -- reset on logout.
  */
-import { create } from 'zustand';
-export const useSyncStatusStore = create()(set => ({
-    statuses: {},
-    setStatus: (collectionKey, status) => set(state => ({
-        statuses: { ...state.statuses, [collectionKey]: status }
-    })),
-    reset: () => set({ statuses: {} })
-}));
+import { createStore } from 'zustand/vanilla';
+/**
+ * Creates one session's sync status store (a vanilla zustand store; subscribe
+ * to it from React with zustand's `useStore`).
+ *
+ * @returns {SyncStatusStore}
+ */
+export function createSyncStatusStore() {
+    return createStore()(set => ({
+        statuses: {},
+        setStatus: (collectionKey, status) => set(state => ({
+            statuses: { ...state.statuses, [collectionKey]: status }
+        })),
+        reset: () => set({ statuses: {} })
+    }));
+}
 /**
  * Rolls the per-collection replication statuses up to a single aggregate plus
  * its display copy. With no collections registered it reports `offline`

package/dist/storage/syncStatusStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"syncStatusStore.js","sourceRoot":"","sources":["../../src/storage/syncStatusStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;GAMG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAWhC,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,EAWpC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,CACnC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACZ,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE;KACzD,CAAC,CAAC;IACL,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;CACnC,CAAC,CAAC,CAAA;AASH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IAKrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,mDAAmD;SAC3D,CAAA;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,KAAK,EAAE,OAAO;YACd,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,+DAA+D;SACvE,CAAA;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,sDAAsD;SAC9D,CAAA;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,oDAAoD;KAC5D,CAAA;AACH,CAAC"}
+{"version":3,"file":"syncStatusStore.js","sourceRoot":"","sources":["../../src/storage/syncStatusStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAiB,MAAM,iBAAiB,CAAA;AA0B5D;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,WAAW,EAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5C,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,CACnC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACZ,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE;SACzD,CAAC,CAAC;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;KACnC,CAAC,CAAC,CAAA;AACL,CAAC;AASD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IAKrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,mDAAmD;SAC3D,CAAA;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,KAAK,EAAE,OAAO;YACd,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,+DAA+D;SACvE,CAAA;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,sDAAsD;SAC9D,CAAA;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,oDAAoD;KAC5D,CAAA;AACH,CAAC"}

package/dist/storage/writerId.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A stable per-install writer id (the last-write-wins tiebreak stamped into
+ * every payload), persisted in localStorage under `<prefix>writerId`. In an
+ * environment without `localStorage` it falls back to a process-stable
+ * unpersisted id instead of throwing.
+ *
+ * The id is an unkeyed, clearable attribution label -- never an identity. On a
+ * miss it adopts a value left under the pre-rename `<prefix>clientId` key and
+ * removes the old one, so an existing install keeps stamping the same id
+ * across the rename rather than looking like a second writer.
+ *
+ * @param [options] {object}
+ * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
+ *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
+ * @returns {string}
+ */
+export declare function getWriterId({ storageKeyPrefix }?: {
+    storageKeyPrefix?: string;
+}): string;
+/**
+ * Clears the persisted writer id (the clear-data grade of the wipe): removes
+ * both the current key and the pre-rename one, so nothing this library wrote
+ * survives in localStorage. Only persistence is touched; the running session's
+ * in-memory id is replaced by {@link StorageContext.resetWriterId}, because the
+ * session keeps running over its new anonymous replica and its write verbs
+ * still have to stamp.
+ *
+ * @param [options] {object}
+ * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
+ *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
+ * @returns {void}
+ */
+export declare function clearPersistedWriterId({ storageKeyPrefix }?: {
+    storageKeyPrefix?: string;
+}): void;
+//# sourceMappingURL=writerId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writerId.d.ts","sourceRoot":"","sources":["../../src/storage/writerId.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,EAC1B,gBAA6C,EAC9C,GAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAe7C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,gBAA6C,EAC9C,GAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAQ3C"}

package/dist/storage/writerId.js

@@ -0,0 +1,76 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * Persistence of the per-install writer id: the last-write-wins tiebreak the
+ * storage context stamps into every payload. {@link getWriterId} resolves it
+ * from localStorage (minting one on a miss), {@link clearPersistedWriterId}
+ * removes it (the clear-data grade of the wipe). The in-memory value a session
+ * stamps with lives on its {@link StorageContext}; nothing here holds state
+ * beyond the no-localStorage fallback.
+ */
+import { uuidv7 } from 'uuidv7';
+import { DEFAULT_STORAGE_KEY_PREFIX } from '../config.js';
+/**
+ * The unpersisted fallback writer id for environments without `localStorage`
+ * (tests, SSR): process-stable, so every resolution within one run agrees,
+ * minted fresh on the next run.
+ */
+let fallbackWriterId = null;
+/**
+ * A stable per-install writer id (the last-write-wins tiebreak stamped into
+ * every payload), persisted in localStorage under `<prefix>writerId`. In an
+ * environment without `localStorage` it falls back to a process-stable
+ * unpersisted id instead of throwing.
+ *
+ * The id is an unkeyed, clearable attribution label -- never an identity. On a
+ * miss it adopts a value left under the pre-rename `<prefix>clientId` key and
+ * removes the old one, so an existing install keeps stamping the same id
+ * across the rename rather than looking like a second writer.
+ *
+ * @param [options] {object}
+ * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
+ *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
+ * @returns {string}
+ */
+export function getWriterId({ storageKeyPrefix = DEFAULT_STORAGE_KEY_PREFIX } = {}) {
+    const writerIdKey = `${storageKeyPrefix}writerId`;
+    const legacyKey = `${storageKeyPrefix}clientId`;
+    try {
+        let id = localStorage.getItem(writerIdKey);
+        if (!id) {
+            id = localStorage.getItem(legacyKey) || uuidv7();
+            localStorage.setItem(writerIdKey, id);
+            localStorage.removeItem(legacyKey);
+        }
+        return id;
+    }
+    catch {
+        fallbackWriterId ??= uuidv7();
+        return fallbackWriterId;
+    }
+}
+/**
+ * Clears the persisted writer id (the clear-data grade of the wipe): removes
+ * both the current key and the pre-rename one, so nothing this library wrote
+ * survives in localStorage. Only persistence is touched; the running session's
+ * in-memory id is replaced by {@link StorageContext.resetWriterId}, because the
+ * session keeps running over its new anonymous replica and its write verbs
+ * still have to stamp.
+ *
+ * @param [options] {object}
+ * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
+ *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
+ * @returns {void}
+ */
+export function clearPersistedWriterId({ storageKeyPrefix = DEFAULT_STORAGE_KEY_PREFIX } = {}) {
+    try {
+        localStorage.removeItem(`${storageKeyPrefix}writerId`);
+        localStorage.removeItem(`${storageKeyPrefix}clientId`);
+    }
+    catch {
+        // No localStorage in this environment: nothing was persisted to clear.
+    }
+    fallbackWriterId = null;
+}
+//# sourceMappingURL=writerId.js.map

package/dist/storage/writerId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writerId.js","sourceRoot":"","sources":["../../src/storage/writerId.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AAEzD;;;;GAIG;AACH,IAAI,gBAAgB,GAAkB,IAAI,CAAA;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,gBAAgB,GAAG,0BAA0B,KACZ,EAAE;IACnC,MAAM,WAAW,GAAG,GAAG,gBAAgB,UAAU,CAAA;IACjD,MAAM,SAAS,GAAG,GAAG,gBAAgB,UAAU,CAAA;IAC/C,IAAI,CAAC;QACH,IAAI,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAC1C,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,MAAM,EAAE,CAAA;YAChD,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;YACrC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;QACpC,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB,KAAK,MAAM,EAAE,CAAA;QAC7B,OAAO,gBAAgB,CAAA;IACzB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,EACrC,gBAAgB,GAAG,0BAA0B,KACZ,EAAE;IACnC,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,CAAC,GAAG,gBAAgB,UAAU,CAAC,CAAA;QACtD,YAAY,CAAC,UAAU,CAAC,GAAG,gBAAgB,UAAU,CAAC,CAAA;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;IACD,gBAAgB,GAAG,IAAI,CAAA;AACzB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@interop/was-react",
   "description": "React library for building 'Bring Your Own Everything' (BYOE) apps on Wallet Attached Storage: DID Auth login via CHAPI wallet, local-first encrypted storage, and background sync to a WAS server.",
-  "version": "0.18.1",
+  "version": "0.20.0",
   "type": "module",
   "scripts": {
     "build": "pnpm run clear && tsc",
@@ -46,18 +46,18 @@
   "types": "dist/index.d.ts",
   "sideEffects": false,
   "dependencies": {
-    "@interop/data-integrity-core": "^8.4.0",
-    "@interop/did-method-webvh": "^5.2.0",
-    "@interop/ed25519-signature": "^7.1.4",
-    "@interop/ezcap": "^7.4.1",
-    "@interop/security-document-loader": "^10.0.0",
-    "@interop/vc": "^11.0.6",
-    "@interop/verifier-core": "^3.5.4",
-    "@interop/wallet-core": "^0.36.1",
-    "@interop/was-client": "^0.37.0",
-    "@interop/webkms-client": "^14.7.1",
+    "@interop/data-integrity-core": "^8.7.1",
+    "@interop/did-method-webvh": "^5.6.1",
+    "@interop/ed25519-signature": "^7.2.0",
+    "@interop/ezcap": "^7.4.5",
+    "@interop/security-document-loader": "^10.1.0",
+    "@interop/vc": "^11.0.7",
+    "@interop/verifier-core": "^3.5.5",
+    "@interop/wallet-core": "^0.66.0",
+    "@interop/was-client": "^0.47.0",
+    "@interop/webkms-client": "^14.7.4",
     "@scure/base": "^2.2.0",
-    "byoe-context": "^0.3.0",
+    "byoe-context": "^0.5.0",
     "credential-handler-polyfill": "^4.1.0",
     "uuidv7": "^1.2.1"
   },
@@ -110,7 +110,7 @@
     "typescript-eslint": "^8.59.4",
     "vite": "^8.0.14",
     "vitest": "^4.1.7",
-    "was-teaching-server": "^0.21.0",
+    "was-teaching-server": "^0.25.1",
     "zustand": "^5.0.12"
   },
   "publishConfig": {