@atlaskit/editor-synced-block-provider 2.6.0 → 2.7.1

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

@@ -19,18 +19,22 @@ export type SyncBlockSourceInfo = {
     title?: string;
     url?: string;
 };
+export type WriteSyncBlockResult = {
+    error?: string;
+    resourceId?: string;
+};
 export interface ADFFetchProvider {
     fetchData: (resourceId: ResourceId) => Promise<SyncBlockInstance>;
 }
 export interface ADFWriteProvider {
     deleteData: (resourceId: string) => Promise<DeleteSyncBlockResult>;
-    writeData: (data: SyncBlockData) => Promise<string>;
+    writeData: (data: SyncBlockData) => Promise<WriteSyncBlockResult>;
 }
 export declare abstract class SyncBlockDataProvider extends NodeDataProvider<SyncBlockNode, SyncBlockInstance> {
-    abstract writeNodesData(nodes: SyncBlockNode[], data: SyncBlockData[]): Promise<Array<ResourceId | undefined>>;
+    abstract writeNodesData(nodes: SyncBlockNode[], data: SyncBlockData[]): Promise<Array<WriteSyncBlockResult>>;
     abstract deleteNodesData(resourceIds: string[]): Promise<Array<DeleteSyncBlockResult>>;
     abstract getSourceId(): ResourceId;
-    abstract retrieveSyncBlockSourceUrlAndTitle(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
+    abstract retrieveSyncBlockSourceInfo(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
 }
 export type SubscriptionCallback = (data: SyncBlockInstance) => void;
 export type TitleSubscriptionCallback = (title: string) => void;

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

@@ -14,7 +14,7 @@ export declare class ReferenceSyncBlockStoreManager {
      * @returns {Promise<void>}
      */
     refreshSubscriptions(): Promise<void>;
-    private fetchSyncBlockSourceURLAndTitle;
+    private retrieveSyncBlockSourceInfo;
     fetchSyncBlocksData(syncBlockNodes: SyncBlockNode[]): Promise<SyncBlockInstance[]>;
     private updateCache;
     private updateSourceTitleSubscriptions;

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

@@ -1,15 +1,18 @@
-import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
+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';
-import type { SyncBlockAttrs, SyncBlockNode } from '../common/types';
+import type { ResourceId, SyncBlockAttrs } from '../common/types';
 import type { SyncBlockDataProvider } from '../providers/types';
 export type ConfirmationCallback = () => Promise<boolean>;
+export type CreationCallback = () => void;
 export declare class SourceSyncBlockStoreManager {
     private dataProvider?;
     private editorView?;
     private syncBlockCache;
     private confirmationCallback?;
     private confirmationTransaction?;
+    private pendingResourceId?;
+    private creationCallback?;
     constructor(dataProvider?: SyncBlockDataProvider);
     /**
      * Add/update a sync block node to/from the local cache
@@ -23,9 +26,18 @@ export declare class SourceSyncBlockStoreManager {
      */
     flushBodiedSyncBlocks(): Promise<boolean>;
     setEditorView(editorView: EditorView | undefined): void;
+    registerPendingCreation(resourceId: ResourceId): void;
+    registerCreationCallback(callback: CreationCallback): void;
+    /**
+     *  Fires callback to insert node (if creation is successful) and clears pending creation data
+     * @param success
+     */
+    commitPendingCreation(success: boolean): void;
+    hasPendingCreation(): boolean;
     registerConfirmationCallback(callback: ConfirmationCallback): () => void;
     requireConfirmationBeforeDelete(): boolean;
-    createSyncBlockNode(): SyncBlockNode;
+    generateBodiedSyncBlockAttrs(): SyncBlockAttrs;
+    createBodiedSyncBlockNode(attrs: SyncBlockAttrs): void;
     deleteSyncBlocksWithConfirmation(tr: Transaction, syncBlockIds: SyncBlockAttrs[]): Promise<void>;
     rebaseTransaction(incomingTr: Transaction, state: EditorState): void;
 }

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

@@ -1,10 +1,10 @@
 import type { EditorView } from '@atlaskit/editor-prosemirror/dist/types/view';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { EditorState, Transaction } from '@atlaskit/editor-prosemirror/state';
-import type { ResourceId, SyncBlockAttrs, SyncBlockNode } from '../common/types';
+import type { ResourceId, SyncBlockAttrs } from '../common/types';
 import type { SubscriptionCallback, SyncBlockDataProvider, SyncBlockInstance, TitleSubscriptionCallback } from '../providers/types';
 import { ReferenceSyncBlockStoreManager } from './referenceSyncBlockStoreManager';
-import { type ConfirmationCallback } from './sourceSyncBlockStoreManager';
+import { type ConfirmationCallback, type CreationCallback } from './sourceSyncBlockStoreManager';
 export declare class SyncBlockStoreManager {
     private referenceSyncBlockStoreManager;
     private sourceSyncBlockStoreManager;
@@ -37,7 +37,24 @@ export declare class SyncBlockStoreManager {
     isSourceBlock(node: PMNode): boolean;
     registerConfirmationCallback(callback: ConfirmationCallback): () => void;
     requireConfirmationBeforeDelete(): boolean;
-    createSyncBlockNode(): SyncBlockNode;
+    /**
+     * Register callback function (which inserts node, handles focus etc) to be used later when creation to backend succeed
+     */
+    registerCreationCallback(callback: CreationCallback): void;
+    /**
+     *
+     * @returns true if waiting for the result of saving new bodiedSyncBlock to backend
+     */
+    hasPendingCreation(): boolean;
+    /**
+     * @returns attributes for a new bodiedSyncBlock node
+     */
+    generateBodiedSyncBlockAttrs(): SyncBlockAttrs;
+    /**
+     * Save bodiedSyncBlock with empty content to backend
+     * @param attrs attributes Ids of the node
+     */
+    createBodiedSyncBlockNode(attrs: SyncBlockAttrs): void;
     subscribeToSyncBlockData(node: PMNode, callback: SubscriptionCallback): () => void;
     subscribeToSyncBlockSourceTitle(node: PMNode, callback: TitleSubscriptionCallback): () => void;
     refreshSubscriptions(): void;

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

@@ -0,0 +1 @@
+export declare const stringifyError: (error: unknown) => string | undefined;

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

@@ -0,0 +1,2 @@
+import type { SyncBlockSourceInfo } from "../providers/types";
+export declare const fetchSourceInfo: (ari: string, localId?: string) => Promise<SyncBlockSourceInfo | undefined>;

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

@@ -1,5 +1,10 @@
+import type { JSONNode } from '@atlaskit/editor-json-transformer';
 import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
-import type { SyncBlockData } from '../common/types';
+import type { SyncBlockData, BlockInstanceId, ResourceId, SyncBlockNode } from '../common/types';
 import type { PAGE_TYPE } from './ari';
 export declare const convertSyncBlockPMNodeToSyncBlockData: (node: PMNode) => SyncBlockData;
 export declare const isBlogPageType: (pageType: PAGE_TYPE) => boolean;
+export declare const createSyncBlockNode: (localId: BlockInstanceId, resourceId: ResourceId) => SyncBlockNode;
+export declare const createBodiedSyncBlockNode: (localId: BlockInstanceId, resourceId: ResourceId) => SyncBlockNode;
+export declare const convertSyncBlockJSONNodeToSyncBlockNode: (node: JSONNode) => SyncBlockNode | undefined;
+export declare const convertPMNodeToSyncBlockNode: (node: PMNode) => SyncBlockNode | undefined;

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

@@ -11,6 +11,5 @@ export type { ADFFetchProvider, ADFWriteProvider, SyncBlockDataProvider, SyncBlo
 export { ReferenceSyncBlockStoreManager } from './store-manager/referenceSyncBlockStoreManager';
 export { SyncBlockStoreManager } from './store-manager/syncBlockStoreManager';
 export { getConfluencePageAri, getPageIdAndTypeFromAri } from './utils/ari';
-export { createSyncBlockNode } from './utils/createSyncBlock';
+export { createSyncBlockNode, convertSyncBlockPMNodeToSyncBlockData, convertSyncBlockJSONNodeToSyncBlockNode, } from './utils/utils';
 export { resolveSyncBlockInstance } from './utils/resolveSyncBlockInstance';
-export { convertSyncBlockPMNodeToSyncBlockData } from './utils/utils';

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

@@ -1,5 +1,5 @@
 import { type SyncBlockData } from '../../common/types';
-import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance } from '../types';
+import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, WriteSyncBlockResult } from '../types';
 /**
  * Configuration for Content API providers
  */
@@ -22,7 +22,7 @@ declare class ConfluenceADFWriteProvider implements ADFWriteProvider {
     private config;
     constructor(config: ContentAPIConfig);
     private createNewContentProperty;
-    writeData(data: SyncBlockData): Promise<string>;
+    writeData(data: SyncBlockData): Promise<WriteSyncBlockResult>;
     deleteData(resourceId: string): Promise<DeleteSyncBlockResult>;
 }
 /**

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

@@ -1,6 +1,6 @@
 import type { JSONNode } from '@atlaskit/editor-json-transformer/types';
 import { type SyncBlockData, type SyncBlockNode } from '../common/types';
-import { SyncBlockDataProvider, type ADFFetchProvider, type ADFWriteProvider, type DeleteSyncBlockResult, type SyncBlockInstance, type SyncBlockSourceInfo } from '../providers/types';
+import { SyncBlockDataProvider, type ADFFetchProvider, type ADFWriteProvider, type DeleteSyncBlockResult, type SyncBlockInstance, type SyncBlockSourceInfo, type WriteSyncBlockResult } from '../providers/types';
 export declare class SyncBlockProvider extends SyncBlockDataProvider {
     name: string;
     private fetchProvider;
@@ -15,11 +15,12 @@ export declare class SyncBlockProvider extends SyncBlockDataProvider {
      * @param nodes
      * @param data
      *
-     * @returns the resource ids of the nodes that were written
+     * @returns Array of {resourceId?: string, error?: string}.
+     * resourceId: resource id of the node if write successfully , error: reason for when write failed
      */
-    writeNodesData(nodes: SyncBlockNode[], data: SyncBlockData[]): Promise<Array<string | undefined>>;
+    writeNodesData(nodes: SyncBlockNode[], data: SyncBlockData[]): Promise<Array<WriteSyncBlockResult>>;
     deleteNodesData(resourceIds: string[]): Promise<Array<DeleteSyncBlockResult>>;
     getSourceId(): string;
-    retrieveSyncBlockSourceUrlAndTitle(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
+    retrieveSyncBlockSourceInfo(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
 }
 export declare const useMemoizedSyncedBlockProvider: (fetchProvider: ADFFetchProvider, writeProvider: ADFWriteProvider, sourceId: string) => SyncBlockProvider;

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

@@ -19,18 +19,22 @@ export type SyncBlockSourceInfo = {
     title?: string;
     url?: string;
 };
+export type WriteSyncBlockResult = {
+    error?: string;
+    resourceId?: string;
+};
 export interface ADFFetchProvider {
     fetchData: (resourceId: ResourceId) => Promise<SyncBlockInstance>;
 }
 export interface ADFWriteProvider {
     deleteData: (resourceId: string) => Promise<DeleteSyncBlockResult>;
-    writeData: (data: SyncBlockData) => Promise<string>;
+    writeData: (data: SyncBlockData) => Promise<WriteSyncBlockResult>;
 }
 export declare abstract class SyncBlockDataProvider extends NodeDataProvider<SyncBlockNode, SyncBlockInstance> {
-    abstract writeNodesData(nodes: SyncBlockNode[], data: SyncBlockData[]): Promise<Array<ResourceId | undefined>>;
+    abstract writeNodesData(nodes: SyncBlockNode[], data: SyncBlockData[]): Promise<Array<WriteSyncBlockResult>>;
     abstract deleteNodesData(resourceIds: string[]): Promise<Array<DeleteSyncBlockResult>>;
     abstract getSourceId(): ResourceId;
-    abstract retrieveSyncBlockSourceUrlAndTitle(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
+    abstract retrieveSyncBlockSourceInfo(node: SyncBlockNode): Promise<SyncBlockSourceInfo | undefined>;
 }
 export type SubscriptionCallback = (data: SyncBlockInstance) => void;
 export type TitleSubscriptionCallback = (title: string) => void;

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

@@ -14,7 +14,7 @@ export declare class ReferenceSyncBlockStoreManager {
      * @returns {Promise<void>}
      */
     refreshSubscriptions(): Promise<void>;
-    private fetchSyncBlockSourceURLAndTitle;
+    private retrieveSyncBlockSourceInfo;
     fetchSyncBlocksData(syncBlockNodes: SyncBlockNode[]): Promise<SyncBlockInstance[]>;
     private updateCache;
     private updateSourceTitleSubscriptions;

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

@@ -1,15 +1,18 @@
-import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
+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';
-import type { SyncBlockAttrs, SyncBlockNode } from '../common/types';
+import type { ResourceId, SyncBlockAttrs } from '../common/types';
 import type { SyncBlockDataProvider } from '../providers/types';
 export type ConfirmationCallback = () => Promise<boolean>;
+export type CreationCallback = () => void;
 export declare class SourceSyncBlockStoreManager {
     private dataProvider?;
     private editorView?;
     private syncBlockCache;
     private confirmationCallback?;
     private confirmationTransaction?;
+    private pendingResourceId?;
+    private creationCallback?;
     constructor(dataProvider?: SyncBlockDataProvider);
     /**
      * Add/update a sync block node to/from the local cache
@@ -23,9 +26,18 @@ export declare class SourceSyncBlockStoreManager {
      */
     flushBodiedSyncBlocks(): Promise<boolean>;
     setEditorView(editorView: EditorView | undefined): void;
+    registerPendingCreation(resourceId: ResourceId): void;
+    registerCreationCallback(callback: CreationCallback): void;
+    /**
+     *  Fires callback to insert node (if creation is successful) and clears pending creation data
+     * @param success
+     */
+    commitPendingCreation(success: boolean): void;
+    hasPendingCreation(): boolean;
     registerConfirmationCallback(callback: ConfirmationCallback): () => void;
     requireConfirmationBeforeDelete(): boolean;
-    createSyncBlockNode(): SyncBlockNode;
+    generateBodiedSyncBlockAttrs(): SyncBlockAttrs;
+    createBodiedSyncBlockNode(attrs: SyncBlockAttrs): void;
     deleteSyncBlocksWithConfirmation(tr: Transaction, syncBlockIds: SyncBlockAttrs[]): Promise<void>;
     rebaseTransaction(incomingTr: Transaction, state: EditorState): void;
 }

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

@@ -1,10 +1,10 @@
 import type { EditorView } from '@atlaskit/editor-prosemirror/dist/types/view';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import type { EditorState, Transaction } from '@atlaskit/editor-prosemirror/state';
-import type { ResourceId, SyncBlockAttrs, SyncBlockNode } from '../common/types';
+import type { ResourceId, SyncBlockAttrs } from '../common/types';
 import type { SubscriptionCallback, SyncBlockDataProvider, SyncBlockInstance, TitleSubscriptionCallback } from '../providers/types';
 import { ReferenceSyncBlockStoreManager } from './referenceSyncBlockStoreManager';
-import { type ConfirmationCallback } from './sourceSyncBlockStoreManager';
+import { type ConfirmationCallback, type CreationCallback } from './sourceSyncBlockStoreManager';
 export declare class SyncBlockStoreManager {
     private referenceSyncBlockStoreManager;
     private sourceSyncBlockStoreManager;
@@ -37,7 +37,24 @@ export declare class SyncBlockStoreManager {
     isSourceBlock(node: PMNode): boolean;
     registerConfirmationCallback(callback: ConfirmationCallback): () => void;
     requireConfirmationBeforeDelete(): boolean;
-    createSyncBlockNode(): SyncBlockNode;
+    /**
+     * Register callback function (which inserts node, handles focus etc) to be used later when creation to backend succeed
+     */
+    registerCreationCallback(callback: CreationCallback): void;
+    /**
+     *
+     * @returns true if waiting for the result of saving new bodiedSyncBlock to backend
+     */
+    hasPendingCreation(): boolean;
+    /**
+     * @returns attributes for a new bodiedSyncBlock node
+     */
+    generateBodiedSyncBlockAttrs(): SyncBlockAttrs;
+    /**
+     * Save bodiedSyncBlock with empty content to backend
+     * @param attrs attributes Ids of the node
+     */
+    createBodiedSyncBlockNode(attrs: SyncBlockAttrs): void;
     subscribeToSyncBlockData(node: PMNode, callback: SubscriptionCallback): () => void;
     subscribeToSyncBlockSourceTitle(node: PMNode, callback: TitleSubscriptionCallback): () => void;
     refreshSubscriptions(): void;

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

@@ -0,0 +1 @@
+export declare const stringifyError: (error: unknown) => string | undefined;

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

@@ -0,0 +1,2 @@
+import type { SyncBlockSourceInfo } from "../providers/types";
+export declare const fetchSourceInfo: (ari: string, localId?: string) => Promise<SyncBlockSourceInfo | undefined>;

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

@@ -1,5 +1,10 @@
+import type { JSONNode } from '@atlaskit/editor-json-transformer';
 import type { Node as PMNode } from '@atlaskit/editor-prosemirror/model';
-import type { SyncBlockData } from '../common/types';
+import type { SyncBlockData, BlockInstanceId, ResourceId, SyncBlockNode } from '../common/types';
 import type { PAGE_TYPE } from './ari';
 export declare const convertSyncBlockPMNodeToSyncBlockData: (node: PMNode) => SyncBlockData;
 export declare const isBlogPageType: (pageType: PAGE_TYPE) => boolean;
+export declare const createSyncBlockNode: (localId: BlockInstanceId, resourceId: ResourceId) => SyncBlockNode;
+export declare const createBodiedSyncBlockNode: (localId: BlockInstanceId, resourceId: ResourceId) => SyncBlockNode;
+export declare const convertSyncBlockJSONNodeToSyncBlockNode: (node: JSONNode) => SyncBlockNode | undefined;
+export declare const convertPMNodeToSyncBlockNode: (node: PMNode) => SyncBlockNode | undefined;

package/package.json

@@ -29,7 +29,7 @@
 		"@atlaskit/css": "^0.15.0",
 		"@atlaskit/editor-json-transformer": "^8.31.0",
 		"@atlaskit/editor-prosemirror": "7.0.0",
-		"@atlaskit/node-data-provider": "^7.4.0",
+		"@atlaskit/node-data-provider": "^7.5.0",
 		"@atlaskit/primitives": "^16.1.0",
 		"@atlaskit/tokens": "^7.1.0",
 		"@babel/runtime": "^7.0.0",
@@ -82,7 +82,7 @@
 		}
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "2.6.0",
+	"version": "2.7.1",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",

package/dist/cjs/utils/createSyncBlock.js

@@ -1,15 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.createSyncBlockNode = void 0;
-var createSyncBlockNode = exports.createSyncBlockNode = function createSyncBlockNode(localId, resourceId) {
-  return {
-    type: 'syncBlock',
-    attrs: {
-      localId: localId,
-      resourceId: resourceId
-    }
-  };
-};

package/dist/es2019/utils/createSyncBlock.js

@@ -1,9 +0,0 @@
-export const createSyncBlockNode = (localId, resourceId) => {
-  return {
-    type: 'syncBlock',
-    attrs: {
-      localId,
-      resourceId
-    }
-  };
-};

package/dist/esm/utils/createSyncBlock.js

@@ -1,9 +0,0 @@
-export var createSyncBlockNode = function createSyncBlockNode(localId, resourceId) {
-  return {
-    type: 'syncBlock',
-    attrs: {
-      localId: localId,
-      resourceId: resourceId
-    }
-  };
-};

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

@@ -1,2 +0,0 @@
-import type { BlockInstanceId, ResourceId, SyncBlockNode } from '../common/types';
-export declare const createSyncBlockNode: (localId: BlockInstanceId, resourceId: ResourceId) => SyncBlockNode;

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

@@ -1,2 +0,0 @@
-import type { BlockInstanceId, ResourceId, SyncBlockNode } from '../common/types';
-export declare const createSyncBlockNode: (localId: BlockInstanceId, resourceId: ResourceId) => SyncBlockNode;