@atlaskit/editor-synced-block-provider 2.10.2 → 2.10.4

package/dist/esm/hooks/useHandleContentChanges.js

@@ -2,7 +2,7 @@ import { useEffect } from 'react';
 export var useHandleContentChanges = function useHandleContentChanges(manager, syncBlockNode) {
   useEffect(function () {
     try {
-      manager.updateSyncBlockData(syncBlockNode);
+      manager.sourceManager.updateSyncBlockData(syncBlockNode);
     } catch (_unused) {
       //TODO: EDITOR-1921 - add error analytics
     }

package/dist/esm/index.js

@@ -1,16 +1,26 @@
 /* eslint-disable @atlaskit/editor/no-re-export */
 
+// common
 export { rebaseTransaction } from './common/rebase-transaction';
 export { SyncBlockError } from './common/types';
+// hooks
 export { useFetchSyncBlockData } from './hooks/useFetchSyncBlockData';
 export { useFetchSyncBlockTitle } from './hooks/useFetchSyncBlockTitle';
 export { useHandleContentChanges } from './hooks/useHandleContentChanges';
-export { blockResourceIdFromSourceAndLocalId, getLocalIdFromResourceId } from './providers/block-service/ari';
+
+// clients
+export { blockResourceIdFromSourceAndLocalId, getLocalIdFromBlockResourceId } from './clients/block-service/ari';
+export { getConfluencePageAri, getLocalIdFromConfluencePageAri, getPageARIFromContentPropertyResourceId, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId } from './clients/confluence/ari';
+
+// providers
 export { useMemoizedBlockServiceAPIProviders } from './providers/block-service/blockServiceAPI';
 export { createContentAPIProvidersWithDefaultKey, useMemoizedContentAPIProviders } from './providers/confluence/confluenceContentAPI';
+export { fetchConfluenceSourceInfo } from './clients/confluence/sourceInfo';
 export { SyncBlockProvider as SyncedBlockProvider, useMemoizedSyncedBlockProvider } from './providers/syncBlockProvider';
+// store managers
 export { ReferenceSyncBlockStoreManager } from './store-manager/referenceSyncBlockStoreManager';
 export { SyncBlockStoreManager } from './store-manager/syncBlockStoreManager';
-export { getConfluencePageAri, getLocalIdFromAri, getPageARIFromResourceId, getPageIdAndTypeFromAri, resourceIdFromSourceAndLocalId } from './utils/ari';
-export { createSyncBlockNode, convertSyncBlockPMNodeToSyncBlockData, convertSyncBlockJSONNodeToSyncBlockNode } from './utils/utils';
-export { resolveSyncBlockInstance } from './utils/resolveSyncBlockInstance';
+
+// utils
+export { resolveSyncBlockInstance } from './utils/resolveSyncBlockInstance';
+export { createSyncBlockNode, convertSyncBlockPMNodeToSyncBlockData, convertSyncBlockJSONNodeToSyncBlockNode, convertPMNodesToSyncBlockNodes } from './utils/utils';

package/dist/esm/providers/block-service/blockServiceAPI.js

@@ -3,10 +3,10 @@ import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 import { useMemo } from 'react';
+import { blockResourceIdFromSourceAndLocalId, getLocalIdFromBlockResourceId } from '../../clients/block-service/ari';
+import { BlockError, createSyncedBlock, deleteSyncedBlock, getSyncedBlockContent, updateSyncedBlock } from '../../clients/block-service/blockService';
 import { SyncBlockError } from '../../common/types';
-import { BlockError, createSyncedBlock, deleteSyncedBlock, getSyncedBlockContent, updateSyncedBlock } from '../../utils/blockService';
 import { stringifyError } from '../../utils/errorHandling';
-import { blockResourceIdFromSourceAndLocalId, getLocalIdFromResourceId } from './ari';
 var mapBlockError = function mapBlockError(error) {
   switch (error.status) {
     case 403:
@@ -34,7 +34,7 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
         return _regeneratorRuntime.wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
-              localId = getLocalIdFromResourceId(resourceId);
+              localId = getLocalIdFromBlockResourceId(resourceId);
               _context.prev = 1;
               _context.next = 4;
               return getSyncedBlockContent({
@@ -94,7 +94,7 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
     value: function retrieveSourceInfoFetchData(resourceId, pageARI) {
       var sourceLocalId;
       try {
-        sourceLocalId = getLocalIdFromResourceId(resourceId);
+        sourceLocalId = getLocalIdFromBlockResourceId(resourceId);
       } catch (error) {
         // EDITOR-1921: log analytic here, safe to continue
       }

package/dist/esm/providers/confluence/confluenceContentAPI.js

@@ -7,11 +7,11 @@ function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbol
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 import { useMemo } from 'react';
+import { getConfluencePageAri, getPageARIFromContentPropertyResourceId, getLocalIdFromConfluencePageAri, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId } from '../../clients/confluence/ari';
+import { getContentProperty, createContentProperty, updateContentProperty, deleteContentProperty } from '../../clients/confluence/contentProperty';
+import { isBlogPageType } from '../../clients/confluence/utils';
 import { SyncBlockError } from '../../common/types';
-import { getConfluencePageAri, getPageARIFromResourceId, getLocalIdFromAri, getPageIdAndTypeFromAri, resourceIdFromSourceAndLocalId } from '../../utils/ari';
-import { getContentProperty, createContentProperty, updateContentProperty, deleteContentProperty } from '../../utils/contentProperty';
 import { stringifyError } from '../../utils/errorHandling';
-import { isBlogPageType } from '../../utils/utils';
 
 /**
  * Configuration for Content API providers
@@ -63,8 +63,8 @@ var ConfluenceADFFetchProvider = /*#__PURE__*/function () {
         return _regeneratorRuntime.wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
-              _getPageIdAndTypeFrom = getPageIdAndTypeFromAri(resourceId), pageId = _getPageIdAndTypeFrom.id, pageType = _getPageIdAndTypeFrom.type;
-              localId = getLocalIdFromAri(resourceId);
+              _getPageIdAndTypeFrom = getPageIdAndTypeFromConfluencePageAri(resourceId), pageId = _getPageIdAndTypeFrom.id, pageType = _getPageIdAndTypeFrom.type;
+              localId = getLocalIdFromConfluencePageAri(resourceId);
               _context.prev = 2;
               key = getContentPropertyKey(this.config.contentPropertyKey, localId);
               options = {
@@ -107,8 +107,18 @@ var ConfluenceADFFetchProvider = /*#__PURE__*/function () {
               return _context.abrupt("return", {
                 data: {
                   content: syncedBlockData.content,
-                  resourceId: resourceId,
-                  blockInstanceId: localId
+                  // If the block instance ID is not set, use the local ID from the fetch data request
+                  // This is a fallback for the case where the block instance ID is not set in the synced block data (old data)
+                  blockInstanceId: syncedBlockData.blockInstanceId || localId,
+                  // If the resource ID is not set, use the resource ID from the fetch data request
+                  // This is a fallback for the case where the resource ID is not set in the synced block data (old data)
+                  resourceId: syncedBlockData.resourceId || resourceId,
+                  // If the product is not set, use the default product 'confluence-page'
+                  // This is a fallback for the case where the product is not set in the synced block data (old data)
+                  product: syncedBlockData.product || 'confluence-page',
+                  // If the source Ari is not set, use the resource ID as the source Ari
+                  // This is a fallback for the case where the source Ari is not set in the synced block data (old data)
+                  sourceAri: syncedBlockData.sourceAri || resourceId
                 },
                 resourceId: resourceId
               });
@@ -133,10 +143,10 @@ var ConfluenceADFFetchProvider = /*#__PURE__*/function () {
   }, {
     key: "retrieveSourceInfoFetchData",
     value: function retrieveSourceInfoFetchData(resourceId) {
-      var pageARI = getPageARIFromResourceId(resourceId);
+      var pageARI = getPageARIFromContentPropertyResourceId(resourceId);
       var sourceLocalId;
       try {
-        sourceLocalId = getLocalIdFromAri(resourceId);
+        sourceLocalId = getLocalIdFromConfluencePageAri(resourceId);
       } catch (error) {
         // EDITOR-1921: log analytic here, safe to continue
       }
@@ -212,14 +222,14 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
   return _createClass(ConfluenceADFWriteProvider, [{
     key: "writeData",
     value: function () {
-      var _writeData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3(data) {
+      var _writeData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3(syncBlockData) {
         var match, resourceId, _match, pageId, pageType, localId, key, sourceAri, syncBlockDataWithSourceDocumentAri, options, updatePayload, updateResult;
         return _regeneratorRuntime.wrap(function _callee3$(_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
-              resourceId = data.resourceId;
+              resourceId = syncBlockData.resourceId;
               _context3.prev = 1;
-              match = getPageIdAndTypeFromAri(data.resourceId);
+              match = getPageIdAndTypeFromConfluencePageAri(resourceId);
               _context3.next = 8;
               break;
             case 5:
@@ -232,10 +242,10 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
               _match = match, pageId = _match.id, pageType = _match.type;
               _context3.prev = 9;
               // Update existing content property
-              localId = getLocalIdFromAri(resourceId);
+              localId = getLocalIdFromConfluencePageAri(resourceId);
               key = getContentPropertyKey(this.config.contentPropertyKey, localId);
               sourceAri = getConfluencePageAri(pageId, this.config.cloudId, pageType);
-              syncBlockDataWithSourceDocumentAri = _objectSpread(_objectSpread({}, data), {}, {
+              syncBlockDataWithSourceDocumentAri = _objectSpread(_objectSpread({}, syncBlockData), {}, {
                 product: 'confluence-page',
                 sourceAri: sourceAri
               });
@@ -263,7 +273,7 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
                 _context3.next = 27;
                 break;
               }
-              return _context3.abrupt("return", this.createNewContentProperty(pageId, key, data, pageType).then(function () {
+              return _context3.abrupt("return", this.createNewContentProperty(pageId, key, syncBlockDataWithSourceDocumentAri, pageType).then(function () {
                 return {
                   resourceId: resourceId
                 };
@@ -305,7 +315,7 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
               _context4.prev = 0;
-              match = getPageIdAndTypeFromAri(resourceId);
+              match = getPageIdAndTypeFromConfluencePageAri(resourceId);
               _context4.next = 7;
               break;
             case 4:
@@ -319,7 +329,7 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
             case 7:
               _match2 = match, pageId = _match2.id, pageType = _match2.type;
               _context4.prev = 8;
-              localId = getLocalIdFromAri(resourceId);
+              localId = getLocalIdFromConfluencePageAri(resourceId);
               key = getContentPropertyKey(this.config.contentPropertyKey, localId);
               options = {
                 pageId: pageId,
@@ -362,7 +372,7 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
   }, {
     key: "generateResourceId",
     value: function generateResourceId(sourceId, localId) {
-      return resourceIdFromSourceAndLocalId(sourceId, localId);
+      return resourceIdFromConfluencePageSourceIdAndLocalId(sourceId, localId);
     }
   }]);
 }();

package/dist/esm/providers/syncBlockProvider.js

@@ -10,10 +10,10 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
 function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
 import { useMemo } from 'react';
+import { getPageIdAndTypeFromConfluencePageAri } from '../clients/confluence/ari';
+import { fetchConfluenceSourceInfo } from '../clients/confluence/sourceInfo';
 import { SyncBlockError } from '../common/types';
 import { SyncBlockDataProvider } from '../providers/types';
-import { getPageIdAndTypeFromAri } from '../utils/ari';
-import { fetchSourceInfo } from '../utils/sourceInfo';
 export var SyncBlockProvider = /*#__PURE__*/function (_SyncBlockDataProvide) {
   // the source document ARI; that the source sync block is on.
 
@@ -226,7 +226,10 @@ export var SyncBlockProvider = /*#__PURE__*/function (_SyncBlockDataProvide) {
           return Promise.reject(error);
         }
       }
-      return pageARI ? fetchSourceInfo(pageARI, sourceLocalId) : Promise.resolve(undefined);
+
+      // TODO: EDITOR-3312 - based on the source sync block product,
+      // execute fetchConfluenceSourceInfo or fetchJiraItemSourceInfo or similar...
+      return pageARI ? fetchConfluenceSourceInfo(pageARI, sourceLocalId) : Promise.resolve(undefined);
     }
   }, {
     key: "generateResourceId",
@@ -261,16 +264,18 @@ export var SyncBlockProvider = /*#__PURE__*/function (_SyncBlockDataProvide) {
       }
       var _syncBlockInstance$da = syncBlockInstance.data,
         sourceAri = _syncBlockInstance$da.sourceAri,
-        resourceId = _syncBlockInstance$da.resourceId,
-        contentProduct = _syncBlockInstance$da.product;
+        product = _syncBlockInstance$da.product;
+      if (!sourceAri || !product) {
+        return undefined;
+      }
 
-      // Temp solution to get the pageId from resource since the sourceDocumentAri is not available for older sync blocks
-      var pageARI = sourceAri || resourceId;
-      var _getPageIdAndTypeFrom = getPageIdAndTypeFromAri(pageARI),
+      // TODO: EDITOR-3312 - based on the source sync block product,
+      // execute getPageIdAndTypeFromConfluencePageAri or getJiraItemIdAndTypeFromJiraItemAri or similar...
+      var _getPageIdAndTypeFrom = getPageIdAndTypeFromConfluencePageAri(sourceAri),
         contentId = _getPageIdAndTypeFrom.id;
       return {
         contentId: contentId,
-        contentProduct: contentProduct || 'confluence-page'
+        contentProduct: product
       };
     }
   }]);

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

@@ -13,6 +13,12 @@ import { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
 import { SyncBlockError } from '../common/types';
 import { resolveSyncBlockInstance } from '../utils/resolveSyncBlockInstance';
 import { createSyncBlockNode } from '../utils/utils';
+
+// A store manager responsible for the lifecycle and state management of reference sync blocks in an editor instance.
+// Designed to manage local in-memory state and synchronize with an external data provider.
+// Supports fetch, cache, and subscription for sync block data.
+// Handles fetching source URL and title for sync blocks.
+// Can be used in both editor and renderer contexts.
 export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
   function ReferenceSyncBlockStoreManager(dataProvider) {
     _classCallCheck(this, ReferenceSyncBlockStoreManager);
@@ -116,6 +122,8 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
         return;
       }
 
+      // TODO: EDITOR-3312 - retrieve the source info based on the source sync block product
+
       // if the sync block is a reference block, we need to fetch the URL to the source
       // we could optimise this further by checking if the sync block is on the same page as the source
       if (!this.syncBlockURLRequests.get(resourceId)) {
@@ -137,21 +145,33 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
         });
       }
     }
+
+    /**
+     * 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
+     */
   }, {
     key: "fetchSyncBlocksData",
-    value: function () {
+    value: (function () {
       var _fetchSyncBlocksData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(syncBlockNodes) {
         var _this2 = this;
         var nodesToFetch, blocksWithNotFoundError, data, resolvedData;
         return _regeneratorRuntime.wrap(function _callee2$(_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
-              if (this.dataProvider) {
+              if (!(syncBlockNodes.length === 0)) {
                 _context3.next = 2;
                 break;
               }
-              throw new Error('Data provider not set');
+              return _context3.abrupt("return", Promise.resolve([]));
             case 2:
+              if (this.dataProvider) {
+                _context3.next = 4;
+                break;
+              }
+              throw new Error('Data provider not set');
+            case 4:
               // Don't fetch for not_found error since the source is already deleted
               nodesToFetch = [], blocksWithNotFoundError = [];
               syncBlockNodes.forEach(function (node) {
@@ -162,16 +182,16 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
                   nodesToFetch.push(node);
                 }
               });
-              _context3.next = 6;
+              _context3.next = 8;
               return this.dataProvider.fetchNodesData(nodesToFetch);
-            case 6:
+            case 8:
               data = _context3.sent;
               if (data) {
-                _context3.next = 9;
+                _context3.next = 11;
                 break;
               }
               throw new Error('Failed to fetch sync block node data');
-            case 9:
+            case 11:
               resolvedData = [];
               data.forEach(function (syncBlockInstance) {
                 var _resolvedSyncBlockIns, _resolvedSyncBlockIns2;
@@ -194,7 +214,7 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
                 }
               });
               return _context3.abrupt("return", [].concat(resolvedData, blocksWithNotFoundError));
-            case 12:
+            case 14:
             case "end":
               return _context3.stop();
           }
@@ -204,7 +224,7 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
         return _fetchSyncBlocksData.apply(this, arguments);
       }
       return fetchSyncBlocksData;
-    }()
+    }())
   }, {
     key: "updateCache",
     value: function updateCache(syncBlock) {
@@ -400,10 +420,17 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
   }, {
     key: "destroy",
     value: function destroy() {
+      this.dataProvider = undefined;
       this.syncBlockCache.clear();
       this.subscriptions.clear();
+      this.titleSubscriptions.clear();
       this.syncBlockURLRequests.clear();
       this.providerFactories.clear();
+      this.isRefreshingSubscriptions = false;
+      this.providerFactories.forEach(function (providerFactory) {
+        providerFactory.destroy();
+      });
+      this.providerFactories.clear();
     }
   }]);
 }();

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

@@ -7,6 +7,11 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
 import uuid from 'uuid';
 import { rebaseTransaction as _rebaseTransaction } from '../common/rebase-transaction';
 import { convertSyncBlockPMNodeToSyncBlockData, createBodiedSyncBlockNode as _createBodiedSyncBlockNode } from '../utils/utils';
+// A store manager responsible for the lifecycle and state management of source sync blocks in an editor instance.
+// Designed to manage local in-memory state and synchronize with an external data provider.
+// Supports create, flush, and delete operations for source sync blocks.
+// Handles caching, debouncing updates, and publish/subscribe for local changes.
+// Ensures consistency between local and remote state, and can be used in both editor and renderer contexts.
 export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
   function SourceSyncBlockStoreManager(dataProvider) {
     var _this = this;
@@ -20,14 +25,22 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
     this.dataProvider = dataProvider;
     this.syncBlockCache = new Map();
   }
-
-  /**
-   * Add/update a sync block node to/from the local cache
-   * @param syncBlockNode - The sync block node to update
-   */
   return _createClass(SourceSyncBlockStoreManager, [{
+    key: "isSourceBlock",
+    value: function isSourceBlock(node) {
+      return node.type.name === 'bodiedSyncBlock';
+    }
+
+    /**
+     * Add/update a sync block node to/from the local cache
+     * @param syncBlockNode - The sync block node to update
+     */
+  }, {
     key: "updateSyncBlockData",
     value: function updateSyncBlockData(syncBlockNode) {
+      if (!this.isSourceBlock(syncBlockNode)) {
+        throw new Error('Invalid sync block node type provided for updateSyncBlockData');
+      }
       var _syncBlockNode$attrs = syncBlockNode.attrs,
         localId = _syncBlockNode$attrs.localId,
         resourceId = _syncBlockNode$attrs.resourceId;
@@ -45,9 +58,9 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
      * @returns true if saving all nodes successfully, false if fail to save some/all nodes
      */
   }, {
-    key: "flushBodiedSyncBlocks",
+    key: "flush",
     value: (function () {
-      var _flushBodiedSyncBlocks = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+      var _flush = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
         var bodiedSyncBlockNodes, bodiedSyncBlockData, writeResults;
         return _regeneratorRuntime.wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
@@ -97,10 +110,10 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
           }
         }, _callee, this, [[0, 14]]);
       }));
-      function flushBodiedSyncBlocks() {
-        return _flushBodiedSyncBlocks.apply(this, arguments);
+      function flush() {
+        return _flush.apply(this, arguments);
       }
-      return flushBodiedSyncBlocks;
+      return flush;
     }())
   }, {
     key: "setEditorView",
@@ -112,6 +125,10 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
     value: function registerPendingCreation(resourceId) {
       this.pendingResourceId = resourceId;
     }
+
+    /**
+     * Register callback function (which inserts node, handles focus etc) to be used later when creation to backend succeed
+     */
   }, {
     key: "registerCreationCallback",
     value: function registerCreationCallback(callback) {
@@ -131,6 +148,11 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
       this.pendingResourceId = undefined;
       this.creationCallback = undefined;
     }
+
+    /**
+     *
+     * @returns true if waiting for the result of saving new bodiedSyncBlock to backend
+     */
   }, {
     key: "hasPendingCreation",
     value: function hasPendingCreation() {
@@ -150,6 +172,10 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
     value: function requireConfirmationBeforeDelete() {
       return !!this.confirmationCallback;
     }
+
+    /**
+     * @returns attributes for a new bodiedSyncBlock node
+     */
   }, {
     key: "generateBodiedSyncBlockAttrs",
     value: function generateBodiedSyncBlockAttrs() {
@@ -166,6 +192,11 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
         localId: localId
       };
     }
+
+    /**
+     * Create a bodiedSyncBlock node with empty content to backend
+     * @param attrs attributes Ids of the node
+     */
   }, {
     key: "createBodiedSyncBlockNode",
     value: function createBodiedSyncBlockNode(attrs) {
@@ -284,5 +315,16 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
       }
       this.confirmationTransaction = _rebaseTransaction(this.confirmationTransaction, incomingTr, state);
     }
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      this.syncBlockCache.clear();
+      this.confirmationCallback = undefined;
+      this.confirmationTransaction = undefined;
+      this.pendingResourceId = undefined;
+      this.creationCallback = undefined;
+      this.dataProvider = undefined;
+      this.editorView = undefined;
+    }
   }]);
 }();