@atlaskit/editor-synced-block-provider 8.5.7 → 8.6.1

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

@@ -6,6 +6,8 @@ function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r)
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+import { bind } from 'bind-event-listener';
+import { getDocument } from '@atlaskit/browser-apis';
 import { logException } from '@atlaskit/editor-common/monitoring';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { buildFetchErrorAttribution, fetchErrorPayload, fetchSuccessPayload } from '../utils/errorHandling';
@@ -20,6 +22,7 @@ import { getSourceProductFromResourceIdSafe } from '../utils/utils';
 
 export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   function SyncBlockSubscriptionManager(deps) {
+    var _this = this;
     _classCallCheck(this, SyncBlockSubscriptionManager);
     _defineProperty(this, "subscriptions", new Map());
     _defineProperty(this, "titleSubscriptions", new Map());
@@ -34,6 +37,24 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
     // backoff cap (gate ON)
     _defineProperty(this, "retryAttempts", new Map());
     _defineProperty(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.
+    _defineProperty(this, "deferredExhausted", new Set());
+    _defineProperty(this, "wakeDebounceTimer", null);
+    // `online` always sweeps (network is back regardless of tab visibility); a
+    // `visibilitychange` only sweeps when the tab became visible.
+    _defineProperty(this, "onOnline", function () {
+      return _this.scheduleWakeSweep();
+    });
+    _defineProperty(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.
+    _defineProperty(this, "wakeListenerCleanups", []);
     this.deps = deps;
   }
 
@@ -96,25 +117,25 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   }, {
     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;
           logException(error, {
             location: 'editor-synced-block-provider/syncBlockSubscriptionManager/notifySubscriptionChangeListeners'
           });
-          (_this2$deps$getFireAn = _this2.deps.getFireAnalyticsEvent()) === null || _this2$deps$getFireAn === void 0 || _this2$deps$getFireAn(fetchErrorPayload(error.message, undefined, undefined, buildFetchErrorAttribution(fg('platform_editor_blocks_patch_3'), error.message)));
+          (_this3$deps$getFireAn = _this3.deps.getFireAnalyticsEvent()) === null || _this3$deps$getFireAn === void 0 || _this3$deps$getFireAn(fetchErrorPayload(error.message, undefined, undefined, buildFetchErrorAttribution(fg('platform_editor_blocks_patch_3'), error.message)));
         }
       });
     }
@@ -134,7 +155,7 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   }, {
     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
@@ -174,25 +195,25 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
         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 (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
@@ -203,18 +224,18 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
               // 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);
           }
         }
       };
@@ -223,7 +244,7 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
     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 () {};
@@ -243,13 +264,13 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
       var resourceSubscriptions = this.titleSubscriptions.get(resourceId) || {};
       this.titleSubscriptions.set(resourceId, _objectSpread(_objectSpread({}, resourceSubscriptions), {}, _defineProperty({}, 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);
           }
         }
       };
@@ -281,7 +302,7 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   }, {
     key: "setupSubscription",
     value: function setupSubscription(resourceId) {
-      var _this5 = this;
+      var _this6 = this;
       if (this.graphqlSubscriptions.has(resourceId)) {
         return;
       }
@@ -290,7 +311,7 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
         return;
       }
       var unsubscribe = dataProvider.subscribeToBlockUpdates(resourceId, function (syncBlockInstance) {
-        _this5.handleGraphQLUpdate(syncBlockInstance);
+        _this6.handleGraphQLUpdate(syncBlockInstance);
       }, function (error) {
         logException(error, {
           location: 'editor-synced-block-provider/syncBlockSubscriptionManager/graphql-subscription'
@@ -303,12 +324,12 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
         // would return undefined; the structured attribution (EDITOR-7862) is therefore
         // applied at the gate-ON exhaustion site in scheduleReconnection instead.
         if (!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(fetchErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+          var _this6$deps$getFireAn;
+          (_this6$deps$getFireAn = _this6.deps.getFireAnalyticsEvent()) === null || _this6$deps$getFireAn === void 0 || _this6$deps$getFireAn(fetchErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
         }
-        _this5.handleSubscriptionTerminated(resourceId);
+        _this6.handleSubscriptionTerminated(resourceId);
       }, function () {
-        _this5.handleSubscriptionTerminated(resourceId);
+        _this6.handleSubscriptionTerminated(resourceId);
       });
       if (unsubscribe) {
         this.graphqlSubscriptions.set(resourceId, unsubscribe);
@@ -342,36 +363,48 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
     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 = 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(fetchErrorPayload(errorMessage, resourceId, getSourceProductFromResourceIdSafe(resourceId), buildFetchErrorAttribution(true, errorMessage, undefined, /* deferred */true)));
+          return;
+        }
         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(fetchErrorPayload(errorMessage, resourceId, getSourceProductFromResourceIdSafe(resourceId), buildFetchErrorAttribution(fg('platform_editor_blocks_patch_3'), errorMessage)));
+        (_this$deps$getFireAna2 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna2 === void 0 || _this$deps$getFireAna2(fetchErrorPayload(errorMessage, resourceId, getSourceProductFromResourceIdSafe(resourceId), buildFetchErrorAttribution(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);
@@ -386,6 +419,106 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
     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 = 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(bind(window, {
+        type: 'online',
+        listener: this.onOnline
+      }));
+      var doc = getDocument();
+      if (doc) {
+        this.wakeListenerCleanups.push(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) {
@@ -398,20 +531,23 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   }, {
     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",
@@ -423,37 +559,42 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
       }
       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();
@@ -468,17 +609,17 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
       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();
     }
@@ -490,7 +631,7 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
   }, {
     key: "handleGraphQLUpdate",
     value: function handleGraphQLUpdate(syncBlockInstance) {
-      var _this7 = this;
+      var _this9 = this;
       if (!syncBlockInstance.resourceId) {
         return;
       }
@@ -499,21 +640,28 @@ export var SyncBlockSubscriptionManager = /*#__PURE__*/function () {
       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(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 : 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(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 : 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(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 : getSourceProductFromResourceIdSafe(syncBlockInstance.resourceId), buildFetchErrorAttribution(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(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 : getSourceProductFromResourceIdSafe(syncBlockInstance.resourceId), buildFetchErrorAttribution(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)));
       }
     }
   }]);
@@ -525,4 +673,6 @@ _defineProperty(SyncBlockSubscriptionManager, "MAX_RETRY_ATTEMPTS", 5);
 // legacy (gate OFF)
 _defineProperty(SyncBlockSubscriptionManager, "MAX_RETRY_ATTEMPTS_HARDENED", 8);
 // gate ON (EDITOR-7861)
-_defineProperty(SyncBlockSubscriptionManager, "MAX_RETRY_DELAY_MS", 30000);
+_defineProperty(SyncBlockSubscriptionManager, "MAX_RETRY_DELAY_MS", 30000);
+// Coalesce wake-event bursts into one re-arm sweep to avoid a reconnection storm.
+_defineProperty(SyncBlockSubscriptionManager, "WAKE_DEBOUNCE_MS", 1000);

package/dist/esm/utils/errorHandling.js

@@ -193,16 +193,19 @@ export var classifyFetchErrorReason = function classifyFetchErrorReason(error) {
  * `gateEnabled` is injected by the caller (the store managers evaluate `fg(...)`) so this
  * helper stays pure and trivially unit-testable for both gate states.
  */
-export var buildFetchErrorAttribution = function buildFetchErrorAttribution(gateEnabled, error, statusCode) {
+export var 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
   });
 };
 
@@ -230,7 +233,7 @@ export function getErrorPayload(actionSubjectId, error, resourceId, sourceProduc
     actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: actionSubjectId,
     eventType: EVENT_TYPE.OPERATIONAL,
-    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
+    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
       error: error
     }, resourceId && {
       resourceId: resourceId
@@ -242,6 +245,8 @@ export function getErrorPayload(actionSubjectId, error, resourceId, sourceProduc
       statusCode: attribution.statusCode
     }), attribution && 'benign' in attribution && {
       benign: attribution.benign
+    }), attribution && 'deferred' in attribution && attribution.deferred === true && {
+      deferred: true
     })
   };
 }
@@ -348,16 +353,49 @@ export var createSuccessPayload = function createSuccessPayload(resourceId, sour
 };
 
 /**
- * Operational `syncedBlockCreate` success event (previously only error rows
- * existed, so dashboards had no create denominator). Fired behind
- * `platform_editor_blocks_patch_4` with the `blockInstanceId` join key.
+ * Optional enrichment for the `syncedBlockCreate` success event. All fields
+ * optional so gate-off/legacy payloads are unchanged. `inputMethod`: creating
+ * surface (enum, PII-safe). `createdEmpty`: true from an empty selection, false
+ * when content was converted.
  */
-export var createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct) {
+
+/**
+ * Operational `syncedBlockCreate` success event, behind
+ * `platform_editor_blocks_patch_4`, with the `blockInstanceId` join key and,
+ * when available, the `inputMethod` + `createdEmpty` creation-type signals.
+ */
+export var createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct, enrichment) {
   return {
     action: ACTION.INSERTED,
     actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE,
     eventType: EVENT_TYPE.OPERATIONAL,
+    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread({
+      resourceId: resourceId
+    }, blockInstanceId && {
+      blockInstanceId: blockInstanceId
+    }), sourceProduct && {
+      sourceProduct: sourceProduct
+    }), (enrichment === null || enrichment === void 0 ? void 0 : enrichment.inputMethod) && {
+      inputMethod: enrichment.inputMethod
+    }), (enrichment === null || enrichment === void 0 ? void 0 : enrichment.createdEmpty) !== undefined && {
+      createdEmpty: enrichment.createdEmpty
+    })
+  };
+};
+
+/**
+ * Operational first-content-added event, behind
+ * `platform_editor_blocks_patch_4`. Fired once when a block created empty first
+ * gains user content. Join keys only (`resourceId` + `blockInstanceId`), no user
+ * content (PII-safe).
+ */
+export var addContentSuccessPayload = function addContentSuccessPayload(resourceId, blockInstanceId, sourceProduct) {
+  return {
+    action: ACTION.ADDED,
+    actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
+    actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_ADD_CONTENT,
+    eventType: EVENT_TYPE.OPERATIONAL,
     attributes: _objectSpread(_objectSpread({
       resourceId: resourceId
     }, blockInstanceId && {

package/dist/types/entry-points/errorHandling.d.ts

@@ -1 +1,2 @@
 export { buildFetchErrorAttribution, fetchErrorPayload, getPiiSafeOriginalError, } from '../utils/errorHandling';
+export type { CreateSuccessEnrichment } from '../utils/errorHandling';