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

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @atlaskit/editor-synced-block-provider
 
+## 8.6.0
+
+### Minor Changes
+
+- [`c0b0b98789f7a`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/c0b0b98789f7a) -
+  Add analytics for synced block source creation: record the creation input method and whether the
+  block was created empty, and emit a one-off event the first time an empty source block gains
+  content.
+
+### Patch Changes
+
+- Updated dependencies
+
+## 8.5.7
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 8.5.6
 
 ### Patch Changes

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

@@ -59,6 +59,20 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
      * multiple blocks are created concurrently. See EDITOR-7112.
      */
     (0, _defineProperty2.default)(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.
+     */
+    (0, _defineProperty2.default)(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.
+     */
+    (0, _defineProperty2.default)(this, "awaitingFirstContent", new Set());
     /**
      * resourceId -> timestamp (ms) of the last `syncedBlockDelete` emission, used
      * to suppress duplicates within {@link DELETE_DEDUPE_WINDOW_MS}. Only consulted
@@ -411,17 +425,48 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         var _this$fireAnalyticsEv4;
         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.
+        // Operational create-success event with the join key + creation-type
+        // signals (inputMethod / createdEmpty) captured at the command layer.
         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.createSuccessOperationalPayload)(resourceId || '', (_this$syncBlockCache$ = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$ === void 0 ? void 0 : _this$syncBlockCache$.blockInstanceId, sourceProduct));
+          (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.call(this, (0, _errorHandling.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$fireAnalyticsEv6;
         // 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$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)));
       }
+      // 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`.
+     */
+  }, {
+    key: "maybeEmitFirstContentAdded",
+    value: function maybeEmitFirstContentAdded(resourceId, blockInstanceId) {
+      var _this$fireAnalyticsEv7;
+      if (this.viewMode === 'view') {
+        return;
+      }
+      if (!(0, _platformFeatureFlags.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$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 || _this$fireAnalyticsEv7.call(this, (0, _errorHandling.addContentSuccessPayload)(resourceId, blockInstanceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
     }
   }, {
     key: "registerConfirmationCallback",
@@ -461,16 +506,28 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
      * @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.
      */
   }, {
     key: "createBodiedSyncBlockNode",
-    value: function createBodiedSyncBlockNode(attrs, node, onCompletion) {
+    value: function createBodiedSyncBlockNode(attrs, node, onCompletion, enrichment) {
       var _this4 = this;
       if (this.viewMode === 'view') {
         return;
       }
       var resourceId = attrs.resourceId,
         blockInstanceId = attrs.localId;
+      // 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) {
@@ -520,14 +577,14 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         });
         this.pendingCreationPromises.set(resourceId, creationPromise);
       } catch (error) {
-        var _this$fireAnalyticsEv7;
+        var _this$fireAnalyticsEv8;
         if (this.isPendingCreation(resourceId)) {
           this.commitPendingCreation(false, resourceId);
         }
         (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.createErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
+        (_this$fireAnalyticsEv8 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv8 === void 0 || _this$fireAnalyticsEv8.call(this, (0, _errorHandling.createErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
       }
     }
   }, {
@@ -565,11 +622,11 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
   }, {
     key: "emitDeleteSuccess",
     value: function emitDeleteSuccess(resourceId, reason, mechanism) {
-      var _this$syncBlockCache$2, _this$fireAnalyticsEv9;
+      var _this$syncBlockCache$2, _this$fireAnalyticsEv0;
       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));
+        var _this$fireAnalyticsEv9;
+        (_this$fireAnalyticsEv9 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv9 === void 0 || _this$fireAnalyticsEv9.call(this, (0, _errorHandling.deleteSuccessPayload)(resourceId, sourceProduct));
         return;
       }
       var now = Date.now();
@@ -584,7 +641,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         deletionReason: reason,
         mechanism: mechanism
       };
-      (_this$fireAnalyticsEv9 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv9 === void 0 || _this$fireAnalyticsEv9.call(this, (0, _errorHandling.deleteSuccessPayload)(resourceId, sourceProduct, enrichment));
+      (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 || _this$fireAnalyticsEv0.call(this, (0, _errorHandling.deleteSuccessPayload)(resourceId, sourceProduct, enrichment));
     }
   }, {
     key: "delete",
@@ -933,11 +990,11 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
           return sourceInfo;
         });
       } catch (error) {
-        var _this$fireAnalyticsEv0;
+        var _this$fireAnalyticsEv1;
         (0, _monitoring.logException)(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 || _this$fireAnalyticsEv0.call(this, (0, _errorHandling.getSourceInfoErrorPayload)(error.message));
+        (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 || _this$fireAnalyticsEv1.call(this, (0, _errorHandling.getSourceInfoErrorPayload)(error.message));
         return Promise.resolve(undefined);
       }
     }
@@ -950,11 +1007,11 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         }
         return this.dataProvider.fetchReferences(resourceId, true);
       } catch (error) {
-        var _this$fireAnalyticsEv1;
+        var _this$fireAnalyticsEv10;
         (0, _monitoring.logException)(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 || _this$fireAnalyticsEv1.call(this, (0, _errorHandling.fetchReferencesErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
+        (_this$fireAnalyticsEv10 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv10 === void 0 || _this$fireAnalyticsEv10.call(this, (0, _errorHandling.fetchReferencesErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
         return Promise.resolve({
           error: _types.SyncBlockError.Errored
         });
@@ -971,6 +1028,8 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
       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 || _this$saveExperience4.abort({

package/dist/cjs/utils/errorHandling.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.fetchSuccessPayload = exports.fetchReferencesErrorPayload = exports.fetchErrorPayload = exports.deleteSuccessPayload = exports.deleteErrorPayload = exports.createSuccessPayload = exports.createSuccessOperationalPayload = exports.createErrorPayload = exports.classifyFetchErrorReason = exports.classifyErrorReason = exports.cacheDeletionForcedPayload = exports.buildFetchErrorAttribution = exports.buildErrorAttribution = exports.FETCH_BENIGN_REASONS = void 0;
+exports.fetchSuccessPayload = exports.fetchReferencesErrorPayload = exports.fetchErrorPayload = exports.deleteSuccessPayload = exports.deleteErrorPayload = exports.createSuccessPayload = exports.createSuccessOperationalPayload = exports.createErrorPayload = exports.classifyFetchErrorReason = exports.classifyErrorReason = exports.cacheDeletionForcedPayload = exports.buildFetchErrorAttribution = exports.buildErrorAttribution = exports.addContentSuccessPayload = exports.FETCH_BENIGN_REASONS = void 0;
 exports.getErrorPayload = getErrorPayload;
 exports.updateSuccessPayload = exports.updateReferenceErrorPayload = exports.updateErrorPayload = exports.updateCacheErrorPayload = exports.stringifyError = exports.sourceInfoOrphanedPayload = exports.getSourceInfoErrorPayload = exports.getPiiSafeOriginalError = void 0;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
@@ -357,16 +357,49 @@ var createSuccessPayload = exports.createSuccessPayload = function createSuccess
 };
 
 /**
- * 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.
  */
-var createSuccessOperationalPayload = exports.createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct) {
+
+/**
+ * Operational `syncedBlockCreate` success event, behind
+ * `platform_editor_blocks_patch_4`, with the `blockInstanceId` join key and,
+ * when available, the `inputMethod` + `createdEmpty` creation-type signals.
+ */
+var createSuccessOperationalPayload = exports.createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct, enrichment) {
   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: _objectSpread(_objectSpread(_objectSpread(_objectSpread({
+      resourceId: resourceId
+    }, blockInstanceId && {
+      blockInstanceId: blockInstanceId
+    }), sourceProduct && {
+      sourceProduct: sourceProduct
+    }), (enrichment === null || enrichment === void 0 ? void 0 : enrichment.inputMethod) && {
+      inputMethod: enrichment.inputMethod
+    }), (enrichment === null || enrichment === void 0 ? void 0 : enrichment.createdEmpty) !== undefined && {
+      createdEmpty: enrichment.createdEmpty
+    })
+  };
+};
+
+/**
+ * Operational first-content-added event, behind
+ * `platform_editor_blocks_patch_4`. Fired once when a block created empty first
+ * gains user content. Join keys only (`resourceId` + `blockInstanceId`), no user
+ * content (PII-safe).
+ */
+var addContentSuccessPayload = exports.addContentSuccessPayload = function addContentSuccessPayload(resourceId, blockInstanceId, sourceProduct) {
+  return {
+    action: _analytics.ACTION.ADDED,
+    actionSubject: _analytics.ACTION_SUBJECT.SYNCED_BLOCK,
+    actionSubjectId: _analytics.ACTION_SUBJECT_ID.SYNCED_BLOCK_ADD_CONTENT,
+    eventType: _analytics.EVENT_TYPE.OPERATIONAL,
     attributes: _objectSpread(_objectSpread({
       resourceId: resourceId
     }, blockInstanceId && {

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/utils/errorHandling.js

@@ -339,15 +339,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.
  */
-export const createSuccessOperationalPayload = (resourceId, blockInstanceId, sourceProduct) => ({
+
+/**
+ * Operational `syncedBlockCreate` success event, behind
+ * `platform_editor_blocks_patch_4`, with the `blockInstanceId` join key and,
+ * when available, the `inputMethod` + `createdEmpty` creation-type signals.
+ */
+export 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/sourceSyncBlockStoreManager.js

@@ -12,7 +12,7 @@ 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, 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. */
@@ -52,6 +52,20 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
      * 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
@@ -404,17 +418,48 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         var _this$fireAnalyticsEv4;
         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.
+        // 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$fireAnalyticsEv5, _this$syncBlockCache$;
-          (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.call(this, createSuccessOperationalPayload(resourceId || '', (_this$syncBlockCache$ = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$ === void 0 ? void 0 : _this$syncBlockCache$.blockInstanceId, sourceProduct));
+          (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.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$fireAnalyticsEv6;
         // 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$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 || _this$fireAnalyticsEv6.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`.
+     */
+  }, {
+    key: "maybeEmitFirstContentAdded",
+    value: function maybeEmitFirstContentAdded(resourceId, blockInstanceId) {
+      var _this$fireAnalyticsEv7;
+      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$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 || _this$fireAnalyticsEv7.call(this, addContentSuccessPayload(resourceId, blockInstanceId, getSourceProductFromResourceIdSafe(resourceId)));
     }
   }, {
     key: "registerConfirmationCallback",
@@ -454,16 +499,28 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
      * @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.
      */
   }, {
     key: "createBodiedSyncBlockNode",
-    value: function createBodiedSyncBlockNode(attrs, node, onCompletion) {
+    value: function createBodiedSyncBlockNode(attrs, node, onCompletion, enrichment) {
       var _this4 = this;
       if (this.viewMode === 'view') {
         return;
       }
       var resourceId = attrs.resourceId,
         blockInstanceId = attrs.localId;
+      // 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) {
@@ -513,14 +570,14 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         });
         this.pendingCreationPromises.set(resourceId, creationPromise);
       } catch (error) {
-        var _this$fireAnalyticsEv7;
+        var _this$fireAnalyticsEv8;
         if (this.isPendingCreation(resourceId)) {
           this.commitPendingCreation(false, resourceId);
         }
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 || _this$fireAnalyticsEv7.call(this, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+        (_this$fireAnalyticsEv8 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv8 === void 0 || _this$fireAnalyticsEv8.call(this, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
       }
     }
   }, {
@@ -558,11 +615,11 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
   }, {
     key: "emitDeleteSuccess",
     value: function emitDeleteSuccess(resourceId, reason, mechanism) {
-      var _this$syncBlockCache$2, _this$fireAnalyticsEv9;
+      var _this$syncBlockCache$2, _this$fireAnalyticsEv0;
       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));
+        var _this$fireAnalyticsEv9;
+        (_this$fireAnalyticsEv9 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv9 === void 0 || _this$fireAnalyticsEv9.call(this, deleteSuccessPayload(resourceId, sourceProduct));
         return;
       }
       var now = Date.now();
@@ -577,7 +634,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         deletionReason: reason,
         mechanism: mechanism
       };
-      (_this$fireAnalyticsEv9 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv9 === void 0 || _this$fireAnalyticsEv9.call(this, deleteSuccessPayload(resourceId, sourceProduct, enrichment));
+      (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 || _this$fireAnalyticsEv0.call(this, deleteSuccessPayload(resourceId, sourceProduct, enrichment));
     }
   }, {
     key: "delete",
@@ -926,11 +983,11 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
           return sourceInfo;
         });
       } catch (error) {
-        var _this$fireAnalyticsEv0;
+        var _this$fireAnalyticsEv1;
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 || _this$fireAnalyticsEv0.call(this, getSourceInfoErrorPayload(error.message));
+        (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 || _this$fireAnalyticsEv1.call(this, getSourceInfoErrorPayload(error.message));
         return Promise.resolve(undefined);
       }
     }
@@ -943,11 +1000,11 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         }
         return this.dataProvider.fetchReferences(resourceId, true);
       } catch (error) {
-        var _this$fireAnalyticsEv1;
+        var _this$fireAnalyticsEv10;
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 || _this$fireAnalyticsEv1.call(this, fetchReferencesErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+        (_this$fireAnalyticsEv10 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv10 === void 0 || _this$fireAnalyticsEv10.call(this, fetchReferencesErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
         return Promise.resolve({
           error: SyncBlockError.Errored
         });
@@ -964,6 +1021,8 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
       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 || _this$saveExperience4.abort({

package/dist/esm/utils/errorHandling.js

@@ -348,16 +348,49 @@ export var createSuccessPayload = function createSuccessPayload(resourceId, sour
 };
 
 /**
- * Operational `syncedBlockCreate` success event (previously only error rows
- * existed, so dashboards had no create denominator). Fired behind
- * `platform_editor_blocks_patch_4` with the `blockInstanceId` join key.
+ * Optional enrichment for the `syncedBlockCreate` success event. All fields
+ * optional so gate-off/legacy payloads are unchanged. `inputMethod`: creating
+ * surface (enum, PII-safe). `createdEmpty`: true from an empty selection, false
+ * when content was converted.
  */
-export var createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct) {
+
+/**
+ * Operational `syncedBlockCreate` success event, behind
+ * `platform_editor_blocks_patch_4`, with the `blockInstanceId` join key and,
+ * when available, the `inputMethod` + `createdEmpty` creation-type signals.
+ */
+export var createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct, enrichment) {
   return {
     action: ACTION.INSERTED,
     actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE,
     eventType: EVENT_TYPE.OPERATIONAL,
+    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread({
+      resourceId: resourceId
+    }, blockInstanceId && {
+      blockInstanceId: blockInstanceId
+    }), sourceProduct && {
+      sourceProduct: sourceProduct
+    }), (enrichment === null || enrichment === void 0 ? void 0 : enrichment.inputMethod) && {
+      inputMethod: enrichment.inputMethod
+    }), (enrichment === null || enrichment === void 0 ? void 0 : enrichment.createdEmpty) !== undefined && {
+      createdEmpty: enrichment.createdEmpty
+    })
+  };
+};
+
+/**
+ * Operational first-content-added event, behind
+ * `platform_editor_blocks_patch_4`. Fired once when a block created empty first
+ * gains user content. Join keys only (`resourceId` + `blockInstanceId`), no user
+ * content (PII-safe).
+ */
+export var addContentSuccessPayload = function addContentSuccessPayload(resourceId, blockInstanceId, sourceProduct) {
+  return {
+    action: ACTION.ADDED,
+    actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
+    actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_ADD_CONTENT,
+    eventType: EVENT_TYPE.OPERATIONAL,
     attributes: _objectSpread(_objectSpread({
       resourceId: resourceId
     }, blockInstanceId && {

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

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

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

@@ -3,6 +3,7 @@ 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, DeletionMechanism, ReferenceSyncBlockData } from '../common/types';
 import type { SyncBlockDataProviderInterface, SyncBlockSourceInfo } from '../providers/types';
+import type { CreateSuccessEnrichment } from '../utils/errorHandling';
 export type ConfirmationCallback = (syncBlockIds: SyncBlockAttrs[], deleteReason: DeletionReason | undefined) => Promise<boolean>;
 type OnDelete = () => void;
 type OnCompletion = (success: boolean) => void;
@@ -35,6 +36,20 @@ export declare class SourceSyncBlockStoreManager {
      * multiple blocks are created concurrently. See EDITOR-7112.
      */
     private creationsTimedOutDuringFlush;
+    /**
+     * 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.
+     */
+    private creationEnrichment;
+    /**
+     * 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.
+     */
+    private awaitingFirstContent;
     private createExperience;
     private saveExperience;
     private deleteExperience;
@@ -86,6 +101,13 @@ export declare class SourceSyncBlockStoreManager {
      * @param success
      */
     commitPendingCreation(success: boolean, resourceId: ResourceId): void;
+    /**
+     * 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: ResourceId, blockInstanceId?: BlockInstanceId): void;
     registerConfirmationCallback(callback: ConfirmationCallback): () => void;
     requireConfirmationBeforeDelete(): boolean;
     /**
@@ -97,8 +119,12 @@ export declare 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: SyncBlockAttrs, node: PMNode, onCompletion: OnCompletion): void;
+    createBodiedSyncBlockNode(attrs: SyncBlockAttrs, node: PMNode, onCompletion: OnCompletion, enrichment?: CreateSuccessEnrichment): void;
     private setPendingDeletion;
     /**
      * Drop dedupe entries older than {@link DELETE_DEDUPE_WINDOW_MS} so

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

@@ -1,5 +1,5 @@
 import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID } from '@atlaskit/editor-common/analytics';
-import type { RendererSyncBlockEventPayload, OperationalAEP, SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import type { INPUT_METHOD, 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;
@@ -175,11 +175,28 @@ export declare const fetchReferencesErrorPayload: (error: string, resourceId?: s
 export declare const fetchSuccessPayload: (resourceId: string, blockInstanceId?: string, sourceProduct?: string) => RendererSyncBlockEventPayload;
 export declare const createSuccessPayload: (resourceId: string, sourceProduct?: 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.
+ * Optional enrichment for the `syncedBlockCreate` success event. All fields
+ * optional so gate-off/legacy payloads are unchanged. `inputMethod`: creating
+ * surface (enum, PII-safe). `createdEmpty`: true from an empty selection, false
+ * when content was converted.
  */
-export declare const createSuccessOperationalPayload: (resourceId: string, blockInstanceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
+export type CreateSuccessEnrichment = {
+    createdEmpty?: boolean;
+    inputMethod?: INPUT_METHOD;
+};
+/**
+ * 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 declare const createSuccessOperationalPayload: (resourceId: string, blockInstanceId?: string, sourceProduct?: string, enrichment?: CreateSuccessEnrichment) => SyncBlockEventPayload;
+/**
+ * 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 declare const addContentSuccessPayload: (resourceId: string, blockInstanceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 export declare const updateSuccessPayload: (resourceId: string, hasReference?: boolean, sourceProduct?: string) => SyncBlockEventPayload;
 /**
  * Optional enrichment for the `syncedBlockDelete` success event behind

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": "^123.0.0",
+		"@atlaskit/tmp-editor-statsig": "^124.1.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.24.0",
+		"@atlaskit/editor-common": "^116.25.0",
 		"react": "^18.2.0"
 	},
 	"devDependencies": {
@@ -74,7 +74,7 @@
 		}
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "8.5.6",
+	"version": "8.6.0",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",