@interop/was-react 0.19.0 → 0.20.0

package/dist/storage/storageManager.d.ts

@@ -1,115 +1,96 @@
+/*!
+ * Copyright (c) 2026 Interop Alliance. All rights reserved.
+ */
+/**
+ * The storage manager: the one remaining process-wide pointer, to the ACTIVE
+ * {@link StorageContext}, plus the app-facing facades over it. Entity stores
+ * are created at module level, before any session exists, so their verbs
+ * cannot hold a context of their own; they reach the live session through
+ * {@link requireStore} / {@link requireRemoteStore} / {@link stampLww} here,
+ * which resolve to whichever context is active. Keeping the facade free of
+ * store imports (no cycle) also lets the session store own the init/hydrate
+ * ordering.
+ *
+ * Activation is deliberate about the two-providers case: a context with a
+ * replica attached is live, and a live context is never replaced -- a second
+ * session attaching a replica of its own throws instead of silently taking the
+ * facades over. A context without a replica (created but not booted, or torn
+ * down) is inert and is replaced without complaint, which is what a React
+ * dev-mode double `useState` initializer or a test's sequence of stores needs.
+ */
 import type { LwwFields } from '../sync/lww.js';
 import type { LocalStore } from './localStore.js';
+import type { StorageContext } from './storageContext.js';
 import type { WasRemoteStore } from './wasRemoteStore.js';
 /**
- * Installs the opened store (called once by the app bootstrap).
+ * 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.
  *
- * @param store {LocalStore}
+ * @param context {StorageContext}
  * @returns {void}
  */
-export declare function setLocalStore(store: LocalStore): void;
+export declare function activateStorageContext(context: StorageContext): void;
 /**
- * The opened store, or throws if the app has not bootstrapped yet.
+ * Releases the active pointer if `context` holds it (a torn-down session); a
+ * no-op for any other context.
  *
- * @returns {LocalStore}
+ * @param context {StorageContext}
+ * @returns {void}
  */
-export declare function requireStore(): LocalStore;
+export declare function deactivateStorageContext(context: StorageContext): void;
 /**
- * Whether the store has been opened.
+ * Whether a storage context is active.
  *
  * @returns {boolean}
  */
-export declare function hasStore(): boolean;
+export declare function hasStorageContext(): boolean;
 /**
- * Releases the held store reference (logout; the caller closes the db).
+ * The active storage context, or throws if no session store has been created.
  *
- * @returns {void}
+ * @returns {StorageContext}
  */
-export declare function clearLocalStore(): void;
+export declare function requireStorageContext(): StorageContext;
 /**
- * Installs the per-session delegated remote store (set once background sync
- * has bootstrapped it from the granted zcaps).
+ * The active session's opened replica, or throws if none is open.
  *
- * @param store {WasRemoteStore}
- * @returns {void}
- */
-export declare function setRemoteStore(store: WasRemoteStore): void;
-/**
- * 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}
+ * @returns {LocalStore}
  */
-export declare function requireRemoteStore(): WasRemoteStore;
+export declare function requireStore(): LocalStore;
 /**
- * Whether a connected session's remote store is available.
+ * Whether the active session has a replica open.
  *
  * @returns {boolean}
  */
-export declare function hasRemoteStore(): boolean;
-/**
- * Releases the held remote store reference (logout / sync teardown).
- *
- * @returns {void}
- */
-export declare function clearRemoteStore(): void;
+export declare function hasStore(): boolean;
 /**
- * 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.
+ * The active session's remote store, or throws while no wallet-connected
+ * session is active.
  *
- * @param [options] {object}
- * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
- *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
- * @returns {string}
+ * @returns {WasRemoteStore}
  */
-export declare function getWriterId({ storageKeyPrefix }?: {
-    storageKeyPrefix?: string;
-}): string;
+export declare function requireRemoteStore(): WasRemoteStore;
 /**
- * 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 declare function setWriterId(id: string): void;
+export declare function hasRemoteStore(): boolean;
 /**
- * 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 declare function requireWriterId(): 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. A fresh id is installed in memory rather than the
- * resolved one being dropped, because the session keeps running over its new
- * anonymous replica and its write verbs still have to stamp; nothing persists
- * it, so the next run resolves and stores an id of its own.
- *
- * @param [options] {object}
- * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
- *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
- * @returns {void}
- */
-export declare function clearWriterId({ storageKeyPrefix }?: {
-    storageKeyPrefix?: string;
-}): void;
-/**
- * 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

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

@@ -1 +1 @@
-{"version":3,"file":"storageManager.d.ts","sourceRoot":"","sources":["../../src/storage/storageManager.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAKzD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAErD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,UAAU,CAKzC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CAOnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AASD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,EAC1B,gBAA6C,EAC9C,GAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAe7C;AAID;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,EAC5B,gBAA6C,EAC9C,GAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAS3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAM5E"}
+{"version":3,"file":"storageManager.d.ts","sourceRoot":"","sources":["../../src/storage/storageManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAIzD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAQpE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAItE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAOtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,UAAU,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAE5E"}

package/dist/storage/storageManager.js

@@ -1,200 +1,105 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * 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.
- *
- * 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,
- * {@link clearWriterId} removes it (the clear-data wipe), 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;
+let active = null;
 /**
- * Installs the opened store (called once by the app bootstrap).
+ * 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.
  *
- * @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;
-}
-/**
- * Whether the store has been opened.
- *
- * @returns {boolean}
- */
-export function hasStore() {
-    return localStore !== null;
+    active = context;
 }
 /**
- * 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;
-}
-/**
- * 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. A fresh id is installed in memory rather than the
- * resolved one being dropped, because the session keeps running over its new
- * anonymous replica and its write verbs still have to stamp; nothing persists
- * it, so the next run resolves and stores an id of its own.
- *
- * @param [options] {object}
- * @param [options.storageKeyPrefix] {string}   the localStorage key prefix
- *   (defaults to {@link DEFAULT_STORAGE_KEY_PREFIX})
- * @returns {void}
- */
-export function clearWriterId({ 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;
-    setWriterId(uuidv7());
+    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":"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"}
+{"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"}