@rtc-agent/component 0.2.8-rc.4 → 0.2.9-rc.0

package/dist/worker-bridge.d.ts

@@ -44,9 +44,27 @@ export declare class WorkerBridge {
     /** Comlink-proxied callbacks (for cross-Worker transfer). */
     private _proxiedCallbacks;
     private _initialized;
+    /** Promise-based dedup guard: concurrent init() calls share the same initialization. */
+    private _initPromise;
+    /** AbortController for cancelling ongoing catch-up */
+    private _catchUpAbortController?;
     private _config;
     /** Connection state listeners (main-thread side). */
     private _connectionListeners;
+    /**
+     * Whether sessionStorage cursor has been restored (only once per instance lifetime).
+     * Prevents destroy(false) + init() from re-loading a stale sessionStorage cursor.
+     */
+    private _hasRestoredFromStorage;
+    /**
+     * Last processed UI update sequence number (for catch-up after page refresh).
+     * Persisted in sessionStorage to survive page refreshes within the same tab.
+     * Updated during both catch-up and real-time broadcasts to minimize redundant replays.
+     */
+    private _lastProcessedSeq;
+    /** Database name for scoping sessionStorage key (prevents cross-instance collisions). */
+    private _databaseName;
+    private static readonly SESSION_STORAGE_KEY_PREFIX;
     private static readonly MAX_INIT_RETRIES;
     private static readonly INIT_RETRY_DELAY_MS;
     /** Timeout for worker liveness verification (ping/pong). */
@@ -112,19 +130,31 @@ export declare class WorkerBridge {
      * 1. Call Worker's core.init() to initialize shared state.
      * 2. Register this tab's callbacks (onUIUpdate + requestToken + onConnectionStateChange).
      * 3. Open the port to start communication.
+     * 4. Catch up on missed UI update events (persisted in Worker's IndexedDB).
+     *    Callbacks are registered first so real-time events arriving during catch-up
+     *    update _lastProcessedSeq, preventing both loss and duplication.
      *
      * Idempotent: only the first call takes effect.
+     * Concurrent calls share the same initialization Promise (no double catch-up).
      * Must call initWorker() first.
      */
     init(config: PersistenceConfig): Promise<void>;
+    /**
+     * Internal initialization logic.
+     */
+    private _doInit;
     /**
      * Destroy the bridge.
      *
      * 1. Unregister callbacks.
      * 2. Close the port.
      * 3. Terminate the Worker (note: SharedWorker only terminates after all ports are closed).
+     *
+     * @param clearStorage - If true, clear sessionStorage cursor (use when tab is closing).
+     *                       If false (default), keep cursor so component remount doesn't trigger
+     *                       redundant catch-up. Only clear on actual tab close (beforeunload).
      */
-    destroy(): Promise<void>;
+    destroy(clearStorage?: boolean): Promise<void>;
     /**
      * Get the current connection state of RTCAgentClient in the Worker.
      *
@@ -148,5 +178,54 @@ export declare class WorkerBridge {
      * Note: virtualFS is a module-level singleton; the replacement is global.
      */
     installVirtualFSProxy(): void;
+    /**
+     * Catch up on missed UI update events from the Worker's persistent queue.
+     *
+     * Called AFTER registerCallback(), so real-time events arriving during catch-up
+     * will update _lastProcessedSeq via the onUIUpdate callback. The catch-up query
+     * uses `seq > _lastProcessedSeq`, so it automatically skips events already
+     * delivered in real-time — preventing both loss and duplication.
+     *
+     * Paginated: handles >1000 missed events by looping until hasMore is false.
+     * Idempotent: skips entries with seq <= _lastProcessedSeq (guards against
+     * events delivered in real-time between the query and the loop iteration).
+     * Gap-aware: if hasGap is true, stops and signals onStateGap for full refresh.
+     */
+    private _doCatchUp;
+    /**
+     * Yield control to the main thread to allow UI rendering and user interaction.
+     *
+     * Uses MessageChannel to schedule a macrotask without setTimeout's 4ms minimum
+     * delay floor (imposed by HTML spec for deeply-nested setTimeout calls).
+     * MessageChannel.postMessage() enqueues a 'message' event as a macrotask,
+     * which fires on the next event-loop turn with ~0ms latency.
+     *
+     * Combined with time-slicing in _doCatchUp, this prevents UI jank regardless
+     * of browser (works on Safari which lacks requestIdleCallback).
+     */
+    private _yieldToMain;
+    /**
+     * Runtime type validation for UIUpdateEvent.
+     *
+     * Ensures the event structure is valid before processing (guards against
+     * corrupted IndexedDB data or schema mismatches after upgrades).
+     */
+    private _isValidUIUpdateEvent;
+    /**
+     * Update the last processed seq and persist to sessionStorage.
+     */
+    private _updateLastProcessedSeq;
+    /**
+     * Get the sessionStorage key for this instance (scoped by databaseName).
+     */
+    private _getSessionStorageKey;
+    /**
+     * Load last processed seq from sessionStorage.
+     */
+    private _loadLastProcessedSeq;
+    /**
+     * Save last processed seq to sessionStorage.
+     */
+    private _saveLastProcessedSeq;
 }
 //# sourceMappingURL=worker-bridge.d.ts.map

package/dist/worker-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-bridge.d.ts","sourceRoot":"","sources":["../src/worker-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAc,KAAK,MAAM,EAAC,MAAM,SAAS,CAAC;AAEjD,OAAO,KAAK,EAAC,iBAAiB,EAA4C,MAAM,wBAAwB,CAAC;AACzG,OAAO,KAAK,EAAC,eAAe,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAE7E,OAAO,KAAK,EAAC,qBAAqB,EAAkB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,kCAAkC,CAAC;AAmErE,MAAM,WAAW,kBAAkB;IAC/B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IAqCjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IApC1B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAkB;IACpC,6DAA6D;IAC7D,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAqB;IAEpC,qDAAqD;IACrD,OAAO,CAAC,oBAAoB,CAAoD;IAEhF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IACnD,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IAEvD;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;gBAUR,KAAK,EAAE,cAAc,EACtC,MAAM,GAAE,kBAAuB;IAuDnC;;;;;;;;;;;;OAYG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC;;OAEG;YACW,eAAe;IAuG7B;;;;;;OAMG;YACW,kBAAkB;IA0ChC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAExC;IAED;;;;;;;;;OASG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpD;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB9B;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAIpD;;;;OAIG;IACH,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IASpF;;;;;;;;;OASG;IACH,qBAAqB,IAAI,IAAI;CAyChC"}
+{"version":3,"file":"worker-bridge.d.ts","sourceRoot":"","sources":["../src/worker-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAc,KAAK,MAAM,EAAC,MAAM,SAAS,CAAC;AAEjD,OAAO,KAAK,EAAC,iBAAiB,EAA4C,MAAM,wBAAwB,CAAC;AACzG,OAAO,KAAK,EAAC,eAAe,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAE7E,OAAO,KAAK,EAAC,qBAAqB,EAAmC,MAAM,mBAAmB,CAAC;AAC/F,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,kCAAkC,CAAC;AAmErE,MAAM,WAAW,kBAAkB;IAC/B;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IAyDjB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAxD1B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAkB;IACpC,6DAA6D;IAC7D,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,YAAY,CAAS;IAC7B,wFAAwF;IACxF,OAAO,CAAC,YAAY,CAA8B;IAClD,sDAAsD;IACtD,OAAO,CAAC,uBAAuB,CAAC,CAAkB;IAClD,OAAO,CAAC,OAAO,CAAqB;IAEpC,qDAAqD;IACrD,OAAO,CAAC,oBAAoB,CAAoD;IAEhF;;;OAGG;IACH,OAAO,CAAC,uBAAuB,CAAS;IAExC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAAS;IAClC,yFAAyF;IACzF,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAuB;IAEzE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAK;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IACnD,4DAA4D;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IAEvD;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;gBAUR,KAAK,EAAE,cAAc,EACtC,MAAM,GAAE,kBAAuB;IA6EnC;;;;;;;;;;;;OAYG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BjC;;OAEG;YACW,eAAe;IAuG7B;;;;;;OAMG;YACW,kBAAkB;IA0ChC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAExC;IAED;;;;;;;;;;;;;OAaG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBpD;;OAEG;YACW,OAAO;IAiCrB;;;;;;;;;;OAUG;IACG,OAAO,CAAC,YAAY,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAqClD;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAIpD;;;;OAIG;IACH,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;IASpF;;;;;;;;;OASG;IACH,qBAAqB,IAAI,IAAI;IA4C7B;;;;;;;;;;;;OAYG;YACW,UAAU;IAmGxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY;IAYpB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAK/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAQhC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtc-agent/component",
-  "version": "0.2.8-rc.4",
+  "version": "0.2.9-rc.0",
   "description": "RTC Agent Web Components（基于 Lit）",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,10 +32,10 @@
     "lit": "^3.1.0",
     "marked": "^18.0.11",
     "zod": "^3.23.8",
-    "@rtc-agent/client": "0.2.8-rc.4",
-    "@rtc-agent/protocol": "0.2.8-rc.4",
-    "@rtc-agent/worker": "0.2.8-rc.4",
-    "@rtc-agent/persistence": "0.2.8-rc.4"
+    "@rtc-agent/client": "0.2.9-rc.0",
+    "@rtc-agent/protocol": "0.2.9-rc.0",
+    "@rtc-agent/worker": "0.2.9-rc.0",
+    "@rtc-agent/persistence": "0.2.9-rc.0"
   },
   "devDependencies": {
     "@lit/localize-tools": "^0.8.2",