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

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

@@ -2,7 +2,7 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { logException } from '@atlaskit/editor-common/monitoring';
 import { fg } from '@atlaskit/platform-feature-flags';
 import { SyncBlockError } from '../common/types';
-import { updateErrorPayload, createErrorPayload, deleteErrorPayload, updateCacheErrorPayload, getSourceInfoErrorPayload, updateSuccessPayload, createSuccessPayload, createSuccessOperationalPayload, deleteSuccessPayload, fetchReferencesErrorPayload, buildErrorAttribution } from '../utils/errorHandling';
+import { updateErrorPayload, createErrorPayload, deleteErrorPayload, updateCacheErrorPayload, getSourceInfoErrorPayload, updateSuccessPayload, createSuccessPayload, createSuccessOperationalPayload, addContentSuccessPayload, deleteSuccessPayload, fetchReferencesErrorPayload, buildErrorAttribution } from '../utils/errorHandling';
 import { getCreateSourceExperience, getDeleteSourceExperience, getSaveSourceExperience, getFetchSourceInfoExperience } from '../utils/experienceTracking';
 import { convertSyncBlockPMNodeToSyncBlockData, getSourceProductFromResourceIdSafe } from '../utils/utils';
 /** Maximum time (ms) flush() will wait for in-flight block creations before proceeding. */
@@ -40,6 +40,20 @@ export class SourceSyncBlockStoreManager {
      * multiple blocks are created concurrently. See EDITOR-7112.
      */
     _defineProperty(this, "creationsTimedOutDuringFlush", new Set());
+    /**
+     * Creation-type signals captured at `createBodiedSyncBlockNode` time and read
+     * back in `commitPendingCreation` to enrich the `syncedBlockCreate` event.
+     * Kept out of the flushed cache record so it never leaks into Block Service /
+     * ADF; removed once consumed.
+     */
+    _defineProperty(this, "creationEnrichment", new Map());
+    /**
+     * Resource IDs of blocks created empty this session that have not yet fired
+     * the first-content-added event. Added on empty creation, removed when the
+     * block first gains content (the event fires once). Blocks created with
+     * content or not created this session are never tracked.
+     */
+    _defineProperty(this, "awaitingFirstContent", new Set());
     /**
      * resourceId -> timestamp (ms) of the last `syncedBlockDelete` emission, used
      * to suppress duplicates within {@link DELETE_DEDUPE_WINDOW_MS}. Only consulted
@@ -338,17 +352,46 @@ export class SourceSyncBlockStoreManager {
       var _this$fireAnalyticsEv6;
       const sourceProduct = getSourceProductFromResourceIdSafe(resourceId);
       (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 ? void 0 : _this$fireAnalyticsEv6.call(this, createSuccessPayload(resourceId || '', sourceProduct));
-      // Operational create-success event with the join key.
+      // Operational create-success event with the join key + creation-type
+      // signals (inputMethod / createdEmpty) captured at the command layer.
       if (fg('platform_editor_blocks_patch_4')) {
         var _this$fireAnalyticsEv7, _this$syncBlockCache$;
-        (_this$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 ? void 0 : _this$fireAnalyticsEv7.call(this, createSuccessOperationalPayload(resourceId || '', (_this$syncBlockCache$ = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$ === void 0 ? void 0 : _this$syncBlockCache$.blockInstanceId, sourceProduct));
+        (_this$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 ? void 0 : _this$fireAnalyticsEv7.call(this, createSuccessOperationalPayload(resourceId || '', (_this$syncBlockCache$ = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$ === void 0 ? void 0 : _this$syncBlockCache$.blockInstanceId, sourceProduct, this.creationEnrichment.get(resourceId)));
       }
     } else {
       var _this$fireAnalyticsEv8;
       // Delete the node from cache if fail to create so it's not flushed to BE
       this.syncBlockCache.delete(resourceId || '');
+      // Creation failed, so there is no block to add content to — drop the
+      // first-content tracking entry so a later unrelated edit cannot fire it.
+      this.awaitingFirstContent.delete(resourceId || '');
       (_this$fireAnalyticsEv8 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv8 === void 0 ? void 0 : _this$fireAnalyticsEv8.call(this, createErrorPayload('Fail to create bodied sync block', resourceId, getSourceProductFromResourceIdSafe(resourceId)));
     }
+    // Enrichment is single-use — drop it once the create has resolved either way.
+    this.creationEnrichment.delete(resourceId || '');
+  }
+
+  /**
+   * Fire the first-content-added event once when a block created empty this
+   * session first gains content. The caller detects the in-block edit; this owns
+   * dedupe + emission (fires at most once per block, only for empty→content).
+   * Gated behind `platform_editor_blocks_patch_4`.
+   */
+  maybeEmitFirstContentAdded(resourceId, blockInstanceId) {
+    var _this$fireAnalyticsEv9;
+    if (this.viewMode === 'view') {
+      return;
+    }
+    if (!fg('platform_editor_blocks_patch_4')) {
+      return;
+    }
+    // `delete` returns false when the id was not tracked (already emitted, or
+    // the block was not created empty this session), so this both dedupes and
+    // scopes emission to genuine first-content transitions in one check.
+    if (!this.awaitingFirstContent.delete(resourceId)) {
+      return;
+    }
+    (_this$fireAnalyticsEv9 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv9 === void 0 ? void 0 : _this$fireAnalyticsEv9.call(this, addContentSuccessPayload(resourceId, blockInstanceId, getSourceProductFromResourceIdSafe(resourceId)));
   }
   registerConfirmationCallback(callback) {
     this.confirmationCallback = callback;
@@ -382,8 +425,12 @@ export class SourceSyncBlockStoreManager {
    * @param attrs attributes Ids of the node
    * @param node the ProseMirror node to cache
    * @param onCompletion callback invoked when creation completes
+   * @param enrichment optional creation-type signals stashed and attached to the
+   *   `syncedBlockCreate` event when the async create resolves. When
+   *   `createdEmpty` is true the block is also registered for the
+   *   first-content-added event.
    */
-  createBodiedSyncBlockNode(attrs, node, onCompletion) {
+  createBodiedSyncBlockNode(attrs, node, onCompletion, enrichment) {
     if (this.viewMode === 'view') {
       return;
     }
@@ -391,6 +438,14 @@ export class SourceSyncBlockStoreManager {
       resourceId,
       localId: blockInstanceId
     } = attrs;
+    // Stash creation-type signals for commitPendingCreation to read.
+    if (enrichment) {
+      this.creationEnrichment.set(resourceId, enrichment);
+      // Only empty-created blocks can produce an empty→content transition.
+      if (enrichment.createdEmpty) {
+        this.awaitingFirstContent.add(resourceId);
+      }
+    }
     try {
       var _this$createExperienc;
       if (!this.dataProvider) {
@@ -418,15 +473,15 @@ export class SourceSyncBlockStoreManager {
           this.commitPendingCreation(true, resourceId);
           (_this$createExperienc2 = this.createExperience) === null || _this$createExperienc2 === void 0 ? void 0 : _this$createExperienc2.success();
         } else {
-          var _this$createExperienc3, _this$fireAnalyticsEv9;
+          var _this$createExperienc3, _this$fireAnalyticsEv0;
           this.commitPendingCreation(false, resourceId);
           (_this$createExperienc3 = this.createExperience) === null || _this$createExperienc3 === void 0 ? void 0 : _this$createExperienc3.failure({
             reason: result.error || 'Failed to create bodied sync block'
           });
-          (_this$fireAnalyticsEv9 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv9 === void 0 ? void 0 : _this$fireAnalyticsEv9.call(this, createErrorPayload(result.error || 'Failed to create bodied sync block', resourceId, getSourceProductFromResourceIdSafe(resourceId), buildErrorAttribution(fg('platform_editor_blocks_patch_3'), result.error, result.statusCode)));
+          (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 ? void 0 : _this$fireAnalyticsEv0.call(this, createErrorPayload(result.error || 'Failed to create bodied sync block', resourceId, getSourceProductFromResourceIdSafe(resourceId), buildErrorAttribution(fg('platform_editor_blocks_patch_3'), result.error, result.statusCode)));
         }
       }).catch(error => {
-        var _this$createExperienc4, _this$fireAnalyticsEv0;
+        var _this$createExperienc4, _this$fireAnalyticsEv1;
         this.commitPendingCreation(false, resourceId);
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
@@ -434,20 +489,20 @@ export class SourceSyncBlockStoreManager {
         (_this$createExperienc4 = this.createExperience) === null || _this$createExperienc4 === void 0 ? void 0 : _this$createExperienc4.failure({
           reason: error.message
         });
-        (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 ? void 0 : _this$fireAnalyticsEv0.call(this, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+        (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 ? void 0 : _this$fireAnalyticsEv1.call(this, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
       }).finally(() => {
         this.pendingCreationPromises.delete(resourceId);
       });
       this.pendingCreationPromises.set(resourceId, creationPromise);
     } catch (error) {
-      var _this$fireAnalyticsEv1;
+      var _this$fireAnalyticsEv10;
       if (this.isPendingCreation(resourceId)) {
         this.commitPendingCreation(false, resourceId);
       }
       logException(error, {
         location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
       });
-      (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 ? void 0 : _this$fireAnalyticsEv1.call(this, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+      (_this$fireAnalyticsEv10 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv10 === void 0 ? void 0 : _this$fireAnalyticsEv10.call(this, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
     }
   }
   /**
@@ -469,11 +524,11 @@ export class SourceSyncBlockStoreManager {
    * while the cache entry still exists so `blockInstanceId` is available.
    */
   emitDeleteSuccess(resourceId, reason, mechanism) {
-    var _this$syncBlockCache$2, _this$fireAnalyticsEv11;
+    var _this$syncBlockCache$2, _this$fireAnalyticsEv12;
     const sourceProduct = getSourceProductFromResourceIdSafe(resourceId);
     if (!fg('platform_editor_blocks_patch_4')) {
-      var _this$fireAnalyticsEv10;
-      (_this$fireAnalyticsEv10 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv10 === void 0 ? void 0 : _this$fireAnalyticsEv10.call(this, deleteSuccessPayload(resourceId, sourceProduct));
+      var _this$fireAnalyticsEv11;
+      (_this$fireAnalyticsEv11 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv11 === void 0 ? void 0 : _this$fireAnalyticsEv11.call(this, deleteSuccessPayload(resourceId, sourceProduct));
       return;
     }
     const now = Date.now();
@@ -488,7 +543,7 @@ export class SourceSyncBlockStoreManager {
       deletionReason: reason,
       mechanism
     };
-    (_this$fireAnalyticsEv11 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv11 === void 0 ? void 0 : _this$fireAnalyticsEv11.call(this, deleteSuccessPayload(resourceId, sourceProduct, enrichment));
+    (_this$fireAnalyticsEv12 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv12 === void 0 ? void 0 : _this$fireAnalyticsEv12.call(this, deleteSuccessPayload(resourceId, sourceProduct, enrichment));
   }
   async delete(syncBlockIds, onDelete, onDeleteCompleted, reason, mechanism) {
     try {
@@ -529,8 +584,8 @@ export class SourceSyncBlockStoreManager {
           if (result.success) {
             this.emitDeleteSuccess(result.resourceId, reason, mechanism);
           } else {
-            var _this$fireAnalyticsEv12;
-            (_this$fireAnalyticsEv12 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv12 === void 0 ? void 0 : _this$fireAnalyticsEv12.call(this, deleteErrorPayload(result.error || 'Failed to delete synced block', result.resourceId, getSourceProductFromResourceIdSafe(result.resourceId), buildErrorAttribution(attributionEnabled, result.error, result.statusCode)));
+            var _this$fireAnalyticsEv13;
+            (_this$fireAnalyticsEv13 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv13 === void 0 ? void 0 : _this$fireAnalyticsEv13.call(this, deleteErrorPayload(result.error || 'Failed to delete synced block', result.resourceId, getSourceProductFromResourceIdSafe(result.resourceId), buildErrorAttribution(attributionEnabled, result.error, result.statusCode)));
           }
         });
       }
@@ -541,9 +596,9 @@ export class SourceSyncBlockStoreManager {
       // so the attribution `reason` falls back to `unknown` when the gate is on.
       const attribution = buildErrorAttribution(fg('platform_editor_blocks_patch_3'));
       syncBlockIds.forEach(Ids => {
-        var _this$fireAnalyticsEv13;
+        var _this$fireAnalyticsEv14;
         this.setPendingDeletion(Ids, false);
-        (_this$fireAnalyticsEv13 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv13 === void 0 ? void 0 : _this$fireAnalyticsEv13.call(this, deleteErrorPayload(error.message, Ids.resourceId, getSourceProductFromResourceIdSafe(Ids.resourceId), attribution));
+        (_this$fireAnalyticsEv14 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv14 === void 0 ? void 0 : _this$fireAnalyticsEv14.call(this, deleteErrorPayload(error.message, Ids.resourceId, getSourceProductFromResourceIdSafe(Ids.resourceId), attribution));
       });
       logException(error, {
         location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
@@ -703,11 +758,11 @@ export class SourceSyncBlockStoreManager {
         return sourceInfo;
       });
     } catch (error) {
-      var _this$fireAnalyticsEv14;
+      var _this$fireAnalyticsEv15;
       logException(error, {
         location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
       });
-      (_this$fireAnalyticsEv14 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv14 === void 0 ? void 0 : _this$fireAnalyticsEv14.call(this, getSourceInfoErrorPayload(error.message));
+      (_this$fireAnalyticsEv15 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv15 === void 0 ? void 0 : _this$fireAnalyticsEv15.call(this, getSourceInfoErrorPayload(error.message));
       return Promise.resolve(undefined);
     }
   }
@@ -718,11 +773,11 @@ export class SourceSyncBlockStoreManager {
       }
       return this.dataProvider.fetchReferences(resourceId, true);
     } catch (error) {
-      var _this$fireAnalyticsEv15;
+      var _this$fireAnalyticsEv16;
       logException(error, {
         location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
       });
-      (_this$fireAnalyticsEv15 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv15 === void 0 ? void 0 : _this$fireAnalyticsEv15.call(this, fetchReferencesErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+      (_this$fireAnalyticsEv16 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv16 === void 0 ? void 0 : _this$fireAnalyticsEv16.call(this, fetchReferencesErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
       return Promise.resolve({
         error: SyncBlockError.Errored
       });
@@ -737,6 +792,8 @@ export class SourceSyncBlockStoreManager {
     this.postCreationFlushCallback = undefined;
     this.pendingCreationPromises.clear();
     this.creationsTimedOutDuringFlush.clear();
+    this.creationEnrichment.clear();
+    this.awaitingFirstContent.clear();
     this.recentDeleteEmissions.clear();
     this.dataProvider = undefined;
     (_this$saveExperience4 = this.saveExperience) === null || _this$saveExperience4 === void 0 ? void 0 : _this$saveExperience4.abort({

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

@@ -1,4 +1,6 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+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';
@@ -45,6 +47,22 @@ export class SyncBlockSubscriptionManager {
     // 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", () => this.scheduleWakeSweep());
+    _defineProperty(this, "onVisibilityChange", () => {
+      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;
   }
 
@@ -306,14 +324,26 @@ export class SyncBlockSubscriptionManager {
     const attempts = (_this$retryAttempts$g = this.retryAttempts.get(resourceId)) !== null && _this$retryAttempts$g !== void 0 ? _this$retryAttempts$g : 0;
     const maxAttempts = this.getMaxRetryAttempts();
     if (attempts >= maxAttempts) {
-      var _this$deps$getFireAna3;
+      var _this$deps$getFireAna4;
       // Exhausted all attempts — the only place a WS drop surfaces as a
       // fetch error under the gate (EDITOR-7861).
       const errorMessage = `Subscription reconnection failed after ${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.
+      const shouldDefer = fg('platform_editor_blocks_patch_3') && this.isDocumentHidden();
+      if (shouldDefer) {
+        var _this$deps$getFireAna3;
+        this.deferredExhausted.add(resourceId);
+        this.registerWakeListeners();
+        (_this$deps$getFireAna3 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna3 === void 0 ? void 0 : _this$deps$getFireAna3(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$getFireAna3 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna3 === void 0 ? void 0 : _this$deps$getFireAna3(fetchErrorPayload(errorMessage, resourceId, getSourceProductFromResourceIdSafe(resourceId), buildFetchErrorAttribution(fg('platform_editor_blocks_patch_3'), errorMessage)));
+      (_this$deps$getFireAna4 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna4 === void 0 ? void 0 : _this$deps$getFireAna4(fetchErrorPayload(errorMessage, resourceId, getSourceProductFromResourceIdSafe(resourceId), buildFetchErrorAttribution(fg('platform_editor_blocks_patch_3'), errorMessage)));
       return;
     }
     const delay = this.getReconnectionDelay(attempts);
@@ -344,6 +374,85 @@ export class SyncBlockSubscriptionManager {
   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).
+   */
+  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.
+   */
+  registerWakeListeners() {
+    if (this.wakeListenerCleanups.length > 0 || typeof window === 'undefined') {
+      return;
+    }
+    this.wakeListenerCleanups.push(bind(window, {
+      type: 'online',
+      listener: this.onOnline
+    }));
+    const doc = getDocument();
+    if (doc) {
+      this.wakeListenerCleanups.push(bind(doc, {
+        type: 'visibilitychange',
+        listener: this.onVisibilityChange
+      }));
+    }
+  }
+  unregisterWakeListeners() {
+    if (this.wakeDebounceTimer !== null) {
+      clearTimeout(this.wakeDebounceTimer);
+      this.wakeDebounceTimer = null;
+    }
+    for (const cleanup of this.wakeListenerCleanups) {
+      cleanup();
+    }
+    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.
+   */
+  scheduleWakeSweep() {
+    if (this.wakeDebounceTimer !== null) {
+      return;
+    }
+    this.wakeDebounceTimer = setTimeout(() => {
+      this.wakeDebounceTimer = null;
+      this.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.
+   */
+  handleWake() {
+    if (this.deferredExhausted.size === 0) {
+      this.unregisterWakeListeners();
+      return;
+    }
+    const toRearm = Array.from(this.deferredExhausted);
+    this.deferredExhausted.clear();
+    for (const resourceId of toRearm) {
+      // 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();
+  }
   cancelPendingRetry(resourceId) {
     const timer = this.pendingRetries.get(resourceId);
     if (timer) {
@@ -357,6 +466,9 @@ export class SyncBlockSubscriptionManager {
     }
     this.pendingRetries.clear();
     this.retryAttempts.clear();
+    // Nothing left to re-arm: drop parked exhaustions and tear down wake listeners.
+    this.deferredExhausted.clear();
+    this.unregisterWakeListeners();
   }
   cleanupSubscription(resourceId) {
     const unsubscribe = this.graphqlSubscriptions.get(resourceId);
@@ -366,6 +478,11 @@ export class SyncBlockSubscriptionManager {
     }
     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();
+    }
   }
   setupSubscriptionsForAllBlocks() {
     for (const resourceId of this.subscriptions.keys()) {
@@ -404,21 +521,28 @@ export class SyncBlockSubscriptionManager {
     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();
+        }
+      }
       const callbacks = this.subscriptions.get(syncBlockInstance.resourceId);
       const localIds = callbacks ? Object.keys(callbacks) : [];
       localIds.forEach(localId => {
-        var _this$deps$getFireAna4, _syncBlockInstance$da, _syncBlockInstance$da2;
-        (_this$deps$getFireAna4 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna4 === void 0 ? void 0 : _this$deps$getFireAna4(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 _this$deps$getFireAna5, _syncBlockInstance$da, _syncBlockInstance$da2;
+        (_this$deps$getFireAna5 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna5 === void 0 ? void 0 : _this$deps$getFireAna5(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$getFireAna5, _syncBlockInstance$da3, _syncBlockInstance$da4, _syncBlockInstance$er3, _syncBlockInstance$er4, _syncBlockInstance$er5;
+      var _syncBlockInstance$er, _syncBlockInstance$er2, _this$deps$getFireAna6, _syncBlockInstance$da3, _syncBlockInstance$da4, _syncBlockInstance$er3, _syncBlockInstance$er4, _syncBlockInstance$er5;
       const 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$getFireAna5 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna5 === void 0 ? void 0 : _this$deps$getFireAna5(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$getFireAna6 = this.deps.getFireAnalyticsEvent()) === null || _this$deps$getFireAna6 === void 0 ? void 0 : _this$deps$getFireAna6(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)));
     }
   }
 }
@@ -429,4 +553,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/es2019/utils/errorHandling.js

@@ -188,16 +188,20 @@ export const 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 const buildFetchErrorAttribution = (gateEnabled, error, statusCode) => {
+export const buildFetchErrorAttribution = (gateEnabled, error, statusCode, deferred) => {
   if (!gateEnabled) {
     return undefined;
   }
   const reason = classifyFetchErrorReason(error);
   return {
     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
+    }),
+    ...(deferred === true && {
+      deferred: true
     })
   };
 };
@@ -246,6 +250,11 @@ export function getErrorPayload(actionSubjectId, error, resourceId, sourceProduc
       // `attribution.benign` is accessible.
       ...(attribution && 'benign' in attribution && {
         benign: attribution.benign
+      }),
+      // `deferred` is only present on fetch/subscribe attribution, and only when a
+      // tab-hidden exhaustion was deferred rather than surfaced. Boolean, never UGC.
+      ...(attribution && 'deferred' in attribution && attribution.deferred === true && {
+        deferred: true
       })
     }
   };
@@ -339,15 +348,50 @@ export const createSuccessPayload = (resourceId, sourceProduct) => {
 };
 
 /**
- * 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.
+ */
+
+/**
+ * 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 const createSuccessOperationalPayload = (resourceId, blockInstanceId, sourceProduct) => ({
+export const createSuccessOperationalPayload = (resourceId, blockInstanceId, sourceProduct, enrichment) => ({
   action: ACTION.INSERTED,
   actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
   actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE,
   eventType: EVENT_TYPE.OPERATIONAL,
+  attributes: {
+    resourceId,
+    ...(blockInstanceId && {
+      blockInstanceId
+    }),
+    ...(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 const addContentSuccessPayload = (resourceId, blockInstanceId, sourceProduct) => ({
+  action: ACTION.ADDED,
+  actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
+  actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_ADD_CONTENT,
+  eventType: EVENT_TYPE.OPERATIONAL,
   attributes: {
     resourceId,
     ...(blockInstanceId && {

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

@@ -1013,7 +1013,7 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
                 _context4.next = 1;
                 break;
               }
-              return _context4.abrupt("return", fg('platform_editor_blocks_patch_2'));
+              return _context4.abrupt("return", true);
             case 1:
               if (this.isCacheDirty) {
                 _context4.next = 2;