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

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/block-service/blockServiceAPI.d.ts

@@ -49,6 +49,8 @@ export declare const writeDataBatch: (cloudId: string, parentAri: string | undef
 interface BlockServiceADFFetchProviderProps {
     cloudId: string;
     parentAri: string | undefined;
+    parentId?: string;
+    product?: SyncBlockProduct;
 }
 /**
  * ADFFetchProvider implementation that fetches synced block data from Block Service API
@@ -56,7 +58,10 @@ interface BlockServiceADFFetchProviderProps {
 declare class BlockServiceADFFetchProvider implements ADFFetchProvider {
     private cloudId;
     private parentAri;
-    constructor({ cloudId, parentAri }: BlockServiceADFFetchProviderProps);
+    private parentId?;
+    private product?;
+    constructor({ cloudId, parentAri, parentId, product }: BlockServiceADFFetchProviderProps);
+    generateResourceIdForReference(sourceId: ResourceId): ResourceId;
     fetchData(resourceId: string): Promise<SyncBlockInstance>;
     fetchReferences(referenceResourceId: string): Promise<ReferenceSyncBlockData>;
     /**
@@ -116,11 +121,13 @@ export declare const useMemoizedBlockServiceAPIProviders: ({ cloudId, parentAri,
 interface BlockServiceFetchOnlyAPIProviderProps {
     cloudId: string;
     parentAri: string | undefined;
+    parentId?: string;
+    product?: SyncBlockProduct;
 }
 /**
  * If the parentAri is not a valid ARI, pass in an empty string.
  */
-export declare const useMemoizedBlockServiceFetchOnlyAPIProvider: ({ cloudId, parentAri, }: BlockServiceFetchOnlyAPIProviderProps) => {
+export declare const useMemoizedBlockServiceFetchOnlyAPIProvider: ({ cloudId, parentAri, parentId, product, }: BlockServiceFetchOnlyAPIProviderProps) => {
     fetchProvider: BlockServiceADFFetchProvider;
     writeProvider: undefined;
 };

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

@@ -69,11 +69,11 @@ 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;
     };
-    canGenerateResourceIdForReference(): boolean;
     generateResourceIdForReference(sourceId: ResourceId): ResourceId;
     /**
      * Get the synced block renderer provider options

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

@@ -151,6 +151,8 @@ export interface ADFFetchProvider {
     batchFetchData: (blockNodeIdentifiers: BlockNodeIdentifiers[], config?: BatchFetchConfig) => Promise<SyncBlockInstance[]>;
     fetchData: (resourceId: ResourceId) => Promise<SyncBlockInstance>;
     fetchReferences: (referenceResourceId: string) => Promise<ReferenceSyncBlockData>;
+    /** Returns an unscoped sourceId when the host document identity is unavailable. */
+    generateResourceIdForReference?: (sourceId: ResourceId) => ResourceId;
     /**
      * Subscribes to real-time updates for a specific block.
      */
@@ -205,6 +207,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.
@@ -220,7 +226,6 @@ export declare abstract class SyncBlockDataProviderInterface extends NodeDataPro
      * @returns The generated resource ID
      */
     abstract generateResourceIdForReference(sourceId: ResourceId): ResourceId;
-    canGenerateResourceIdForReference?(): boolean;
     abstract updateReferenceData(blocks: SyncBlockAttrs[], noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
     abstract fetchReferences(resourceId: string, isSource: boolean): Promise<ReferenceSyncBlockData>;
     /**

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

@@ -33,7 +33,7 @@
 		"uuid": "^11.1.1"
 	},
 	"peerDependencies": {
-		"@atlaskit/editor-common": "^131.2.0",
+		"@atlaskit/editor-common": "^131.6.0",
 		"react": "^18.2.0 || ^19.2.0"
 	},
 	"devDependencies": {
@@ -42,11 +42,16 @@
 		"react-dom": "^19.2.0"
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "23.0.5",
+	"version": "23.1.1",
 	"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"
+		}
 	}
 }