@interop/was-react 0.19.0 → 0.20.1

package/dist/storage/rehydrate.d.ts

@@ -1,64 +0,0 @@
-/*!
- * Copyright (c) 2026 Interop Alliance. All rights reserved.
- */
-/**
- * The hydration MECHANISM: the per-collection re-hydrate hooks (decrypt the
- * localStore rows into the app's stores) plus the debounced remote-change
- * scheduler used by every sync entry point. Generic over an injected
- * {@link StoreRegistry} -- the app supplies the concrete per-collection
- * handlers; nothing here knows the domain entities.
- */
-import type { Json } from '../sync/index.js';
-import type { StoreRegistry } from '../config.js';
-/**
- * Hydrates every registered store from the (already opened) localStore.
- *
- * @param registry {StoreRegistry}
- * @returns {Promise<void>}
- */
-export declare function hydrateAll(registry: StoreRegistry): Promise<void>;
-/**
- * Empties every registered store (logout).
- *
- * @param registry {StoreRegistry}
- * @returns {void}
- */
-export declare function clearAllEntityStores(registry: StoreRegistry): 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.
- *
- * @param registry {StoreRegistry}
- * @param collectionKey {string}
- * @param event {object}   an RxDB change event (operation + documentData)
- * @returns {Promise<void>}
- */
-export declare function patchFromChange(registry: StoreRegistry, 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.
- *
- * @param registry {StoreRegistry}
- * @param collectionKey {string}
- * @returns {void}
- */
-export declare function scheduleRehydrate(registry: StoreRegistry, collectionKey: string): void;
-/**
- * Cancels every pending debounced re-hydrate. Called on logout so a timer that
- * fires after the LocalStore is torn down does not reach a `requireStore()` that
- * throws (an unhandled rejection).
- *
- * @returns {void}
- */
-export declare function cancelScheduledRehydrates(): void;
-//# sourceMappingURL=rehydrate.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"rehydrate.d.ts","sourceRoot":"","sources":["../../src/storage/rehydrate.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAIlE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAC/D,GACA,OAAO,CAAC,IAAI,CAAC,CAsDf;AAOD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EACvB,aAAa,EAAE,MAAM,GACpB,IAAI,CAqBN;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAKhD"}

package/dist/storage/rehydrate.js

@@ -1,132 +0,0 @@
-import { hasStore, requireStore } from './storageManager.js';
-/**
- * Hydrates every registered store from the (already opened) localStore.
- *
- * @param registry {StoreRegistry}
- * @returns {Promise<void>}
- */
-export async function hydrateAll(registry) {
-    await Promise.all(Object.values(registry).map(entry => entry.hydrate()));
-}
-/**
- * Empties every registered store (logout).
- *
- * @param registry {StoreRegistry}
- * @returns {void}
- */
-export function clearAllEntityStores(registry) {
-    for (const entry of Object.values(registry)) {
-        entry.clear();
-    }
-}
-/**
- * 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.
- *
- * @param registry {StoreRegistry}
- * @param collectionKey {string}
- * @param event {object}   an RxDB change event (operation + documentData)
- * @returns {Promise<void>}
- */
-export async function patchFromChange(registry, collectionKey, event) {
-    const entry = registry[collectionKey];
-    if (!entry) {
-        return;
-    }
-    const row = event.documentData;
-    const envelope = row?.data;
-    const deleted = event.operation === 'DELETE' || row?._deleted === true;
-    if (!row || envelope === undefined) {
-        scheduleRehydrate(registry, collectionKey);
-        return;
-    }
-    // Capture the store BEFORE the decrypt await. This patch is fired floating
-    // off the RxDB change stream, so a logout/login teardown can clear or SWAP
-    // the process-wide holder while the decrypt is in flight; re-resolving the
-    // holder after the await would either throw (an unhandled rejection) or --
-    // worse -- write the previous session's payload and envelope id into the
-    // NEW session's replica. The captured store plus the identity re-check
-    // below makes a patch that outlives its store a silent no-op.
-    if (!hasStore()) {
-        return;
-    }
-    const store = requireStore();
-    let payload;
-    try {
-        payload = await store.decryptEnvelope(collectionKey, envelope);
-    }
-    catch {
-        scheduleRehydrate(registry, collectionKey);
-        return;
-    }
-    // Bail if the holder changed or closed across the await: this event belongs
-    // to the torn-down session, not the one now live.
-    if (!hasStore() || requireStore() !== store) {
-        return;
-    }
-    if (deleted) {
-        // Only honor a tombstone for the envelope the entity currently lives in.
-        // A delete of a DIFFERENT envelope that decrypts to the same logical id is
-        // a stale duplicate being cleaned up (a reconciled singleton loser, or the
-        // pre-resurrection row of a locally re-created doc) -- dropping the live
-        // doc for it would undo the reconciliation/resurrection.
-        const mapped = store.envelopeIdFor(collectionKey, payload.id);
-        if (mapped !== undefined && mapped !== row.id) {
-            return;
-        }
-        store.forgetEnvelope(collectionKey, payload.id);
-        entry.drop(payload.id);
-    }
-    else {
-        store.rememberEnvelope(collectionKey, payload.id, row.id);
-        entry.upsert(payload);
-    }
-}
-/**
- * Per-collection debounce timers coalescing a pull burst into one hydrate.
- */
-const rehydrateTimers = new Map();
-/**
- * Schedules a debounced re-hydrate of one collection's store after a pull.
- *
- * @param registry {StoreRegistry}
- * @param collectionKey {string}
- * @returns {void}
- */
-export function scheduleRehydrate(registry, collectionKey) {
-    const entry = registry[collectionKey];
-    if (!entry) {
-        return;
-    }
-    const existing = rehydrateTimers.get(collectionKey);
-    if (existing) {
-        clearTimeout(existing);
-    }
-    rehydrateTimers.set(collectionKey, setTimeout(() => {
-        rehydrateTimers.delete(collectionKey);
-        // A timer that outlived logout must not touch a torn-down store: hydrate
-        // reaches for `requireStore()`, which throws once the store is cleared.
-        if (!hasStore()) {
-            return;
-        }
-        void entry.hydrate();
-    }, 50));
-}
-/**
- * Cancels every pending debounced re-hydrate. Called on logout so a timer that
- * fires after the LocalStore is torn down does not reach a `requireStore()` that
- * throws (an unhandled rejection).
- *
- * @returns {void}
- */
-export function cancelScheduledRehydrates() {
-    for (const timer of rehydrateTimers.values()) {
-        clearTimeout(timer);
-    }
-    rehydrateTimers.clear();
-}
-//# sourceMappingURL=rehydrate.js.map

package/dist/storage/rehydrate.js.map

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