@atlaskit/editor-synced-block-provider 2.9.0 → 2.10.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @atlaskit/editor-synced-block-provider
 
+## 2.10.1
+
+### Patch Changes
+
+- [`a05464ea42678`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/a05464ea42678) -
+  EDITOR-2791 bump adf-schema
+- Updated dependencies
+
+## 2.10.0
+
+### Minor Changes
+
+- [`00d86f82d23fa`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/00d86f82d23fa) -
+  Move ARI checks to providers
+
+### Patch Changes
+
+- Updated dependencies
+
+## 2.9.1
+
+### Patch Changes
+
+- [`e3aafa008fcf4`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/e3aafa008fcf4) -
+  EDITOR-2771 Pass parent Editor/Renderer data providers through SyncBlockDataProvider to the nested
+  renderer
+- Updated dependencies
+
 ## 2.9.0
 
 ### Minor Changes

package/dist/cjs/hooks/useFetchSyncBlockData.js

@@ -72,8 +72,9 @@ var useFetchSyncBlockData = exports.useFetchSyncBlockData = function useFetchSyn
     };
   }, [localId, referenceSyncBlockStoreManager, resourceId]);
   return {
-    syncBlockInstance: syncBlockInstance,
     isLoading: isLoading,
-    reloadData: reloadData
+    providerFactory: referenceSyncBlockStoreManager.getProviderFactory(resourceId || ''),
+    reloadData: reloadData,
+    syncBlockInstance: syncBlockInstance
   };
 };

package/dist/cjs/index.js

@@ -60,13 +60,13 @@ Object.defineProperty(exports, "createSyncBlockNode", {
 Object.defineProperty(exports, "getConfluencePageAri", {
   enumerable: true,
   get: function get() {
-    return _ari.getConfluencePageAri;
+    return _ari2.getConfluencePageAri;
   }
 });
 Object.defineProperty(exports, "getLocalIdFromAri", {
   enumerable: true,
   get: function get() {
-    return _ari.getLocalIdFromAri;
+    return _ari2.getLocalIdFromAri;
   }
 });
 Object.defineProperty(exports, "getLocalIdFromResourceId", {
@@ -78,13 +78,13 @@ Object.defineProperty(exports, "getLocalIdFromResourceId", {
 Object.defineProperty(exports, "getPageARIFromResourceId", {
   enumerable: true,
   get: function get() {
-    return _ari.getPageARIFromResourceId;
+    return _ari2.getPageARIFromResourceId;
   }
 });
 Object.defineProperty(exports, "getPageIdAndTypeFromAri", {
   enumerable: true,
   get: function get() {
-    return _ari.getPageIdAndTypeFromAri;
+    return _ari2.getPageIdAndTypeFromAri;
   }
 });
 Object.defineProperty(exports, "rebaseTransaction", {
@@ -102,7 +102,7 @@ Object.defineProperty(exports, "resolveSyncBlockInstance", {
 Object.defineProperty(exports, "resourceIdFromSourceAndLocalId", {
   enumerable: true,
   get: function get() {
-    return _ari.resourceIdFromSourceAndLocalId;
+    return _ari2.resourceIdFromSourceAndLocalId;
   }
 });
 Object.defineProperty(exports, "useFetchSyncBlockData", {
@@ -146,11 +146,12 @@ var _types = require("./common/types");
 var _useFetchSyncBlockData = require("./hooks/useFetchSyncBlockData");
 var _useFetchSyncBlockTitle = require("./hooks/useFetchSyncBlockTitle");
 var _useHandleContentChanges = require("./hooks/useHandleContentChanges");
+var _ari = require("./providers/block-service/ari");
 var _blockServiceAPI = require("./providers/block-service/blockServiceAPI");
 var _confluenceContentAPI = require("./providers/confluence/confluenceContentAPI");
 var _syncBlockProvider = require("./providers/syncBlockProvider");
 var _referenceSyncBlockStoreManager = require("./store-manager/referenceSyncBlockStoreManager");
 var _syncBlockStoreManager = require("./store-manager/syncBlockStoreManager");
-var _ari = require("./utils/ari");
+var _ari2 = require("./utils/ari");
 var _utils = require("./utils/utils");
 var _resolveSyncBlockInstance = require("./utils/resolveSyncBlockInstance");

package/dist/cjs/providers/block-service/ari.js

@@ -0,0 +1,34 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getLocalIdFromResourceId = exports.blockResourceIdFromSourceAndLocalId = void 0;
+/* eslint-disable require-unicode-regexp */
+/**
+ * Generates a unique block ARI from a source ARI and a local ID.
+ * @param sourceId - the ARI of the document. E.G ari:cloud:confluence:cloudId:page/pageId
+ * @param localId - the localId of the block node. A randomly generated UUID
+ * @returns the block ARI. E.G ari:cloud:blocks:cloudId:synced-block/localId
+ */
+var blockResourceIdFromSourceAndLocalId = exports.blockResourceIdFromSourceAndLocalId = function blockResourceIdFromSourceAndLocalId(sourceId, localId) {
+  var match = sourceId.match(/ari:cloud:confluence:([^:]+):(page|blogpost)\/.*/);
+  if (!(match !== null && match !== void 0 && match[1])) {
+    throw new Error("Invalid source ARI: ".concat(sourceId));
+  }
+  var cloudId = match[1];
+  return "ari:cloud:blocks:".concat(cloudId, ":synced-block/").concat(localId);
+};
+
+/**
+ * Extracts the local ID from a block ARI.
+ * @param ari - the block ARI. E.G ari:cloud:blocks:cloudId:synced-block/localId
+ * @returns the localId of the block node. A randomly generated UUID
+ */
+var getLocalIdFromResourceId = exports.getLocalIdFromResourceId = function getLocalIdFromResourceId(ari) {
+  var match = ari.match(/ari:cloud:blocks:[^:]+:synced-block\/([a-zA-Z0-9-]+)/);
+  if (match !== null && match !== void 0 && match[1]) {
+    return match[1];
+  }
+  throw new Error("Invalid page ARI: ".concat(ari));
+};

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

@@ -11,9 +11,9 @@ var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/cl
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var _react = require("react");
 var _types = require("../../common/types");
-var _ari = require("../../utils/ari");
 var _blockService = require("../../utils/blockService");
 var _errorHandling = require("../../utils/errorHandling");
+var _ari = require("./ari");
 var mapBlockError = function mapBlockError(error) {
   switch (error.status) {
     case 403:
@@ -96,6 +96,20 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
       }
       return fetchData;
     }()
+  }, {
+    key: "retrieveSourceInfoFetchData",
+    value: function retrieveSourceInfoFetchData(resourceId, pageARI) {
+      var sourceLocalId;
+      try {
+        sourceLocalId = (0, _ari.getLocalIdFromResourceId)(resourceId);
+      } catch (error) {
+        // EDITOR-1921: log analytic here, safe to continue
+      }
+      return {
+        pageARI: pageARI,
+        sourceLocalId: sourceLocalId
+      };
+    }
   }]);
 }();
 /**

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

@@ -134,6 +134,21 @@ var ConfluenceADFFetchProvider = /*#__PURE__*/function () {
       }
       return fetchData;
     }()
+  }, {
+    key: "retrieveSourceInfoFetchData",
+    value: function retrieveSourceInfoFetchData(resourceId) {
+      var pageARI = (0, _ari.getPageARIFromResourceId)(resourceId);
+      var sourceLocalId;
+      try {
+        sourceLocalId = (0, _ari.getLocalIdFromAri)(resourceId);
+      } catch (error) {
+        // EDITOR-1921: log analytic here, safe to continue
+      }
+      return {
+        pageARI: pageARI,
+        sourceLocalId: sourceLocalId
+      };
+    }
   }]);
 }();
 /**

package/dist/cjs/providers/syncBlockProvider.js

@@ -17,12 +17,21 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/de
 var _react = require("react");
 var _types = require("../common/types");
 var _types2 = require("../providers/types");
-var _ari = require("../utils/ari");
 var _sourceInfo = require("../utils/sourceInfo");
 function _callSuper(t, o, e) { return o = (0, _getPrototypeOf2.default)(o), (0, _possibleConstructorReturn2.default)(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], (0, _getPrototypeOf2.default)(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; })(); }
 var SyncBlockProvider = exports.SyncBlockProvider = /*#__PURE__*/function (_SyncBlockDataProvide) {
-  function SyncBlockProvider(fetchProvider, writeProvider, sourceId) {
+  // the source document ARI; that the source sync block is on.
+
+  /**
+   * Constructor for the SyncBlockProvider
+   *
+   * @param fetchProvider
+   * @param writeProvider
+   * @param sourceId
+   * @param nestedRendererDataProviders
+   */
+  function SyncBlockProvider(fetchProvider, writeProvider, sourceId, providerOptions) {
     var _this;
     (0, _classCallCheck2.default)(this, SyncBlockProvider);
     _this = _callSuper(this, SyncBlockProvider);
@@ -30,19 +39,44 @@ var SyncBlockProvider = exports.SyncBlockProvider = /*#__PURE__*/function (_Sync
     _this.fetchProvider = fetchProvider;
     _this.writeProvider = writeProvider;
     _this.sourceId = sourceId;
+    _this.providerOptions = providerOptions;
     return _this;
   }
+
+  /**
+   * Check if the node is supported by the provider
+   *
+   * @param node
+   *
+   * @returns True if the node is supported, false otherwise
+   */
   (0, _inherits2.default)(SyncBlockProvider, _SyncBlockDataProvide);
   return (0, _createClass2.default)(SyncBlockProvider, [{
     key: "isNodeSupported",
     value: function isNodeSupported(node) {
-      return node.type === 'syncBlock';
+      return node.type === 'syncBlock' || node.type === 'bodiedSyncBlock';
     }
+
+    /**
+     * Get the data key for the node
+     *
+     * @param node
+     *
+     * @returns The data key
+     */
   }, {
     key: "nodeDataKey",
     value: function nodeDataKey(node) {
       return node.attrs.localId;
     }
+
+    /**
+     * Fetch the data from the fetch provider
+     *
+     * @param nodes
+     *
+     * @returns Array of {resourceId?: string, error?: string}.
+     */
   }, {
     key: "fetchNodesData",
     value: function fetchNodesData(nodes) {
@@ -70,6 +104,7 @@ var SyncBlockProvider = exports.SyncBlockProvider = /*#__PURE__*/function (_Sync
     }
 
     /**
+     * Write the data to the write provider
      *
      * @param nodes
      * @param data
@@ -114,10 +149,18 @@ var SyncBlockProvider = exports.SyncBlockProvider = /*#__PURE__*/function (_Sync
         return _writeNodesData.apply(this, arguments);
       }
       return writeNodesData;
-    }())
+    }()
+    /**
+     * Delete the data from the write provider
+     *
+     * @param resourceIds
+     *
+     * @returns Array of {resourceId?: string, error?: string}.
+     */
+    )
   }, {
     key: "deleteNodesData",
-    value: function () {
+    value: (function () {
       var _deleteNodesData = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(resourceIds) {
         var _this4 = this;
         var results;
@@ -152,28 +195,42 @@ var SyncBlockProvider = exports.SyncBlockProvider = /*#__PURE__*/function (_Sync
       }
       return deleteNodesData;
     }()
+    /**
+     * Get the source id
+     *
+     * @returns The source id
+     */
+    )
   }, {
     key: "getSourceId",
     value: function getSourceId() {
       return this.sourceId;
     }
+
+    /**
+     * Retrieve the source info from the source id
+     *
+     * @param node
+     *
+     * @returns The source info
+     */
   }, {
     key: "retrieveSyncBlockSourceInfo",
     value: function retrieveSyncBlockSourceInfo(node) {
+      // with content API, this is the concatenation of the page ARI and the block's localId. 
+      // with block service, this is the ARI of the block.
+      // this can be cleaned up from the specific providers and placed here after platform_synced_blocks_block_service_provider
       var resourceId = node.attrs.resourceId;
       var pageARI;
       var sourceLocalId;
       if (resourceId && typeof resourceId === 'string') {
         try {
-          pageARI = (0, _ari.getPageARIFromResourceId)(resourceId);
+          var fetchData = this.fetchProvider.retrieveSourceInfoFetchData(resourceId, this.sourceId);
+          pageARI = fetchData.pageARI;
+          sourceLocalId = fetchData.sourceLocalId;
         } catch (error) {
           return Promise.reject(error);
         }
-        try {
-          sourceLocalId = (0, _ari.getLocalIdFromAri)(resourceId);
-        } catch (error) {
-          // EDITOR-1921: log analytic here, safe to continue
-        }
       }
       return pageARI ? (0, _sourceInfo.fetchSourceInfo)(pageARI, sourceLocalId) : Promise.resolve(undefined);
     }
@@ -182,10 +239,21 @@ var SyncBlockProvider = exports.SyncBlockProvider = /*#__PURE__*/function (_Sync
     value: function generateResourceId(sourceId, localId) {
       return this.writeProvider.generateResourceId(sourceId, localId);
     }
+
+    /**
+     * Get the synced block renderer provider options
+     *
+     * @returns The synced block renderer provider options
+     */
+  }, {
+    key: "getSyncedBlockRendererProviderOptions",
+    value: function getSyncedBlockRendererProviderOptions() {
+      return this.providerOptions;
+    }
   }]);
 }(_types2.SyncBlockDataProvider);
-var useMemoizedSyncedBlockProvider = exports.useMemoizedSyncedBlockProvider = function useMemoizedSyncedBlockProvider(fetchProvider, writeProvider, sourceId) {
+var useMemoizedSyncedBlockProvider = exports.useMemoizedSyncedBlockProvider = function useMemoizedSyncedBlockProvider(fetchProvider, writeProvider, sourceId, providerOptions) {
   return (0, _react.useMemo)(function () {
-    return new SyncBlockProvider(fetchProvider, writeProvider, sourceId);
-  }, [fetchProvider, writeProvider, sourceId]);
+    return new SyncBlockProvider(fetchProvider, writeProvider, sourceId, providerOptions);
+  }, [fetchProvider, writeProvider, sourceId, providerOptions]);
 };

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

@@ -11,6 +11,7 @@ var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _providerFactory = require("@atlaskit/editor-common/provider-factory");
 var _types = require("../common/types");
 var _resolveSyncBlockInstance = require("../utils/resolveSyncBlockInstance");
 var _utils = require("../utils/utils");
@@ -28,6 +29,7 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
     this.titleSubscriptions = new Map();
     this.dataProvider = dataProvider;
     this.syncBlockURLRequests = new Map();
+    this.providerFactories = new Map();
   }
 
   /**
@@ -243,6 +245,7 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
     key: "deleteFromCache",
     value: function deleteFromCache(resourceId) {
       this.syncBlockCache.delete(resourceId);
+      this.providerFactories.delete(resourceId);
     }
   }, {
     key: "subscribeToSyncBlock",
@@ -338,12 +341,35 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
       }
       return (_syncBlock$data = syncBlock.data) === null || _syncBlock$data === void 0 ? void 0 : _syncBlock$data.sourceURL;
     }
+  }, {
+    key: "getProviderFactory",
+    value: function getProviderFactory(resourceId) {
+      if (!this.dataProvider) {
+        return undefined;
+      }
+      var _this$dataProvider$ge = this.dataProvider.getSyncedBlockRendererProviderOptions(),
+        parentDataProviders = _this$dataProvider$ge.parentDataProviders;
+      if (!this.providerFactories.has(resourceId)) {
+        // TODO: EDITOR-2771 - In follow up PR, create media & emoji providers per ref sync block
+        // The media & emoji providers will be set later, once we get ref sync block data with page ID
+        // So we need to keep the reference to the Provider Factory so we can then set media & emoji providers later
+        this.providerFactories.set(resourceId, _providerFactory.ProviderFactory.create({
+          emojiProvider: parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.emojiProvider,
+          mediaProvider: parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.mediaProvider,
+          mentionProvider: parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.mentionProvider,
+          profilecardProvider: parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.profilecardProvider,
+          taskDecisionProvider: parentDataProviders === null || parentDataProviders === void 0 ? void 0 : parentDataProviders.taskDecisionProvider
+        }));
+      }
+      return this.providerFactories.get(resourceId);
+    }
   }, {
     key: "destroy",
     value: function destroy() {
       this.syncBlockCache.clear();
       this.subscriptions.clear();
       this.syncBlockURLRequests.clear();
+      this.providerFactories.clear();
     }
   }]);
 }();

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

@@ -171,6 +171,11 @@ var SyncBlockStoreManager = exports.SyncBlockStoreManager = /*#__PURE__*/functio
       // only applicable to source sync block, for now (will be refactored further)
       this.sourceSyncBlockStoreManager.rebaseTransaction(incomingTr, state);
     }
+  }, {
+    key: "getReferenceSyncBlockProviderFactory",
+    value: function getReferenceSyncBlockProviderFactory(resourceId) {
+      return this.referenceSyncBlockStoreManager.getProviderFactory(resourceId);
+    }
   }, {
     key: "destroy",
     value: function destroy() {

package/dist/cjs/utils/ari.js

@@ -3,13 +3,15 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.resourceIdFromSourceAndLocalId = exports.getPageIdAndTypeFromAri = exports.getPageARIFromResourceId = exports.getLocalIdFromResourceId = exports.getLocalIdFromAri = exports.getConfluencePageAri = exports.blockResourceIdFromSourceAndLocalId = void 0;
+exports.resourceIdFromSourceAndLocalId = exports.getPageIdAndTypeFromAri = exports.getPageARIFromResourceId = exports.getLocalIdFromAri = exports.getConfluencePageAri = void 0;
 /* eslint-disable require-unicode-regexp  */
 
 var getConfluencePageAri = exports.getConfluencePageAri = function getConfluencePageAri(pageId, cloudId) {
   var pageType = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'page';
   return "ari:cloud:confluence:".concat(cloudId, ":").concat(pageType, "/").concat(pageId);
 };
+
+// For extracting from Page ARI and also the content property's version of resourceId 
 var getPageIdAndTypeFromAri = exports.getPageIdAndTypeFromAri = function getPageIdAndTypeFromAri(ari) {
   var match = ari.match(/ari:cloud:confluence:[^:]+:(page|blogpost)\/(\d+)/);
   if (match !== null && match !== void 0 && match[2]) {
@@ -36,35 +38,4 @@ var getPageARIFromResourceId = exports.getPageARIFromResourceId = function getPa
 };
 var resourceIdFromSourceAndLocalId = exports.resourceIdFromSourceAndLocalId = function resourceIdFromSourceAndLocalId(sourceId, localId) {
   return sourceId + '/' + localId;
-};
-
-/**
- * For the following functions, they are used for the block service API provider.
- * The resourceId/blockResourceId always refers to the block ARI.
- */
-
-/**
- * @param sourceId - the ARI of the document. E.G ari:cloud:confluence:cloudId:page/pageId
- * @param localId - the localId of the block node. A randomly generated UUID
- * @returns the block ARI. E.G ari:cloud:blocks:cloudId:synced-block/localId
- */
-var blockResourceIdFromSourceAndLocalId = exports.blockResourceIdFromSourceAndLocalId = function blockResourceIdFromSourceAndLocalId(sourceId, localId) {
-  var match = sourceId.match(/ari:cloud:confluence:([^:]+):(page|blogpost)\/.*/);
-  if (!(match !== null && match !== void 0 && match[1])) {
-    throw new Error("Invalid source ARI: ".concat(sourceId));
-  }
-  var cloudId = match[1];
-  return "ari:cloud:blocks:".concat(cloudId, ":synced-block/").concat(localId);
-};
-
-/**
- * @param ari - the block ARI. E.G ari:cloud:blocks:cloudId:synced-block/localId
- * @returns the localId of the block node. A randomly generated UUID
- */
-var getLocalIdFromResourceId = exports.getLocalIdFromResourceId = function getLocalIdFromResourceId(ari) {
-  var match = ari.match(/ari:cloud:confluence:[^:]+:(page|blogpost)\/\d+\/([a-zA-Z0-9-]+)/);
-  if (match !== null && match !== void 0 && match[2]) {
-    return match[2];
-  }
-  throw new Error("Invalid page ARI: ".concat(ari));
 };

package/dist/cjs/utils/sourceInfo.js

@@ -69,15 +69,15 @@ var getSourceInfo = /*#__PURE__*/function () {
   };
 }();
 var fetchSourceInfo = exports.fetchSourceInfo = /*#__PURE__*/function () {
-  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(ari, localId) {
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(pageAri, localId) {
     var _response$data, _contentData$space, _getPageIdAndTypeFrom, pageType, response, contentData, title, url, _ref3, base;
     return _regenerator.default.wrap(function _callee2$(_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
           _context2.prev = 0;
-          _getPageIdAndTypeFrom = (0, _ari.getPageIdAndTypeFromAri)(ari), pageType = _getPageIdAndTypeFrom.type;
+          _getPageIdAndTypeFrom = (0, _ari.getPageIdAndTypeFromAri)(pageAri), pageType = _getPageIdAndTypeFrom.type;
           _context2.next = 4;
-          return getSourceInfo(ari);
+          return getSourceInfo(pageAri);
         case 4:
           response = _context2.sent;
           contentData = (_response$data = response.data) === null || _response$data === void 0 || (_response$data = _response$data.content) === null || _response$data === void 0 || (_response$data = _response$data.nodes) === null || _response$data === void 0 ? void 0 : _response$data[0];

package/dist/es2019/hooks/useFetchSyncBlockData.js

@@ -36,8 +36,9 @@ export const useFetchSyncBlockData = (manager, resourceId, localId) => {
     };
   }, [localId, referenceSyncBlockStoreManager, resourceId]);
   return {
-    syncBlockInstance,
     isLoading,
-    reloadData
+    providerFactory: referenceSyncBlockStoreManager.getProviderFactory(resourceId || ''),
+    reloadData,
+    syncBlockInstance
   };
 };

package/dist/es2019/index.js

@@ -5,11 +5,12 @@ export { SyncBlockError } from './common/types';
 export { useFetchSyncBlockData } from './hooks/useFetchSyncBlockData';
 export { useFetchSyncBlockTitle } from './hooks/useFetchSyncBlockTitle';
 export { useHandleContentChanges } from './hooks/useHandleContentChanges';
+export { blockResourceIdFromSourceAndLocalId, getLocalIdFromResourceId } from './providers/block-service/ari';
 export { useMemoizedBlockServiceAPIProviders } from './providers/block-service/blockServiceAPI';
 export { createContentAPIProvidersWithDefaultKey, useMemoizedContentAPIProviders } from './providers/confluence/confluenceContentAPI';
 export { SyncBlockProvider as SyncedBlockProvider, useMemoizedSyncedBlockProvider } from './providers/syncBlockProvider';
 export { ReferenceSyncBlockStoreManager } from './store-manager/referenceSyncBlockStoreManager';
 export { SyncBlockStoreManager } from './store-manager/syncBlockStoreManager';
-export { blockResourceIdFromSourceAndLocalId, getConfluencePageAri, getLocalIdFromAri, getLocalIdFromResourceId, getPageARIFromResourceId, getPageIdAndTypeFromAri, resourceIdFromSourceAndLocalId } from './utils/ari';
+export { getConfluencePageAri, getLocalIdFromAri, getPageARIFromResourceId, getPageIdAndTypeFromAri, resourceIdFromSourceAndLocalId } from './utils/ari';
 export { createSyncBlockNode, convertSyncBlockPMNodeToSyncBlockData, convertSyncBlockJSONNodeToSyncBlockNode } from './utils/utils';
 export { resolveSyncBlockInstance } from './utils/resolveSyncBlockInstance';

package/dist/es2019/providers/block-service/ari.js

@@ -0,0 +1,28 @@
+/* eslint-disable require-unicode-regexp */
+/**
+ * Generates a unique block ARI from a source ARI and a local ID.
+ * @param sourceId - the ARI of the document. E.G ari:cloud:confluence:cloudId:page/pageId
+ * @param localId - the localId of the block node. A randomly generated UUID
+ * @returns the block ARI. E.G ari:cloud:blocks:cloudId:synced-block/localId
+ */
+export const blockResourceIdFromSourceAndLocalId = (sourceId, localId) => {
+  const match = sourceId.match(/ari:cloud:confluence:([^:]+):(page|blogpost)\/.*/);
+  if (!(match !== null && match !== void 0 && match[1])) {
+    throw new Error(`Invalid source ARI: ${sourceId}`);
+  }
+  const cloudId = match[1];
+  return `ari:cloud:blocks:${cloudId}:synced-block/${localId}`;
+};
+
+/**
+ * Extracts the local ID from a block ARI.
+ * @param ari - the block ARI. E.G ari:cloud:blocks:cloudId:synced-block/localId
+ * @returns the localId of the block node. A randomly generated UUID
+ */
+export const getLocalIdFromResourceId = ari => {
+  const match = ari.match(/ari:cloud:blocks:[^:]+:synced-block\/([a-zA-Z0-9-]+)/);
+  if (match !== null && match !== void 0 && match[1]) {
+    return match[1];
+  }
+  throw new Error(`Invalid page ARI: ${ari}`);
+};

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

@@ -1,8 +1,8 @@
 import { useMemo } from 'react';
 import { SyncBlockError } from '../../common/types';
-import { blockResourceIdFromSourceAndLocalId, getLocalIdFromResourceId } from '../../utils/ari';
 import { BlockError, createSyncedBlock, deleteSyncedBlock, getSyncedBlockContent, updateSyncedBlock } from '../../utils/blockService';
 import { stringifyError } from '../../utils/errorHandling';
+import { blockResourceIdFromSourceAndLocalId, getLocalIdFromResourceId } from './ari';
 const mapBlockError = error => {
   switch (error.status) {
     case 403:
@@ -56,6 +56,18 @@ class BlockServiceADFFetchProvider {
       };
     }
   }
+  retrieveSourceInfoFetchData(resourceId, pageARI) {
+    let sourceLocalId;
+    try {
+      sourceLocalId = getLocalIdFromResourceId(resourceId);
+    } catch (error) {
+      // EDITOR-1921: log analytic here, safe to continue
+    }
+    return {
+      pageARI,
+      sourceLocalId
+    };
+  }
 }
 
 /**

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

@@ -1,7 +1,7 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { useMemo } from 'react';
 import { SyncBlockError } from '../../common/types';
-import { getLocalIdFromAri, getPageIdAndTypeFromAri, resourceIdFromSourceAndLocalId } from '../../utils/ari';
+import { getLocalIdFromAri, getPageARIFromResourceId, getPageIdAndTypeFromAri, resourceIdFromSourceAndLocalId } from '../../utils/ari';
 import { getContentProperty, createContentProperty, updateContentProperty, deleteContentProperty } from '../../utils/contentProperty';
 import { stringifyError } from '../../utils/errorHandling';
 import { isBlogPageType } from '../../utils/utils';
@@ -98,6 +98,19 @@ class ConfluenceADFFetchProvider {
       };
     }
   }
+  retrieveSourceInfoFetchData(resourceId) {
+    const pageARI = getPageARIFromResourceId(resourceId);
+    let sourceLocalId;
+    try {
+      sourceLocalId = getLocalIdFromAri(resourceId);
+    } catch (error) {
+      // EDITOR-1921: log analytic here, safe to continue
+    }
+    return {
+      pageARI,
+      sourceLocalId
+    };
+  }
 }
 
 /**