@multiplatform.one/frappe 6.1.0 → 6.3.0

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

@@ -129,16 +129,14 @@ var BackfillManager = /* @__PURE__ */function () {
   function BackfillManager2(db, normalizedCache) {
     var options = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
     _class_call_check(this, BackfillManager2);
+    _define_property(this, "activeBackfills", /* @__PURE__ */new Map());
+    _define_property(this, "backfillQueue", /* @__PURE__ */new Map());
     _define_property(this, "db", void 0);
     _define_property(this, "normalizedCache", void 0);
     _define_property(this, "options", void 0);
-    _define_property(this, "activeBackfills", void 0);
-    _define_property(this, "backfillQueue", void 0);
     this.db = db;
     this.normalizedCache = normalizedCache;
     this.options = options;
-    this.activeBackfills = /* @__PURE__ */new Map();
-    this.backfillQueue = /* @__PURE__ */new Map();
   }
   _create_class(BackfillManager2, [{
     key: "backfill",
@@ -320,54 +318,62 @@ var BackfillManager = /* @__PURE__ */function () {
         return this.fullRefresh(subscription);
       }
       try {
-        var response = await this.db.backfill({
-          doctype: subscription.query.doctype,
-          fields: subscription.query.fields,
-          filters: subscription.query.filters,
-          modifiedAfter: subscription.checkpoint,
-          limit: this.options.pageSize || 200
-        });
-        if ("deleted" in response && Array.isArray(response.deleted)) {
-          var deletedDocIds = response.deleted.filter(function (deletion) {
-            return deletion === null || deletion === void 0 ? void 0 : deletion.name;
-          }).map(function (deletion) {
-            return deletion.name;
+        var _this_options_maxPages;
+        var maxPages = (_this_options_maxPages = this.options.maxPages) !== null && _this_options_maxPages !== void 0 ? _this_options_maxPages : 20;
+        for (var page = 0; page < maxPages; page++) {
+          var _response_checkpoint, _ref;
+          var _response_deleted;
+          var response = await this.db.backfill({
+            doctype: subscription.query.doctype,
+            fields: subscription.query.fields,
+            filters: subscription.query.filters,
+            modifiedAfter: subscription.checkpoint,
+            limit: this.options.pageSize || 200
           });
-          if (deletedDocIds.length > 0) {
-            subscription.removeDocuments(deletedDocIds, this.normalizedCache);
-          }
-        }
-        var _iteratorNormalCompletion = true,
-          _didIteratorError = false,
-          _iteratorError = void 0;
-        try {
-          for (var _iterator = response.rows[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
-            var doc = _step.value;
-            var exists = subscription.getProgressiveCache().docIds.includes(doc.name);
-            var matches = (0, import_filters.matchesFilters)(doc, subscription.query.filters);
-            if (exists && !matches) {
-              subscription.removeDocuments([doc.name], this.normalizedCache);
-            } else if (!exists && matches) {
-              subscription.needsRehydration = true;
-            } else if (exists) {
-              this.normalizedCache.upsert(doc);
+          if ("deleted" in response && Array.isArray(response.deleted)) {
+            var deletedDocIds = response.deleted.filter(function (deletion) {
+              return deletion === null || deletion === void 0 ? void 0 : deletion.name;
+            }).map(function (deletion) {
+              return deletion.name;
+            });
+            if (deletedDocIds.length > 0) {
+              subscription.removeDocuments(deletedDocIds, this.normalizedCache);
             }
           }
-        } catch (err) {
-          _didIteratorError = true;
-          _iteratorError = err;
-        } finally {
+          var _iteratorNormalCompletion = true,
+            _didIteratorError = false,
+            _iteratorError = void 0;
           try {
-            if (!_iteratorNormalCompletion && _iterator.return != null) {
-              _iterator.return();
+            for (var _iterator = response.rows[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+              var doc = _step.value;
+              var exists = subscription.getProgressiveCache().docIds.includes(doc.name);
+              var matches = (0, import_filters.matchesFilters)(doc, subscription.query.filters);
+              if (exists && !matches) {
+                subscription.removeDocuments([doc.name], this.normalizedCache);
+              } else if (!exists && matches) {
+                subscription.needsRehydration = true;
+              } else if (exists) {
+                this.normalizedCache.upsert(doc);
+              }
             }
+          } catch (err) {
+            _didIteratorError = true;
+            _iteratorError = err;
           } finally {
-            if (_didIteratorError) {
-              throw _iteratorError;
+            try {
+              if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+              }
+            } finally {
+              if (_didIteratorError) {
+                throw _iteratorError;
+              }
             }
           }
+          subscription.checkpoint = (_response_checkpoint = response.checkpoint) !== null && _response_checkpoint !== void 0 ? _response_checkpoint : calculateCheckpointFromDocs(response.rows);
+          var madeProgress = response.rows.length > 0 || ((_ref = (_response_deleted = response.deleted) === null || _response_deleted === void 0 ? void 0 : _response_deleted.length) !== null && _ref !== void 0 ? _ref : 0) > 0;
+          if (!response.has_more || !response.checkpoint || !madeProgress) break;
         }
-        subscription.checkpoint = calculateCheckpointFromDocs(response.rows);
       } catch (error) {
         console.error("Incremental backfill failed:", error);
         await this.fullRefresh(subscription);

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

@@ -1 +1 @@
-{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","backfill_exports","__export","BackfillManager","BackfillReason","BackfillStrategy","module","exports","import_filters","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","calculateCheckpointFromDocs","docs","maxTimestamp","maxDate","_iteratorNormalCompletion","_didIteratorError","_iteratorError","_iterator","Symbol","iterator","_step","next","done","doc","modified","date","Date","Number","isNaN","getTime","unused","err","return","log","console","BackfillReason2","BackfillStrategy2","BackfillManager2","db","normalizedCache","options","arguments","activeBackfills","Map","backfillQueue","backfill","subscription","reason","subscriptionId","id","has","queueBackfill","get","backfillPromise","performBackfill","set","backfillSucceeded","error","delete","queued","_$reason","shift","catch","backfillOne","getProgressiveCache","hasMore","fetchWithCursor","processDocuments","calculateCheckpoint","updateProgressiveCache","rehydrateCurrentPage","pageSize","viewWindow","currentPage","start","response","getDocList","query","doctype","fields","filters","orderBy","limitStart","limit","newDocIds","map","doc2","name","currentDocIds","docIds","updatedDocIds","splice","upsert","needsRehydration","strategy","determineStrategy","fullRefresh","incrementalBackfill","pageBackfill","gapBackfill","cursorFetch","nextCursor","checkpoint"],"sources":["../../../src/sync/backfill.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","backfill_exports","__export","BackfillManager","BackfillReason","BackfillStrategy","module","exports","import_filters","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","calculateCheckpointFromDocs","docs","maxTimestamp","maxDate","_iteratorNormalCompletion","_didIteratorError","_iteratorError","_iterator","Symbol","iterator","_step","next","done","doc","modified","date","Date","Number","isNaN","getTime","unused","err","return","log","console","BackfillReason2","BackfillStrategy2","BackfillManager2","db","normalizedCache","options","arguments","Map","backfill","subscription","reason","subscriptionId","id","activeBackfills","has","queueBackfill","get","backfillPromise","performBackfill","set","backfillSucceeded","error","delete","queued","backfillQueue","_$reason","shift","catch","backfillOne","getProgressiveCache","hasMore","fetchWithCursor","processDocuments","calculateCheckpoint","updateProgressiveCache","rehydrateCurrentPage","pageSize","viewWindow","currentPage","start","response","getDocList","query","doctype","fields","filters","orderBy","limitStart","limit","newDocIds","map","doc2","name","currentDocIds","docIds","updatedDocIds","splice","upsert","needsRehydration","strategy","determineStrategy","fullRefresh","incrementalBackfill","pageBackfill","gapBackfill","cursorFetch","nextCursor","checkpoint","batchSize"],"sources":["../../../src/sync/backfill.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/cjs/sync/index.cjs

@@ -35,6 +35,30 @@ var import_rehydration = require("./rehydration.cjs");
 var import_subscriptionManager = require("./subscriptionManager.cjs");
 var import_types = require("./types.cjs");
 class SyncModule {
+  normalizedCache;
+  mutationJournal;
+  storeListeners = /* @__PURE__ */new Set();
+  /** Listeners registered via `subscribeRealtimeEvents`. */
+  realtimeEventListeners = /* @__PURE__ */new Set();
+  subscriptionManager;
+  /** Mutation engine for optimistic updates and conflict resolution. */
+  mutationEngine;
+  /** Realtime event handler for Socket.IO integration. */
+  realtimeHandler;
+  /** Persistence manager for state snapshots. */
+  persistenceManager;
+  /** Rehydration manager for intelligent subscription updates. */
+  rehydrationManager;
+  /** Cleanup functions returned by lifecycle subscriptions. */
+  cleanupFocus;
+  cleanupFocusReplay;
+  cleanupOnlineBackfill;
+  cleanupOnlineReplay;
+  /** Timer handle for periodic CDC polling. */
+  cdcIntervalHandle;
+  db;
+  realtime;
+  options;
   constructor(db, realtime, options = {}) {
     this.db = db;
     this.realtime = realtime;
@@ -48,40 +72,26 @@ class SyncModule {
       storage: typeof localStorage !== "undefined" ? localStorage : void 0
     });
     this.subscriptionManager = new import_subscriptionManager.SubscriptionManager(this.db, this.normalizedCache, this.options);
-    this.rehydrationManager = new import_rehydration.RehydrationManager(this.db, this.normalizedCache, this.subscriptionManager, this.mutationJournal);
+    this.rehydrationManager = new import_rehydration.RehydrationManager(this.db, this.normalizedCache, this.subscriptionManager, this.mutationJournal, () => this.emit());
     this.mutationEngine = new import_mutationEngine.MutationEngine(this.db, this.realtime, this.normalizedCache, this.mutationJournal, this.subscriptionManager, this.rehydrationManager, this.options);
     const realtimeOptions = {
       ...this.options,
       onResetCache: () => this.resetCache(),
       onBackfillAll: () => this.backfill({
         scope: import_types.BackfillScope.All
-      })
+      }),
+      // Realtime reconciliation mutates cache/membership outside the public
+      // mutate/backfill entry points — bridge those changes to store listeners.
+      onStoreChange: () => this.emit(),
+      onRealtimeEvent: event => {
+        this.options.onRealtimeEvent?.(event);
+        for (const listener of this.realtimeEventListeners) listener(event);
+      }
     };
     this.realtimeHandler = new import_realtime.RealtimeHandler(this.db, this.realtime, this.normalizedCache, this.subscriptionManager, this.rehydrationManager, realtimeOptions);
     this.persistenceManager = new import_persistence.PersistenceManager(this.normalizedCache, this.mutationJournal, this.subscriptionManager, this.mutationEngine, realtimeOptions);
     this.setupWindowEvents();
   }
-  db;
-  realtime;
-  options;
-  normalizedCache;
-  mutationJournal;
-  storeListeners = /* @__PURE__ */new Set();
-  subscriptionManager;
-  /** Mutation engine for optimistic updates and conflict resolution. */
-  mutationEngine;
-  /** Realtime event handler for Socket.IO integration. */
-  realtimeHandler;
-  /** Persistence manager for state snapshots. */
-  persistenceManager;
-  /** Rehydration manager for intelligent subscription updates. */
-  rehydrationManager;
-  /** Cleanup functions returned by lifecycle subscriptions. */
-  cleanupFocus;
-  cleanupOnlineBackfill;
-  cleanupOnlineReplay;
-  /** Timer handle for periodic CDC polling. */
-  cdcIntervalHandle;
   /**
    * Sets up lifecycle event listeners for sync triggers.
    * Stores cleanup functions returned by each subscription.
@@ -90,6 +100,9 @@ class SyncModule {
     this.cleanupFocus = (0, import_platform.onAppFocus)(() => this.backfill({
       scope: import_types.BackfillScope.All
     }));
+    this.cleanupFocusReplay = (0, import_platform.onAppFocus)(() => {
+      if (this.mutationJournal.listPending().length > 0) void this.replayPending();
+    });
     this.cleanupOnlineBackfill = (0, import_platform.onOnline)(() => this.backfill({
       scope: import_types.BackfillScope.All
     }));
@@ -102,17 +115,28 @@ class SyncModule {
   }
   /**
    * Creates a subscription, seeds cache with initial rows, and stores a backfill checkpoint.
+   *
+   * With persistence enabled, a query matching a subscription restored from
+   * the snapshot is re-adopted cache-first: the returned rows come from the
+   * restored cache and a background network refresh follows (`result.refresh`).
+   * If that refresh fails (offline), the cached membership keeps serving and
+   * the subscription is marked stale until the next successful backfill.
    */
   async subscribe(query) {
+    await this.persistenceManager.whenReady();
     const result = await this.subscriptionManager.subscribe(query);
+    this.realtimeHandler.watchDoctype(query.doctype);
     this.emit();
+    if (result.refresh) void result.refresh.then(() => this.emit());
     return result;
   }
   /**
    * Removes a subscription by id.
    */
   unsubscribe(subscriptionId) {
+    const subscription = this.subscriptionManager.getSubscription(subscriptionId);
     this.subscriptionManager.unsubscribe(subscriptionId);
+    if (subscription) this.realtimeHandler.unwatchDoctype(subscription.query.doctype);
     this.emit();
   }
   async mutate(mutation) {
@@ -190,6 +214,40 @@ class SyncModule {
       this.storeListeners.delete(listener);
     };
   }
+  /**
+   * Registers a listener for raw realtime events (doc_update, list_update,
+   * doc_deleted, connected, …). Useful for consumers that manage their own
+   * fetching (e.g. server-side paginated tables) but still want live
+   * invalidation hints. Returns an unsubscribe function.
+   */
+  subscribeRealtimeEvents(listener) {
+    this.realtimeEventListeners.add(listener);
+    return () => {
+      this.realtimeEventListeners.delete(listener);
+    };
+  }
+  /**
+   * Joins the realtime doctype room without creating a data subscription
+   * (refcounted). Pair with `unwatchDoctype` on cleanup. Used by consumers
+   * that fetch their own data but need the doctype's realtime hints.
+   */
+  watchDoctype(doctype) {
+    this.realtimeHandler.watchDoctype(doctype);
+  }
+  /** Releases one `watchDoctype` reference. */
+  unwatchDoctype(doctype) {
+    this.realtimeHandler.unwatchDoctype(doctype);
+  }
+  /**
+   * Live socket connection snapshot. `connected` is the state right now;
+   * `everConnected` distinguishes "reconnecting" from "realtime never up"
+   * (fixture mode, SSR, or no realtime module). Store listeners are
+   * notified on every flip, so read this inside a `subscribeStore` callback
+   * for a reactive indicator.
+   */
+  getConnectionState() {
+    return this.realtimeHandler.getConnectionState();
+  }
   /** Notifies listeners, schedules persistence, and broadcasts cross-tab changes. */
   emit() {
     for (const listener of this.storeListeners) listener();
@@ -198,6 +256,7 @@ class SyncModule {
   }
   /** Clears subscriptions, cache, journal, and temp id mappings. */
   resetCache() {
+    this.realtimeHandler.unwatchAll();
     this.subscriptionManager.clear();
     this.normalizedCache.clear();
     this.mutationJournal.clear();
@@ -207,6 +266,7 @@ class SyncModule {
   /** Cleanup and dispose of resources */
   async dispose() {
     this.storeListeners.clear();
+    this.realtimeEventListeners.clear();
     this.resetCache();
     this.mutationJournal.dispose();
     this.mutationEngine.dispose();
@@ -214,9 +274,11 @@ class SyncModule {
     this.persistenceManager.destroy();
     this.rehydrationManager.clear();
     this.cleanupFocus?.();
+    this.cleanupFocusReplay?.();
     this.cleanupOnlineBackfill?.();
     this.cleanupOnlineReplay?.();
     this.cleanupFocus = void 0;
+    this.cleanupFocusReplay = void 0;
     this.cleanupOnlineBackfill = void 0;
     this.cleanupOnlineReplay = void 0;
     if (this.cdcIntervalHandle) {
@@ -243,6 +305,8 @@ class SyncModule {
         tombstoneCount: sub.tombstones?.size ?? 0,
         checkpoint: sub.checkpoint,
         cursor: sub.cursor,
+        stale: sub.stale,
+        restored: this.subscriptionManager.isRestoredSubscription(sub.id),
         pageInfo
       };
       if (virtualSub) {
@@ -290,7 +354,9 @@ class SyncModule {
       connection: {
         socketConnected: this.realtimeHandler.getIsConnected(),
         isLeader: this.persistenceManager.getIsLeader(),
-        isOnline: typeof navigator !== "undefined" ? navigator.onLine : true
+        // React Native has navigator but no onLine (undefined) — treat
+        // anything other than an explicit false as online.
+        isOnline: typeof navigator === "undefined" || navigator.onLine !== false
       }
     };
   }

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

@@ -75,25 +75,26 @@ var SyncModule = /* @__PURE__ */function () {
     var _this = this;
     var options = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
     _class_call_check(this, SyncModule2);
-    _define_property(this, "db", void 0);
-    _define_property(this, "realtime", void 0);
-    _define_property(this, "options", void 0);
     _define_property(this, "normalizedCache", void 0);
     _define_property(this, "mutationJournal", void 0);
-    _define_property(this, "storeListeners", void 0);
+    _define_property(this, "storeListeners", /* @__PURE__ */new Set());
+    _define_property(this, "realtimeEventListeners", /* @__PURE__ */new Set());
     _define_property(this, "subscriptionManager", void 0);
     _define_property(this, "mutationEngine", void 0);
     _define_property(this, "realtimeHandler", void 0);
     _define_property(this, "persistenceManager", void 0);
     _define_property(this, "rehydrationManager", void 0);
     _define_property(this, "cleanupFocus", void 0);
+    _define_property(this, "cleanupFocusReplay", void 0);
     _define_property(this, "cleanupOnlineBackfill", void 0);
     _define_property(this, "cleanupOnlineReplay", void 0);
     _define_property(this, "cdcIntervalHandle", void 0);
+    _define_property(this, "db", void 0);
+    _define_property(this, "realtime", void 0);
+    _define_property(this, "options", void 0);
     this.db = db;
     this.realtime = realtime;
     this.options = options;
-    this.storeListeners = /* @__PURE__ */new Set();
     this.normalizedCache = new import_normalizedCache.NormalizedCache({
       maxSize: this.options.maxCacheSize
     });
@@ -103,7 +104,9 @@ var SyncModule = /* @__PURE__ */function () {
       storage: typeof localStorage !== "undefined" ? localStorage : void 0
     });
     this.subscriptionManager = new import_subscriptionManager.SubscriptionManager(this.db, this.normalizedCache, this.options);
-    this.rehydrationManager = new import_rehydration.RehydrationManager(this.db, this.normalizedCache, this.subscriptionManager, this.mutationJournal);
+    this.rehydrationManager = new import_rehydration.RehydrationManager(this.db, this.normalizedCache, this.subscriptionManager, this.mutationJournal, function () {
+      return _this.emit();
+    });
     this.mutationEngine = new import_mutationEngine.MutationEngine(this.db, this.realtime, this.normalizedCache, this.mutationJournal, this.subscriptionManager, this.rehydrationManager, this.options);
     var realtimeOptions = {
       ...this.options,
@@ -114,6 +117,37 @@ var SyncModule = /* @__PURE__ */function () {
         return _this.backfill({
           scope: import_types.BackfillScope.All
         });
+      },
+      // Realtime reconciliation mutates cache/membership outside the public
+      // mutate/backfill entry points — bridge those changes to store listeners.
+      onStoreChange: function onStoreChange() {
+        return _this.emit();
+      },
+      onRealtimeEvent: function onRealtimeEvent(event) {
+        var _this_options_onRealtimeEvent, _this_options;
+        (_this_options_onRealtimeEvent = (_this_options = _this.options).onRealtimeEvent) === null || _this_options_onRealtimeEvent === void 0 ? void 0 : _this_options_onRealtimeEvent.call(_this_options, event);
+        var _iteratorNormalCompletion = true,
+          _didIteratorError = false,
+          _iteratorError = void 0;
+        try {
+          for (var _iterator = _this.realtimeEventListeners[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+            var listener = _step.value;
+            listener(event);
+          }
+        } catch (err) {
+          _didIteratorError = true;
+          _iteratorError = err;
+        } finally {
+          try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+              _iterator.return();
+            }
+          } finally {
+            if (_didIteratorError) {
+              throw _iteratorError;
+            }
+          }
+        }
       }
     };
     this.realtimeHandler = new import_realtime.RealtimeHandler(this.db, this.realtime, this.normalizedCache, this.subscriptionManager, this.rehydrationManager, realtimeOptions);
@@ -134,6 +168,9 @@ var SyncModule = /* @__PURE__ */function () {
           scope: import_types.BackfillScope.All
         });
       });
+      this.cleanupFocusReplay = (0, import_platform.onAppFocus)(function () {
+        if (_this.mutationJournal.listPending().length > 0) void _this.replayPending();
+      });
       this.cleanupOnlineBackfill = (0, import_platform.onOnline)(function () {
         return _this.backfill({
           scope: import_types.BackfillScope.All
@@ -155,10 +192,22 @@ var SyncModule = /* @__PURE__ */function () {
     value: (
     /**
     * Creates a subscription, seeds cache with initial rows, and stores a backfill checkpoint.
+    *
+    * With persistence enabled, a query matching a subscription restored from
+    * the snapshot is re-adopted cache-first: the returned rows come from the
+    * restored cache and a background network refresh follows (`result.refresh`).
+    * If that refresh fails (offline), the cached membership keeps serving and
+    * the subscription is marked stale until the next successful backfill.
     */
     async function subscribe(query) {
+      var _this = this;
+      await this.persistenceManager.whenReady();
       var result = await this.subscriptionManager.subscribe(query);
+      this.realtimeHandler.watchDoctype(query.doctype);
       this.emit();
+      if (result.refresh) void result.refresh.then(function () {
+        return _this.emit();
+      });
       return result;
     })
   }, {
@@ -167,7 +216,9 @@ var SyncModule = /* @__PURE__ */function () {
     */
     key: "unsubscribe",
     value: function unsubscribe(subscriptionId) {
+      var subscription = this.subscriptionManager.getSubscription(subscriptionId);
       this.subscriptionManager.unsubscribe(subscriptionId);
+      if (subscription) this.realtimeHandler.unwatchDoctype(subscription.query.doctype);
       this.emit();
     }
   }, {
@@ -272,6 +323,49 @@ var SyncModule = /* @__PURE__ */function () {
         _this.storeListeners.delete(listener);
       };
     }
+  }, {
+    /**
+    * Registers a listener for raw realtime events (doc_update, list_update,
+    * doc_deleted, connected, …). Useful for consumers that manage their own
+    * fetching (e.g. server-side paginated tables) but still want live
+    * invalidation hints. Returns an unsubscribe function.
+    */
+    key: "subscribeRealtimeEvents",
+    value: function subscribeRealtimeEvents(listener) {
+      var _this = this;
+      this.realtimeEventListeners.add(listener);
+      return function () {
+        _this.realtimeEventListeners.delete(listener);
+      };
+    }
+  }, {
+    /**
+    * Joins the realtime doctype room without creating a data subscription
+    * (refcounted). Pair with `unwatchDoctype` on cleanup. Used by consumers
+    * that fetch their own data but need the doctype's realtime hints.
+    */
+    key: "watchDoctype",
+    value: function watchDoctype(doctype) {
+      this.realtimeHandler.watchDoctype(doctype);
+    }
+  }, {
+    /** Releases one `watchDoctype` reference. */
+    key: "unwatchDoctype",
+    value: function unwatchDoctype(doctype) {
+      this.realtimeHandler.unwatchDoctype(doctype);
+    }
+  }, {
+    /**
+    * Live socket connection snapshot. `connected` is the state right now;
+    * `everConnected` distinguishes "reconnecting" from "realtime never up"
+    * (fixture mode, SSR, or no realtime module). Store listeners are
+    * notified on every flip, so read this inside a `subscribeStore` callback
+    * for a reactive indicator.
+    */
+    key: "getConnectionState",
+    value: function getConnectionState() {
+      return this.realtimeHandler.getConnectionState();
+    }
   }, {
     key: "emit",
     value: (/** Notifies listeners, schedules persistence, and broadcasts cross-tab changes. */
@@ -305,6 +399,7 @@ var SyncModule = /* @__PURE__ */function () {
     /** Clears subscriptions, cache, journal, and temp id mappings. */
     key: "resetCache",
     value: function resetCache() {
+      this.realtimeHandler.unwatchAll();
       this.subscriptionManager.clear();
       this.normalizedCache.clear();
       this.mutationJournal.clear();
@@ -315,8 +410,9 @@ var SyncModule = /* @__PURE__ */function () {
     key: "dispose",
     value: (/** Cleanup and dispose of resources */
     async function dispose() {
-      var _this_cleanupFocus, _this, _this_cleanupOnlineBackfill, _this1, _this_cleanupOnlineReplay, _this2;
+      var _this_cleanupFocus, _this, _this_cleanupFocusReplay, _this1, _this_cleanupOnlineBackfill, _this2, _this_cleanupOnlineReplay, _this3;
       this.storeListeners.clear();
+      this.realtimeEventListeners.clear();
       this.resetCache();
       this.mutationJournal.dispose();
       this.mutationEngine.dispose();
@@ -324,9 +420,11 @@ var SyncModule = /* @__PURE__ */function () {
       this.persistenceManager.destroy();
       this.rehydrationManager.clear();
       (_this_cleanupFocus = (_this = this).cleanupFocus) === null || _this_cleanupFocus === void 0 ? void 0 : _this_cleanupFocus.call(_this);
-      (_this_cleanupOnlineBackfill = (_this1 = this).cleanupOnlineBackfill) === null || _this_cleanupOnlineBackfill === void 0 ? void 0 : _this_cleanupOnlineBackfill.call(_this1);
-      (_this_cleanupOnlineReplay = (_this2 = this).cleanupOnlineReplay) === null || _this_cleanupOnlineReplay === void 0 ? void 0 : _this_cleanupOnlineReplay.call(_this2);
+      (_this_cleanupFocusReplay = (_this1 = this).cleanupFocusReplay) === null || _this_cleanupFocusReplay === void 0 ? void 0 : _this_cleanupFocusReplay.call(_this1);
+      (_this_cleanupOnlineBackfill = (_this2 = this).cleanupOnlineBackfill) === null || _this_cleanupOnlineBackfill === void 0 ? void 0 : _this_cleanupOnlineBackfill.call(_this2);
+      (_this_cleanupOnlineReplay = (_this3 = this).cleanupOnlineReplay) === null || _this_cleanupOnlineReplay === void 0 ? void 0 : _this_cleanupOnlineReplay.call(_this3);
       this.cleanupFocus = void 0;
+      this.cleanupFocusReplay = void 0;
       this.cleanupOnlineBackfill = void 0;
       this.cleanupOnlineReplay = void 0;
       if (this.cdcIntervalHandle) {
@@ -362,6 +460,8 @@ var SyncModule = /* @__PURE__ */function () {
             tombstoneCount: (_ref = (_sub_tombstones = sub.tombstones) === null || _sub_tombstones === void 0 ? void 0 : _sub_tombstones.size) !== null && _ref !== void 0 ? _ref : 0,
             checkpoint: sub.checkpoint,
             cursor: sub.cursor,
+            stale: sub.stale,
+            restored: this.subscriptionManager.isRestoredSubscription(sub.id),
             pageInfo
           };
           if (virtualSub) {
@@ -444,7 +544,9 @@ var SyncModule = /* @__PURE__ */function () {
         connection: {
           socketConnected: this.realtimeHandler.getIsConnected(),
           isLeader: this.persistenceManager.getIsLeader(),
-          isOnline: typeof navigator !== "undefined" ? navigator.onLine : true
+          // React Native has navigator but no onLine (undefined) — treat
+          // anything other than an explicit false as online.
+          isOnline: typeof navigator === "undefined" || navigator.onLine !== false
         }
       };
     }