@atlaskit/editor-synced-block-provider 8.6.0 → 8.6.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @atlaskit/editor-synced-block-provider
 
+## 8.6.2
+
+### Patch Changes
+
+- Updated dependencies
+
+## 8.6.1
+
+### Patch Changes
+
+- [`f543995529d9d`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/f543995529d9d) -
+  [ux] Synced blocks now recover automatically from realtime connection drops that happen while a
+  tab is hidden or the network is offline. Instead of showing a fetch error when reconnection
+  attempts are exhausted in the background, the block silently re-arms and reconnects when the tab
+  becomes visible again or the network comes back online.
+- Updated dependencies
+
 ## 8.6.0
 
 ### Minor Changes

package/dist/cjs/store-manager/referenceSyncBlockStoreManager.js

@@ -1020,7 +1020,7 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
                 _context4.next = 1;
                 break;
               }
-              return _context4.abrupt("return", (0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_2'));
+              return _context4.abrupt("return", true);
             case 1:
               if (this.isCacheDirty) {
                 _context4.next = 2;

package/dist/cjs/store-manager/syncBlockSubscriptionManager.js

@@ -8,6 +8,8 @@ exports.SyncBlockSubscriptionManager = void 0;
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _bindEventListener = require("bind-event-listener");
+var _browserApis = require("@atlaskit/browser-apis");
 var _monitoring = require("@atlaskit/editor-common/monitoring");
 var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _errorHandling = require("../utils/errorHandling");
@@ -26,6 +28,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
  */
 var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   function SyncBlockSubscriptionManager(deps) {
+    var _this = this;
     (0, _classCallCheck2.default)(this, SyncBlockSubscriptionManager);
     (0, _defineProperty2.default)(this, "subscriptions", new Map());
     (0, _defineProperty2.default)(this, "titleSubscriptions", new Map());
@@ -40,6 +43,24 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
     // backoff cap (gate ON)
     (0, _defineProperty2.default)(this, "retryAttempts", new Map());
     (0, _defineProperty2.default)(this, "pendingRetries", new Map());
+    // Resources whose reconnection exhausted while the tab was hidden: parked here and
+    // re-armed on the next online / visibilitychange→visible instead of surfacing a
+    // terminal error. Only a re-armed attempt that also exhausts while visible fails.
+    (0, _defineProperty2.default)(this, "deferredExhausted", new Set());
+    (0, _defineProperty2.default)(this, "wakeDebounceTimer", null);
+    // `online` always sweeps (network is back regardless of tab visibility); a
+    // `visibilitychange` only sweeps when the tab became visible.
+    (0, _defineProperty2.default)(this, "onOnline", function () {
+      return _this.scheduleWakeSweep();
+    });
+    (0, _defineProperty2.default)(this, "onVisibilityChange", function () {
+      if (!_this.isDocumentHidden()) {
+        _this.scheduleWakeSweep();
+      }
+    });
+    // Cleanup fns returned by `bind` for the registered wake listeners; a non-empty
+    // array means listeners are currently registered. Emptied on teardown.
+    (0, _defineProperty2.default)(this, "wakeListenerCleanups", []);
     this.deps = deps;
   }
 
@@ -102,25 +123,25 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
   }, {
     key: "onSubscriptionsChanged",
     value: function onSubscriptionsChanged(listener) {
-      var _this = this;
+      var _this2 = this;
       this.subscriptionChangeListeners.add(listener);
       return function () {
-        _this.subscriptionChangeListeners.delete(listener);
+        _this2.subscriptionChangeListeners.delete(listener);
       };
     }
   }, {
     key: "notifySubscriptionChangeListeners",
     value: function notifySubscriptionChangeListeners() {
-      var _this2 = this;
+      var _this3 = this;
       this.subscriptionChangeListeners.forEach(function (listener) {
         try {
           listener();
         } catch (error) {
-          var _this2$deps$getFireAn;
+          var _this3$deps$getFireAn;
           (0, _monitoring.logException)(error, {
             location: 'editor-synced-block-provider/syncBlockSubscriptionManager/notifySubscriptionChangeListeners'
           });
-          (_this2$deps$getFireAn = _this2.deps.getFireAnalyticsEvent()) === null || _this2$deps$getFireAn === void 0 || _this2$deps$getFireAn((0, _errorHandling.fetchErrorPayload)(error.message, undefined, undefined, (0, _errorHandling.buildFetchErrorAttribution)((0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_3'), error.message)));
+          (_this3$deps$getFireAn = _this3.deps.getFireAnalyticsEvent()) === null || _this3$deps$getFireAn === void 0 || _this3$deps$getFireAn((0, _errorHandling.fetchErrorPayload)(error.message, undefined, undefined, (0, _errorHandling.buildFetchErrorAttribution)((0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_3'), error.message)));
         }
       });
     }
@@ -140,7 +161,7 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
   }, {
     key: "subscribeToSyncBlock",
     value: function subscribeToSyncBlock(resourceId, localId, callback) {
-      var _this3 = this;
+      var _this4 = this;
       // Cancel any pending cache deletion for this resourceId.
       // This handles the case where a block is moved - the old component unmounts
       // (scheduling deletion) but the new component mounts and subscribes before
@@ -180,25 +201,25 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
         this.setupSubscription(resourceId);
       }
       return function () {
-        var resourceSubscriptions = _this3.subscriptions.get(resourceId);
+        var resourceSubscriptions = _this4.subscriptions.get(resourceId);
         if (resourceSubscriptions) {
           // Unsubscription means a reference synced block is removed from the document
-          _this3.deps.markCacheDirty();
+          _this4.deps.markCacheDirty();
           delete resourceSubscriptions[localId];
           var remainingIds = Object.keys(resourceSubscriptions);
           if (remainingIds.length === 0) {
-            _this3.subscriptions.delete(resourceId);
+            _this4.subscriptions.delete(resourceId);
 
             // Clean up GraphQL subscription when no more local subscribers
-            _this3.cleanupSubscription(resourceId);
+            _this4.cleanupSubscription(resourceId);
 
             // Notify listeners that subscription was removed
-            _this3.notifySubscriptionChangeListeners();
+            _this4.notifySubscriptionChangeListeners();
 
             // Under the flag, delegate cache deletion to the store manager
             // which uses a 30s grace period with guard re-checks.
             if ((0, _platformFeatureFlags.fg)('platform_synced_block_patch_14')) {
-              _this3.deps.scheduleCacheDeletion(resourceId);
+              _this4.deps.scheduleCacheDeletion(resourceId);
             } else {
               // Legacy path (unchanged): delay cache deletion to handle
               // block moves (unmount/remount). When a block is moved, the
@@ -209,18 +230,18 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
               // TODO: EDITOR-4152 - Rework this logic (superseded by
               // `platform_synced_block_patch_14`).
               var deletionTimeout = setTimeout(function () {
-                var hasSubscribers = _this3.subscriptions.has(resourceId);
+                var hasSubscribers = _this4.subscriptions.has(resourceId);
 
                 // Only delete if still no subscribers (wasn't re-subscribed)
                 if (!hasSubscribers) {
-                  _this3.deps.deleteFromCache(resourceId);
+                  _this4.deps.deleteFromCache(resourceId);
                 }
-                _this3.pendingCacheDeletions.delete(resourceId);
+                _this4.pendingCacheDeletions.delete(resourceId);
               }, 1000);
-              _this3.pendingCacheDeletions.set(resourceId, deletionTimeout);
+              _this4.pendingCacheDeletions.set(resourceId, deletionTimeout);
             }
           } else {
-            _this3.subscriptions.set(resourceId, resourceSubscriptions);
+            _this4.subscriptions.set(resourceId, resourceSubscriptions);
           }
         }
       };
@@ -229,7 +250,7 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
     key: "subscribeToSourceTitle",
     value: function subscribeToSourceTitle(node, callback) {
       var _cachedData$data,
-        _this4 = this;
+        _this5 = this;
       // check node is a sync block, as we only support sync block subscriptions
       if (node.type.name !== 'syncBlock') {
         return function () {};
@@ -249,13 +270,13 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
       var resourceSubscriptions = this.titleSubscriptions.get(resourceId) || {};
       this.titleSubscriptions.set(resourceId, _objectSpread(_objectSpread({}, resourceSubscriptions), {}, (0, _defineProperty2.default)({}, localId, callback)));
       return function () {
-        var resourceSubscriptions = _this4.titleSubscriptions.get(resourceId);
+        var resourceSubscriptions = _this5.titleSubscriptions.get(resourceId);
         if (resourceSubscriptions) {
           delete resourceSubscriptions[localId];
           if (Object.keys(resourceSubscriptions).length === 0) {
-            _this4.titleSubscriptions.delete(resourceId);
+            _this5.titleSubscriptions.delete(resourceId);
           } else {
-            _this4.titleSubscriptions.set(resourceId, resourceSubscriptions);
+            _this5.titleSubscriptions.set(resourceId, resourceSubscriptions);
           }
         }
       };
@@ -287,7 +308,7 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
   }, {
     key: "setupSubscription",
     value: function setupSubscription(resourceId) {
-      var _this5 = this;
+      var _this6 = this;
       if (this.graphqlSubscriptions.has(resourceId)) {
         return;
       }
@@ -296,7 +317,7 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
         return;
       }
       var unsubscribe = dataProvider.subscribeToBlockUpdates(resourceId, function (syncBlockInstance) {
-        _this5.handleGraphQLUpdate(syncBlockInstance);
+        _this6.handleGraphQLUpdate(syncBlockInstance);
       }, function (error) {
         (0, _monitoring.logException)(error, {
           location: 'editor-synced-block-provider/syncBlockSubscriptionManager/graphql-subscription'
@@ -309,12 +330,12 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
         // would return undefined; the structured attribution (EDITOR-7862) is therefore
         // applied at the gate-ON exhaustion site in scheduleReconnection instead.
         if (!(0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_3')) {
-          var _this5$deps$getFireAn;
-          (_this5$deps$getFireAn = _this5.deps.getFireAnalyticsEvent()) === null || _this5$deps$getFireAn === void 0 || _this5$deps$getFireAn((0, _errorHandling.fetchErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
+          var _this6$deps$getFireAn;
+          (_this6$deps$getFireAn = _this6.deps.getFireAnalyticsEvent()) === null || _this6$deps$getFireAn === void 0 || _this6$deps$getFireAn((0, _errorHandling.fetchErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
         }
-        _this5.handleSubscriptionTerminated(resourceId);
+        _this6.handleSubscriptionTerminated(resourceId);
       }, function () {
-        _this5.handleSubscriptionTerminated(resourceId);
+        _this6.handleSubscriptionTerminated(resourceId);
       });
       if (unsubscribe) {
         this.graphqlSubscriptions.set(resourceId, unsubscribe);
@@ -348,36 +369,48 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
     key: "scheduleReconnection",
     value: function scheduleReconnection(resourceId) {
       var _this$retryAttempts$g,
-        _this6 = this;
+        _this7 = this;
       var attempts = (_this$retryAttempts$g = this.retryAttempts.get(resourceId)) !== null && _this$retryAttempts$g !== void 0 ? _this$retryAttempts$g : 0;
       var maxAttempts = this.getMaxRetryAttempts();
       if (attempts >= maxAttempts) {
-        var _this$deps$getFireAna;
+        var _this$deps$getFireAna2;
         // Exhausted all attempts — the only place a WS drop surfaces as a
         // fetch error under the gate (EDITOR-7861).
         var errorMessage = "Subscription reconnection failed after ".concat(attempts, " attempts");
+
+        // Tab hidden at exhaustion: don't surface a terminal failure (user isn't
+        // looking, and most exhaustions self-recover once foregrounded). Park + re-arm
+        // on wake, emitting a benign `deferred` signal so suppression stays auditable.
+        var shouldDefer = (0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_3') && this.isDocumentHidden();
+        if (shouldDefer) {
+          var _this$deps$getFireAna;
+          this.deferredExhausted.add(resourceId);
+          this.registerWakeListeners();
+          (_this$deps$getFireAna = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna === void 0 || _this$deps$getFireAna((0, _errorHandling.fetchErrorPayload)(errorMessage, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId), (0, _errorHandling.buildFetchErrorAttribution)(true, errorMessage, undefined, /* deferred */true)));
+          return;
+        }
         (0, _monitoring.logException)(new Error(errorMessage), {
           location: 'editor-synced-block-provider/syncBlockSubscriptionManager/max-retries-exhausted'
         });
-        (_this$deps$getFireAna = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna === void 0 || _this$deps$getFireAna((0, _errorHandling.fetchErrorPayload)(errorMessage, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId), (0, _errorHandling.buildFetchErrorAttribution)((0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_3'), errorMessage)));
+        (_this$deps$getFireAna2 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna2 === void 0 || _this$deps$getFireAna2((0, _errorHandling.fetchErrorPayload)(errorMessage, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId), (0, _errorHandling.buildFetchErrorAttribution)((0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_3'), errorMessage)));
         return;
       }
       var delay = this.getReconnectionDelay(attempts);
       var timer = setTimeout(function () {
-        _this6.pendingRetries.delete(resourceId);
+        _this7.pendingRetries.delete(resourceId);
 
         // Only re-subscribe if still relevant
-        if (_this6.subscriptions.has(resourceId) && _this6.shouldUseRealTime()) {
-          _this6.setupSubscription(resourceId);
+        if (_this7.subscriptions.has(resourceId) && _this7.shouldUseRealTime()) {
+          _this7.setupSubscription(resourceId);
 
           // Only increment if the subscription was actually established
           // (setupSubscription may be a no-op if another code path already re-established it)
-          if (_this6.graphqlSubscriptions.has(resourceId)) {
-            _this6.retryAttempts.set(resourceId, attempts + 1);
+          if (_this7.graphqlSubscriptions.has(resourceId)) {
+            _this7.retryAttempts.set(resourceId, attempts + 1);
           }
         } else {
           // Conditions no longer met — clean up stale retry state
-          _this6.retryAttempts.delete(resourceId);
+          _this7.retryAttempts.delete(resourceId);
         }
       }, delay);
       this.pendingRetries.set(resourceId, timer);
@@ -392,6 +425,106 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
     value: function resetRetryCount(resourceId) {
       this.retryAttempts.delete(resourceId);
     }
+
+    /**
+     * Whether the tab is currently hidden. SSR/non-browser is treated as "not hidden" so
+     * we never defer where wake events can't fire (realtime never subscribes there anyway).
+     */
+  }, {
+    key: "isDocumentHidden",
+    value: function isDocumentHidden() {
+      var _getDocument;
+      return ((_getDocument = (0, _browserApis.getDocument)()) === null || _getDocument === void 0 ? void 0 : _getDocument.hidden) === true;
+    }
+
+    /**
+     * Lazily register shared `online` / `visibilitychange` listeners on first deferral.
+     * Torn down by `unregisterWakeListeners` (via `handleWake`). No-op in SSR / non-browser.
+     */
+  }, {
+    key: "registerWakeListeners",
+    value: function registerWakeListeners() {
+      if (this.wakeListenerCleanups.length > 0 || typeof window === 'undefined') {
+        return;
+      }
+      this.wakeListenerCleanups.push((0, _bindEventListener.bind)(window, {
+        type: 'online',
+        listener: this.onOnline
+      }));
+      var doc = (0, _browserApis.getDocument)();
+      if (doc) {
+        this.wakeListenerCleanups.push((0, _bindEventListener.bind)(doc, {
+          type: 'visibilitychange',
+          listener: this.onVisibilityChange
+        }));
+      }
+    }
+  }, {
+    key: "unregisterWakeListeners",
+    value: function unregisterWakeListeners() {
+      if (this.wakeDebounceTimer !== null) {
+        clearTimeout(this.wakeDebounceTimer);
+        this.wakeDebounceTimer = null;
+      }
+      var _iterator = _createForOfIteratorHelper(this.wakeListenerCleanups),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var cleanup = _step.value;
+          cleanup();
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      this.wakeListenerCleanups = [];
+    }
+
+    /**
+     * Coalesce a burst of wake events into one debounced re-arm sweep. Callers decide
+     * eligibility: `onOnline` always sweeps; `onVisibilityChange` only sweeps when visible.
+     */
+  }, {
+    key: "scheduleWakeSweep",
+    value: function scheduleWakeSweep() {
+      var _this8 = this;
+      if (this.wakeDebounceTimer !== null) {
+        return;
+      }
+      this.wakeDebounceTimer = setTimeout(function () {
+        _this8.wakeDebounceTimer = null;
+        _this8.handleWake();
+      }, SyncBlockSubscriptionManager.WAKE_DEBOUNCE_MS);
+    }
+
+    /**
+     * Re-arm every deferred resource: full reset (attempts→0) + immediate reconnect now
+     * the tab is visible / online. Healthy subscriptions are untouched. A re-armed cycle
+     * that later exhausts while visible fires the terminal error normally.
+     */
+  }, {
+    key: "handleWake",
+    value: function handleWake() {
+      if (this.deferredExhausted.size === 0) {
+        this.unregisterWakeListeners();
+        return;
+      }
+      var toRearm = Array.from(this.deferredExhausted);
+      this.deferredExhausted.clear();
+      for (var _i = 0, _toRearm = toRearm; _i < _toRearm.length; _i++) {
+        var resourceId = _toRearm[_i];
+        // Only re-arm resources that still have active subscribers and realtime on.
+        if (!this.subscriptions.has(resourceId) || !this.shouldUseRealTime()) {
+          continue;
+        }
+        this.resetRetryCount(resourceId);
+        this.cancelPendingRetry(resourceId);
+        this.setupSubscription(resourceId);
+      }
+      // No deferred resources remain until another hidden exhaustion re-adds one.
+      this.unregisterWakeListeners();
+    }
   }, {
     key: "cancelPendingRetry",
     value: function cancelPendingRetry(resourceId) {
@@ -404,20 +537,23 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
   }, {
     key: "cancelAllPendingRetries",
     value: function cancelAllPendingRetries() {
-      var _iterator = _createForOfIteratorHelper(this.pendingRetries.values()),
-        _step;
+      var _iterator2 = _createForOfIteratorHelper(this.pendingRetries.values()),
+        _step2;
       try {
-        for (_iterator.s(); !(_step = _iterator.n()).done;) {
-          var timer = _step.value;
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var timer = _step2.value;
           clearTimeout(timer);
         }
       } catch (err) {
-        _iterator.e(err);
+        _iterator2.e(err);
       } finally {
-        _iterator.f();
+        _iterator2.f();
       }
       this.pendingRetries.clear();
       this.retryAttempts.clear();
+      // Nothing left to re-arm: drop parked exhaustions and tear down wake listeners.
+      this.deferredExhausted.clear();
+      this.unregisterWakeListeners();
     }
   }, {
     key: "cleanupSubscription",
@@ -429,37 +565,42 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
       }
       this.cancelPendingRetry(resourceId);
       this.retryAttempts.delete(resourceId);
+      // No subscribers left, so this resource can't be re-armed.
+      this.deferredExhausted.delete(resourceId);
+      if (this.deferredExhausted.size === 0) {
+        this.unregisterWakeListeners();
+      }
     }
   }, {
     key: "setupSubscriptionsForAllBlocks",
     value: function setupSubscriptionsForAllBlocks() {
-      var _iterator2 = _createForOfIteratorHelper(this.subscriptions.keys()),
-        _step2;
+      var _iterator3 = _createForOfIteratorHelper(this.subscriptions.keys()),
+        _step3;
       try {
-        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-          var resourceId = _step2.value;
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var resourceId = _step3.value;
           this.setupSubscription(resourceId);
         }
       } catch (err) {
-        _iterator2.e(err);
+        _iterator3.e(err);
       } finally {
-        _iterator2.f();
+        _iterator3.f();
       }
     }
   }, {
     key: "cleanupAll",
     value: function cleanupAll() {
-      var _iterator3 = _createForOfIteratorHelper(this.graphqlSubscriptions.values()),
-        _step3;
+      var _iterator4 = _createForOfIteratorHelper(this.graphqlSubscriptions.values()),
+        _step4;
       try {
-        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-          var unsubscribe = _step3.value;
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var unsubscribe = _step4.value;
           unsubscribe();
         }
       } catch (err) {
-        _iterator3.e(err);
+        _iterator4.e(err);
       } finally {
-        _iterator3.f();
+        _iterator4.f();
       }
       this.graphqlSubscriptions.clear();
       this.cancelAllPendingRetries();
@@ -474,17 +615,17 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
       this.useRealTimeSubscriptions = false;
 
       // Clear any pending cache deletions
-      var _iterator4 = _createForOfIteratorHelper(this.pendingCacheDeletions.values()),
-        _step4;
+      var _iterator5 = _createForOfIteratorHelper(this.pendingCacheDeletions.values()),
+        _step5;
       try {
-        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
-          var timeout = _step4.value;
+        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+          var timeout = _step5.value;
           clearTimeout(timeout);
         }
       } catch (err) {
-        _iterator4.e(err);
+        _iterator5.e(err);
       } finally {
-        _iterator4.f();
+        _iterator5.f();
       }
       this.pendingCacheDeletions.clear();
     }
@@ -496,7 +637,7 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
   }, {
     key: "handleGraphQLUpdate",
     value: function handleGraphQLUpdate(syncBlockInstance) {
-      var _this7 = this;
+      var _this9 = this;
       if (!syncBlockInstance.resourceId) {
         return;
       }
@@ -505,21 +646,28 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
       this.deps.updateCache(resolved);
       if (!syncBlockInstance.error) {
         this.resetRetryCount(syncBlockInstance.resourceId);
+        // A healthy update means a parked exhaustion recovered on its own before any
+        // wake sweep — drop it and tear down listeners if nothing else is parked.
+        if (this.deferredExhausted.delete(syncBlockInstance.resourceId)) {
+          if (this.deferredExhausted.size === 0) {
+            this.unregisterWakeListeners();
+          }
+        }
         var callbacks = this.subscriptions.get(syncBlockInstance.resourceId);
         var localIds = callbacks ? Object.keys(callbacks) : [];
         localIds.forEach(function (localId) {
-          var _this7$deps$getFireAn, _syncBlockInstance$da, _syncBlockInstance$da2;
-          (_this7$deps$getFireAn = _this7.deps.getFireAnalyticsEvent()) === null || _this7$deps$getFireAn === void 0 || _this7$deps$getFireAn((0, _errorHandling.fetchSuccessPayload)(syncBlockInstance.resourceId, localId, (_syncBlockInstance$da = (_syncBlockInstance$da2 = syncBlockInstance.data) === null || _syncBlockInstance$da2 === void 0 ? void 0 : _syncBlockInstance$da2.product) !== null && _syncBlockInstance$da !== void 0 ? _syncBlockInstance$da : (0, _utils.getSourceProductFromResourceIdSafe)(syncBlockInstance.resourceId)));
+          var _this9$deps$getFireAn, _syncBlockInstance$da, _syncBlockInstance$da2;
+          (_this9$deps$getFireAn = _this9.deps.getFireAnalyticsEvent()) === null || _this9$deps$getFireAn === void 0 || _this9$deps$getFireAn((0, _errorHandling.fetchSuccessPayload)(syncBlockInstance.resourceId, localId, (_syncBlockInstance$da = (_syncBlockInstance$da2 = syncBlockInstance.data) === null || _syncBlockInstance$da2 === void 0 ? void 0 : _syncBlockInstance$da2.product) !== null && _syncBlockInstance$da !== void 0 ? _syncBlockInstance$da : (0, _utils.getSourceProductFromResourceIdSafe)(syncBlockInstance.resourceId)));
         });
         this.deps.fetchSyncBlockSourceInfo(resolved.resourceId);
       } else {
-        var _syncBlockInstance$er, _syncBlockInstance$er2, _this$deps$getFireAna2, _syncBlockInstance$da3, _syncBlockInstance$da4, _syncBlockInstance$er3, _syncBlockInstance$er4, _syncBlockInstance$er5;
+        var _syncBlockInstance$er, _syncBlockInstance$er2, _this$deps$getFireAna3, _syncBlockInstance$da3, _syncBlockInstance$da4, _syncBlockInstance$er3, _syncBlockInstance$er4, _syncBlockInstance$er5;
         var errorMessage = ((_syncBlockInstance$er = syncBlockInstance.error) === null || _syncBlockInstance$er === void 0 ? void 0 : _syncBlockInstance$er.reason) || ((_syncBlockInstance$er2 = syncBlockInstance.error) === null || _syncBlockInstance$er2 === void 0 ? void 0 : _syncBlockInstance$er2.type);
 
         // Prefer the structured `type` (a `SyncBlockError` enum value) for classification
         // and fall back to the free-text `reason` so source-state/permission strings are
         // still bucketed (EDITOR-7862). The emitted free-text `error` attribute is unchanged.
-        (_this$deps$getFireAna2 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna2 === void 0 || _this$deps$getFireAna2((0, _errorHandling.fetchErrorPayload)(errorMessage, syncBlockInstance.resourceId, (_syncBlockInstance$da3 = (_syncBlockInstance$da4 = syncBlockInstance.data) === null || _syncBlockInstance$da4 === void 0 ? void 0 : _syncBlockInstance$da4.product) !== null && _syncBlockInstance$da3 !== void 0 ? _syncBlockInstance$da3 : (0, _utils.getSourceProductFromResourceIdSafe)(syncBlockInstance.resourceId), (0, _errorHandling.buildFetchErrorAttribution)((0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_3'), ((_syncBlockInstance$er3 = syncBlockInstance.error) === null || _syncBlockInstance$er3 === void 0 ? void 0 : _syncBlockInstance$er3.type) || ((_syncBlockInstance$er4 = syncBlockInstance.error) === null || _syncBlockInstance$er4 === void 0 ? void 0 : _syncBlockInstance$er4.reason), (_syncBlockInstance$er5 = syncBlockInstance.error) === null || _syncBlockInstance$er5 === void 0 ? void 0 : _syncBlockInstance$er5.statusCode)));
+        (_this$deps$getFireAna3 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna3 === void 0 || _this$deps$getFireAna3((0, _errorHandling.fetchErrorPayload)(errorMessage, syncBlockInstance.resourceId, (_syncBlockInstance$da3 = (_syncBlockInstance$da4 = syncBlockInstance.data) === null || _syncBlockInstance$da4 === void 0 ? void 0 : _syncBlockInstance$da4.product) !== null && _syncBlockInstance$da3 !== void 0 ? _syncBlockInstance$da3 : (0, _utils.getSourceProductFromResourceIdSafe)(syncBlockInstance.resourceId), (0, _errorHandling.buildFetchErrorAttribution)((0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_3'), ((_syncBlockInstance$er3 = syncBlockInstance.error) === null || _syncBlockInstance$er3 === void 0 ? void 0 : _syncBlockInstance$er3.type) || ((_syncBlockInstance$er4 = syncBlockInstance.error) === null || _syncBlockInstance$er4 === void 0 ? void 0 : _syncBlockInstance$er4.reason), (_syncBlockInstance$er5 = syncBlockInstance.error) === null || _syncBlockInstance$er5 === void 0 ? void 0 : _syncBlockInstance$er5.statusCode)));
       }
     }
   }]);
@@ -531,4 +679,6 @@ var SyncBlockSubscriptionManager = exports.SyncBlockSubscriptionManager = /*#__P
 // legacy (gate OFF)
 (0, _defineProperty2.default)(SyncBlockSubscriptionManager, "MAX_RETRY_ATTEMPTS_HARDENED", 8);
 // gate ON (EDITOR-7861)
-(0, _defineProperty2.default)(SyncBlockSubscriptionManager, "MAX_RETRY_DELAY_MS", 30000);
+(0, _defineProperty2.default)(SyncBlockSubscriptionManager, "MAX_RETRY_DELAY_MS", 30000);
+// Coalesce wake-event bursts into one re-arm sweep to avoid a reconnection storm.
+(0, _defineProperty2.default)(SyncBlockSubscriptionManager, "WAKE_DEBOUNCE_MS", 1000);

package/dist/cjs/utils/errorHandling.js

@@ -202,16 +202,19 @@ var classifyFetchErrorReason = exports.classifyFetchErrorReason = function class
  * `gateEnabled` is injected by the caller (the store managers evaluate `fg(...)`) so this
  * helper stays pure and trivially unit-testable for both gate states.
  */
-var buildFetchErrorAttribution = exports.buildFetchErrorAttribution = function buildFetchErrorAttribution(gateEnabled, error, statusCode) {
+var buildFetchErrorAttribution = exports.buildFetchErrorAttribution = function buildFetchErrorAttribution(gateEnabled, error, statusCode, deferred) {
   if (!gateEnabled) {
     return undefined;
   }
   var reason = classifyFetchErrorReason(error);
-  return _objectSpread({
+  return _objectSpread(_objectSpread({
     reason: reason,
-    benign: FETCH_BENIGN_REASONS.has(reason)
+    // A deferred (tab-hidden) exhaustion is benign regardless of reason bucket.
+    benign: deferred === true || FETCH_BENIGN_REASONS.has(reason)
   }, statusCode !== undefined && {
     statusCode: statusCode
+  }), deferred === true && {
+    deferred: true
   });
 };
 
@@ -239,7 +242,7 @@ function getErrorPayload(actionSubjectId, error, resourceId, sourceProduct, attr
     actionSubject: _analytics.ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: actionSubjectId,
     eventType: _analytics.EVENT_TYPE.OPERATIONAL,
-    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
+    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
       error: error
     }, resourceId && {
       resourceId: resourceId
@@ -251,6 +254,8 @@ function getErrorPayload(actionSubjectId, error, resourceId, sourceProduct, attr
       statusCode: attribution.statusCode
     }), attribution && 'benign' in attribution && {
       benign: attribution.benign
+    }), attribution && 'deferred' in attribution && attribution.deferred === true && {
+      deferred: true
     })
   };
 }

package/dist/es2019/store-manager/referenceSyncBlockStoreManager.js

@@ -841,7 +841,7 @@ export class ReferenceSyncBlockStoreManager {
     if (this.viewMode === 'view') {
       // Reference flushes are only meaningful while editing. Treat view-mode flush attempts as
       // gated no-op successes so lifecycle/teardown calls do not report false save failures.
-      return fg('platform_editor_blocks_patch_2');
+      return true;
     }
     if (!this.isCacheDirty) {
       // we use the isCacheDirty flag as a quick check.