@multiplatform.one/frappe 6.1.0 → 6.4.0

package/dist/cjs/sync/realtime.cjs

@@ -27,6 +27,22 @@ __export(realtime_exports, {
 module.exports = __toCommonJS(realtime_exports);
 var import_types = require("./types.cjs");
 class RealtimeHandler {
+  reconnectAttempts = 0;
+  reconnectTimer;
+  hasConnected = false;
+  /** Live socket state: true between `connected` and `disconnect` events. */
+  connected = false;
+  connectionConfig;
+  /** Refcount of active subscriptions per doctype — drives doctype room membership. */
+  watchedDoctypes = /* @__PURE__ */new Map();
+  /** In-flight authoritative fetches, deduping concurrent doc_update/list_update pairs. */
+  inflightFetches = /* @__PURE__ */new Map();
+  db;
+  realtime;
+  normalizedCache;
+  subscriptionManager;
+  rehydrationManager;
+  options;
   constructor(db, realtime, normalizedCache, subscriptionManager, rehydrationManager, options = {}) {
     this.db = db;
     this.realtime = realtime;
@@ -43,21 +59,40 @@ class RealtimeHandler {
     this.setupRealtimeHandlers();
     this.setupConnectionManagement();
   }
-  db;
-  realtime;
-  normalizedCache;
-  subscriptionManager;
-  rehydrationManager;
-  options;
-  reconnectAttempts = 0;
-  reconnectTimer;
-  hasConnected = false;
-  connectionConfig;
   /**
    * Sets up realtime event handlers for document changes.
+   *
+   * Real Frappe (v15) wire protocol, verified live against a stock bench
+   * (see .test-evidence/storybook-rubric/p-results/frappe-realtime-live-e2e.md):
+   * - `doc_update`  `{doctype, name, modified}` — emitted to the per-doc room
+   *   `doc:{doctype}/{name}` on every save.
+   * - `list_update` `{doctype, name, user}` — emitted to the doctype room
+   *   `doctype:{doctype}` on every save of a non-single, non-child doctype.
+   * - Deletion emits the SAME two events (payload indistinguishable from an
+   *   update) — there is NO `doc_deleted` event. Deletions are detected here
+   *   opportunistically when the authoritative re-fetch 404s, but the durable
+   *   deletion signal remains the tombstone/CDC backfill (`Deleted Document`
+   *   doctype maintained by the `live` app's on_trash hook).
+   *
+   * Both real events funnel into the same fetch-and-reconcile path, deduped
+   * so a doc_update/list_update pair for the same doc costs one fetch.
    */
   setupRealtimeHandlers() {
     if (!this.realtime) return;
+    this.realtime?.on("doc_update", async payload => {
+      if (this.options.onRealtimeEvent) this.options.onRealtimeEvent({
+        type: import_types.RealtimeEventType.DocUpdate,
+        payload
+      });
+      return this.onDocChanged(payload);
+    });
+    this.realtime?.on("list_update", async payload => {
+      if (this.options.onRealtimeEvent) this.options.onRealtimeEvent({
+        type: import_types.RealtimeEventType.ListUpdate,
+        payload
+      });
+      return this.onDocChanged(payload);
+    });
     this.realtime?.on("doc_changed", async payload => {
       if (this.options.onRealtimeEvent) this.options.onRealtimeEvent({
         type: import_types.RealtimeEventType.DocChanged,
@@ -99,6 +134,7 @@ class RealtimeHandler {
    */
   onConnected() {
     this.hasConnected = true;
+    this.connected = true;
     this.reconnectAttempts = 0;
     if (this.reconnectTimer) {
       clearTimeout(this.reconnectTimer);
@@ -112,6 +148,7 @@ class RealtimeHandler {
     if (this.options.onBackfillAll) {
       this.options.onBackfillAll();
     }
+    this.options.onStoreChange?.();
     console.debug("[RealtimeHandler] Connected to realtime server");
   }
   /**
@@ -119,18 +156,24 @@ class RealtimeHandler {
    */
   onDisconnected() {
     console.debug("[RealtimeHandler] Disconnected from realtime server");
+    this.connected = false;
+    this.options.onStoreChange?.();
     if (this.hasConnected) {
       this.scheduleReconnection();
     }
   }
   /**
-   * Attempts to connect to the realtime server.
+   * No-op placeholder retained for the disconnect backoff schedule below.
+   * Transport reconnect is owned by Socket.IO inside RealtimeModule; this
+   * layer only tracks attempts for logging / future health hooks.
    */
   attemptConnection() {
     if (!this.realtime) return;
   }
   /**
-   * Schedules a reconnection attempt with exponential backoff and jitter.
+   * Schedules a reconnection *watchdog* tick with exponential backoff and jitter.
+   * Does not open sockets — RealtimeModule already reconnects. Kept so disconnect
+   * storms remain observable (and existing unit tests stay meaningful).
    */
   scheduleReconnection() {
     if (this.reconnectTimer) {
@@ -156,12 +199,61 @@ class RealtimeHandler {
     delay = Math.round(delay + jitter);
     return Math.max(this.connectionConfig.reconnectBaseDelay, Math.min(delay, this.connectionConfig.reconnectMaxDelay));
   }
+  /**
+   * Join the realtime doctype room for a doctype (refcounted). Called by the
+   * sync module whenever a subscription for the doctype is added. Room
+   * membership survives reconnects — RealtimeModule re-joins tracked rooms on
+   * every `connect`.
+   *
+   * Note: only doctype-level rooms are joined. `list_update` fires for every
+   * save of a regular doctype, which covers doc updates too; per-doc rooms
+   * would only add coverage for single/read-only doctypes.
+   */
+  watchDoctype(doctype) {
+    const count = (this.watchedDoctypes.get(doctype) ?? 0) + 1;
+    this.watchedDoctypes.set(doctype, count);
+    if (count === 1 && this.realtime) {
+      Promise.resolve(this.realtime.subscribeList(doctype)).catch(err => console.warn(`[RealtimeHandler] Failed to join doctype room ${doctype}:`, err));
+    }
+  }
+  /** Release one reference to a doctype room; leaves the room on the last one. */
+  unwatchDoctype(doctype) {
+    const count = (this.watchedDoctypes.get(doctype) ?? 0) - 1;
+    if (count > 0) {
+      this.watchedDoctypes.set(doctype, count);
+      return;
+    }
+    this.watchedDoctypes.delete(doctype);
+    this.realtime?.unsubscribeList(doctype);
+  }
+  /** Leave all doctype rooms (used by cache resets/disposal). */
+  unwatchAll() {
+    if (this.realtime) {
+      for (const doctype of this.watchedDoctypes.keys()) {
+        this.realtime.unsubscribeList(doctype);
+      }
+    }
+    this.watchedDoctypes.clear();
+  }
   /**
    * Realtime handler: authoritative document changed.
    * Fetches document via REST with current user context to respect permissions,
    * updates cache, and reconciles subscription membership.
+   *
+   * Concurrent events for the same document (frappe emits doc_update AND
+   * list_update per save) share a single in-flight fetch.
    */
-  async onDocChanged(payload) {
+  onDocChanged(payload) {
+    const key = `${payload?.doctype}\0${payload?.name}`;
+    const inflight = this.inflightFetches.get(key);
+    if (inflight) return inflight;
+    const fetchPromise = this.fetchAndReconcile(payload).finally(() => {
+      this.inflightFetches.delete(key);
+    });
+    this.inflightFetches.set(key, fetchPromise);
+    return fetchPromise;
+  }
+  async fetchAndReconcile(payload) {
     try {
       const document = await this.db.getDoc(payload.doctype, payload.name);
       this.normalizedCache.upsert(document);
@@ -169,7 +261,12 @@ class RealtimeHandler {
       for (const subscription of subscriptionsNeedingRehydration) {
         this.rehydrationManager?.scheduleRehydration(subscription, import_types.RehydrationReason.RemoteCreate);
       }
+      this.options.onStoreChange?.();
     } catch (err) {
+      if (err?.status === 404) {
+        await this.onDocDeleted(payload);
+        return;
+      }
       console.warn(`Failed to fetch document ${payload?.doctype}/${payload?.name} during realtime update:`, err);
     }
   }
@@ -186,6 +283,7 @@ class RealtimeHandler {
       for (const subscription of affectedSubscriptions) {
         this.rehydrationManager?.scheduleRehydration(subscription, import_types.RehydrationReason.Delete);
       }
+      this.options.onStoreChange?.();
     } catch (err) {
       console.warn(`Failed to process doc_deleted for ${payload?.doctype}/${payload?.name}:`, err);
     }
@@ -199,6 +297,18 @@ class RealtimeHandler {
   getIsConnected() {
     return this.hasConnected;
   }
+  /**
+   * Live connection snapshot for reconnect indicators.
+   * `connected` tracks the socket right now; `everConnected` distinguishes
+   * "reconnecting" (was up, dropped) from "never had realtime" (fixtures,
+   * SSR, no realtime module).
+   */
+  getConnectionState() {
+    return {
+      connected: this.connected,
+      everConnected: this.hasConnected
+    };
+  }
   /**
    * Disposes of resources and clears timers.
    */
@@ -207,6 +317,7 @@ class RealtimeHandler {
       clearTimeout(this.reconnectTimer);
       this.reconnectTimer = void 0;
     }
+    this.unwatchAll();
     if (this.realtime) {
       this.realtime?.disconnect();
     }

package/dist/cjs/sync/realtime.native.js

@@ -68,24 +68,25 @@ var RealtimeHandler = /* @__PURE__ */function () {
     _class_call_check(this, RealtimeHandler2);
     var _ref, _ref1, _ref2, _ref3;
     var _options_connectionConfig, _options_connectionConfig1, _options_connectionConfig2, _options_connectionConfig3;
+    _define_property(this, "reconnectAttempts", 0);
+    _define_property(this, "reconnectTimer", void 0);
+    _define_property(this, "hasConnected", false);
+    _define_property(this, "connected", false);
+    _define_property(this, "connectionConfig", void 0);
+    _define_property(this, "watchedDoctypes", /* @__PURE__ */new Map());
+    _define_property(this, "inflightFetches", /* @__PURE__ */new Map());
     _define_property(this, "db", void 0);
     _define_property(this, "realtime", void 0);
     _define_property(this, "normalizedCache", void 0);
     _define_property(this, "subscriptionManager", void 0);
     _define_property(this, "rehydrationManager", void 0);
     _define_property(this, "options", void 0);
-    _define_property(this, "reconnectAttempts", void 0);
-    _define_property(this, "reconnectTimer", void 0);
-    _define_property(this, "hasConnected", void 0);
-    _define_property(this, "connectionConfig", void 0);
     this.db = db;
     this.realtime = realtime;
     this.normalizedCache = normalizedCache;
     this.subscriptionManager = subscriptionManager;
     this.rehydrationManager = rehydrationManager;
     this.options = options;
-    this.reconnectAttempts = 0;
-    this.hasConnected = false;
     this.connectionConfig = {
       reconnectBaseDelay: (_ref = (_options_connectionConfig = options.connectionConfig) === null || _options_connectionConfig === void 0 ? void 0 : _options_connectionConfig.reconnectBaseDelay) !== null && _ref !== void 0 ? _ref : 1e3,
       reconnectMaxDelay: (_ref1 = (_options_connectionConfig1 = options.connectionConfig) === null || _options_connectionConfig1 === void 0 ? void 0 : _options_connectionConfig1.reconnectMaxDelay) !== null && _ref1 !== void 0 ? _ref1 : 3e4,
@@ -100,26 +101,55 @@ var RealtimeHandler = /* @__PURE__ */function () {
     value: (
     /**
     * Sets up realtime event handlers for document changes.
+    *
+    * Real Frappe (v15) wire protocol, verified live against a stock bench
+    * (see .test-evidence/storybook-rubric/p-results/frappe-realtime-live-e2e.md):
+    * - `doc_update`  `{doctype, name, modified}` — emitted to the per-doc room
+    *   `doc:{doctype}/{name}` on every save.
+    * - `list_update` `{doctype, name, user}` — emitted to the doctype room
+    *   `doctype:{doctype}` on every save of a non-single, non-child doctype.
+    * - Deletion emits the SAME two events (payload indistinguishable from an
+    *   update) — there is NO `doc_deleted` event. Deletions are detected here
+    *   opportunistically when the authoritative re-fetch 404s, but the durable
+    *   deletion signal remains the tombstone/CDC backfill (`Deleted Document`
+    *   doctype maintained by the `live` app's on_trash hook).
+    *
+    * Both real events funnel into the same fetch-and-reconcile path, deduped
+    * so a doc_update/list_update pair for the same doc costs one fetch.
     */
     function setupRealtimeHandlers() {
       var _this = this;
-      var _this_realtime, _this_realtime1, _this_realtime2, _this_realtime3, _this_realtime4;
+      var _this_realtime, _this_realtime1, _this_realtime2, _this_realtime3, _this_realtime4, _this_realtime5, _this_realtime6;
       if (!this.realtime) return;
-      (_this_realtime = this.realtime) === null || _this_realtime === void 0 ? void 0 : _this_realtime.on("doc_changed", async function (payload) {
+      (_this_realtime = this.realtime) === null || _this_realtime === void 0 ? void 0 : _this_realtime.on("doc_update", async function (payload) {
+        if (_this.options.onRealtimeEvent) _this.options.onRealtimeEvent({
+          type: import_types.RealtimeEventType.DocUpdate,
+          payload
+        });
+        return _this.onDocChanged(payload);
+      });
+      (_this_realtime1 = this.realtime) === null || _this_realtime1 === void 0 ? void 0 : _this_realtime1.on("list_update", async function (payload) {
+        if (_this.options.onRealtimeEvent) _this.options.onRealtimeEvent({
+          type: import_types.RealtimeEventType.ListUpdate,
+          payload
+        });
+        return _this.onDocChanged(payload);
+      });
+      (_this_realtime2 = this.realtime) === null || _this_realtime2 === void 0 ? void 0 : _this_realtime2.on("doc_changed", async function (payload) {
         if (_this.options.onRealtimeEvent) _this.options.onRealtimeEvent({
           type: import_types.RealtimeEventType.DocChanged,
           payload
         });
         return _this.onDocChanged(payload);
       });
-      (_this_realtime1 = this.realtime) === null || _this_realtime1 === void 0 ? void 0 : _this_realtime1.on("doc_deleted", async function (payload) {
+      (_this_realtime3 = this.realtime) === null || _this_realtime3 === void 0 ? void 0 : _this_realtime3.on("doc_deleted", async function (payload) {
         if (_this.options.onRealtimeEvent) _this.options.onRealtimeEvent({
           type: import_types.RealtimeEventType.DocDeleted,
           payload
         });
         return _this.onDocDeleted(payload);
       });
-      (_this_realtime2 = this.realtime) === null || _this_realtime2 === void 0 ? void 0 : _this_realtime2.on("perm_epoch_bump", function () {
+      (_this_realtime4 = this.realtime) === null || _this_realtime4 === void 0 ? void 0 : _this_realtime4.on("perm_epoch_bump", function () {
         if (_this.options.onRealtimeEvent) _this.options.onRealtimeEvent({
           type: import_types.RealtimeEventType.PermEpochBump
         });
@@ -127,10 +157,10 @@ var RealtimeHandler = /* @__PURE__ */function () {
           _this.options.onResetCache();
         }
       });
-      (_this_realtime3 = this.realtime) === null || _this_realtime3 === void 0 ? void 0 : _this_realtime3.on("connected", function () {
+      (_this_realtime5 = this.realtime) === null || _this_realtime5 === void 0 ? void 0 : _this_realtime5.on("connected", function () {
         _this.onConnected();
       });
-      (_this_realtime4 = this.realtime) === null || _this_realtime4 === void 0 ? void 0 : _this_realtime4.on("disconnect", function () {
+      (_this_realtime6 = this.realtime) === null || _this_realtime6 === void 0 ? void 0 : _this_realtime6.on("disconnect", function () {
         _this.onDisconnected();
       });
     })
@@ -151,7 +181,9 @@ var RealtimeHandler = /* @__PURE__ */function () {
     * Handles successful connection.
     */
     function onConnected() {
+      var _this_options_onStoreChange, _this_options;
       this.hasConnected = true;
+      this.connected = true;
       this.reconnectAttempts = 0;
       if (this.reconnectTimer) {
         clearTimeout(this.reconnectTimer);
@@ -165,6 +197,7 @@ var RealtimeHandler = /* @__PURE__ */function () {
       if (this.options.onBackfillAll) {
         this.options.onBackfillAll();
       }
+      (_this_options_onStoreChange = (_this_options = this.options).onStoreChange) === null || _this_options_onStoreChange === void 0 ? void 0 : _this_options_onStoreChange.call(_this_options);
       console.debug("[RealtimeHandler] Connected to realtime server");
     })
   }, {
@@ -174,7 +207,10 @@ var RealtimeHandler = /* @__PURE__ */function () {
     * Handles disconnection with automatic reconnection.
     */
     function onDisconnected() {
+      var _this_options_onStoreChange, _this_options;
       console.debug("[RealtimeHandler] Disconnected from realtime server");
+      this.connected = false;
+      (_this_options_onStoreChange = (_this_options = this.options).onStoreChange) === null || _this_options_onStoreChange === void 0 ? void 0 : _this_options_onStoreChange.call(_this_options);
       if (this.hasConnected) {
         this.scheduleReconnection();
       }
@@ -183,18 +219,20 @@ var RealtimeHandler = /* @__PURE__ */function () {
     key: "attemptConnection",
     value: (
     /**
-    * Attempts to connect to the realtime server.
+    * No-op placeholder retained for the disconnect backoff schedule below.
+    * Transport reconnect is owned by Socket.IO inside RealtimeModule; this
+    * layer only tracks attempts for logging / future health hooks.
     */
     function attemptConnection() {
       if (!this.realtime) return;
     })
   }, {
     key: "scheduleReconnection",
-    value:
-    // RealtimeModule handles reconnection internally via its reconnection config.
-    // Handlers are already attached in the constructor via setupRealtimeHandlers().
+    value: (
     /**
-    * Schedules a reconnection attempt with exponential backoff and jitter.
+    * Schedules a reconnection *watchdog* tick with exponential backoff and jitter.
+    * Does not open sockets — RealtimeModule already reconnects. Kept so disconnect
+    * storms remain observable (and existing unit tests stay meaningful).
     */
     function scheduleReconnection() {
       var _this = this;
@@ -207,7 +245,7 @@ var RealtimeHandler = /* @__PURE__ */function () {
         _this.reconnectAttempts++;
         _this.attemptConnection();
       }, delay);
-    }
+    })
   }, {
     key: "calculateReconnectDelay",
     value: (
@@ -224,6 +262,72 @@ var RealtimeHandler = /* @__PURE__ */function () {
       delay = Math.round(delay + jitter);
       return Math.max(this.connectionConfig.reconnectBaseDelay, Math.min(delay, this.connectionConfig.reconnectMaxDelay));
     })
+  }, {
+    /**
+    * Join the realtime doctype room for a doctype (refcounted). Called by the
+    * sync module whenever a subscription for the doctype is added. Room
+    * membership survives reconnects — RealtimeModule re-joins tracked rooms on
+    * every `connect`.
+    *
+    * Note: only doctype-level rooms are joined. `list_update` fires for every
+    * save of a regular doctype, which covers doc updates too; per-doc rooms
+    * would only add coverage for single/read-only doctypes.
+    */
+    key: "watchDoctype",
+    value: function watchDoctype(doctype) {
+      var _this_watchedDoctypes_get;
+      var count = ((_this_watchedDoctypes_get = this.watchedDoctypes.get(doctype)) !== null && _this_watchedDoctypes_get !== void 0 ? _this_watchedDoctypes_get : 0) + 1;
+      this.watchedDoctypes.set(doctype, count);
+      if (count === 1 && this.realtime) {
+        Promise.resolve(this.realtime.subscribeList(doctype)).catch(function (err) {
+          return console.warn(`[RealtimeHandler] Failed to join doctype room ${doctype}:`, err);
+        });
+      }
+    }
+  }, {
+    /** Release one reference to a doctype room; leaves the room on the last one. */
+    key: "unwatchDoctype",
+    value: function unwatchDoctype(doctype) {
+      var _this_watchedDoctypes_get;
+      var _this_realtime;
+      var count = ((_this_watchedDoctypes_get = this.watchedDoctypes.get(doctype)) !== null && _this_watchedDoctypes_get !== void 0 ? _this_watchedDoctypes_get : 0) - 1;
+      if (count > 0) {
+        this.watchedDoctypes.set(doctype, count);
+        return;
+      }
+      this.watchedDoctypes.delete(doctype);
+      (_this_realtime = this.realtime) === null || _this_realtime === void 0 ? void 0 : _this_realtime.unsubscribeList(doctype);
+    }
+  }, {
+    /** Leave all doctype rooms (used by cache resets/disposal). */
+    key: "unwatchAll",
+    value: function unwatchAll() {
+      if (this.realtime) {
+        var _iteratorNormalCompletion = true,
+          _didIteratorError = false,
+          _iteratorError = void 0;
+        try {
+          for (var _iterator = this.watchedDoctypes.keys()[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+            var doctype = _step.value;
+            this.realtime.unsubscribeList(doctype);
+          }
+        } catch (err) {
+          _didIteratorError = true;
+          _iteratorError = err;
+        } finally {
+          try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+              _iterator.return();
+            }
+          } finally {
+            if (_didIteratorError) {
+              throw _iteratorError;
+            }
+          }
+        }
+      }
+      this.watchedDoctypes.clear();
+    }
   }, {
     key: "onDocChanged",
     value: (
@@ -231,9 +335,26 @@ var RealtimeHandler = /* @__PURE__ */function () {
     * Realtime handler: authoritative document changed.
     * Fetches document via REST with current user context to respect permissions,
     * updates cache, and reconciles subscription membership.
+    *
+    * Concurrent events for the same document (frappe emits doc_update AND
+    * list_update per save) share a single in-flight fetch.
     */
-    async function onDocChanged(payload) {
+    function onDocChanged(payload) {
+      var _this = this;
+      var key = `${payload === null || payload === void 0 ? void 0 : payload.doctype}\0${payload === null || payload === void 0 ? void 0 : payload.name}`;
+      var inflight = this.inflightFetches.get(key);
+      if (inflight) return inflight;
+      var fetchPromise = this.fetchAndReconcile(payload).finally(function () {
+        _this.inflightFetches.delete(key);
+      });
+      this.inflightFetches.set(key, fetchPromise);
+      return fetchPromise;
+    })
+  }, {
+    key: "fetchAndReconcile",
+    value: async function fetchAndReconcile(payload) {
       try {
+        var _this_options_onStoreChange, _this_options;
         var document = await this.db.getDoc(payload.doctype, payload.name);
         this.normalizedCache.upsert(document);
         var subscriptionsNeedingRehydration = this.subscriptionManager.updateSubscriptionMembership(document);
@@ -260,10 +381,15 @@ var RealtimeHandler = /* @__PURE__ */function () {
             }
           }
         }
+        (_this_options_onStoreChange = (_this_options = this.options).onStoreChange) === null || _this_options_onStoreChange === void 0 ? void 0 : _this_options_onStoreChange.call(_this_options);
       } catch (err) {
+        if ((err === null || err === void 0 ? void 0 : err.status) === 404) {
+          await this.onDocDeleted(payload);
+          return;
+        }
         console.warn(`Failed to fetch document ${payload === null || payload === void 0 ? void 0 : payload.doctype}/${payload === null || payload === void 0 ? void 0 : payload.name} during realtime update:`, err);
       }
-    })
+    }
   }, {
     key: "onDocDeleted",
     value: (
@@ -272,6 +398,7 @@ var RealtimeHandler = /* @__PURE__ */function () {
     */
     async function onDocDeleted(payload) {
       try {
+        var _this_options_onStoreChange, _this_options;
         this.normalizedCache.remove({
           doctype: payload.doctype,
           name: payload.name
@@ -300,6 +427,7 @@ var RealtimeHandler = /* @__PURE__ */function () {
             }
           }
         }
+        (_this_options_onStoreChange = (_this_options = this.options).onStoreChange) === null || _this_options_onStoreChange === void 0 ? void 0 : _this_options_onStoreChange.call(_this_options);
       } catch (err) {
         console.warn(`Failed to process doc_deleted for ${payload === null || payload === void 0 ? void 0 : payload.doctype}/${payload === null || payload === void 0 ? void 0 : payload.name}:`, err);
       }
@@ -319,6 +447,20 @@ var RealtimeHandler = /* @__PURE__ */function () {
     value: function getIsConnected() {
       return this.hasConnected;
     }
+  }, {
+    /**
+    * Live connection snapshot for reconnect indicators.
+    * `connected` tracks the socket right now; `everConnected` distinguishes
+    * "reconnecting" (was up, dropped) from "never had realtime" (fixtures,
+    * SSR, no realtime module).
+    */
+    key: "getConnectionState",
+    value: function getConnectionState() {
+      return {
+        connected: this.connected,
+        everConnected: this.hasConnected
+      };
+    }
   }, {
     /**
     * Disposes of resources and clears timers.
@@ -329,6 +471,7 @@ var RealtimeHandler = /* @__PURE__ */function () {
         clearTimeout(this.reconnectTimer);
         this.reconnectTimer = void 0;
       }
+      this.unwatchAll();
       if (this.realtime) {
         var _this_realtime;
         (_this_realtime = this.realtime) === null || _this_realtime === void 0 ? void 0 : _this_realtime.disconnect();

package/dist/cjs/sync/realtime.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","realtime_exports","__export","RealtimeHandler","module","exports","import_types","require","_class_call_check","instance","Constructor","TypeError","_defineProperties","target","props","i","length","descriptor","enumerable","configurable","writable","Object","defineProperty","key","_create_class","protoProps","staticProps","prototype","_define_property","obj","RealtimeHandler2","db","realtime","normalizedCache","subscriptionManager","rehydrationManager","options","arguments","_ref","_ref1","_ref2","_ref3","_options_connectionConfig","_options_connectionConfig1","_options_connectionConfig2","_options_connectionConfig3","reconnectAttempts","hasConnected","connectionConfig","reconnectBaseDelay","reconnectMaxDelay","reconnectJitter","exponentialBackoff","setupRealtimeHandlers","setupConnectionManagement","_this","_this_realtime","_this_realtime1","_this_realtime2","_this_realtime3","_this_realtime4","on","payload","onRealtimeEvent","type","RealtimeEventType","DocChanged","onDocChanged","DocDeleted","onDocDeleted","PermEpochBump","onResetCache","onConnected","onDisconnected","attemptConnection","reconnectTimer","clearTimeout","Connected","onBackfillAll","console","debug","scheduleReconnection","delay","calculateReconnectDelay","setTimeout"],"sources":["../../../src/sync/realtime.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","realtime_exports","__export","RealtimeHandler","module","exports","import_types","require","_class_call_check","instance","Constructor","TypeError","_defineProperties","target","props","i","length","descriptor","enumerable","configurable","writable","Object","defineProperty","key","_create_class","protoProps","staticProps","prototype","_define_property","obj","RealtimeHandler2","db","realtime","normalizedCache","subscriptionManager","rehydrationManager","options","arguments","_ref","_ref1","_ref2","_ref3","_options_connectionConfig","_options_connectionConfig1","_options_connectionConfig2","_options_connectionConfig3","Map","connectionConfig","reconnectBaseDelay","reconnectMaxDelay","reconnectJitter","exponentialBackoff","setupRealtimeHandlers","setupConnectionManagement","_this","_this_realtime","_this_realtime1","_this_realtime2","_this_realtime3","_this_realtime4","_this_realtime5","_this_realtime6","on","payload","onRealtimeEvent","type","RealtimeEventType","DocUpdate","onDocChanged","ListUpdate","DocChanged","DocDeleted","onDocDeleted","PermEpochBump","onResetCache","onConnected","onDisconnected","attemptConnection","_this_options_onStoreChange","_this_options","hasConnected","connected","reconnectAttempts","reconnectTimer","clearTimeout","Connected","onBackfillAll","onStoreChange","call","console","debug","scheduleReconnection","delay","calculateReconnectDelay","setTimeout","Math","min","pow","jitterRange","jitter","random","round","max","watchDoctype","doctype","_this_watchedDoctypes_get","count","watchedDoctypes","get","set","Promise","resolve","subscribeList","catch","err","warn","unwatchDoctype","delete","unsubscribeList","unwatchAll","_iteratorNormalCompletion","_didIteratorError","_iteratorError","_iterator","keys","Symbol","iterator","_step","next","done","return"],"sources":["../../../src/sync/realtime.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/cjs/sync/rehydration.cjs

@@ -28,16 +28,6 @@ module.exports = __toCommonJS(rehydration_exports);
 var import_pacer = require("@tanstack/pacer");
 var import_types = require("./types.cjs");
 class RehydrationManager {
-  constructor(db, cache, subscriptionManager, mutationJournal) {
-    this.db = db;
-    this.cache = cache;
-    this.subscriptionManager = subscriptionManager;
-    this.mutationJournal = mutationJournal;
-  }
-  db;
-  cache;
-  subscriptionManager;
-  mutationJournal;
   /** Queue of pending rehydration tasks, keyed by subscription ID */
   rehydrationQueue = /* @__PURE__ */new Map();
   /** Debouncer for batching rehydration queue processing */
@@ -46,6 +36,19 @@ class RehydrationManager {
   });
   /** Maps temporary IDs to server-assigned IDs for optimistic creates */
   temporaryIdMap = /* @__PURE__ */new Map();
+  db;
+  cache;
+  subscriptionManager;
+  mutationJournal;
+  /** Notifies the sync store after rehydration mutates cache/membership. */
+  onChange;
+  constructor(db, cache, subscriptionManager, mutationJournal, onChange) {
+    this.db = db;
+    this.cache = cache;
+    this.subscriptionManager = subscriptionManager;
+    this.mutationJournal = mutationJournal;
+    this.onChange = onChange;
+  }
   /**
    * Schedules a rehydration task for a subscription based on the reason.
    * Coalesces multiple requests for the same subscription.
@@ -159,14 +162,17 @@ class RehydrationManager {
       }
       return a.scheduledAt - b.scheduledAt;
     });
+    let anyExecuted = false;
     for (const task of tasks) {
       try {
         await this.executeRehydration(task);
         this.rehydrationQueue.delete(task.subscriptionId);
+        anyExecuted = true;
       } catch (error) {
         console.error(`Rehydration failed for ${task.subscriptionId}:`, error);
       }
     }
+    if (anyExecuted) this.onChange?.();
   }
   /**
    * Executes a single rehydration task.