@atlaskit/editor-synced-block-provider 8.4.4 → 8.5.1

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

@@ -12,12 +12,20 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 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, deleteSuccessPayload, fetchReferencesErrorPayload, buildErrorAttribution } from '../utils/errorHandling';
+import { updateErrorPayload, createErrorPayload, deleteErrorPayload, updateCacheErrorPayload, getSourceInfoErrorPayload, updateSuccessPayload, createSuccessPayload, createSuccessPayloadNew, 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. */
 var FLUSH_CREATION_AWAIT_TIMEOUT_MS = 1000;
 
+/**
+ * Window (ms) within which a repeated `syncedBlockDelete` emission for the same
+ * resourceId is suppressed. The same logical removal can re-fire across
+ * rebased/remote/redo transactions; a short window collapses those bursts to one
+ * event while still allowing a genuine delete→recreate→delete later.
+ */
+var DELETE_DEDUPE_WINDOW_MS = 5000;
+
 // A store manager responsible for the lifecycle and state management of source sync blocks in an editor instance.
 // Designed to manage local in-memory state and synchronize with an external data provider.
 // Supports create, flush, and delete operations for source sync blocks.
@@ -44,6 +52,12 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
      * multiple blocks are created concurrently. See EDITOR-7112.
      */
     _defineProperty(this, "creationsTimedOutDuringFlush", new Set());
+    /**
+     * resourceId -> timestamp (ms) of the last `syncedBlockDelete` emission, used
+     * to suppress duplicates within {@link DELETE_DEDUPE_WINDOW_MS}. Only consulted
+     * behind `platform_editor_blocks_patch_4`.
+     */
+    _defineProperty(this, "recentDeleteEmissions", new Map());
     _defineProperty(this, "setPendingDeletion", function (Ids, value) {
       if (_this.viewMode === 'view') {
         return;
@@ -388,12 +402,18 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
       }
       if (success) {
         var _this$fireAnalyticsEv4;
-        (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 || _this$fireAnalyticsEv4.call(this, createSuccessPayload(resourceId || '', getSourceProductFromResourceIdSafe(resourceId)));
+        var sourceProduct = getSourceProductFromResourceIdSafe(resourceId);
+        (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 || _this$fireAnalyticsEv4.call(this, createSuccessPayload(resourceId || '', sourceProduct));
+        // Operational create-success event with the join key.
+        if (fg('platform_editor_blocks_patch_4')) {
+          var _this$fireAnalyticsEv5, _this$syncBlockCache$;
+          (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.call(this, createSuccessPayloadNew(resourceId || '', (_this$syncBlockCache$ = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$ === void 0 ? void 0 : _this$syncBlockCache$.blockInstanceId, sourceProduct));
+        }
       } else {
-        var _this$fireAnalyticsEv5;
+        var _this$fireAnalyticsEv6;
         // Delete the node from cache if fail to create so it's not flushed to BE
         this.syncBlockCache.delete(resourceId || '');
-        (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.call(this, createErrorPayload('Fail to create bodied sync block', resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+        (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 || _this$fireAnalyticsEv6.call(this, createErrorPayload('Fail to create bodied sync block', resourceId, getSourceProductFromResourceIdSafe(resourceId)));
       }
     }
   }, {
@@ -493,20 +513,76 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         });
         this.pendingCreationPromises.set(resourceId, creationPromise);
       } catch (error) {
-        var _this$fireAnalyticsEv6;
+        var _this$fireAnalyticsEv7;
         if (this.isPendingCreation(resourceId)) {
           this.commitPendingCreation(false, resourceId);
         }
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 || _this$fireAnalyticsEv6.call(this, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+        (_this$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 || _this$fireAnalyticsEv7.call(this, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
       }
     }
+  }, {
+    key: "pruneRecentDeleteEmissions",
+    value:
+    /**
+     * Drop dedupe entries older than {@link DELETE_DEDUPE_WINDOW_MS} so
+     * `recentDeleteEmissions` stays bounded by the number of recent deletes.
+     */
+    function pruneRecentDeleteEmissions(now) {
+      var _iterator2 = _createForOfIteratorHelper(this.recentDeleteEmissions),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var _step2$value = _slicedToArray(_step2.value, 2),
+            resourceId = _step2$value[0],
+            emittedAt = _step2$value[1];
+          if (now - emittedAt >= DELETE_DEDUPE_WINDOW_MS) {
+            this.recentDeleteEmissions.delete(resourceId);
+          }
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+    }
+
+    /**
+     * Emit the `syncedBlockDelete` success event. Gate off: legacy payload. Gate
+     * on: attaches `deletionReason`, `mechanism` and `blockInstanceId`, and
+     * suppresses repeat emissions within {@link DELETE_DEDUPE_WINDOW_MS}. Must run
+     * while the cache entry still exists so `blockInstanceId` is available.
+     */
+  }, {
+    key: "emitDeleteSuccess",
+    value: function emitDeleteSuccess(resourceId, reason, mechanism) {
+      var _this$syncBlockCache$2, _this$fireAnalyticsEv9;
+      var sourceProduct = getSourceProductFromResourceIdSafe(resourceId);
+      if (!fg('platform_editor_blocks_patch_4')) {
+        var _this$fireAnalyticsEv8;
+        (_this$fireAnalyticsEv8 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv8 === void 0 || _this$fireAnalyticsEv8.call(this, deleteSuccessPayload(resourceId, sourceProduct));
+        return;
+      }
+      var now = Date.now();
+      var lastEmittedAt = this.recentDeleteEmissions.get(resourceId);
+      if (lastEmittedAt !== undefined && now - lastEmittedAt < DELETE_DEDUPE_WINDOW_MS) {
+        return; // duplicate emission for the same logical removal
+      }
+      this.pruneRecentDeleteEmissions(now);
+      this.recentDeleteEmissions.set(resourceId, now);
+      var enrichment = {
+        blockInstanceId: (_this$syncBlockCache$2 = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$2 === void 0 ? void 0 : _this$syncBlockCache$2.blockInstanceId,
+        deletionReason: reason,
+        mechanism: mechanism
+      };
+      (_this$fireAnalyticsEv9 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv9 === void 0 || _this$fireAnalyticsEv9.call(this, deleteSuccessPayload(resourceId, sourceProduct, enrichment));
+    }
   }, {
     key: "delete",
     value: function () {
-      var _delete2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(syncBlockIds, onDelete, onDeleteCompleted, reason) {
+      var _delete2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(syncBlockIds, onDelete, onDeleteCompleted, reason, mechanism) {
         var _this5 = this;
         var _this$deleteExperienc, results, callback, isDeleteSuccessful, _this$deleteExperienc2, _this$deleteExperienc3, attributionEnabled, attribution, _t2;
         return _regeneratorRuntime.wrap(function (_context2) {
@@ -541,15 +617,16 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
               onDeleteCompleted(isDeleteSuccessful);
               if (isDeleteSuccessful) {
                 onDelete();
+                // Emit before the cache entry is deleted below, so blockInstanceId
+                // is still available to emitDeleteSuccess.
+                results.forEach(function (result) {
+                  _this5.emitDeleteSuccess(result.resourceId, reason, mechanism);
+                });
                 callback = function callback(Ids) {
                   return _this5.syncBlockCache.delete(Ids.resourceId);
                 };
                 this.clearPendingDeletion();
                 (_this$deleteExperienc2 = this.deleteExperience) === null || _this$deleteExperienc2 === void 0 || _this$deleteExperienc2.success();
-                results.forEach(function (result) {
-                  var _this5$fireAnalyticsE;
-                  (_this5$fireAnalyticsE = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE === void 0 || _this5$fireAnalyticsE.call(_this5, deleteSuccessPayload(result.resourceId, getSourceProductFromResourceIdSafe(result.resourceId)));
-                });
               } else {
                 callback = function callback(Ids) {
                   _this5.setPendingDeletion(Ids, false);
@@ -558,11 +635,10 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
                 attributionEnabled = fg('platform_editor_blocks_patch_3');
                 results.forEach(function (result) {
                   if (result.success) {
-                    var _this5$fireAnalyticsE2;
-                    (_this5$fireAnalyticsE2 = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE2 === void 0 || _this5$fireAnalyticsE2.call(_this5, deleteSuccessPayload(result.resourceId, getSourceProductFromResourceIdSafe(result.resourceId)));
+                    _this5.emitDeleteSuccess(result.resourceId, reason, mechanism);
                   } else {
-                    var _this5$fireAnalyticsE3;
-                    (_this5$fireAnalyticsE3 = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE3 === void 0 || _this5$fireAnalyticsE3.call(_this5, deleteErrorPayload(result.error || 'Failed to delete synced block', result.resourceId, getSourceProductFromResourceIdSafe(result.resourceId), buildErrorAttribution(attributionEnabled, result.error, result.statusCode)));
+                    var _this5$fireAnalyticsE;
+                    (_this5$fireAnalyticsE = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE === void 0 || _this5$fireAnalyticsE.call(_this5, deleteErrorPayload(result.error || 'Failed to delete synced block', result.resourceId, getSourceProductFromResourceIdSafe(result.resourceId), buildErrorAttribution(attributionEnabled, result.error, result.statusCode)));
                   }
                 });
               }
@@ -575,9 +651,9 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
               // so the attribution `reason` falls back to `unknown` when the gate is on.
               attribution = buildErrorAttribution(fg('platform_editor_blocks_patch_3'));
               syncBlockIds.forEach(function (Ids) {
-                var _this5$fireAnalyticsE4;
+                var _this5$fireAnalyticsE2;
                 _this5.setPendingDeletion(Ids, false);
-                (_this5$fireAnalyticsE4 = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE4 === void 0 || _this5$fireAnalyticsE4.call(_this5, deleteErrorPayload(_t2.message, Ids.resourceId, getSourceProductFromResourceIdSafe(Ids.resourceId), attribution));
+                (_this5$fireAnalyticsE2 = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE2 === void 0 || _this5$fireAnalyticsE2.call(_this5, deleteErrorPayload(_t2.message, Ids.resourceId, getSourceProductFromResourceIdSafe(Ids.resourceId), attribution));
               });
               logException(_t2, {
                 location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
@@ -590,7 +666,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
           }
         }, _callee2, this, [[0, 4]]);
       }));
-      function _delete(_x, _x2, _x3, _x4) {
+      function _delete(_x, _x2, _x3, _x4, _x5) {
         return _delete2.apply(this, arguments);
       }
       return _delete;
@@ -604,7 +680,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
     key: "retryDeletion",
     value: function () {
       var _retryDeletion = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
-        var _this$deletionRetryIn, syncBlockIds, onDelete, onDeleteCompleted, deletionReason;
+        var _this$deletionRetryIn, syncBlockIds, onDelete, onDeleteCompleted, deletionReason, mechanism;
         return _regeneratorRuntime.wrap(function (_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
@@ -620,13 +696,13 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
               }
               return _context3.abrupt("return", Promise.resolve());
             case 2:
-              _this$deletionRetryIn = this.deletionRetryInfo, syncBlockIds = _this$deletionRetryIn.syncBlockIds, onDelete = _this$deletionRetryIn.onDelete, onDeleteCompleted = _this$deletionRetryIn.onDeleteCompleted, deletionReason = _this$deletionRetryIn.deletionReason;
+              _this$deletionRetryIn = this.deletionRetryInfo, syncBlockIds = _this$deletionRetryIn.syncBlockIds, onDelete = _this$deletionRetryIn.onDelete, onDeleteCompleted = _this$deletionRetryIn.onDeleteCompleted, deletionReason = _this$deletionRetryIn.deletionReason, mechanism = _this$deletionRetryIn.mechanism;
               if (!this.confirmationCallback) {
                 _context3.next = 3;
                 break;
               }
               _context3.next = 3;
-              return this.delete(syncBlockIds, onDelete, onDeleteCompleted, deletionReason);
+              return this.delete(syncBlockIds, onDelete, onDeleteCompleted, deletionReason, mechanism);
             case 3:
             case "end":
               return _context3.stop();
@@ -656,7 +732,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
     value: (function () {
       var _fetchAndCacheStatuses = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4() {
         var _this6 = this;
-        var sourceToReferenceMap, syncBlockNodes, results, _iterator2, _step2, _sourceToReferenceMap, _result$data, result, sourceResourceId, cached, _t3;
+        var sourceToReferenceMap, syncBlockNodes, results, _iterator3, _step3, _sourceToReferenceMap, _result$data, result, sourceResourceId, cached, _t3;
         return _regeneratorRuntime.wrap(function (_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
@@ -692,10 +768,10 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
               return this.dataProvider.fetchNodesData(syncBlockNodes);
             case 3:
               results = _context4.sent;
-              _iterator2 = _createForOfIteratorHelper(results);
+              _iterator3 = _createForOfIteratorHelper(results);
               try {
-                for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-                  result = _step2.value;
+                for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+                  result = _step3.value;
                   // Map the reference resourceId back to the source resourceId
                   sourceResourceId = (_sourceToReferenceMap = sourceToReferenceMap.get(result.resourceId)) !== null && _sourceToReferenceMap !== void 0 ? _sourceToReferenceMap : result.resourceId;
                   cached = this.syncBlockCache.get(sourceResourceId);
@@ -704,9 +780,9 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
                   }
                 }
               } catch (err) {
-                _iterator2.e(err);
+                _iterator3.e(err);
               } finally {
-                _iterator2.f();
+                _iterator3.f();
               }
               _context4.next = 5;
               break;
@@ -756,7 +832,9 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
       // onDelete: no-op, document is being discarded
       function () {},
       // onDeleteCompleted: no-op
-      'source-block-unpublished');
+      'source-block-unpublished',
+      // Cancel/discard cleanup is code-initiated, not a direct user edit.
+      'other');
     }
 
     /**
@@ -770,7 +848,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
   }, {
     key: "deleteSyncBlocksWithConfirmation",
     value: (function () {
-      var _deleteSyncBlocksWithConfirmation = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee5(syncBlockIds, deletionReason, onDelete, onDeleteCompleted, destroyCallback) {
+      var _deleteSyncBlocksWithConfirmation = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee5(syncBlockIds, deletionReason, onDelete, onDeleteCompleted, destroyCallback, mechanism) {
         var confirmed, isDeleteSuccessful;
         return _regeneratorRuntime.wrap(function (_context5) {
           while (1) switch (_context5.prev = _context5.next) {
@@ -794,7 +872,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
                 break;
               }
               _context5.next = 3;
-              return this.delete(syncBlockIds, onDelete, onDeleteCompleted, deletionReason);
+              return this.delete(syncBlockIds, onDelete, onDeleteCompleted, deletionReason, mechanism);
             case 3:
               isDeleteSuccessful = _context5.sent;
               if (!isDeleteSuccessful) {
@@ -804,7 +882,8 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
                   onDelete: onDelete,
                   onDeleteCompleted: onDeleteCompleted,
                   destroyCallback: destroyCallback,
-                  deletionReason: deletionReason
+                  deletionReason: deletionReason,
+                  mechanism: mechanism
                 };
               } else {
                 destroyCallback();
@@ -819,7 +898,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
           }
         }, _callee5, this);
       }));
-      function deleteSyncBlocksWithConfirmation(_x5, _x6, _x7, _x8, _x9) {
+      function deleteSyncBlocksWithConfirmation(_x6, _x7, _x8, _x9, _x0, _x1) {
         return _deleteSyncBlocksWithConfirmation.apply(this, arguments);
       }
       return deleteSyncBlocksWithConfirmation;
@@ -847,11 +926,11 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
           return sourceInfo;
         });
       } catch (error) {
-        var _this$fireAnalyticsEv7;
+        var _this$fireAnalyticsEv0;
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 || _this$fireAnalyticsEv7.call(this, getSourceInfoErrorPayload(error.message));
+        (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 || _this$fireAnalyticsEv0.call(this, getSourceInfoErrorPayload(error.message));
         return Promise.resolve(undefined);
       }
     }
@@ -864,11 +943,11 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         }
         return this.dataProvider.fetchReferences(resourceId, true);
       } catch (error) {
-        var _this$fireAnalyticsEv8;
+        var _this$fireAnalyticsEv1;
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv8 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv8 === void 0 || _this$fireAnalyticsEv8.call(this, fetchReferencesErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+        (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 || _this$fireAnalyticsEv1.call(this, fetchReferencesErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
         return Promise.resolve({
           error: SyncBlockError.Errored
         });
@@ -885,6 +964,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
       this.postCreationFlushCallback = undefined;
       this.pendingCreationPromises.clear();
       this.creationsTimedOutDuringFlush.clear();
+      this.recentDeleteEmissions.clear();
       this.dataProvider = undefined;
       (_this$saveExperience4 = this.saveExperience) === null || _this$saveExperience4 === void 0 || _this$saveExperience4.abort({
         reason: 'editorDestroyed'

package/dist/esm/utils/errorHandling.js

@@ -325,15 +325,25 @@ export var createSuccessPayload = function createSuccessPayload(resourceId, sour
     })
   };
 };
-export var createSuccessPayloadNew = function createSuccessPayloadNew(resourceId) {
+
+/**
+ * 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.
+ */
+export var createSuccessPayloadNew = function createSuccessPayloadNew(resourceId, blockInstanceId, sourceProduct) {
   return {
     action: ACTION.INSERTED,
     actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE,
     eventType: EVENT_TYPE.OPERATIONAL,
-    attributes: {
+    attributes: _objectSpread(_objectSpread({
       resourceId: resourceId
-    }
+    }, blockInstanceId && {
+      blockInstanceId: blockInstanceId
+    }), sourceProduct && {
+      sourceProduct: sourceProduct
+    })
   };
 };
 export var updateSuccessPayload = function updateSuccessPayload(resourceId, hasReference, sourceProduct) {
@@ -351,16 +361,29 @@ export var updateSuccessPayload = function updateSuccessPayload(resourceId, hasR
     })
   };
 };
-export var deleteSuccessPayload = function deleteSuccessPayload(resourceId, sourceProduct) {
+
+/**
+ * Optional enrichment for the `syncedBlockDelete` success event behind
+ * `platform_editor_blocks_patch_4`. All fields optional so the gate-off payload
+ * is unchanged; `blockInstanceId` is the bare-uuid join key.
+ */
+
+export var deleteSuccessPayload = function deleteSuccessPayload(resourceId, sourceProduct, enrichment) {
   return {
     action: ACTION.DELETED,
     actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_DELETE,
     eventType: EVENT_TYPE.OPERATIONAL,
-    attributes: _objectSpread({
+    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread({
       resourceId: resourceId
     }, sourceProduct && {
       sourceProduct: sourceProduct
+    }), (enrichment === null || enrichment === void 0 ? void 0 : enrichment.blockInstanceId) && {
+      blockInstanceId: enrichment.blockInstanceId
+    }), (enrichment === null || enrichment === void 0 ? void 0 : enrichment.deletionReason) && {
+      deletionReason: enrichment.deletionReason
+    }), (enrichment === null || enrichment === void 0 ? void 0 : enrichment.mechanism) && {
+      mechanism: enrichment.mechanism
     })
   };
 };

package/dist/types/common/types.d.ts

@@ -76,6 +76,21 @@ export type ReferencesSourceInfo = {
 };
 export type DeletionReason = 'source-block-deleted' | 'source-block-unsynced' | 'source-block-unpublished';
 export type DeletionReasonResponse = DeletionReason | 'source-document-deleted';
+/**
+ * How a source bodiedSyncBlock removal was performed, derived from the
+ * originating transaction. Distinct from {@link DeletionReason} (the outcome):
+ * `mechanism` tells deliberate deletes apart from undos and accidental overwrites.
+ *
+ * Values name the user action that produced the removal:
+ *  - `undo` / `redo` — removal came from a history undo/redo.
+ *  - `deleteButton` — the explicit "Delete" control in the synced-block toolbar.
+ *  - `keyboardDelete` — Backspace/Delete key on a caret or range selection.
+ *  - `selectionReplaced` — the block was selected and replaced by typing or
+ *    pasting over it (the accidental-overwrite path).
+ *  - `other` — any non-direct removal (unsync, conversion, code-dispatched, or a
+ *    structural wrap/lift/unwrap edit).
+ */
+export type DeletionMechanism = 'undo' | 'redo' | 'deleteButton' | 'keyboardDelete' | 'selectionReplaced' | 'other';
 export type SyncBlockPrefetchData = {
     prefetchPromise: Promise<SyncBlockInstance[] | undefined>;
     resourceIds: string[];

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

@@ -1,2 +1,2 @@
 export { SyncBlockError } from '../common/types';
-export type { ResourceId, SyncBlockData, SyncBlockNode, SyncBlockProduct, SyncBlockStatus, BlockInstanceId, SyncBlockAttrs, ReferenceSyncBlockData, ReferencesSourceInfo, DeletionReason, SyncBlockPrefetchData, } from '../common/types';
+export type { ResourceId, SyncBlockData, SyncBlockNode, SyncBlockProduct, SyncBlockStatus, BlockInstanceId, SyncBlockAttrs, ReferenceSyncBlockData, ReferencesSourceInfo, DeletionReason, DeletionMechanism, SyncBlockPrefetchData, } from '../common/types';

package/dist/types/store-manager/sourceSyncBlockStoreManager.d.ts

@@ -1,7 +1,7 @@
 import type { SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { ViewMode } from '@atlaskit/editor-plugin-editor-viewmode';
 import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
-import type { ResourceId, SyncBlockAttrs, BlockInstanceId, DeletionReason, ReferenceSyncBlockData } from '../common/types';
+import type { ResourceId, SyncBlockAttrs, BlockInstanceId, DeletionReason, DeletionMechanism, ReferenceSyncBlockData } from '../common/types';
 import type { SyncBlockDataProviderInterface, SyncBlockSourceInfo } from '../providers/types';
 export type ConfirmationCallback = (syncBlockIds: SyncBlockAttrs[], deleteReason: DeletionReason | undefined) => Promise<boolean>;
 type OnDelete = () => void;
@@ -39,6 +39,12 @@ export declare class SourceSyncBlockStoreManager {
     private saveExperience;
     private deleteExperience;
     private fetchSourceInfoExperience;
+    /**
+     * resourceId -> timestamp (ms) of the last `syncedBlockDelete` emission, used
+     * to suppress duplicates within {@link DELETE_DEDUPE_WINDOW_MS}. Only consulted
+     * behind `platform_editor_blocks_patch_4`.
+     */
+    private recentDeleteEmissions;
     constructor(dataProvider?: SyncBlockDataProviderInterface, viewMode?: ViewMode, isLivePage?: boolean);
     /**
      * Register a callback to be invoked after flush() completes.
@@ -94,6 +100,18 @@ export declare class SourceSyncBlockStoreManager {
      */
     createBodiedSyncBlockNode(attrs: SyncBlockAttrs, node: PMNode, onCompletion: OnCompletion): void;
     private setPendingDeletion;
+    /**
+     * Drop dedupe entries older than {@link DELETE_DEDUPE_WINDOW_MS} so
+     * `recentDeleteEmissions` stays bounded by the number of recent deletes.
+     */
+    private pruneRecentDeleteEmissions;
+    /**
+     * Emit the `syncedBlockDelete` success event. Gate off: legacy payload. Gate
+     * on: attaches `deletionReason`, `mechanism` and `blockInstanceId`, and
+     * suppresses repeat emissions within {@link DELETE_DEDUPE_WINDOW_MS}. Must run
+     * while the cache entry still exists so `blockInstanceId` is available.
+     */
+    private emitDeleteSuccess;
     private delete;
     isRetryingDeletion(): boolean;
     retryDeletion(): Promise<void>;
@@ -120,7 +138,7 @@ export declare class SourceSyncBlockStoreManager {
      * @param onDeleteCompleted - The callback for after the deletion is saved to BE (whether successful or not)
      * @param destroyCallback - The callback to clear any reference stored for deletion (regardless if deletion is completed or abort)
      */
-    deleteSyncBlocksWithConfirmation(syncBlockIds: SyncBlockAttrs[], deletionReason: DeletionReason, onDelete: OnDelete, onDeleteCompleted: OnCompletion, destroyCallback: DestroyCallback): Promise<void>;
+    deleteSyncBlocksWithConfirmation(syncBlockIds: SyncBlockAttrs[], deletionReason: DeletionReason, onDelete: OnDelete, onDeleteCompleted: OnCompletion, destroyCallback: DestroyCallback, mechanism?: DeletionMechanism): Promise<void>;
     getSyncBlockSourceInfo(localId: BlockInstanceId): Promise<SyncBlockSourceInfo | undefined>;
     fetchReferences(resourceId: string): Promise<ReferenceSyncBlockData>;
     destroy(): void;

package/dist/types/utils/errorHandling.d.ts

@@ -1,6 +1,7 @@
 import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID } from '@atlaskit/editor-common/analytics';
 import type { RendererSyncBlockEventPayload, OperationalAEP, SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import { SyncBlockError } from '../common/types';
+import type { DeletionMechanism, DeletionReason } from '../common/types';
 export declare const stringifyError: (error: unknown) => string | undefined;
 /**
  * The set of categorical failure reasons emitted on synced-block operational error
@@ -162,6 +163,21 @@ export declare const cacheDeletionForcedPayload: (rescheduleCount: number, resou
 export declare const fetchReferencesErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 export declare const fetchSuccessPayload: (resourceId: string, blockInstanceId?: string, sourceProduct?: string) => RendererSyncBlockEventPayload;
 export declare const createSuccessPayload: (resourceId: string, sourceProduct?: string) => SyncBlockEventPayload;
-export declare const createSuccessPayloadNew: (resourceId: string) => SyncBlockEventPayload;
+/**
+ * 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.
+ */
+export declare const createSuccessPayloadNew: (resourceId: string, blockInstanceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 export declare const updateSuccessPayload: (resourceId: string, hasReference?: boolean, sourceProduct?: string) => SyncBlockEventPayload;
-export declare const deleteSuccessPayload: (resourceId: string, sourceProduct?: string) => SyncBlockEventPayload;
+/**
+ * Optional enrichment for the `syncedBlockDelete` success event behind
+ * `platform_editor_blocks_patch_4`. All fields optional so the gate-off payload
+ * is unchanged; `blockInstanceId` is the bare-uuid join key.
+ */
+export type DeleteSuccessEnrichment = {
+    blockInstanceId?: string;
+    deletionReason?: DeletionReason;
+    mechanism?: DeletionMechanism;
+};
+export declare const deleteSuccessPayload: (resourceId: string, sourceProduct?: string, enrichment?: DeleteSuccessEnrichment) => SyncBlockEventPayload;

package/package.json

@@ -21,7 +21,7 @@
 		"@atlaskit/editor-prosemirror": "^8.0.0",
 		"@atlaskit/node-data-provider": "^13.0.0",
 		"@atlaskit/platform-feature-flags": "^2.0.0",
-		"@atlaskit/tmp-editor-statsig": "^118.0.0",
+		"@atlaskit/tmp-editor-statsig": "^119.0.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^0.20.0",
 		"graphql-ws": "^5.14.2",
@@ -30,7 +30,7 @@
 		"uuid": "^3.1.0"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^116.18.0",
+		"@atlaskit/editor-common": "^116.19.0",
 		"react": "^18.2.0"
 	},
 	"devDependencies": {
@@ -74,7 +74,7 @@
 		}
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "8.4.4",
+	"version": "8.5.1",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",