@atlaskit/editor-synced-block-provider 2.10.5 → 2.11.0

package/dist/esm/utils/errorHandling.js

@@ -1,7 +1,37 @@
+import { ACTION, ACTION_SUBJECT, EVENT_TYPE, ACTION_SUBJECT_ID } from "@atlaskit/editor-common/analytics";
 export var stringifyError = function stringifyError(error) {
   try {
     return JSON.stringify(error);
   } catch (_unused) {
     return undefined;
   }
+};
+export var getErrorPayload = function getErrorPayload(actionSubjectId, error) {
+  return {
+    action: ACTION.ERROR,
+    actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
+    actionSubjectId: actionSubjectId,
+    eventType: EVENT_TYPE.OPERATIONAL,
+    attributes: {
+      error: error
+    }
+  };
+};
+export var fetchErrorPayload = function fetchErrorPayload(error) {
+  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_FETCH, error);
+};
+export var getSourceInfoErrorPayload = function getSourceInfoErrorPayload(error) {
+  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_GET_SOURCE_INFO, error);
+};
+export var updateErrorPayload = function updateErrorPayload(error) {
+  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE, error);
+};
+export var createErrorPayload = function createErrorPayload(error) {
+  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error);
+};
+export var deleteErrorPayload = function deleteErrorPayload(error) {
+  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_DELETE, error);
+};
+export var updateCacheErrorPayload = function updateCacheErrorPayload(error) {
+  return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE_CACHE, error);
 };

package/dist/types/clients/block-service/blockService.d.ts

@@ -3,10 +3,8 @@ export type BlockContentResponse = {
     blockAri: string;
     blockInstanceId: string;
     content: string;
-    contentUpdatedAt: number;
     createdAt: number;
     createdBy: string;
-    isSynced: boolean;
     product: SyncBlockProduct;
     sourceAri: string;
     status: 'active' | 'deleted';

package/dist/types/clients/confluence/sourceInfo.d.ts

@@ -1,2 +1,3 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { SyncBlockSourceInfo } from '../../providers/types';
-export declare const fetchConfluenceSourceInfo: (pageAri: string, localId?: string) => Promise<SyncBlockSourceInfo | undefined>;
+export declare const fetchConfluencePageInfo: (pageAri: string, localId?: string, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void) => Promise<SyncBlockSourceInfo | undefined>;

package/dist/types/hooks/useFetchSyncBlockData.d.ts

@@ -1,3 +1,4 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
 import type { SyncBlockInstance } from '../providers/types';
 import type { SyncBlockStoreManager } from '../store-manager/syncBlockStoreManager';
@@ -7,4 +8,4 @@ export interface UseFetchSyncBlockDataResult {
     reloadData: () => Promise<void>;
     syncBlockInstance: SyncBlockInstance | null;
 }
-export declare const useFetchSyncBlockData: (manager: SyncBlockStoreManager, resourceId?: string, localId?: string) => UseFetchSyncBlockDataResult;
+export declare const useFetchSyncBlockData: (manager: SyncBlockStoreManager, resourceId?: string, localId?: string, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void) => UseFetchSyncBlockDataResult;

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 export { rebaseTransaction } from './common/rebase-transaction';
 export { SyncBlockError } from './common/types';
-export type { SyncBlockData, SyncBlockNode } from './common/types';
+export type { SyncBlockData, SyncBlockNode, SyncBlockProduct, BlockInstanceId, } from './common/types';
 export { useFetchSyncBlockData, type UseFetchSyncBlockDataResult, } from './hooks/useFetchSyncBlockData';
 export { useFetchSyncBlockTitle } from './hooks/useFetchSyncBlockTitle';
 export { useHandleContentChanges } from './hooks/useHandleContentChanges';
@@ -8,7 +8,7 @@ export { blockResourceIdFromSourceAndLocalId, getLocalIdFromBlockResourceId, } f
 export { getConfluencePageAri, getLocalIdFromConfluencePageAri, getPageARIFromContentPropertyResourceId, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId, } from './clients/confluence/ari';
 export { useMemoizedBlockServiceAPIProviders } from './providers/block-service/blockServiceAPI';
 export { createContentAPIProvidersWithDefaultKey, useMemoizedContentAPIProviders, } from './providers/confluence/confluenceContentAPI';
-export { fetchConfluenceSourceInfo } from './clients/confluence/sourceInfo';
+export { fetchConfluencePageInfo } from './clients/confluence/sourceInfo';
 export { SyncBlockProvider as SyncedBlockProvider, useMemoizedSyncedBlockProvider, } from './providers/syncBlockProvider';
 export type { ADFFetchProvider, ADFWriteProvider, SyncBlockDataProvider, SyncBlockInstance, MediaEmojiProviderOptions, SyncedBlockRendererProviderOptions, SyncBlockRendererProviderCreator, } from './providers/types';
 export { ReferenceSyncBlockStoreManager } from './store-manager/referenceSyncBlockStoreManager';

package/dist/types/providers/block-service/blockServiceAPI.d.ts

@@ -1,21 +1,23 @@
-import { type ResourceId, type SyncBlockData } from '../../common/types';
-import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SourceInfoFetchData, SyncBlockInstance, WriteSyncBlockResult } from '../types';
+import { type SyncBlockData, type SyncBlockProduct } from '../../common/types';
+import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, WriteSyncBlockResult } from '../types';
 /**
  * ADFFetchProvider implementation that fetches synced block data from Block Service API
  */
 declare class BlockServiceADFFetchProvider implements ADFFetchProvider {
     fetchData(resourceId: string): Promise<SyncBlockInstance>;
-    retrieveSourceInfoFetchData(resourceId: ResourceId, pageARI: string): SourceInfoFetchData;
 }
 /**
  * ADFWriteProvider implementation that writes synced block data to Block Service API
  */
 declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
+    private sourceAri;
+    private product;
+    constructor(sourceAri: string, product: SyncBlockProduct);
     writeData(data: SyncBlockData): Promise<WriteSyncBlockResult>;
     deleteData(resourceId: string): Promise<DeleteSyncBlockResult>;
-    generateResourceId(sourceId: string, localId: string): string;
+    generateResourceId(sourceAri: string, localId: string): string;
 }
-export declare const useMemoizedBlockServiceAPIProviders: () => {
+export declare const useMemoizedBlockServiceAPIProviders: (sourceAri: string, product: SyncBlockProduct) => {
     fetchProvider: BlockServiceADFFetchProvider;
     writeProvider: BlockServiceADFWriteProvider;
 };

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

@@ -1,5 +1,5 @@
-import { type ResourceId, type SyncBlockData } from '../../common/types';
-import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SourceInfoFetchData, SyncBlockInstance, WriteSyncBlockResult } from '../types';
+import { type SyncBlockData } from '../../common/types';
+import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, WriteSyncBlockResult } from '../types';
 /**
  * Configuration for Content API providers
  */
@@ -14,7 +14,6 @@ declare class ConfluenceADFFetchProvider implements ADFFetchProvider {
     private config;
     constructor(config: ContentAPIConfig);
     fetchData(resourceId: string): Promise<SyncBlockInstance>;
-    retrieveSourceInfoFetchData(resourceId: ResourceId): SourceInfoFetchData;
 }
 /**
  * ADFWriteProvider implementation that writes synced block data to Confluence Content API

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

@@ -1,5 +1,6 @@
+import type { RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { JSONNode } from '@atlaskit/editor-json-transformer/types';
-import { type SyncBlockData, type SyncBlockNode } from '../common/types';
+import { type BlockInstanceId, type ResourceId, type SyncBlockData, type SyncBlockNode, type SyncBlockProduct } from '../common/types';
 import { SyncBlockDataProvider, type ADFFetchProvider, type ADFWriteProvider, type DeleteSyncBlockResult, type SyncBlockInstance, type SyncBlockParentInfo, type SyncBlockSourceInfo, type SyncedBlockRendererProviderOptions, type WriteSyncBlockResult } from '../providers/types';
 export declare class SyncBlockProvider extends SyncBlockDataProvider {
     name: string;
@@ -57,7 +58,7 @@ export declare class SyncBlockProvider extends SyncBlockDataProvider {
      *
      * @returns Array of {resourceId?: string, error?: string}.
      */
-    deleteNodesData(resourceIds: string[]): Promise<Array<DeleteSyncBlockResult>>;
+    deleteNodesData(resourceIds: ResourceId[]): Promise<Array<DeleteSyncBlockResult>>;
     /**
      * Get the source id
      *
@@ -65,14 +66,16 @@ export declare class SyncBlockProvider extends SyncBlockDataProvider {
      */
     getSourceId(): string;
     /**
-     * Retrieve the source info from the source id
+     * Fetch the source info from the source id
      *
-     * @param node
+     * @param params
+     * @param params.sourceAri - The source ARI
+     * @param params.sourceProduct - The source product. e.g. 'confluence-page', 'jira-work-item'
      *
      * @returns The source info
      */
-    retrieveSyncBlockSourceInfo(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
-    generateResourceId(sourceId: string, localId: string): string;
+    fetchSyncBlockSourceInfo(localId: BlockInstanceId, sourceAri: string, sourceProduct: SyncBlockProduct, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void): Promise<SyncBlockSourceInfo | undefined>;
+    generateResourceId(sourceId: string, localId: BlockInstanceId): string;
     /**
      * Get the synced block renderer provider options
      *
@@ -82,11 +85,11 @@ export declare class SyncBlockProvider extends SyncBlockDataProvider {
     /**
      * Retrieve the parent info for the sync block
      *
-     * @param resourceId
-     * @param syncBlockInstance
+     * @param sourceAri - The source ARI
+     * @param sourceProduct - The source product. e.g. 'confluence-page', 'jira-work-item'
      *
      * @returns The parent info for the sync block
      */
-    retrieveSyncBlockParentInfo(syncBlockInstance: SyncBlockInstance | undefined): SyncBlockParentInfo | undefined;
+    retrieveSyncBlockParentInfo(sourceAri: string, sourceProduct: SyncBlockProduct): SyncBlockParentInfo | undefined;
 }
 export declare const useMemoizedSyncedBlockProvider: (fetchProvider: ADFFetchProvider, writeProvider: ADFWriteProvider, sourceId: string, providerOptions: SyncedBlockRendererProviderOptions) => SyncBlockProvider;

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

@@ -1,9 +1,10 @@
+import type { RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { MediaProvider, ProfilecardProvider } from '@atlaskit/editor-common/provider-factory';
 import type { EmojiProvider } from '@atlaskit/emoji';
 import type { MentionProvider } from '@atlaskit/mention/types';
 import { NodeDataProvider } from '@atlaskit/node-data-provider';
 import type { TaskDecisionProvider } from '@atlaskit/task-decision/types';
-import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBlockProduct } from '../common/types';
+import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBlockProduct, BlockInstanceId } from '../common/types';
 /**
  * The instance of a sync block, containing its data and metadata.
  * Mainly used for representing the state of a sync block after fetching from a data provider.
@@ -12,11 +13,11 @@ import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBloc
 export type SyncBlockInstance = {
     data?: SyncBlockData;
     error?: SyncBlockError;
-    resourceId: string;
+    resourceId: ResourceId;
 };
 export type DeleteSyncBlockResult = {
     error?: string;
-    resourceId: string;
+    resourceId: ResourceId;
     success: boolean;
 };
 export type SyncBlockSourceInfo = {
@@ -29,7 +30,7 @@ export type SyncBlockParentInfo = {
 };
 export type WriteSyncBlockResult = {
     error?: string;
-    resourceId?: string;
+    resourceId?: ResourceId;
 };
 export type SourceInfoFetchData = {
     pageARI: string;
@@ -37,10 +38,9 @@ export type SourceInfoFetchData = {
 };
 export interface ADFFetchProvider {
     fetchData: (resourceId: ResourceId) => Promise<SyncBlockInstance>;
-    retrieveSourceInfoFetchData: (resourceId: ResourceId, pageAri: string) => SourceInfoFetchData;
 }
 export interface ADFWriteProvider {
-    deleteData: (resourceId: string) => Promise<DeleteSyncBlockResult>;
+    deleteData: (resourceId: ResourceId) => Promise<DeleteSyncBlockResult>;
     generateResourceId: (sourceId: string, localId: string) => ResourceId;
     writeData: (data: SyncBlockData) => Promise<WriteSyncBlockResult>;
 }
@@ -65,16 +65,16 @@ export declare abstract class SyncBlockDataProvider extends NodeDataProvider<Syn
     abstract writeNodesData(nodes: SyncBlockNode[], data: SyncBlockData[]): Promise<Array<WriteSyncBlockResult>>;
     abstract deleteNodesData(resourceIds: string[]): Promise<Array<DeleteSyncBlockResult>>;
     abstract getSourceId(): ResourceId;
-    abstract retrieveSyncBlockSourceInfo(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
+    abstract fetchSyncBlockSourceInfo(localId: BlockInstanceId, sourceAri: string, sourceProduct: SyncBlockProduct, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void): Promise<SyncBlockSourceInfo | undefined>;
     abstract getSyncedBlockRendererProviderOptions(): SyncedBlockRendererProviderOptions;
-    abstract retrieveSyncBlockParentInfo(syncBlockInstance: SyncBlockInstance | undefined): SyncBlockParentInfo | undefined;
+    abstract retrieveSyncBlockParentInfo(sourceAri: string, sourceProduct: SyncBlockProduct): SyncBlockParentInfo | undefined;
     /**
      * Generates a resource ID from a source ID and local ID.
      * @param sourceId - The source document ID (e.g., page ARI)
      * @param localId - The local block ID (usually a UUID)
      * @returns The generated resource ID
      */
-    abstract generateResourceId(sourceId: ResourceId, localId: string): ResourceId;
+    abstract generateResourceId(sourceId: ResourceId, localId: BlockInstanceId): ResourceId;
 }
 export type SubscriptionCallback = (data: SyncBlockInstance) => void;
 export type TitleSubscriptionCallback = (title: string) => void;

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

@@ -1,3 +1,4 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import { type ResourceId, type SyncBlockNode } from '../common/types';
@@ -8,21 +9,24 @@ export declare class ReferenceSyncBlockStoreManager {
     private subscriptions;
     private titleSubscriptions;
     private providerFactories;
+    private fireAnalyticsEvent?;
     private syncBlockURLRequests;
     private isRefreshingSubscriptions;
-    constructor(dataProvider?: SyncBlockDataProvider);
+    constructor(dataProvider?: SyncBlockDataProvider, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void);
+    updateFireAnalyticsEvent(fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void): void;
     /**
      * Refreshes the subscriptions for all sync blocks.
      * @returns {Promise<void>}
      */
     refreshSubscriptions(): Promise<void>;
-    private retrieveSyncBlockSourceInfo;
+    private fetchSyncBlockSourceInfo;
     /**
      * Fetch sync block data for a given array of sync block nodes.
      * @param syncBlockNodes - The array of sync block nodes to fetch data for
      * @returns The fetched sync block data results
      */
     fetchSyncBlocksData(syncBlockNodes: SyncBlockNode[]): Promise<SyncBlockInstance[]>;
+    private updateCacheWithSourceInfo;
     private updateCache;
     private updateSourceTitleSubscriptions;
     private getFromCache;

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

@@ -1,3 +1,4 @@
+import { type SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { EditorState, Transaction } from '@atlaskit/editor-prosemirror/state';
 import type { EditorView } from '@atlaskit/editor-prosemirror/view';
@@ -8,12 +9,13 @@ export type CreationCallback = () => void;
 export declare class SourceSyncBlockStoreManager {
     private dataProvider?;
     private editorView?;
+    private fireAnalyticsEvent?;
     private syncBlockCache;
     private confirmationCallback?;
     private confirmationTransaction?;
     private pendingResourceId?;
     private creationCallback?;
-    constructor(dataProvider?: SyncBlockDataProvider);
+    constructor(dataProvider?: SyncBlockDataProvider, fireAnalyticsEvent?: (payload: SyncBlockEventPayload) => void);
     isSourceBlock(node: PMNode): boolean;
     /**
      * Add/update a sync block node to/from the local cache

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

@@ -1,10 +1,11 @@
+import type { SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { SyncBlockDataProvider } from '../providers/types';
 import { ReferenceSyncBlockStoreManager } from './referenceSyncBlockStoreManager';
 import { SourceSyncBlockStoreManager } from './sourceSyncBlockStoreManager';
 export declare class SyncBlockStoreManager {
     private referenceSyncBlockStoreManager;
     private sourceSyncBlockStoreManager;
-    constructor(dataProvider?: SyncBlockDataProvider);
+    constructor(dataProvider?: SyncBlockDataProvider, fireAnalyticsEvent?: (payload: SyncBlockEventPayload) => void);
     get referenceManager(): ReferenceSyncBlockStoreManager;
     get sourceManager(): SourceSyncBlockStoreManager;
     destroy(): void;

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

@@ -1 +1,11 @@
+import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, type RendererSyncBlockEventPayload, type OperationalAEP, type SyncBlockEventPayload } from "@atlaskit/editor-common/analytics";
 export declare const stringifyError: (error: unknown) => string | undefined;
+export declare const getErrorPayload: <T extends ACTION_SUBJECT_ID>(actionSubjectId: T, error: string) => OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, T, {
+    error: string;
+}>;
+export declare const fetchErrorPayload: (error: string) => RendererSyncBlockEventPayload;
+export declare const getSourceInfoErrorPayload: (error: string) => RendererSyncBlockEventPayload;
+export declare const updateErrorPayload: (error: string) => SyncBlockEventPayload;
+export declare const createErrorPayload: (error: string) => SyncBlockEventPayload;
+export declare const deleteErrorPayload: (error: string) => SyncBlockEventPayload;
+export declare const updateCacheErrorPayload: (error: string) => SyncBlockEventPayload;

package/dist/types-ts4.5/clients/block-service/blockService.d.ts

@@ -3,10 +3,8 @@ export type BlockContentResponse = {
     blockAri: string;
     blockInstanceId: string;
     content: string;
-    contentUpdatedAt: number;
     createdAt: number;
     createdBy: string;
-    isSynced: boolean;
     product: SyncBlockProduct;
     sourceAri: string;
     status: 'active' | 'deleted';

package/dist/types-ts4.5/clients/confluence/sourceInfo.d.ts

@@ -1,2 +1,3 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { SyncBlockSourceInfo } from '../../providers/types';
-export declare const fetchConfluenceSourceInfo: (pageAri: string, localId?: string) => Promise<SyncBlockSourceInfo | undefined>;
+export declare const fetchConfluencePageInfo: (pageAri: string, localId?: string, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void) => Promise<SyncBlockSourceInfo | undefined>;

package/dist/types-ts4.5/hooks/useFetchSyncBlockData.d.ts

@@ -1,3 +1,4 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
 import type { SyncBlockInstance } from '../providers/types';
 import type { SyncBlockStoreManager } from '../store-manager/syncBlockStoreManager';
@@ -7,4 +8,4 @@ export interface UseFetchSyncBlockDataResult {
     reloadData: () => Promise<void>;
     syncBlockInstance: SyncBlockInstance | null;
 }
-export declare const useFetchSyncBlockData: (manager: SyncBlockStoreManager, resourceId?: string, localId?: string) => UseFetchSyncBlockDataResult;
+export declare const useFetchSyncBlockData: (manager: SyncBlockStoreManager, resourceId?: string, localId?: string, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void) => UseFetchSyncBlockDataResult;

package/dist/types-ts4.5/index.d.ts

@@ -1,6 +1,6 @@
 export { rebaseTransaction } from './common/rebase-transaction';
 export { SyncBlockError } from './common/types';
-export type { SyncBlockData, SyncBlockNode } from './common/types';
+export type { SyncBlockData, SyncBlockNode, SyncBlockProduct, BlockInstanceId, } from './common/types';
 export { useFetchSyncBlockData, type UseFetchSyncBlockDataResult, } from './hooks/useFetchSyncBlockData';
 export { useFetchSyncBlockTitle } from './hooks/useFetchSyncBlockTitle';
 export { useHandleContentChanges } from './hooks/useHandleContentChanges';
@@ -8,7 +8,7 @@ export { blockResourceIdFromSourceAndLocalId, getLocalIdFromBlockResourceId, } f
 export { getConfluencePageAri, getLocalIdFromConfluencePageAri, getPageARIFromContentPropertyResourceId, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId, } from './clients/confluence/ari';
 export { useMemoizedBlockServiceAPIProviders } from './providers/block-service/blockServiceAPI';
 export { createContentAPIProvidersWithDefaultKey, useMemoizedContentAPIProviders, } from './providers/confluence/confluenceContentAPI';
-export { fetchConfluenceSourceInfo } from './clients/confluence/sourceInfo';
+export { fetchConfluencePageInfo } from './clients/confluence/sourceInfo';
 export { SyncBlockProvider as SyncedBlockProvider, useMemoizedSyncedBlockProvider, } from './providers/syncBlockProvider';
 export type { ADFFetchProvider, ADFWriteProvider, SyncBlockDataProvider, SyncBlockInstance, MediaEmojiProviderOptions, SyncedBlockRendererProviderOptions, SyncBlockRendererProviderCreator, } from './providers/types';
 export { ReferenceSyncBlockStoreManager } from './store-manager/referenceSyncBlockStoreManager';

package/dist/types-ts4.5/providers/block-service/blockServiceAPI.d.ts

@@ -1,21 +1,23 @@
-import { type ResourceId, type SyncBlockData } from '../../common/types';
-import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SourceInfoFetchData, SyncBlockInstance, WriteSyncBlockResult } from '../types';
+import { type SyncBlockData, type SyncBlockProduct } from '../../common/types';
+import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, WriteSyncBlockResult } from '../types';
 /**
  * ADFFetchProvider implementation that fetches synced block data from Block Service API
  */
 declare class BlockServiceADFFetchProvider implements ADFFetchProvider {
     fetchData(resourceId: string): Promise<SyncBlockInstance>;
-    retrieveSourceInfoFetchData(resourceId: ResourceId, pageARI: string): SourceInfoFetchData;
 }
 /**
  * ADFWriteProvider implementation that writes synced block data to Block Service API
  */
 declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
+    private sourceAri;
+    private product;
+    constructor(sourceAri: string, product: SyncBlockProduct);
     writeData(data: SyncBlockData): Promise<WriteSyncBlockResult>;
     deleteData(resourceId: string): Promise<DeleteSyncBlockResult>;
-    generateResourceId(sourceId: string, localId: string): string;
+    generateResourceId(sourceAri: string, localId: string): string;
 }
-export declare const useMemoizedBlockServiceAPIProviders: () => {
+export declare const useMemoizedBlockServiceAPIProviders: (sourceAri: string, product: SyncBlockProduct) => {
     fetchProvider: BlockServiceADFFetchProvider;
     writeProvider: BlockServiceADFWriteProvider;
 };

package/dist/types-ts4.5/providers/confluence/confluenceContentAPI.d.ts

@@ -1,5 +1,5 @@
-import { type ResourceId, type SyncBlockData } from '../../common/types';
-import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SourceInfoFetchData, SyncBlockInstance, WriteSyncBlockResult } from '../types';
+import { type SyncBlockData } from '../../common/types';
+import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, WriteSyncBlockResult } from '../types';
 /**
  * Configuration for Content API providers
  */
@@ -14,7 +14,6 @@ declare class ConfluenceADFFetchProvider implements ADFFetchProvider {
     private config;
     constructor(config: ContentAPIConfig);
     fetchData(resourceId: string): Promise<SyncBlockInstance>;
-    retrieveSourceInfoFetchData(resourceId: ResourceId): SourceInfoFetchData;
 }
 /**
  * ADFWriteProvider implementation that writes synced block data to Confluence Content API

package/dist/types-ts4.5/providers/syncBlockProvider.d.ts

@@ -1,5 +1,6 @@
+import type { RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { JSONNode } from '@atlaskit/editor-json-transformer/types';
-import { type SyncBlockData, type SyncBlockNode } from '../common/types';
+import { type BlockInstanceId, type ResourceId, type SyncBlockData, type SyncBlockNode, type SyncBlockProduct } from '../common/types';
 import { SyncBlockDataProvider, type ADFFetchProvider, type ADFWriteProvider, type DeleteSyncBlockResult, type SyncBlockInstance, type SyncBlockParentInfo, type SyncBlockSourceInfo, type SyncedBlockRendererProviderOptions, type WriteSyncBlockResult } from '../providers/types';
 export declare class SyncBlockProvider extends SyncBlockDataProvider {
     name: string;
@@ -57,7 +58,7 @@ export declare class SyncBlockProvider extends SyncBlockDataProvider {
      *
      * @returns Array of {resourceId?: string, error?: string}.
      */
-    deleteNodesData(resourceIds: string[]): Promise<Array<DeleteSyncBlockResult>>;
+    deleteNodesData(resourceIds: ResourceId[]): Promise<Array<DeleteSyncBlockResult>>;
     /**
      * Get the source id
      *
@@ -65,14 +66,16 @@ export declare class SyncBlockProvider extends SyncBlockDataProvider {
      */
     getSourceId(): string;
     /**
-     * Retrieve the source info from the source id
+     * Fetch the source info from the source id
      *
-     * @param node
+     * @param params
+     * @param params.sourceAri - The source ARI
+     * @param params.sourceProduct - The source product. e.g. 'confluence-page', 'jira-work-item'
      *
      * @returns The source info
      */
-    retrieveSyncBlockSourceInfo(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
-    generateResourceId(sourceId: string, localId: string): string;
+    fetchSyncBlockSourceInfo(localId: BlockInstanceId, sourceAri: string, sourceProduct: SyncBlockProduct, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void): Promise<SyncBlockSourceInfo | undefined>;
+    generateResourceId(sourceId: string, localId: BlockInstanceId): string;
     /**
      * Get the synced block renderer provider options
      *
@@ -82,11 +85,11 @@ export declare class SyncBlockProvider extends SyncBlockDataProvider {
     /**
      * Retrieve the parent info for the sync block
      *
-     * @param resourceId
-     * @param syncBlockInstance
+     * @param sourceAri - The source ARI
+     * @param sourceProduct - The source product. e.g. 'confluence-page', 'jira-work-item'
      *
      * @returns The parent info for the sync block
      */
-    retrieveSyncBlockParentInfo(syncBlockInstance: SyncBlockInstance | undefined): SyncBlockParentInfo | undefined;
+    retrieveSyncBlockParentInfo(sourceAri: string, sourceProduct: SyncBlockProduct): SyncBlockParentInfo | undefined;
 }
 export declare const useMemoizedSyncedBlockProvider: (fetchProvider: ADFFetchProvider, writeProvider: ADFWriteProvider, sourceId: string, providerOptions: SyncedBlockRendererProviderOptions) => SyncBlockProvider;

package/dist/types-ts4.5/providers/types.d.ts

@@ -1,9 +1,10 @@
+import type { RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { MediaProvider, ProfilecardProvider } from '@atlaskit/editor-common/provider-factory';
 import type { EmojiProvider } from '@atlaskit/emoji';
 import type { MentionProvider } from '@atlaskit/mention/types';
 import { NodeDataProvider } from '@atlaskit/node-data-provider';
 import type { TaskDecisionProvider } from '@atlaskit/task-decision/types';
-import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBlockProduct } from '../common/types';
+import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBlockProduct, BlockInstanceId } from '../common/types';
 /**
  * The instance of a sync block, containing its data and metadata.
  * Mainly used for representing the state of a sync block after fetching from a data provider.
@@ -12,11 +13,11 @@ import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBloc
 export type SyncBlockInstance = {
     data?: SyncBlockData;
     error?: SyncBlockError;
-    resourceId: string;
+    resourceId: ResourceId;
 };
 export type DeleteSyncBlockResult = {
     error?: string;
-    resourceId: string;
+    resourceId: ResourceId;
     success: boolean;
 };
 export type SyncBlockSourceInfo = {
@@ -29,7 +30,7 @@ export type SyncBlockParentInfo = {
 };
 export type WriteSyncBlockResult = {
     error?: string;
-    resourceId?: string;
+    resourceId?: ResourceId;
 };
 export type SourceInfoFetchData = {
     pageARI: string;
@@ -37,10 +38,9 @@ export type SourceInfoFetchData = {
 };
 export interface ADFFetchProvider {
     fetchData: (resourceId: ResourceId) => Promise<SyncBlockInstance>;
-    retrieveSourceInfoFetchData: (resourceId: ResourceId, pageAri: string) => SourceInfoFetchData;
 }
 export interface ADFWriteProvider {
-    deleteData: (resourceId: string) => Promise<DeleteSyncBlockResult>;
+    deleteData: (resourceId: ResourceId) => Promise<DeleteSyncBlockResult>;
     generateResourceId: (sourceId: string, localId: string) => ResourceId;
     writeData: (data: SyncBlockData) => Promise<WriteSyncBlockResult>;
 }
@@ -65,16 +65,16 @@ export declare abstract class SyncBlockDataProvider extends NodeDataProvider<Syn
     abstract writeNodesData(nodes: SyncBlockNode[], data: SyncBlockData[]): Promise<Array<WriteSyncBlockResult>>;
     abstract deleteNodesData(resourceIds: string[]): Promise<Array<DeleteSyncBlockResult>>;
     abstract getSourceId(): ResourceId;
-    abstract retrieveSyncBlockSourceInfo(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
+    abstract fetchSyncBlockSourceInfo(localId: BlockInstanceId, sourceAri: string, sourceProduct: SyncBlockProduct, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void): Promise<SyncBlockSourceInfo | undefined>;
     abstract getSyncedBlockRendererProviderOptions(): SyncedBlockRendererProviderOptions;
-    abstract retrieveSyncBlockParentInfo(syncBlockInstance: SyncBlockInstance | undefined): SyncBlockParentInfo | undefined;
+    abstract retrieveSyncBlockParentInfo(sourceAri: string, sourceProduct: SyncBlockProduct): SyncBlockParentInfo | undefined;
     /**
      * Generates a resource ID from a source ID and local ID.
      * @param sourceId - The source document ID (e.g., page ARI)
      * @param localId - The local block ID (usually a UUID)
      * @returns The generated resource ID
      */
-    abstract generateResourceId(sourceId: ResourceId, localId: string): ResourceId;
+    abstract generateResourceId(sourceId: ResourceId, localId: BlockInstanceId): ResourceId;
 }
 export type SubscriptionCallback = (data: SyncBlockInstance) => void;
 export type TitleSubscriptionCallback = (title: string) => void;

package/dist/types-ts4.5/store-manager/referenceSyncBlockStoreManager.d.ts

@@ -1,3 +1,4 @@
+import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import { type ResourceId, type SyncBlockNode } from '../common/types';
@@ -8,21 +9,24 @@ export declare class ReferenceSyncBlockStoreManager {
     private subscriptions;
     private titleSubscriptions;
     private providerFactories;
+    private fireAnalyticsEvent?;
     private syncBlockURLRequests;
     private isRefreshingSubscriptions;
-    constructor(dataProvider?: SyncBlockDataProvider);
+    constructor(dataProvider?: SyncBlockDataProvider, fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void);
+    updateFireAnalyticsEvent(fireAnalyticsEvent?: (payload: RendererSyncBlockEventPayload) => void): void;
     /**
      * Refreshes the subscriptions for all sync blocks.
      * @returns {Promise<void>}
      */
     refreshSubscriptions(): Promise<void>;
-    private retrieveSyncBlockSourceInfo;
+    private fetchSyncBlockSourceInfo;
     /**
      * Fetch sync block data for a given array of sync block nodes.
      * @param syncBlockNodes - The array of sync block nodes to fetch data for
      * @returns The fetched sync block data results
      */
     fetchSyncBlocksData(syncBlockNodes: SyncBlockNode[]): Promise<SyncBlockInstance[]>;
+    private updateCacheWithSourceInfo;
     private updateCache;
     private updateSourceTitleSubscriptions;
     private getFromCache;

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

@@ -1,3 +1,4 @@
+import { type SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { EditorState, Transaction } from '@atlaskit/editor-prosemirror/state';
 import type { EditorView } from '@atlaskit/editor-prosemirror/view';
@@ -8,12 +9,13 @@ export type CreationCallback = () => void;
 export declare class SourceSyncBlockStoreManager {
     private dataProvider?;
     private editorView?;
+    private fireAnalyticsEvent?;
     private syncBlockCache;
     private confirmationCallback?;
     private confirmationTransaction?;
     private pendingResourceId?;
     private creationCallback?;
-    constructor(dataProvider?: SyncBlockDataProvider);
+    constructor(dataProvider?: SyncBlockDataProvider, fireAnalyticsEvent?: (payload: SyncBlockEventPayload) => void);
     isSourceBlock(node: PMNode): boolean;
     /**
      * Add/update a sync block node to/from the local cache

package/dist/types-ts4.5/store-manager/syncBlockStoreManager.d.ts

@@ -1,10 +1,11 @@
+import type { SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { SyncBlockDataProvider } from '../providers/types';
 import { ReferenceSyncBlockStoreManager } from './referenceSyncBlockStoreManager';
 import { SourceSyncBlockStoreManager } from './sourceSyncBlockStoreManager';
 export declare class SyncBlockStoreManager {
     private referenceSyncBlockStoreManager;
     private sourceSyncBlockStoreManager;
-    constructor(dataProvider?: SyncBlockDataProvider);
+    constructor(dataProvider?: SyncBlockDataProvider, fireAnalyticsEvent?: (payload: SyncBlockEventPayload) => void);
     get referenceManager(): ReferenceSyncBlockStoreManager;
     get sourceManager(): SourceSyncBlockStoreManager;
     destroy(): void;

package/dist/types-ts4.5/utils/errorHandling.d.ts

@@ -1 +1,11 @@
+import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, type RendererSyncBlockEventPayload, type OperationalAEP, type SyncBlockEventPayload } from "@atlaskit/editor-common/analytics";
 export declare const stringifyError: (error: unknown) => string | undefined;
+export declare const getErrorPayload: <T extends ACTION_SUBJECT_ID>(actionSubjectId: T, error: string) => OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, T, {
+    error: string;
+}>;
+export declare const fetchErrorPayload: (error: string) => RendererSyncBlockEventPayload;
+export declare const getSourceInfoErrorPayload: (error: string) => RendererSyncBlockEventPayload;
+export declare const updateErrorPayload: (error: string) => SyncBlockEventPayload;
+export declare const createErrorPayload: (error: string) => SyncBlockEventPayload;
+export declare const deleteErrorPayload: (error: string) => SyncBlockEventPayload;
+export declare const updateCacheErrorPayload: (error: string) => SyncBlockEventPayload;