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

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @atlaskit/editor-synced-block-provider
 
+## 8.5.0
+
+### Minor Changes
+
+- [`ecafba7c81b7d`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/ecafba7c81b7d) -
+  Enrich synced block deletion analytics so source-block deletions can be explained rather than just
+  counted. The source `syncedBlockDelete` operational event now carries `deletionReason` and a
+  `mechanism` dimension (undo/redo/deleteButton/keyboardDelete/selectionReplaced/other), and
+  repeated emissions for the same removal are de-duplicated. A real operational `syncedBlockCreate`
+  success event is now emitted, and the source bare-uuid join key is added to the copy event so
+  create/copy/delete can be correlated. All new attributes and events are gated behind
+  `platform_editor_blocks_patch_4`; gate-off behaviour is unchanged.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 8.4.4
 
 ### Patch Changes

package/dist/cjs/common/types.js

@@ -34,6 +34,20 @@ var SyncBlockError = exports.SyncBlockError = /*#__PURE__*/function (SyncBlockEr
   SyncBlockError["EntityNotFound"] = "entity_not_found";
   return SyncBlockError;
 }({});
+/**
+ * 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).
+ */
 /**
  * Helpers to distinguish "data provider not ready / torn down" from a genuine
  * fetch/subscribe failure (EDITOR-7860). On Jira the provider is wired

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

@@ -25,6 +25,14 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 /** 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.
@@ -51,6 +59,12 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
      * multiple blocks are created concurrently. See EDITOR-7112.
      */
     (0, _defineProperty2.default)(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`.
+     */
+    (0, _defineProperty2.default)(this, "recentDeleteEmissions", new Map());
     (0, _defineProperty2.default)(this, "setPendingDeletion", function (Ids, value) {
       if (_this.viewMode === 'view') {
         return;
@@ -395,12 +409,18 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
       }
       if (success) {
         var _this$fireAnalyticsEv4;
-        (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 || _this$fireAnalyticsEv4.call(this, (0, _errorHandling.createSuccessPayload)(resourceId || '', (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
+        var sourceProduct = (0, _utils.getSourceProductFromResourceIdSafe)(resourceId);
+        (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 || _this$fireAnalyticsEv4.call(this, (0, _errorHandling.createSuccessPayload)(resourceId || '', sourceProduct));
+        // Operational create-success event with the join key.
+        if ((0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_4')) {
+          var _this$fireAnalyticsEv5, _this$syncBlockCache$;
+          (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.call(this, (0, _errorHandling.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, (0, _errorHandling.createErrorPayload)('Fail to create bodied sync block', resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
+        (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 || _this$fireAnalyticsEv6.call(this, (0, _errorHandling.createErrorPayload)('Fail to create bodied sync block', resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
       }
     }
   }, {
@@ -500,20 +520,76 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         });
         this.pendingCreationPromises.set(resourceId, creationPromise);
       } catch (error) {
-        var _this$fireAnalyticsEv6;
+        var _this$fireAnalyticsEv7;
         if (this.isPendingCreation(resourceId)) {
           this.commitPendingCreation(false, resourceId);
         }
         (0, _monitoring.logException)(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 || _this$fireAnalyticsEv6.call(this, (0, _errorHandling.createErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
+        (_this$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 || _this$fireAnalyticsEv7.call(this, (0, _errorHandling.createErrorPayload)(error.message, resourceId, (0, _utils.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 = (0, _slicedToArray2.default)(_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 = (0, _utils.getSourceProductFromResourceIdSafe)(resourceId);
+      if (!(0, _platformFeatureFlags.fg)('platform_editor_blocks_patch_4')) {
+        var _this$fireAnalyticsEv8;
+        (_this$fireAnalyticsEv8 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv8 === void 0 || _this$fireAnalyticsEv8.call(this, (0, _errorHandling.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, (0, _errorHandling.deleteSuccessPayload)(resourceId, sourceProduct, enrichment));
+    }
   }, {
     key: "delete",
     value: function () {
-      var _delete2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(syncBlockIds, onDelete, onDeleteCompleted, reason) {
+      var _delete2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.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 _regenerator.default.wrap(function (_context2) {
@@ -548,15 +624,16 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
               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, (0, _errorHandling.deleteSuccessPayload)(result.resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(result.resourceId)));
-                });
               } else {
                 callback = function callback(Ids) {
                   _this5.setPendingDeletion(Ids, false);
@@ -565,11 +642,10 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
                 attributionEnabled = (0, _platformFeatureFlags.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, (0, _errorHandling.deleteSuccessPayload)(result.resourceId, (0, _utils.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, (0, _errorHandling.deleteErrorPayload)(result.error || 'Failed to delete synced block', result.resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(result.resourceId), (0, _errorHandling.buildErrorAttribution)(attributionEnabled, result.error, result.statusCode)));
+                    var _this5$fireAnalyticsE;
+                    (_this5$fireAnalyticsE = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE === void 0 || _this5$fireAnalyticsE.call(_this5, (0, _errorHandling.deleteErrorPayload)(result.error || 'Failed to delete synced block', result.resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(result.resourceId), (0, _errorHandling.buildErrorAttribution)(attributionEnabled, result.error, result.statusCode)));
                   }
                 });
               }
@@ -582,9 +658,9 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
               // so the attribution `reason` falls back to `unknown` when the gate is on.
               attribution = (0, _errorHandling.buildErrorAttribution)((0, _platformFeatureFlags.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, (0, _errorHandling.deleteErrorPayload)(_t2.message, Ids.resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(Ids.resourceId), attribution));
+                (_this5$fireAnalyticsE2 = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE2 === void 0 || _this5$fireAnalyticsE2.call(_this5, (0, _errorHandling.deleteErrorPayload)(_t2.message, Ids.resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(Ids.resourceId), attribution));
               });
               (0, _monitoring.logException)(_t2, {
                 location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
@@ -597,7 +673,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
           }
         }, _callee2, this, [[0, 4]]);
       }));
-      function _delete(_x, _x2, _x3, _x4) {
+      function _delete(_x, _x2, _x3, _x4, _x5) {
         return _delete2.apply(this, arguments);
       }
       return _delete;
@@ -611,7 +687,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
     key: "retryDeletion",
     value: function () {
       var _retryDeletion = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3() {
-        var _this$deletionRetryIn, syncBlockIds, onDelete, onDeleteCompleted, deletionReason;
+        var _this$deletionRetryIn, syncBlockIds, onDelete, onDeleteCompleted, deletionReason, mechanism;
         return _regenerator.default.wrap(function (_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
@@ -627,13 +703,13 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
               }
               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();
@@ -663,7 +739,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
     value: (function () {
       var _fetchAndCacheStatuses = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.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 _regenerator.default.wrap(function (_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
@@ -699,10 +775,10 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
               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);
@@ -711,9 +787,9 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
                   }
                 }
               } catch (err) {
-                _iterator2.e(err);
+                _iterator3.e(err);
               } finally {
-                _iterator2.f();
+                _iterator3.f();
               }
               _context4.next = 5;
               break;
@@ -763,7 +839,9 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
       // 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');
     }
 
     /**
@@ -777,7 +855,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
   }, {
     key: "deleteSyncBlocksWithConfirmation",
     value: (function () {
-      var _deleteSyncBlocksWithConfirmation = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee5(syncBlockIds, deletionReason, onDelete, onDeleteCompleted, destroyCallback) {
+      var _deleteSyncBlocksWithConfirmation = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee5(syncBlockIds, deletionReason, onDelete, onDeleteCompleted, destroyCallback, mechanism) {
         var confirmed, isDeleteSuccessful;
         return _regenerator.default.wrap(function (_context5) {
           while (1) switch (_context5.prev = _context5.next) {
@@ -801,7 +879,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
                 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) {
@@ -811,7 +889,8 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
                   onDelete: onDelete,
                   onDeleteCompleted: onDeleteCompleted,
                   destroyCallback: destroyCallback,
-                  deletionReason: deletionReason
+                  deletionReason: deletionReason,
+                  mechanism: mechanism
                 };
               } else {
                 destroyCallback();
@@ -826,7 +905,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
           }
         }, _callee5, this);
       }));
-      function deleteSyncBlocksWithConfirmation(_x5, _x6, _x7, _x8, _x9) {
+      function deleteSyncBlocksWithConfirmation(_x6, _x7, _x8, _x9, _x0, _x1) {
         return _deleteSyncBlocksWithConfirmation.apply(this, arguments);
       }
       return deleteSyncBlocksWithConfirmation;
@@ -854,11 +933,11 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
           return sourceInfo;
         });
       } catch (error) {
-        var _this$fireAnalyticsEv7;
+        var _this$fireAnalyticsEv0;
         (0, _monitoring.logException)(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 || _this$fireAnalyticsEv7.call(this, (0, _errorHandling.getSourceInfoErrorPayload)(error.message));
+        (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 || _this$fireAnalyticsEv0.call(this, (0, _errorHandling.getSourceInfoErrorPayload)(error.message));
         return Promise.resolve(undefined);
       }
     }
@@ -871,11 +950,11 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         }
         return this.dataProvider.fetchReferences(resourceId, true);
       } catch (error) {
-        var _this$fireAnalyticsEv8;
+        var _this$fireAnalyticsEv1;
         (0, _monitoring.logException)(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv8 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv8 === void 0 || _this$fireAnalyticsEv8.call(this, (0, _errorHandling.fetchReferencesErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
+        (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 || _this$fireAnalyticsEv1.call(this, (0, _errorHandling.fetchReferencesErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
         return Promise.resolve({
           error: _types.SyncBlockError.Errored
         });
@@ -892,6 +971,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
       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/cjs/utils/errorHandling.js

@@ -334,15 +334,25 @@ var createSuccessPayload = exports.createSuccessPayload = function createSuccess
     })
   };
 };
-var createSuccessPayloadNew = exports.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.
+ */
+var createSuccessPayloadNew = exports.createSuccessPayloadNew = function createSuccessPayloadNew(resourceId, blockInstanceId, sourceProduct) {
   return {
     action: _analytics.ACTION.INSERTED,
     actionSubject: _analytics.ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: _analytics.ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE,
     eventType: _analytics.EVENT_TYPE.OPERATIONAL,
-    attributes: {
+    attributes: _objectSpread(_objectSpread({
       resourceId: resourceId
-    }
+    }, blockInstanceId && {
+      blockInstanceId: blockInstanceId
+    }), sourceProduct && {
+      sourceProduct: sourceProduct
+    })
   };
 };
 var updateSuccessPayload = exports.updateSuccessPayload = function updateSuccessPayload(resourceId, hasReference, sourceProduct) {
@@ -360,16 +370,29 @@ var updateSuccessPayload = exports.updateSuccessPayload = function updateSuccess
     })
   };
 };
-var deleteSuccessPayload = exports.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.
+ */
+
+var deleteSuccessPayload = exports.deleteSuccessPayload = function deleteSuccessPayload(resourceId, sourceProduct, enrichment) {
   return {
     action: _analytics.ACTION.DELETED,
     actionSubject: _analytics.ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: _analytics.ACTION_SUBJECT_ID.SYNCED_BLOCK_DELETE,
     eventType: _analytics.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/es2019/common/types.js

@@ -18,6 +18,22 @@ export let SyncBlockError = /*#__PURE__*/function (SyncBlockError) {
   SyncBlockError["EntityNotFound"] = "entity_not_found";
   return SyncBlockError;
 }({});
+
+/**
+ * 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).
+ */
+
 /**
  * Helpers to distinguish "data provider not ready / torn down" from a genuine
  * fetch/subscribe failure (EDITOR-7860). On Jira the provider is wired