@atlaskit/editor-synced-block-provider 23.0.5 → 23.1.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @atlaskit/editor-synced-block-provider
 
+## 23.1.0
+
+### Minor Changes
+
+- [`bf97ae26b480d`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/bf97ae26b480d) -
+  Add a `sourceLocation` analytics attribute (`description` | `custom-field`) to synced block create
+  and get-source-info events for Jira sources, behind the `platform_editor_blocks_patch_13` feature
+  gate and the `editor_synced_blocks_jira_custom_rich_text` experiment. With the gate off, events
+  are unchanged. Add an optional `getParentAri()` method to the synced block data provider.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 23.0.5
 
 ### Patch Changes

package/dist/cjs/clients/jira/ari.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.parseJiraFieldLocation = exports.getJiraWorkItemIdFromAri = exports.getJiraWorkItemAri = exports.getJiraIssueAriFromSourceAri = void 0;
+exports.parseJiraFieldLocation = exports.getJiraWorkItemIdFromAri = exports.getJiraWorkItemAri = exports.getJiraIssueAriFromSourceAri = exports.JIRA_DESCRIPTION_FIELD_ID = void 0;
 /* eslint-disable require-unicode-regexp  */
 
 var JIRA_WORK_ITEM_ARI_REGEX = /ari:cloud:jira:([^:]+):issue\/(\d+)/;
@@ -69,7 +69,7 @@ var getJiraIssueAriFromSourceAri = exports.getJiraIssueAriFromSourceAri = functi
   }
   return ari;
 };
-var JIRA_DESCRIPTION_FIELD_ID = 'description';
+var JIRA_DESCRIPTION_FIELD_ID = exports.JIRA_DESCRIPTION_FIELD_ID = 'description';
 
 /**
  * One synced block location on a Jira work item, parsed once from its document ARI.

package/dist/cjs/common/types.js

@@ -20,6 +20,7 @@ function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.
  * `same-document` is the host document itself, the same page or the same work item field.
  * `same-parent-document` is another field of the host work item.
  */
+/** Which Jira work item field holds a source block. */
 var SyncBlockError = exports.SyncBlockError = /*#__PURE__*/function (SyncBlockError) {
   SyncBlockError["Errored"] = "errored";
   SyncBlockError["NotFound"] = "not_found";

package/dist/cjs/providers/syncBlockProvider.js

@@ -388,6 +388,12 @@ var SyncedBlockProvider = exports.SyncedBlockProvider = /*#__PURE__*/function (_
       }
       return fetchSyncBlockSourceInfo;
     }())
+  }, {
+    key: "getParentAri",
+    value: function getParentAri() {
+      var _this$writeProvider5;
+      return (_this$writeProvider5 = this.writeProvider) === null || _this$writeProvider5 === void 0 ? void 0 : _this$writeProvider5.parentAri;
+    }
   }, {
     key: "generateResourceId",
     value: function generateResourceId() {

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

@@ -18,6 +18,7 @@ var _isExperimentEnabled = require("@atlaskit/platform-feature-experiments/is-ex
 var _types = require("../common/types");
 var _errorHandling = require("../utils/errorHandling");
 var _experienceTracking = require("../utils/experienceTracking");
+var _fieldAwareLocations = require("../utils/fieldAwareLocations");
 var _resolveSyncBlockInstance = require("../utils/resolveSyncBlockInstance");
 var _resourceId = require("../utils/resourceId");
 var _utils = require("../utils/utils");
@@ -440,15 +441,26 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
           (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, (0, _errorHandling.getSourceInfoErrorPayload)('SourceAri, product or blockInstanceId missing', resourceId, sourceProduct));
           return Promise.resolve(undefined);
         }
+        var sourceLocation = (0, _fieldAwareLocations.getSourceLocation)(sourceAri);
+        // Undefined with `platform_editor_blocks_patch_13` off, so experience calls below keep
+        // exactly their previous arguments (no `metadata` key, `success()` without arguments).
+        var experienceMetadata = sourceLocation && {
+          sourceLocation: sourceLocation
+        };
+        var withExperienceMetadata = function withExperienceMetadata(options) {
+          return experienceMetadata ? _objectSpread(_objectSpread({}, options), {}, {
+            metadata: experienceMetadata
+          }) : options;
+        };
         (_this$fetchSourceInfo = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo === void 0 || _this$fetchSourceInfo.start({});
         var sourceInfoPromise = this.dataProvider.fetchSyncBlockSourceInfo(blockInstanceId, sourceAri, product, true // hasAccess
         ).then(function (sourceInfo) {
           if (!sourceInfo) {
             var _this2$fetchSourceInf, _this2$fireAnalyticsE;
-            (_this2$fetchSourceInf = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf === void 0 || _this2$fetchSourceInf.failure({
+            (_this2$fetchSourceInf = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf === void 0 || _this2$fetchSourceInf.failure(withExperienceMetadata({
               reason: 'No source info returned'
-            });
-            (_this2$fireAnalyticsE = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE === void 0 || _this2$fireAnalyticsE.call(_this2, (0, _errorHandling.getSourceInfoErrorPayload)('No source info returned', resourceId, sourceProduct));
+            }));
+            (_this2$fireAnalyticsE = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE === void 0 || _this2$fireAnalyticsE.call(_this2, (0, _errorHandling.getSourceInfoErrorPayload)('No source info returned', resourceId, sourceProduct, sourceLocation));
             return undefined;
           }
           _this2.updateCacheWithSourceInfo(resourceId, sourceInfo);
@@ -456,22 +468,29 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
             _this2._subscriptionManager.updateSourceTitleSubscriptions(resourceId, sourceInfo.title);
           }
           if (sourceInfo.title && sourceInfo.url) {
-            var _this2$fetchSourceInf2;
-            (_this2$fetchSourceInf2 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf2 === void 0 || _this2$fetchSourceInf2.success();
+            if (experienceMetadata) {
+              var _this2$fetchSourceInf2;
+              (_this2$fetchSourceInf2 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf2 === void 0 || _this2$fetchSourceInf2.success({
+                metadata: experienceMetadata
+              });
+            } else {
+              var _this2$fetchSourceInf3;
+              (_this2$fetchSourceInf3 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf3 === void 0 || _this2$fetchSourceInf3.success();
+            }
           } else {
-            var _this2$fetchSourceInf3, _this2$fireAnalyticsE2;
-            (_this2$fetchSourceInf3 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf3 === void 0 || _this2$fetchSourceInf3.failure({
+            var _this2$fetchSourceInf4, _this2$fireAnalyticsE2;
+            (_this2$fetchSourceInf4 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf4 === void 0 || _this2$fetchSourceInf4.failure(withExperienceMetadata({
               reason: 'Missing title or url'
-            });
-            (_this2$fireAnalyticsE2 = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE2 === void 0 || _this2$fireAnalyticsE2.call(_this2, (0, _errorHandling.getSourceInfoErrorPayload)('Missing title or url', resourceId, sourceProduct));
+            }));
+            (_this2$fireAnalyticsE2 = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE2 === void 0 || _this2$fireAnalyticsE2.call(_this2, (0, _errorHandling.getSourceInfoErrorPayload)('Missing title or url', resourceId, sourceProduct, sourceLocation));
           }
           return sourceInfo;
         }).catch(function (error) {
-          var _this2$fetchSourceInf4, _this2$fireAnalyticsE3;
-          (_this2$fetchSourceInf4 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf4 === void 0 || _this2$fetchSourceInf4.failure({
+          var _this2$fetchSourceInf5, _this2$fireAnalyticsE3;
+          (_this2$fetchSourceInf5 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf5 === void 0 || _this2$fetchSourceInf5.failure(withExperienceMetadata({
             reason: error.message
-          });
-          (_this2$fireAnalyticsE3 = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE3 === void 0 || _this2$fireAnalyticsE3.call(_this2, (0, _errorHandling.getSourceInfoErrorPayload)(error.message, resourceId, sourceProduct));
+          }));
+          (_this2$fireAnalyticsE3 = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE3 === void 0 || _this2$fireAnalyticsE3.call(_this2, (0, _errorHandling.getSourceInfoErrorPayload)(error.message, resourceId, sourceProduct, sourceLocation));
           return undefined;
         }).finally(function () {
           _this2.syncBlockSourceInfoRequests.delete(resourceId);

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

@@ -18,6 +18,7 @@ var _isExperimentEnabled = require("@atlaskit/platform-feature-experiments/is-ex
 var _types = require("../common/types");
 var _errorHandling = require("../utils/errorHandling");
 var _experienceTracking = require("../utils/experienceTracking");
+var _fieldAwareLocations = require("../utils/fieldAwareLocations");
 var _utils = require("../utils/utils");
 var _excluded = ["contentFragment", "isDirty"];
 function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
@@ -494,16 +495,17 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         }
       } else {
         var _this$fireAnalyticsEv3;
-        (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, (0, _errorHandling.createErrorPayload)('creation complete callback missing', resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
+        (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, (0, _errorHandling.createErrorPayload)('creation complete callback missing', resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId), undefined, this.getSourceLocation()));
       }
       if (success) {
         var _this$dataProvider$ge, _this$dataProvider, _this$fireAnalyticsEv4, _this$fireAnalyticsEv5, _this$syncBlockCache$2;
         var sourceProduct = (0, _utils.getSourceProductFromResourceIdSafe)(resourceId);
+        var sourceLocation = this.getSourceLocation();
         var documentInsertedResourceId = (_this$dataProvider$ge = (_this$dataProvider = this.dataProvider) === null || _this$dataProvider === void 0 ? void 0 : _this$dataProvider.generateResourceIdForReference(resourceId)) !== null && _this$dataProvider$ge !== void 0 ? _this$dataProvider$ge : resourceId;
-        (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 || _this$fireAnalyticsEv4.call(this, (0, _errorHandling.createSuccessPayload)(documentInsertedResourceId || '', sourceProduct));
+        (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 || _this$fireAnalyticsEv4.call(this, (0, _errorHandling.createSuccessPayload)(documentInsertedResourceId || '', sourceProduct, sourceLocation));
         // Operational create-success event with the join key + creation-type
         // signals (inputMethod / createdEmpty / nodeTypes) captured at the command layer.
-        (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.call(this, (0, _errorHandling.createSuccessOperationalPayload)(resourceId || '', (_this$syncBlockCache$2 = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$2 === void 0 ? void 0 : _this$syncBlockCache$2.blockInstanceId, sourceProduct, this.creationEnrichment.get(resourceId)));
+        (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.call(this, (0, _errorHandling.createSuccessOperationalPayload)(resourceId || '', (_this$syncBlockCache$2 = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$2 === void 0 ? void 0 : _this$syncBlockCache$2.blockInstanceId, sourceProduct, this.creationEnrichment.get(resourceId), sourceLocation));
       } else {
         var _this$fireAnalyticsEv6;
         // Delete the node from cache if fail to create so it's not flushed to BE
@@ -513,7 +515,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         // 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)));
+        (_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), undefined, this.getSourceLocation()));
       }
       // Enrichment is single-use — drop it once the create has resolved either way.
       this.creationEnrichment.delete(resourceId || '');
@@ -635,7 +637,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
             (_this5$createExperien2 = _this5.createExperience) === null || _this5$createExperien2 === void 0 || _this5$createExperien2.failure({
               reason: result.error || 'Failed to create bodied sync block'
             });
-            (_this5$fireAnalyticsE = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE === void 0 || _this5$fireAnalyticsE.call(_this5, (0, _errorHandling.createErrorPayload)(result.error || 'Failed to create bodied sync block', resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId), (0, _errorHandling.buildErrorAttribution)(result.error, result.statusCode)));
+            (_this5$fireAnalyticsE = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE === void 0 || _this5$fireAnalyticsE.call(_this5, (0, _errorHandling.createErrorPayload)(result.error || 'Failed to create bodied sync block', resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId), (0, _errorHandling.buildErrorAttribution)(result.error, result.statusCode), _this5.getSourceLocation()));
           }
         }).catch(function (error) {
           var _this5$createExperien3, _this5$fireAnalyticsE2;
@@ -646,7 +648,7 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
           (_this5$createExperien3 = _this5.createExperience) === null || _this5$createExperien3 === void 0 || _this5$createExperien3.failure({
             reason: error.message
           });
-          (_this5$fireAnalyticsE2 = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE2 === void 0 || _this5$fireAnalyticsE2.call(_this5, (0, _errorHandling.createErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId)));
+          (_this5$fireAnalyticsE2 = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE2 === void 0 || _this5$fireAnalyticsE2.call(_this5, (0, _errorHandling.createErrorPayload)(error.message, resourceId, (0, _utils.getSourceProductFromResourceIdSafe)(resourceId), undefined, _this5.getSourceLocation()));
         }).finally(function () {
           _this5.pendingCreationPromises.delete(resourceId);
         });
@@ -660,9 +662,15 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
         (0, _error.logException)(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv8 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv8 === void 0 || _this$fireAnalyticsEv8.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), undefined, this.getSourceLocation()));
       }
     }
+  }, {
+    key: "getSourceLocation",
+    value: function getSourceLocation() {
+      var _this$dataProvider2, _this$dataProvider2$g;
+      return (0, _fieldAwareLocations.getSourceLocation)((_this$dataProvider2 = this.dataProvider) === null || _this$dataProvider2 === void 0 || (_this$dataProvider2$g = _this$dataProvider2.getParentAri) === null || _this$dataProvider2$g === void 0 ? void 0 : _this$dataProvider2$g.call(_this$dataProvider2));
+    }
   }, {
     key: "pruneRecentDeleteEmissions",
     value:

package/dist/cjs/utils/errorHandling.js

@@ -221,18 +221,20 @@ var buildFetchErrorAttribution = exports.buildFetchErrorAttribution = function b
  * buckets like `source_deleted` they never emit.
  */
 
-function getErrorPayload(actionSubjectId, error, resourceId, sourceProduct, attribution) {
+function getErrorPayload(actionSubjectId, error, resourceId, sourceProduct, attribution, sourceLocation) {
   return {
     action: _enums.ACTION.ERROR,
     actionSubject: _enums.ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: actionSubjectId,
     eventType: _enums.EVENT_TYPE.OPERATIONAL,
-    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
+    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
       error: error
     }, resourceId && {
       resourceId: resourceId
     }), sourceProduct && {
       sourceProduct: sourceProduct
+    }), sourceLocation && {
+      sourceLocation: sourceLocation
     }), (attribution === null || attribution === void 0 ? void 0 : attribution.reason) && {
       reason: attribution.reason
     }), (attribution === null || attribution === void 0 ? void 0 : attribution.statusCode) !== undefined && {
@@ -252,8 +254,8 @@ var fetchErrorPayload = exports.fetchErrorPayload = function fetchErrorPayload(e
     attribution ? getErrorPayload(_enums.ACTION_SUBJECT_ID.SYNCED_BLOCK_FETCH, error, resourceId, sourceProduct, attribution) : getErrorPayload(_enums.ACTION_SUBJECT_ID.SYNCED_BLOCK_FETCH, error, resourceId, sourceProduct)
   );
 };
-var getSourceInfoErrorPayload = exports.getSourceInfoErrorPayload = function getSourceInfoErrorPayload(error, resourceId, sourceProduct) {
-  return getErrorPayload(_enums.ACTION_SUBJECT_ID.SYNCED_BLOCK_GET_SOURCE_INFO, error, resourceId, sourceProduct);
+var getSourceInfoErrorPayload = exports.getSourceInfoErrorPayload = function getSourceInfoErrorPayload(error, resourceId, sourceProduct, sourceLocation) {
+  return getErrorPayload(_enums.ACTION_SUBJECT_ID.SYNCED_BLOCK_GET_SOURCE_INFO, error, resourceId, sourceProduct, undefined, sourceLocation);
 };
 var updateErrorPayload = exports.updateErrorPayload = function updateErrorPayload(error, resourceId, sourceProduct, attribution) {
   return getErrorPayload(_enums.ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE, error, resourceId, sourceProduct, attribution);
@@ -261,8 +263,8 @@ var updateErrorPayload = exports.updateErrorPayload = function updateErrorPayloa
 var updateReferenceErrorPayload = exports.updateReferenceErrorPayload = function updateReferenceErrorPayload(error, resourceId, sourceProduct, attribution) {
   return getErrorPayload(_enums.ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_UPDATE, error, resourceId, sourceProduct, attribution);
 };
-var createErrorPayload = exports.createErrorPayload = function createErrorPayload(error, resourceId, sourceProduct, attribution) {
-  return getErrorPayload(_enums.ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error, resourceId, sourceProduct, attribution);
+var createErrorPayload = exports.createErrorPayload = function createErrorPayload(error, resourceId, sourceProduct, attribution, sourceLocation) {
+  return getErrorPayload(_enums.ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error, resourceId, sourceProduct, attribution, sourceLocation);
 };
 var deleteErrorPayload = exports.deleteErrorPayload = function deleteErrorPayload(error, resourceId, sourceProduct, attribution) {
   return getErrorPayload(_enums.ACTION_SUBJECT_ID.SYNCED_BLOCK_DELETE, error, resourceId, sourceProduct, attribution);
@@ -331,16 +333,18 @@ var fetchSuccessPayload = exports.fetchSuccessPayload = function fetchSuccessPay
     })
   };
 };
-var createSuccessPayload = exports.createSuccessPayload = function createSuccessPayload(resourceId, sourceProduct) {
+var createSuccessPayload = exports.createSuccessPayload = function createSuccessPayload(resourceId, sourceProduct, sourceLocation) {
   return {
     action: _enums.ACTION.INSERTED,
     actionSubject: _enums.ACTION_SUBJECT.DOCUMENT,
     actionSubjectId: _enums.ACTION_SUBJECT_ID.BODIED_SYNCED_BLOCK,
     eventType: _enums.EVENT_TYPE.TRACK,
-    attributes: _objectSpread({
+    attributes: _objectSpread(_objectSpread({
       resourceId: resourceId
     }, sourceProduct && {
       sourceProduct: sourceProduct
+    }), sourceLocation && {
+      sourceLocation: sourceLocation
     })
   };
 };
@@ -357,14 +361,14 @@ var createSuccessPayload = exports.createSuccessPayload = function createSuccess
  * Operational `syncedBlockCreate` success event with the `blockInstanceId` join key and,
  * when available, the `inputMethod`, `createdEmpty`, and `nodeTypes` creation signals.
  */
-var createSuccessOperationalPayload = exports.createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct, enrichment) {
+var createSuccessOperationalPayload = exports.createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct, enrichment, sourceLocation) {
   var _enrichment$nodeTypes;
   return {
     action: _enums.ACTION.INSERTED,
     actionSubject: _enums.ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: _enums.ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE,
     eventType: _enums.EVENT_TYPE.OPERATIONAL,
-    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
+    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
       resourceId: resourceId
     }, blockInstanceId && {
       blockInstanceId: blockInstanceId
@@ -376,6 +380,8 @@ var createSuccessOperationalPayload = exports.createSuccessOperationalPayload =
       createdEmpty: enrichment.createdEmpty
     }), (enrichment === null || enrichment === void 0 || (_enrichment$nodeTypes = enrichment.nodeTypes) === null || _enrichment$nodeTypes === void 0 ? void 0 : _enrichment$nodeTypes.length) && {
       nodeTypes: enrichment.nodeTypes
+    }), sourceLocation && {
+      sourceLocation: sourceLocation
     })
   };
 };

package/dist/cjs/utils/fieldAwareLocations.js

@@ -3,9 +3,11 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.isFieldAwareJiraLocation = exports.getFieldAwareLocationScope = void 0;
+exports.isFieldAwareJiraLocation = exports.getSourceLocation = exports.getFieldAwareLocationScope = void 0;
 var _isExperimentEnabled = require("@atlaskit/platform-feature-experiments/is-experiment-enabled");
+var _fg = require("@atlaskit/platform-feature-flags/fg");
 var _ari = require("../clients/block-service/ari");
+var _ari2 = require("../clients/jira/ari");
 /**
  * The product check runs first so a Confluence-only document never reads the experiment.
  */
@@ -27,4 +29,27 @@ var getFieldAwareLocationScope = exports.getFieldAwareLocationScope = function g
       hostAri: hostAri
     })
   } : undefined;
+};
+
+/**
+ * Analytics `sourceLocation` for a source ARI: `undefined` for non-Jira sources and for the
+ * control cohort, so events outside the experiment keep their current shape.
+ *
+ * The `platform_editor_blocks_patch_13` gate runs first: with it off this returns `undefined`
+ * without the product check or the experiment read, so no new exposure is logged.
+ */
+var getSourceLocation = exports.getSourceLocation = function getSourceLocation(sourceAri) {
+  if (!(0, _fg.fg)('platform_editor_blocks_patch_13')) {
+    return undefined;
+  }
+  if (!sourceAri || !isFieldAwareJiraLocation((0, _ari.getProductFromSourceAri)(sourceAri))) {
+    return undefined;
+  }
+  var location = (0, _ari2.parseJiraFieldLocation)({
+    ari: sourceAri
+  });
+  if (!location) {
+    return undefined;
+  }
+  return location.fieldId === _ari2.JIRA_DESCRIPTION_FIELD_ID ? 'description' : 'custom-field';
 };

package/dist/es2019/clients/jira/ari.js

@@ -66,7 +66,7 @@ export const getJiraIssueAriFromSourceAri = ({
   }
   return ari;
 };
-const JIRA_DESCRIPTION_FIELD_ID = 'description';
+export const JIRA_DESCRIPTION_FIELD_ID = 'description';
 
 /**
  * One synced block location on a Jira work item, parsed once from its document ARI.

package/dist/es2019/common/types.js

@@ -5,6 +5,8 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
  * `same-parent-document` is another field of the host work item.
  */
 
+/** Which Jira work item field holds a source block. */
+
 export let SyncBlockError = /*#__PURE__*/function (SyncBlockError) {
   SyncBlockError["Errored"] = "errored";
   SyncBlockError["NotFound"] = "not_found";

package/dist/es2019/providers/syncBlockProvider.js

@@ -244,6 +244,10 @@ export class SyncedBlockProvider extends SyncBlockDataProviderInterface {
         return Promise.reject(new Error(`${product} source product not supported`));
     }
   }
+  getParentAri() {
+    var _this$writeProvider6;
+    return (_this$writeProvider6 = this.writeProvider) === null || _this$writeProvider6 === void 0 ? void 0 : _this$writeProvider6.parentAri;
+  }
   generateResourceId() {
     const localId = crypto.randomUUID();
     const resourceId = crypto.randomUUID();

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

@@ -5,6 +5,7 @@ import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-e
 import { isProviderNotReadyError, ProviderNotReadyError, SyncBlockError } from '../common/types';
 import { buildErrorAttribution, buildFetchErrorAttribution, cacheDeletionForcedPayload, fetchErrorPayload, fetchSuccessPayload, getSourceInfoErrorPayload, sourceInfoOrphanedPayload, updateReferenceErrorPayload } from '../utils/errorHandling';
 import { getFetchExperience, getFetchSourceInfoExperience, getSaveReferenceExperience } from '../utils/experienceTracking';
+import { getSourceLocation } from '../utils/fieldAwareLocations';
 import { resolveSyncBlockInstance } from '../utils/resolveSyncBlockInstance';
 import { parseResourceId } from '../utils/resourceId';
 import { createSyncBlockNode, getSourceProductFromResourceIdSafe, normalizeSyncBlockJSONContent } from '../utils/utils';
@@ -348,15 +349,25 @@ export class ReferenceSyncBlockStoreManager {
         (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 ? void 0 : _this$fireAnalyticsEv3.call(this, getSourceInfoErrorPayload('SourceAri, product or blockInstanceId missing', resourceId, sourceProduct));
         return Promise.resolve(undefined);
       }
+      const sourceLocation = getSourceLocation(sourceAri);
+      // Undefined with `platform_editor_blocks_patch_13` off, so experience calls below keep
+      // exactly their previous arguments (no `metadata` key, `success()` without arguments).
+      const experienceMetadata = sourceLocation && {
+        sourceLocation
+      };
+      const withExperienceMetadata = options => experienceMetadata ? {
+        ...options,
+        metadata: experienceMetadata
+      } : options;
       (_this$fetchSourceInfo = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo === void 0 ? void 0 : _this$fetchSourceInfo.start({});
       const sourceInfoPromise = this.dataProvider.fetchSyncBlockSourceInfo(blockInstanceId, sourceAri, product, true // hasAccess
       ).then(sourceInfo => {
         if (!sourceInfo) {
           var _this$fetchSourceInfo2, _this$fireAnalyticsEv4;
-          (_this$fetchSourceInfo2 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo2 === void 0 ? void 0 : _this$fetchSourceInfo2.failure({
+          (_this$fetchSourceInfo2 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo2 === void 0 ? void 0 : _this$fetchSourceInfo2.failure(withExperienceMetadata({
             reason: 'No source info returned'
-          });
-          (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 ? void 0 : _this$fireAnalyticsEv4.call(this, getSourceInfoErrorPayload('No source info returned', resourceId, sourceProduct));
+          }));
+          (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 ? void 0 : _this$fireAnalyticsEv4.call(this, getSourceInfoErrorPayload('No source info returned', resourceId, sourceProduct, sourceLocation));
           return undefined;
         }
         this.updateCacheWithSourceInfo(resourceId, sourceInfo);
@@ -364,22 +375,29 @@ export class ReferenceSyncBlockStoreManager {
           this._subscriptionManager.updateSourceTitleSubscriptions(resourceId, sourceInfo.title);
         }
         if (sourceInfo.title && sourceInfo.url) {
-          var _this$fetchSourceInfo3;
-          (_this$fetchSourceInfo3 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo3 === void 0 ? void 0 : _this$fetchSourceInfo3.success();
+          if (experienceMetadata) {
+            var _this$fetchSourceInfo3;
+            (_this$fetchSourceInfo3 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo3 === void 0 ? void 0 : _this$fetchSourceInfo3.success({
+              metadata: experienceMetadata
+            });
+          } else {
+            var _this$fetchSourceInfo4;
+            (_this$fetchSourceInfo4 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo4 === void 0 ? void 0 : _this$fetchSourceInfo4.success();
+          }
         } else {
-          var _this$fetchSourceInfo4, _this$fireAnalyticsEv5;
-          (_this$fetchSourceInfo4 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo4 === void 0 ? void 0 : _this$fetchSourceInfo4.failure({
+          var _this$fetchSourceInfo5, _this$fireAnalyticsEv5;
+          (_this$fetchSourceInfo5 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo5 === void 0 ? void 0 : _this$fetchSourceInfo5.failure(withExperienceMetadata({
             reason: 'Missing title or url'
-          });
-          (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 ? void 0 : _this$fireAnalyticsEv5.call(this, getSourceInfoErrorPayload('Missing title or url', resourceId, sourceProduct));
+          }));
+          (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 ? void 0 : _this$fireAnalyticsEv5.call(this, getSourceInfoErrorPayload('Missing title or url', resourceId, sourceProduct, sourceLocation));
         }
         return sourceInfo;
       }).catch(error => {
-        var _this$fetchSourceInfo5, _this$fireAnalyticsEv6;
-        (_this$fetchSourceInfo5 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo5 === void 0 ? void 0 : _this$fetchSourceInfo5.failure({
+        var _this$fetchSourceInfo6, _this$fireAnalyticsEv6;
+        (_this$fetchSourceInfo6 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo6 === void 0 ? void 0 : _this$fetchSourceInfo6.failure(withExperienceMetadata({
           reason: error.message
-        });
-        (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 ? void 0 : _this$fireAnalyticsEv6.call(this, getSourceInfoErrorPayload(error.message, resourceId, sourceProduct));
+        }));
+        (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 ? void 0 : _this$fireAnalyticsEv6.call(this, getSourceInfoErrorPayload(error.message, resourceId, sourceProduct, sourceLocation));
         return undefined;
       }).finally(() => {
         this.syncBlockSourceInfoRequests.delete(resourceId);
@@ -1036,7 +1054,7 @@ export class ReferenceSyncBlockStoreManager {
     return success;
   }
   destroy() {
-    var _this$dataProvider7, _this$saveExperience5, _this$fetchExperience0, _this$fetchSourceInfo6;
+    var _this$dataProvider7, _this$saveExperience5, _this$fetchExperience0, _this$fetchSourceInfo7;
     // Mark destroyed first so in-flight timer callbacks can early-return.
     this.isDestroyed = true;
 
@@ -1068,7 +1086,7 @@ export class ReferenceSyncBlockStoreManager {
     (_this$fetchExperience0 = this.fetchExperience) === null || _this$fetchExperience0 === void 0 ? void 0 : _this$fetchExperience0.abort({
       reason: 'editorDestroyed'
     });
-    (_this$fetchSourceInfo6 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo6 === void 0 ? void 0 : _this$fetchSourceInfo6.abort({
+    (_this$fetchSourceInfo7 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo7 === void 0 ? void 0 : _this$fetchSourceInfo7.abort({
       reason: 'editorDestroyed'
     });
     this.fireAnalyticsEvent = undefined;

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

@@ -4,6 +4,7 @@ import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-e
 import { SyncBlockError } from '../common/types';
 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 { getSourceLocation } from '../utils/fieldAwareLocations';
 import { convertSyncBlockPMNodeToSyncBlockData, getSourceProductFromResourceIdSafe } from '../utils/utils';
 /** Maximum time (ms) flush() will wait for in-flight block creations before proceeding. */
 const FLUSH_CREATION_AWAIT_TIMEOUT_MS = 1000;
@@ -406,16 +407,17 @@ export class SourceSyncBlockStoreManager {
       }
     } else {
       var _this$fireAnalyticsEv5;
-      (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 ? void 0 : _this$fireAnalyticsEv5.call(this, createErrorPayload('creation complete callback missing', resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+      (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 ? void 0 : _this$fireAnalyticsEv5.call(this, createErrorPayload('creation complete callback missing', resourceId, getSourceProductFromResourceIdSafe(resourceId), undefined, this.getSourceLocation()));
     }
     if (success) {
       var _this$dataProvider$ge, _this$dataProvider, _this$fireAnalyticsEv6, _this$fireAnalyticsEv7, _this$syncBlockCache$2;
       const sourceProduct = getSourceProductFromResourceIdSafe(resourceId);
+      const sourceLocation = this.getSourceLocation();
       const documentInsertedResourceId = (_this$dataProvider$ge = (_this$dataProvider = this.dataProvider) === null || _this$dataProvider === void 0 ? void 0 : _this$dataProvider.generateResourceIdForReference(resourceId)) !== null && _this$dataProvider$ge !== void 0 ? _this$dataProvider$ge : resourceId;
-      (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 ? void 0 : _this$fireAnalyticsEv6.call(this, createSuccessPayload(documentInsertedResourceId || '', sourceProduct));
+      (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 ? void 0 : _this$fireAnalyticsEv6.call(this, createSuccessPayload(documentInsertedResourceId || '', sourceProduct, sourceLocation));
       // Operational create-success event with the join key + creation-type
       // signals (inputMethod / createdEmpty / nodeTypes) captured at the command layer.
-      (_this$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 ? void 0 : _this$fireAnalyticsEv7.call(this, createSuccessOperationalPayload(resourceId || '', (_this$syncBlockCache$2 = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$2 === void 0 ? void 0 : _this$syncBlockCache$2.blockInstanceId, sourceProduct, this.creationEnrichment.get(resourceId)));
+      (_this$fireAnalyticsEv7 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv7 === void 0 ? void 0 : _this$fireAnalyticsEv7.call(this, createSuccessOperationalPayload(resourceId || '', (_this$syncBlockCache$2 = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$2 === void 0 ? void 0 : _this$syncBlockCache$2.blockInstanceId, sourceProduct, this.creationEnrichment.get(resourceId), sourceLocation));
     } else {
       var _this$fireAnalyticsEv8;
       // Delete the node from cache if fail to create so it's not flushed to BE
@@ -425,7 +427,7 @@ export class SourceSyncBlockStoreManager {
       // 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)));
+      (_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), undefined, this.getSourceLocation()));
     }
     // Enrichment is single-use — drop it once the create has resolved either way.
     this.creationEnrichment.delete(resourceId || '');
@@ -538,7 +540,7 @@ export class SourceSyncBlockStoreManager {
           (_this$createExperienc3 = this.createExperience) === null || _this$createExperienc3 === void 0 ? void 0 : _this$createExperienc3.failure({
             reason: result.error || 'Failed to create bodied sync block'
           });
-          (_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(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(result.error, result.statusCode), this.getSourceLocation()));
         }
       }).catch(error => {
         var _this$createExperienc4, _this$fireAnalyticsEv1;
@@ -549,7 +551,7 @@ export class SourceSyncBlockStoreManager {
         (_this$createExperienc4 = this.createExperience) === null || _this$createExperienc4 === void 0 ? void 0 : _this$createExperienc4.failure({
           reason: error.message
         });
-        (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 ? void 0 : _this$fireAnalyticsEv1.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), undefined, this.getSourceLocation()));
       }).finally(() => {
         this.pendingCreationPromises.delete(resourceId);
       });
@@ -563,9 +565,13 @@ export class SourceSyncBlockStoreManager {
       logException(error, {
         location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
       });
-      (_this$fireAnalyticsEv10 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv10 === void 0 ? void 0 : _this$fireAnalyticsEv10.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), undefined, this.getSourceLocation()));
     }
   }
+  getSourceLocation() {
+    var _this$dataProvider2, _this$dataProvider2$g;
+    return getSourceLocation((_this$dataProvider2 = this.dataProvider) === null || _this$dataProvider2 === void 0 ? void 0 : (_this$dataProvider2$g = _this$dataProvider2.getParentAri) === null || _this$dataProvider2$g === void 0 ? void 0 : _this$dataProvider2$g.call(_this$dataProvider2));
+  }
   /**
    * Drop dedupe entries older than {@link DELETE_DEDUPE_WINDOW_MS} so
    * `recentDeleteEmissions` stays bounded by the number of recent deletes.
@@ -709,8 +715,8 @@ export class SourceSyncBlockStoreManager {
     // so we can update the correct cache entries.
     const sourceToReferenceMap = new Map();
     const syncBlockNodes = Array.from(this.syncBlockCache.entries()).map(([resourceId, data]) => {
-      var _this$dataProvider$ge2, _this$dataProvider2;
-      const referenceResourceId = (_this$dataProvider$ge2 = (_this$dataProvider2 = this.dataProvider) === null || _this$dataProvider2 === void 0 ? void 0 : _this$dataProvider2.generateResourceIdForReference(resourceId)) !== null && _this$dataProvider$ge2 !== void 0 ? _this$dataProvider$ge2 : resourceId;
+      var _this$dataProvider$ge2, _this$dataProvider3;
+      const referenceResourceId = (_this$dataProvider$ge2 = (_this$dataProvider3 = this.dataProvider) === null || _this$dataProvider3 === void 0 ? void 0 : _this$dataProvider3.generateResourceIdForReference(resourceId)) !== null && _this$dataProvider$ge2 !== void 0 ? _this$dataProvider$ge2 : resourceId;
       sourceToReferenceMap.set(referenceResourceId, resourceId);
       return {
         type: 'bodiedSyncBlock',

package/dist/es2019/utils/errorHandling.js

@@ -209,7 +209,7 @@ export const buildFetchErrorAttribution = (error, statusCode, deferred) => {
  * buckets like `source_deleted` they never emit.
  */
 
-export function getErrorPayload(actionSubjectId, error, resourceId, sourceProduct, attribution) {
+export function getErrorPayload(actionSubjectId, error, resourceId, sourceProduct, attribution, sourceLocation) {
   return {
     action: ACTION.ERROR,
     actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
@@ -223,6 +223,9 @@ export function getErrorPayload(actionSubjectId, error, resourceId, sourceProduc
       ...(sourceProduct && {
         sourceProduct
       }),
+      ...(sourceLocation && {
+        sourceLocation
+      }),
       ...((attribution === null || attribution === void 0 ? void 0 : attribution.reason) && {
         reason: attribution.reason
       }),
@@ -249,10 +252,10 @@ export const fetchErrorPayload = (error, resourceId, sourceProduct, attribution)
 // attribution it hits the fetch overload (wider `reason`); without it, the
 // no-attribution overload. Both produce a fetch event regardless.
 attribution ? getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_FETCH, error, resourceId, sourceProduct, attribution) : getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_FETCH, error, resourceId, sourceProduct);
-export const getSourceInfoErrorPayload = (error, resourceId, sourceProduct) => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_GET_SOURCE_INFO, error, resourceId, sourceProduct);
+export const getSourceInfoErrorPayload = (error, resourceId, sourceProduct, sourceLocation) => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_GET_SOURCE_INFO, error, resourceId, sourceProduct, undefined, sourceLocation);
 export const updateErrorPayload = (error, resourceId, sourceProduct, attribution) => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE, error, resourceId, sourceProduct, attribution);
 export const updateReferenceErrorPayload = (error, resourceId, sourceProduct, attribution) => getErrorPayload(ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_UPDATE, error, resourceId, sourceProduct, attribution);
-export const createErrorPayload = (error, resourceId, sourceProduct, attribution) => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error, resourceId, sourceProduct, attribution);
+export const createErrorPayload = (error, resourceId, sourceProduct, attribution, sourceLocation) => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error, resourceId, sourceProduct, attribution, sourceLocation);
 export const deleteErrorPayload = (error, resourceId, sourceProduct, attribution) => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_DELETE, error, resourceId, sourceProduct, attribution);
 export const updateCacheErrorPayload = (error, resourceId, sourceProduct) => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE_CACHE, error, resourceId, sourceProduct);
 /**
@@ -316,7 +319,7 @@ export const fetchSuccessPayload = (resourceId, blockInstanceId, sourceProduct)
     })
   }
 });
-export const createSuccessPayload = (resourceId, sourceProduct) => {
+export const createSuccessPayload = (resourceId, sourceProduct, sourceLocation) => {
   return {
     action: ACTION.INSERTED,
     actionSubject: ACTION_SUBJECT.DOCUMENT,
@@ -326,6 +329,9 @@ export const createSuccessPayload = (resourceId, sourceProduct) => {
       resourceId,
       ...(sourceProduct && {
         sourceProduct
+      }),
+      ...(sourceLocation && {
+        sourceLocation
       })
     }
   };
@@ -343,7 +349,7 @@ export const createSuccessPayload = (resourceId, sourceProduct) => {
  * Operational `syncedBlockCreate` success event with the `blockInstanceId` join key and,
  * when available, the `inputMethod`, `createdEmpty`, and `nodeTypes` creation signals.
  */
-export const createSuccessOperationalPayload = (resourceId, blockInstanceId, sourceProduct, enrichment) => {
+export const createSuccessOperationalPayload = (resourceId, blockInstanceId, sourceProduct, enrichment, sourceLocation) => {
   var _enrichment$nodeTypes;
   return {
     action: ACTION.INSERTED,
@@ -366,6 +372,9 @@ export const createSuccessOperationalPayload = (resourceId, blockInstanceId, sou
       }),
       ...((enrichment === null || enrichment === void 0 ? void 0 : (_enrichment$nodeTypes = enrichment.nodeTypes) === null || _enrichment$nodeTypes === void 0 ? void 0 : _enrichment$nodeTypes.length) && {
         nodeTypes: enrichment.nodeTypes
+      }),
+      ...(sourceLocation && {
+        sourceLocation
       })
     }
   };

package/dist/es2019/utils/fieldAwareLocations.js

@@ -1,5 +1,7 @@
 import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-experiment-enabled';
-import { getLocationScope } from '../clients/block-service/ari';
+import { fg } from '@atlaskit/platform-feature-flags/fg';
+import { getLocationScope, getProductFromSourceAri } from '../clients/block-service/ari';
+import { JIRA_DESCRIPTION_FIELD_ID, parseJiraFieldLocation } from '../clients/jira/ari';
 /**
  * The product check runs first so a Confluence-only document never reads the experiment.
  */
@@ -18,4 +20,27 @@ export const getFieldAwareLocationScope = ({
     documentAri,
     hostAri
   })
-} : undefined;
+} : undefined;
+
+/**
+ * Analytics `sourceLocation` for a source ARI: `undefined` for non-Jira sources and for the
+ * control cohort, so events outside the experiment keep their current shape.
+ *
+ * The `platform_editor_blocks_patch_13` gate runs first: with it off this returns `undefined`
+ * without the product check or the experiment read, so no new exposure is logged.
+ */
+export const getSourceLocation = sourceAri => {
+  if (!fg('platform_editor_blocks_patch_13')) {
+    return undefined;
+  }
+  if (!sourceAri || !isFieldAwareJiraLocation(getProductFromSourceAri(sourceAri))) {
+    return undefined;
+  }
+  const location = parseJiraFieldLocation({
+    ari: sourceAri
+  });
+  if (!location) {
+    return undefined;
+  }
+  return location.fieldId === JIRA_DESCRIPTION_FIELD_ID ? 'description' : 'custom-field';
+};

package/dist/esm/clients/jira/ari.js

@@ -63,7 +63,7 @@ export var getJiraIssueAriFromSourceAri = function getJiraIssueAriFromSourceAri(
   }
   return ari;
 };
-var JIRA_DESCRIPTION_FIELD_ID = 'description';
+export var JIRA_DESCRIPTION_FIELD_ID = 'description';
 
 /**
  * One synced block location on a Jira work item, parsed once from its document ARI.

package/dist/esm/common/types.js

@@ -14,6 +14,8 @@ function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.
  * `same-parent-document` is another field of the host work item.
  */
 
+/** Which Jira work item field holds a source block. */
+
 export var SyncBlockError = /*#__PURE__*/function (SyncBlockError) {
   SyncBlockError["Errored"] = "errored";
   SyncBlockError["NotFound"] = "not_found";

package/dist/esm/providers/syncBlockProvider.js

@@ -381,6 +381,12 @@ export var SyncedBlockProvider = /*#__PURE__*/function (_SyncBlockDataProvide) {
       }
       return fetchSyncBlockSourceInfo;
     }())
+  }, {
+    key: "getParentAri",
+    value: function getParentAri() {
+      var _this$writeProvider5;
+      return (_this$writeProvider5 = this.writeProvider) === null || _this$writeProvider5 === void 0 ? void 0 : _this$writeProvider5.parentAri;
+    }
   }, {
     key: "generateResourceId",
     value: function generateResourceId() {

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

@@ -16,6 +16,7 @@ import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-e
 import { isProviderNotReadyError, ProviderNotReadyError, SyncBlockError } from '../common/types';
 import { buildErrorAttribution, buildFetchErrorAttribution, cacheDeletionForcedPayload, fetchErrorPayload, fetchSuccessPayload, getSourceInfoErrorPayload, sourceInfoOrphanedPayload, updateReferenceErrorPayload } from '../utils/errorHandling';
 import { getFetchExperience, getFetchSourceInfoExperience, getSaveReferenceExperience } from '../utils/experienceTracking';
+import { getSourceLocation } from '../utils/fieldAwareLocations';
 import { resolveSyncBlockInstance } from '../utils/resolveSyncBlockInstance';
 import { parseResourceId } from '../utils/resourceId';
 import { createSyncBlockNode, getSourceProductFromResourceIdSafe, normalizeSyncBlockJSONContent } from '../utils/utils';
@@ -433,15 +434,26 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
           (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, getSourceInfoErrorPayload('SourceAri, product or blockInstanceId missing', resourceId, sourceProduct));
           return Promise.resolve(undefined);
         }
+        var sourceLocation = getSourceLocation(sourceAri);
+        // Undefined with `platform_editor_blocks_patch_13` off, so experience calls below keep
+        // exactly their previous arguments (no `metadata` key, `success()` without arguments).
+        var experienceMetadata = sourceLocation && {
+          sourceLocation: sourceLocation
+        };
+        var withExperienceMetadata = function withExperienceMetadata(options) {
+          return experienceMetadata ? _objectSpread(_objectSpread({}, options), {}, {
+            metadata: experienceMetadata
+          }) : options;
+        };
         (_this$fetchSourceInfo = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo === void 0 || _this$fetchSourceInfo.start({});
         var sourceInfoPromise = this.dataProvider.fetchSyncBlockSourceInfo(blockInstanceId, sourceAri, product, true // hasAccess
         ).then(function (sourceInfo) {
           if (!sourceInfo) {
             var _this2$fetchSourceInf, _this2$fireAnalyticsE;
-            (_this2$fetchSourceInf = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf === void 0 || _this2$fetchSourceInf.failure({
+            (_this2$fetchSourceInf = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf === void 0 || _this2$fetchSourceInf.failure(withExperienceMetadata({
               reason: 'No source info returned'
-            });
-            (_this2$fireAnalyticsE = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE === void 0 || _this2$fireAnalyticsE.call(_this2, getSourceInfoErrorPayload('No source info returned', resourceId, sourceProduct));
+            }));
+            (_this2$fireAnalyticsE = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE === void 0 || _this2$fireAnalyticsE.call(_this2, getSourceInfoErrorPayload('No source info returned', resourceId, sourceProduct, sourceLocation));
             return undefined;
           }
           _this2.updateCacheWithSourceInfo(resourceId, sourceInfo);
@@ -449,22 +461,29 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
             _this2._subscriptionManager.updateSourceTitleSubscriptions(resourceId, sourceInfo.title);
           }
           if (sourceInfo.title && sourceInfo.url) {
-            var _this2$fetchSourceInf2;
-            (_this2$fetchSourceInf2 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf2 === void 0 || _this2$fetchSourceInf2.success();
+            if (experienceMetadata) {
+              var _this2$fetchSourceInf2;
+              (_this2$fetchSourceInf2 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf2 === void 0 || _this2$fetchSourceInf2.success({
+                metadata: experienceMetadata
+              });
+            } else {
+              var _this2$fetchSourceInf3;
+              (_this2$fetchSourceInf3 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf3 === void 0 || _this2$fetchSourceInf3.success();
+            }
           } else {
-            var _this2$fetchSourceInf3, _this2$fireAnalyticsE2;
-            (_this2$fetchSourceInf3 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf3 === void 0 || _this2$fetchSourceInf3.failure({
+            var _this2$fetchSourceInf4, _this2$fireAnalyticsE2;
+            (_this2$fetchSourceInf4 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf4 === void 0 || _this2$fetchSourceInf4.failure(withExperienceMetadata({
               reason: 'Missing title or url'
-            });
-            (_this2$fireAnalyticsE2 = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE2 === void 0 || _this2$fireAnalyticsE2.call(_this2, getSourceInfoErrorPayload('Missing title or url', resourceId, sourceProduct));
+            }));
+            (_this2$fireAnalyticsE2 = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE2 === void 0 || _this2$fireAnalyticsE2.call(_this2, getSourceInfoErrorPayload('Missing title or url', resourceId, sourceProduct, sourceLocation));
           }
           return sourceInfo;
         }).catch(function (error) {
-          var _this2$fetchSourceInf4, _this2$fireAnalyticsE3;
-          (_this2$fetchSourceInf4 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf4 === void 0 || _this2$fetchSourceInf4.failure({
+          var _this2$fetchSourceInf5, _this2$fireAnalyticsE3;
+          (_this2$fetchSourceInf5 = _this2.fetchSourceInfoExperience) === null || _this2$fetchSourceInf5 === void 0 || _this2$fetchSourceInf5.failure(withExperienceMetadata({
             reason: error.message
-          });
-          (_this2$fireAnalyticsE3 = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE3 === void 0 || _this2$fireAnalyticsE3.call(_this2, getSourceInfoErrorPayload(error.message, resourceId, sourceProduct));
+          }));
+          (_this2$fireAnalyticsE3 = _this2.fireAnalyticsEvent) === null || _this2$fireAnalyticsE3 === void 0 || _this2$fireAnalyticsE3.call(_this2, getSourceInfoErrorPayload(error.message, resourceId, sourceProduct, sourceLocation));
           return undefined;
         }).finally(function () {
           _this2.syncBlockSourceInfoRequests.delete(resourceId);

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

@@ -17,6 +17,7 @@ import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-e
 import { SyncBlockError } from '../common/types';
 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 { getSourceLocation as _getSourceLocation } from '../utils/fieldAwareLocations';
 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;
@@ -487,16 +488,17 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         }
       } else {
         var _this$fireAnalyticsEv3;
-        (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, createErrorPayload('creation complete callback missing', resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+        (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, createErrorPayload('creation complete callback missing', resourceId, getSourceProductFromResourceIdSafe(resourceId), undefined, this.getSourceLocation()));
       }
       if (success) {
         var _this$dataProvider$ge, _this$dataProvider, _this$fireAnalyticsEv4, _this$fireAnalyticsEv5, _this$syncBlockCache$2;
         var sourceProduct = getSourceProductFromResourceIdSafe(resourceId);
+        var sourceLocation = this.getSourceLocation();
         var documentInsertedResourceId = (_this$dataProvider$ge = (_this$dataProvider = this.dataProvider) === null || _this$dataProvider === void 0 ? void 0 : _this$dataProvider.generateResourceIdForReference(resourceId)) !== null && _this$dataProvider$ge !== void 0 ? _this$dataProvider$ge : resourceId;
-        (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 || _this$fireAnalyticsEv4.call(this, createSuccessPayload(documentInsertedResourceId || '', sourceProduct));
+        (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 || _this$fireAnalyticsEv4.call(this, createSuccessPayload(documentInsertedResourceId || '', sourceProduct, sourceLocation));
         // Operational create-success event with the join key + creation-type
         // signals (inputMethod / createdEmpty / nodeTypes) captured at the command layer.
-        (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.call(this, createSuccessOperationalPayload(resourceId || '', (_this$syncBlockCache$2 = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$2 === void 0 ? void 0 : _this$syncBlockCache$2.blockInstanceId, sourceProduct, this.creationEnrichment.get(resourceId)));
+        (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 || _this$fireAnalyticsEv5.call(this, createSuccessOperationalPayload(resourceId || '', (_this$syncBlockCache$2 = this.syncBlockCache.get(resourceId)) === null || _this$syncBlockCache$2 === void 0 ? void 0 : _this$syncBlockCache$2.blockInstanceId, sourceProduct, this.creationEnrichment.get(resourceId), sourceLocation));
       } else {
         var _this$fireAnalyticsEv6;
         // Delete the node from cache if fail to create so it's not flushed to BE
@@ -506,7 +508,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         // 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)));
+        (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 || _this$fireAnalyticsEv6.call(this, createErrorPayload('Fail to create bodied sync block', resourceId, getSourceProductFromResourceIdSafe(resourceId), undefined, this.getSourceLocation()));
       }
       // Enrichment is single-use — drop it once the create has resolved either way.
       this.creationEnrichment.delete(resourceId || '');
@@ -628,7 +630,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
             (_this5$createExperien2 = _this5.createExperience) === null || _this5$createExperien2 === void 0 || _this5$createExperien2.failure({
               reason: result.error || 'Failed to create bodied sync block'
             });
-            (_this5$fireAnalyticsE = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE === void 0 || _this5$fireAnalyticsE.call(_this5, createErrorPayload(result.error || 'Failed to create bodied sync block', resourceId, getSourceProductFromResourceIdSafe(resourceId), buildErrorAttribution(result.error, result.statusCode)));
+            (_this5$fireAnalyticsE = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE === void 0 || _this5$fireAnalyticsE.call(_this5, createErrorPayload(result.error || 'Failed to create bodied sync block', resourceId, getSourceProductFromResourceIdSafe(resourceId), buildErrorAttribution(result.error, result.statusCode), _this5.getSourceLocation()));
           }
         }).catch(function (error) {
           var _this5$createExperien3, _this5$fireAnalyticsE2;
@@ -639,7 +641,7 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
           (_this5$createExperien3 = _this5.createExperience) === null || _this5$createExperien3 === void 0 || _this5$createExperien3.failure({
             reason: error.message
           });
-          (_this5$fireAnalyticsE2 = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE2 === void 0 || _this5$fireAnalyticsE2.call(_this5, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId)));
+          (_this5$fireAnalyticsE2 = _this5.fireAnalyticsEvent) === null || _this5$fireAnalyticsE2 === void 0 || _this5$fireAnalyticsE2.call(_this5, createErrorPayload(error.message, resourceId, getSourceProductFromResourceIdSafe(resourceId), undefined, _this5.getSourceLocation()));
         }).finally(function () {
           _this5.pendingCreationPromises.delete(resourceId);
         });
@@ -653,9 +655,15 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv8 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv8 === void 0 || _this$fireAnalyticsEv8.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), undefined, this.getSourceLocation()));
       }
     }
+  }, {
+    key: "getSourceLocation",
+    value: function getSourceLocation() {
+      var _this$dataProvider2, _this$dataProvider2$g;
+      return _getSourceLocation((_this$dataProvider2 = this.dataProvider) === null || _this$dataProvider2 === void 0 || (_this$dataProvider2$g = _this$dataProvider2.getParentAri) === null || _this$dataProvider2$g === void 0 ? void 0 : _this$dataProvider2$g.call(_this$dataProvider2));
+    }
   }, {
     key: "pruneRecentDeleteEmissions",
     value:

package/dist/esm/utils/errorHandling.js

@@ -212,18 +212,20 @@ export var buildFetchErrorAttribution = function buildFetchErrorAttribution(erro
  * buckets like `source_deleted` they never emit.
  */
 
-export function getErrorPayload(actionSubjectId, error, resourceId, sourceProduct, attribution) {
+export function getErrorPayload(actionSubjectId, error, resourceId, sourceProduct, attribution, sourceLocation) {
   return {
     action: ACTION.ERROR,
     actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
     actionSubjectId: actionSubjectId,
     eventType: EVENT_TYPE.OPERATIONAL,
-    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
+    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
       error: error
     }, resourceId && {
       resourceId: resourceId
     }), sourceProduct && {
       sourceProduct: sourceProduct
+    }), sourceLocation && {
+      sourceLocation: sourceLocation
     }), (attribution === null || attribution === void 0 ? void 0 : attribution.reason) && {
       reason: attribution.reason
     }), (attribution === null || attribution === void 0 ? void 0 : attribution.statusCode) !== undefined && {
@@ -243,8 +245,8 @@ export var fetchErrorPayload = function fetchErrorPayload(error, resourceId, sou
     attribution ? getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_FETCH, error, resourceId, sourceProduct, attribution) : getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_FETCH, error, resourceId, sourceProduct)
   );
 };
-export var getSourceInfoErrorPayload = function getSourceInfoErrorPayload(error, resourceId, sourceProduct) {
-  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_GET_SOURCE_INFO, error, resourceId, sourceProduct);
+export var getSourceInfoErrorPayload = function getSourceInfoErrorPayload(error, resourceId, sourceProduct, sourceLocation) {
+  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_GET_SOURCE_INFO, error, resourceId, sourceProduct, undefined, sourceLocation);
 };
 export var updateErrorPayload = function updateErrorPayload(error, resourceId, sourceProduct, attribution) {
   return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE, error, resourceId, sourceProduct, attribution);
@@ -252,8 +254,8 @@ export var updateErrorPayload = function updateErrorPayload(error, resourceId, s
 export var updateReferenceErrorPayload = function updateReferenceErrorPayload(error, resourceId, sourceProduct, attribution) {
   return getErrorPayload(ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_UPDATE, error, resourceId, sourceProduct, attribution);
 };
-export var createErrorPayload = function createErrorPayload(error, resourceId, sourceProduct, attribution) {
-  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error, resourceId, sourceProduct, attribution);
+export var createErrorPayload = function createErrorPayload(error, resourceId, sourceProduct, attribution, sourceLocation) {
+  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error, resourceId, sourceProduct, attribution, sourceLocation);
 };
 export var deleteErrorPayload = function deleteErrorPayload(error, resourceId, sourceProduct, attribution) {
   return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_DELETE, error, resourceId, sourceProduct, attribution);
@@ -322,16 +324,18 @@ export var fetchSuccessPayload = function fetchSuccessPayload(resourceId, blockI
     })
   };
 };
-export var createSuccessPayload = function createSuccessPayload(resourceId, sourceProduct) {
+export var createSuccessPayload = function createSuccessPayload(resourceId, sourceProduct, sourceLocation) {
   return {
     action: ACTION.INSERTED,
     actionSubject: ACTION_SUBJECT.DOCUMENT,
     actionSubjectId: ACTION_SUBJECT_ID.BODIED_SYNCED_BLOCK,
     eventType: EVENT_TYPE.TRACK,
-    attributes: _objectSpread({
+    attributes: _objectSpread(_objectSpread({
       resourceId: resourceId
     }, sourceProduct && {
       sourceProduct: sourceProduct
+    }), sourceLocation && {
+      sourceLocation: sourceLocation
     })
   };
 };
@@ -348,14 +352,14 @@ export var createSuccessPayload = function createSuccessPayload(resourceId, sour
  * Operational `syncedBlockCreate` success event with the `blockInstanceId` join key and,
  * when available, the `inputMethod`, `createdEmpty`, and `nodeTypes` creation signals.
  */
-export var createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct, enrichment) {
+export var createSuccessOperationalPayload = function createSuccessOperationalPayload(resourceId, blockInstanceId, sourceProduct, enrichment, sourceLocation) {
   var _enrichment$nodeTypes;
   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(_objectSpread({
+    attributes: _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({
       resourceId: resourceId
     }, blockInstanceId && {
       blockInstanceId: blockInstanceId
@@ -367,6 +371,8 @@ export var createSuccessOperationalPayload = function createSuccessOperationalPa
       createdEmpty: enrichment.createdEmpty
     }), (enrichment === null || enrichment === void 0 || (_enrichment$nodeTypes = enrichment.nodeTypes) === null || _enrichment$nodeTypes === void 0 ? void 0 : _enrichment$nodeTypes.length) && {
       nodeTypes: enrichment.nodeTypes
+    }), sourceLocation && {
+      sourceLocation: sourceLocation
     })
   };
 };

package/dist/esm/utils/fieldAwareLocations.js

@@ -1,5 +1,7 @@
 import { isExperimentEnabled } from '@atlaskit/platform-feature-experiments/is-experiment-enabled';
-import { getLocationScope } from '../clients/block-service/ari';
+import { fg } from '@atlaskit/platform-feature-flags/fg';
+import { getLocationScope, getProductFromSourceAri } from '../clients/block-service/ari';
+import { JIRA_DESCRIPTION_FIELD_ID, parseJiraFieldLocation } from '../clients/jira/ari';
 /**
  * The product check runs first so a Confluence-only document never reads the experiment.
  */
@@ -21,4 +23,27 @@ export var getFieldAwareLocationScope = function getFieldAwareLocationScope(_ref
       hostAri: hostAri
     })
   } : undefined;
+};
+
+/**
+ * Analytics `sourceLocation` for a source ARI: `undefined` for non-Jira sources and for the
+ * control cohort, so events outside the experiment keep their current shape.
+ *
+ * The `platform_editor_blocks_patch_13` gate runs first: with it off this returns `undefined`
+ * without the product check or the experiment read, so no new exposure is logged.
+ */
+export var getSourceLocation = function getSourceLocation(sourceAri) {
+  if (!fg('platform_editor_blocks_patch_13')) {
+    return undefined;
+  }
+  if (!sourceAri || !isFieldAwareJiraLocation(getProductFromSourceAri(sourceAri))) {
+    return undefined;
+  }
+  var location = parseJiraFieldLocation({
+    ari: sourceAri
+  });
+  if (!location) {
+    return undefined;
+  }
+  return location.fieldId === JIRA_DESCRIPTION_FIELD_ID ? 'description' : 'custom-field';
 };

package/dist/types/clients/jira/ari.d.ts

@@ -26,6 +26,7 @@ export declare const getJiraWorkItemIdFromAri: ({ ari }: {
 export declare const getJiraIssueAriFromSourceAri: ({ ari }: {
     ari: string;
 }) => string;
+export declare const JIRA_DESCRIPTION_FIELD_ID = "description";
 /**
  * One synced block location on a Jira work item, parsed once from its document ARI.
  * Two locations name the same field when both members match, whichever of the two ARI

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

@@ -12,6 +12,8 @@ export type SyncBlockStatus = 'active' | 'deleted' | 'unpublished';
  * `same-parent-document` is another field of the host work item.
  */
 export type SyncBlockLocationScope = 'same-document' | 'same-parent-document' | 'elsewhere';
+/** Which Jira work item field holds a source block. */
+export type SyncBlockSourceLocation = 'description' | 'custom-field';
 export type SyncBlockAttrs = {
     localId: BlockInstanceId;
     resourceId: ResourceId;

package/dist/types/providers/syncBlockProvider.d.ts

@@ -69,6 +69,7 @@ export declare class SyncedBlockProvider extends SyncBlockDataProviderInterface
      * @returns The source info
      */
     fetchSyncBlockSourceInfo(localId?: BlockInstanceId, sourceAri?: string, sourceProduct?: SyncBlockProduct, hasAccess?: boolean): Promise<SyncBlockSourceInfo | undefined>;
+    getParentAri(): string | undefined;
     generateResourceId(): {
         localId: BlockInstanceId;
         resourceId: ResourceId;

package/dist/types/providers/types.d.ts

@@ -205,6 +205,10 @@ export declare abstract class SyncBlockDataProviderInterface extends NodeDataPro
     abstract fetchSyncBlockSourceInfo(localId?: BlockInstanceId, sourceAri?: string, sourceProduct?: SyncBlockProduct, hasAccess?: boolean): Promise<SyncBlockSourceInfo | undefined>;
     abstract setProviderOptions(providerOptions: SyncedBlockRendererProviderOptions): void;
     abstract getSyncedBlockRendererProviderOptions(): SyncedBlockRendererProviderOptions;
+    /**
+     * ARI of the document that new source blocks are created in, when a write provider is set.
+     */
+    getParentAri?(): string | undefined;
     abstract retrieveSyncBlockParentInfo(sourceAri: string, sourceProduct: SyncBlockProduct): SyncBlockParentInfo | undefined;
     /**
      * Generates a resource ID for source synced block.

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

@@ -144,6 +144,7 @@ export declare class SourceSyncBlockStoreManager {
      *   first-content-added event.
      */
     createBodiedSyncBlockNode(attrs: SyncBlockAttrs, node: PMNode, onCompletion: OnCompletion, enrichment?: CreateSuccessEnrichment): void;
+    private getSourceLocation;
     private setPendingDeletion;
     /**
      * Drop dedupe entries older than {@link DELETE_DEDUPE_WINDOW_MS} so

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

@@ -3,7 +3,7 @@ import type { INPUT_METHOD } from '@atlaskit/editor-common/analytics/types/enums
 import type { RendererSyncBlockEventPayload, SyncBlockEventPayload } from '@atlaskit/editor-common/analytics/types/sync-block-events';
 import type { OperationalAEP } from '@atlaskit/editor-common/analytics/types/utils';
 import { SyncBlockError } from '../common/types';
-import type { DeletionMechanism, DeletionReason } from '../common/types';
+import type { DeletionMechanism, DeletionReason, SyncBlockSourceLocation } from '../common/types';
 export declare const stringifyError: (error: unknown) => string | undefined;
 /**
  * PII-safe extraction of `message`/`name` from an unknown caught error, used to
@@ -134,27 +134,29 @@ export declare const buildFetchErrorAttribution: (error?: string, statusCode?: n
  * {@link SyncBlockErrorReason}, so write-path payloads never claim to carry fetch-only
  * buckets like `source_deleted` they never emit.
  */
-export declare function getErrorPayload<T extends ACTION_SUBJECT_ID>(actionSubjectId: T, error: string, resourceId: string | undefined, sourceProduct: string | undefined, attribution: FetchErrorAttributionAttributes): OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, T, {
+export declare function getErrorPayload<T extends ACTION_SUBJECT_ID>(actionSubjectId: T, error: string, resourceId: string | undefined, sourceProduct: string | undefined, attribution: FetchErrorAttributionAttributes, sourceLocation?: SyncBlockSourceLocation): OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, T, {
     error: string;
     resourceId?: string;
     sourceProduct?: string;
+    sourceLocation?: SyncBlockSourceLocation;
     reason?: SyncBlockFetchErrorReason;
     statusCode?: number;
     benign?: boolean;
     deferred?: boolean;
 }>;
-export declare function getErrorPayload<T extends ACTION_SUBJECT_ID>(actionSubjectId: T, error: string, resourceId?: string, sourceProduct?: string, attribution?: ErrorAttributionAttributes): OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, T, {
+export declare function getErrorPayload<T extends ACTION_SUBJECT_ID>(actionSubjectId: T, error: string, resourceId?: string, sourceProduct?: string, attribution?: ErrorAttributionAttributes, sourceLocation?: SyncBlockSourceLocation): OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, T, {
     error: string;
     resourceId?: string;
     sourceProduct?: string;
+    sourceLocation?: SyncBlockSourceLocation;
     reason?: SyncBlockErrorReason;
     statusCode?: number;
 }>;
 export declare const fetchErrorPayload: (error: string, resourceId?: string, sourceProduct?: string, attribution?: FetchErrorAttributionAttributes) => RendererSyncBlockEventPayload;
-export declare const getSourceInfoErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => RendererSyncBlockEventPayload;
+export declare const getSourceInfoErrorPayload: (error: string, resourceId?: string, sourceProduct?: string, sourceLocation?: SyncBlockSourceLocation) => RendererSyncBlockEventPayload;
 export declare const updateErrorPayload: (error: string, resourceId?: string, sourceProduct?: string, attribution?: ErrorAttributionAttributes) => SyncBlockEventPayload;
 export declare const updateReferenceErrorPayload: (error: string, resourceId?: string, sourceProduct?: string, attribution?: ErrorAttributionAttributes) => RendererSyncBlockEventPayload;
-export declare const createErrorPayload: (error: string, resourceId?: string, sourceProduct?: string, attribution?: ErrorAttributionAttributes) => SyncBlockEventPayload;
+export declare const createErrorPayload: (error: string, resourceId?: string, sourceProduct?: string, attribution?: ErrorAttributionAttributes, sourceLocation?: SyncBlockSourceLocation) => SyncBlockEventPayload;
 export declare const deleteErrorPayload: (error: string, resourceId?: string, sourceProduct?: string, attribution?: ErrorAttributionAttributes) => SyncBlockEventPayload;
 export declare const updateCacheErrorPayload: (error: string, resourceId?: string, sourceProduct?: string) => SyncBlockEventPayload;
 /**
@@ -173,7 +175,7 @@ export declare const sourceInfoOrphanedPayload: (resourceId?: string, sourceProd
 export declare const cacheDeletionForcedPayload: (rescheduleCount: number, resourceId?: string, sourceProduct?: string) => RendererSyncBlockEventPayload;
 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 createSuccessPayload: (resourceId: string, sourceProduct?: string, sourceLocation?: SyncBlockSourceLocation) => SyncBlockEventPayload;
 /**
  * Optional enrichment for the `syncedBlockCreate` success event. All fields
  * optional so legacy payloads are unchanged. `inputMethod`: creating
@@ -190,7 +192,7 @@ export type CreateSuccessEnrichment = {
  * Operational `syncedBlockCreate` success event with the `blockInstanceId` join key and,
  * when available, the `inputMethod`, `createdEmpty`, and `nodeTypes` creation signals.
  */
-export declare const createSuccessOperationalPayload: (resourceId: string, blockInstanceId?: string, sourceProduct?: string, enrichment?: CreateSuccessEnrichment) => SyncBlockEventPayload;
+export declare const createSuccessOperationalPayload: (resourceId: string, blockInstanceId?: string, sourceProduct?: string, enrichment?: CreateSuccessEnrichment, sourceLocation?: SyncBlockSourceLocation) => SyncBlockEventPayload;
 /**
  * Operational first-content-added event. Fired once when a block created empty first
  * gains user content. Join keys only (`resourceId` + `blockInstanceId`), no user

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

@@ -1,4 +1,4 @@
-import type { SyncBlockLocationScope, SyncBlockProduct } from '../common/types';
+import type { SyncBlockLocationScope, SyncBlockProduct, SyncBlockSourceLocation } from '../common/types';
 /**
  * The product check runs first so a Confluence-only document never reads the experiment.
  */
@@ -14,3 +14,11 @@ export declare const getFieldAwareLocationScope: ({ documentAri, hostAri, produc
 }) => {
     locationScope: SyncBlockLocationScope;
 } | undefined;
+/**
+ * Analytics `sourceLocation` for a source ARI: `undefined` for non-Jira sources and for the
+ * control cohort, so events outside the experiment keep their current shape.
+ *
+ * The `platform_editor_blocks_patch_13` gate runs first: with it off this returns `undefined`
+ * without the product check or the experiment read, so no new exposure is logged.
+ */
+export declare const getSourceLocation: (sourceAri: string | undefined) => SyncBlockSourceLocation | undefined;

package/package.json

@@ -42,11 +42,16 @@
 		"react-dom": "^19.2.0"
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "23.0.5",
+	"version": "23.1.0",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
+	},
+	"platform-feature-flags": {
+		"platform_editor_blocks_patch_13": {
+			"type": "boolean"
+		}
 	}
 }