@atlaskit/editor-synced-block-provider 3.27.0 → 3.27.1

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

@@ -542,128 +542,216 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
       return Promise.resolve(undefined);
     }
 
+    /**
+     * Processes prefetched data and updates the cache.
+     * @param prefetchedData - The prefetched data to process
+     * @returns {Promise<void>}
+     */
+  }, {
+    key: "processPrefetchedData",
+    value: (function () {
+      var _processPrefetchedData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(prefetchedData) {
+        var _this$fetchExperience,
+          _this7 = this;
+        var prefetchedResolvedData, _this$processFetchedD, hasUnexpectedError, hasExpectedError, _this$fetchExperience2, _this$fetchExperience3, _this$fetchExperience4, _this$fetchExperience5;
+        return _regeneratorRuntime.wrap(function _callee2$(_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
+            case 0:
+              if (prefetchedData) {
+                _context3.next = 2;
+                break;
+              }
+              return _context3.abrupt("return");
+            case 2:
+              // start the fetch experience (this should be started much earlier to properly track performance, but better late than never)
+              (_this$fetchExperience = this.fetchExperience) === null || _this$fetchExperience === void 0 || _this$fetchExperience.start({});
+
+              // mark the sync block requests as in fly
+              prefetchedData.resourceIds.forEach(function (resourceId) {
+                _this7.syncBlockFetchDataRequests.set(resourceId, true);
+              });
+              _context3.prev = 4;
+              _context3.next = 7;
+              return prefetchedData.prefetchPromise;
+            case 7:
+              prefetchedResolvedData = _context3.sent;
+              _this$processFetchedD = this.processFetchedData(prefetchedResolvedData), hasUnexpectedError = _this$processFetchedD.hasUnexpectedError, hasExpectedError = _this$processFetchedD.hasExpectedError;
+              if (hasUnexpectedError) {
+                (_this$fetchExperience2 = this.fetchExperience) === null || _this$fetchExperience2 === void 0 || _this$fetchExperience2.failure({
+                  reason: 'Unexpected error during prefetch'
+                });
+              } else if (hasExpectedError) {
+                (_this$fetchExperience3 = this.fetchExperience) === null || _this$fetchExperience3 === void 0 || _this$fetchExperience3.abort({
+                  reason: 'Expected error: NotFound or PermissionDenied during prefetch'
+                });
+              } else {
+                (_this$fetchExperience4 = this.fetchExperience) === null || _this$fetchExperience4 === void 0 || _this$fetchExperience4.success();
+              }
+              _context3.next = 15;
+              break;
+            case 12:
+              _context3.prev = 12;
+              _context3.t0 = _context3["catch"](4);
+              (_this$fetchExperience5 = this.fetchExperience) === null || _this$fetchExperience5 === void 0 || _this$fetchExperience5.failure({
+                reason: "Prefetch promise rejected: ".concat(_context3.t0.message)
+              });
+            case 15:
+              _context3.prev = 15;
+              // Clean up in-flight markers so subsequent fetches (e.g. refreshSubscriptions) are not blocked
+              prefetchedData.resourceIds.forEach(function (resourceId) {
+                _this7.syncBlockFetchDataRequests.delete(resourceId);
+              });
+              return _context3.finish(15);
+            case 18:
+            case "end":
+              return _context3.stop();
+          }
+        }, _callee2, this, [[4, 12, 15, 18]]);
+      }));
+      function processPrefetchedData(_x) {
+        return _processPrefetchedData.apply(this, arguments);
+      }
+      return processPrefetchedData;
+    }()
     /**
      * 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 () {
-      var _fetchSyncBlocksData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(syncBlockNodes) {
-        var _this7 = this,
-          _this$fetchExperience;
-        var nodesToFetch, data, hasUnexpectedError, hasExpectedError, _this$fetchExperience2, _this$fetchExperience3, _this$fetchExperience4;
-        return _regeneratorRuntime.wrap(function _callee2$(_context3) {
-          while (1) switch (_context3.prev = _context3.next) {
+      var _fetchSyncBlocksData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3(syncBlockNodes) {
+        var _this8 = this,
+          _this$fetchExperience6;
+        var nodesToFetch, data, _this$processFetchedD2, hasUnexpectedError, hasExpectedError, _this$fetchExperience7, _this$fetchExperience8, _this$fetchExperience9;
+        return _regeneratorRuntime.wrap(function _callee3$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
             case 0:
               if (!(syncBlockNodes.length === 0)) {
-                _context3.next = 2;
+                _context4.next = 2;
                 break;
               }
-              return _context3.abrupt("return");
+              return _context4.abrupt("return");
             case 2:
               // Don't fetch for not_found error since the source is already deleted
               nodesToFetch = [];
               syncBlockNodes.forEach(function (node) {
                 var _existingSyncBlock$er;
-                if (_this7.syncBlockFetchDataRequests.get(node.attrs.resourceId)) {
+                if (_this8.syncBlockFetchDataRequests.get(node.attrs.resourceId)) {
                   return;
                 }
-                var existingSyncBlock = _this7.getFromCache(node.attrs.resourceId);
+                var existingSyncBlock = _this8.getFromCache(node.attrs.resourceId);
                 if ((existingSyncBlock === null || existingSyncBlock === void 0 || (_existingSyncBlock$er = existingSyncBlock.error) === null || _existingSyncBlock$er === void 0 ? void 0 : _existingSyncBlock$er.type) === SyncBlockError.NotFound) {
                   return;
                 }
                 nodesToFetch.push(node);
               });
               if (!(nodesToFetch.length === 0)) {
-                _context3.next = 6;
+                _context4.next = 6;
                 break;
               }
-              return _context3.abrupt("return");
+              return _context4.abrupt("return");
             case 6:
               if (this.dataProvider) {
-                _context3.next = 8;
+                _context4.next = 8;
                 break;
               }
               throw new Error('Data provider not set');
             case 8:
               nodesToFetch.forEach(function (node) {
-                _this7.syncBlockFetchDataRequests.set(node.attrs.resourceId, true);
+                _this8.syncBlockFetchDataRequests.set(node.attrs.resourceId, true);
               });
-              (_this$fetchExperience = this.fetchExperience) === null || _this$fetchExperience === void 0 || _this$fetchExperience.start({});
-              _context3.next = 12;
+              (_this$fetchExperience6 = this.fetchExperience) === null || _this$fetchExperience6 === void 0 || _this$fetchExperience6.start({});
+              _context4.next = 12;
               return this.dataProvider.fetchNodesData(nodesToFetch).finally(function () {
                 nodesToFetch.forEach(function (node) {
-                  _this7.syncBlockFetchDataRequests.delete(node.attrs.resourceId);
+                  _this8.syncBlockFetchDataRequests.delete(node.attrs.resourceId);
                 });
               });
             case 12:
-              data = _context3.sent;
-              hasUnexpectedError = false;
-              hasExpectedError = false;
-              data.forEach(function (syncBlockInstance) {
-                var _resolvedSyncBlockIns;
-                if (!syncBlockInstance.resourceId) {
-                  var _this7$fireAnalyticsE, _syncBlockInstance$er2;
-                  (_this7$fireAnalyticsE = _this7.fireAnalyticsEvent) === null || _this7$fireAnalyticsE === void 0 || _this7$fireAnalyticsE.call(_this7, fetchErrorPayload(((_syncBlockInstance$er2 = syncBlockInstance.error) === null || _syncBlockInstance$er2 === void 0 ? void 0 : _syncBlockInstance$er2.type) || 'Returned sync block instance does not have resource id'));
-                  return;
-                }
-                var existingSyncBlock = _this7.getFromCache(syncBlockInstance.resourceId);
-                var resolvedSyncBlockInstance = existingSyncBlock ? resolveSyncBlockInstance(existingSyncBlock, syncBlockInstance) : syncBlockInstance;
-                _this7.updateCache(resolvedSyncBlockInstance);
-
-                // Check if this is a newly added unpublished sync block and notify
-                // Only trigger for sync blocks that were just added (not refreshed or loaded on page init)
-                if (!syncBlockInstance.error && ((_resolvedSyncBlockIns = resolvedSyncBlockInstance.data) === null || _resolvedSyncBlockIns === void 0 ? void 0 : _resolvedSyncBlockIns.status) === 'unpublished' && _this7.newlyAddedSyncBlocks.has(syncBlockInstance.resourceId) && _this7.onUnpublishedSyncBlockDetected) {
-                  // Remove from newly added set after checking to prevent duplicate flags
-                  _this7.newlyAddedSyncBlocks.delete(syncBlockInstance.resourceId);
-                  _this7.onUnpublishedSyncBlockDetected(resolvedSyncBlockInstance.resourceId);
-                } else if (_this7.newlyAddedSyncBlocks.has(syncBlockInstance.resourceId)) {
-                  // Remove from newly added set even if not unpublished (to clean up)
-                  _this7.newlyAddedSyncBlocks.delete(syncBlockInstance.resourceId);
-                }
-                if (syncBlockInstance.error) {
-                  var _this7$fireAnalyticsE2;
-                  (_this7$fireAnalyticsE2 = _this7.fireAnalyticsEvent) === null || _this7$fireAnalyticsE2 === void 0 || _this7$fireAnalyticsE2.call(_this7, fetchErrorPayload(syncBlockInstance.error.type, syncBlockInstance.resourceId));
-                  if (syncBlockInstance.error.type === SyncBlockError.NotFound || syncBlockInstance.error.type === SyncBlockError.Forbidden) {
-                    hasExpectedError = true;
-                  } else if (syncBlockInstance.error) {
-                    hasUnexpectedError = true;
-                  }
-                  return;
-                } else {
-                  var callbacks = _this7.subscriptions.get(syncBlockInstance.resourceId);
-                  var localIds = callbacks ? Object.keys(callbacks) : [];
-                  localIds.forEach(function (localId) {
-                    var _this7$fireAnalyticsE3, _syncBlockInstance$da2;
-                    (_this7$fireAnalyticsE3 = _this7.fireAnalyticsEvent) === null || _this7$fireAnalyticsE3 === void 0 || _this7$fireAnalyticsE3.call(_this7, fetchSuccessPayload(syncBlockInstance.resourceId, localId, (_syncBlockInstance$da2 = syncBlockInstance.data) === null || _syncBlockInstance$da2 === void 0 ? void 0 : _syncBlockInstance$da2.product));
-                  });
-                }
-                _this7.fetchSyncBlockSourceInfo(resolvedSyncBlockInstance.resourceId);
-              });
+              data = _context4.sent;
+              _this$processFetchedD2 = this.processFetchedData(data), hasUnexpectedError = _this$processFetchedD2.hasUnexpectedError, hasExpectedError = _this$processFetchedD2.hasExpectedError;
               if (hasUnexpectedError) {
-                (_this$fetchExperience2 = this.fetchExperience) === null || _this$fetchExperience2 === void 0 || _this$fetchExperience2.failure({
+                (_this$fetchExperience7 = this.fetchExperience) === null || _this$fetchExperience7 === void 0 || _this$fetchExperience7.failure({
                   reason: 'Unexpected error during fetch'
                 });
               } else if (hasExpectedError) {
-                (_this$fetchExperience3 = this.fetchExperience) === null || _this$fetchExperience3 === void 0 || _this$fetchExperience3.abort({
+                (_this$fetchExperience8 = this.fetchExperience) === null || _this$fetchExperience8 === void 0 || _this$fetchExperience8.abort({
                   reason: 'Expected error: NotFound or PermissionDenied'
                 });
               } else {
-                (_this$fetchExperience4 = this.fetchExperience) === null || _this$fetchExperience4 === void 0 || _this$fetchExperience4.success();
+                (_this$fetchExperience9 = this.fetchExperience) === null || _this$fetchExperience9 === void 0 || _this$fetchExperience9.success();
               }
-            case 17:
+            case 15:
             case "end":
-              return _context3.stop();
+              return _context4.stop();
           }
-        }, _callee2, this);
+        }, _callee3, this);
       }));
-      function fetchSyncBlocksData(_x) {
+      function fetchSyncBlocksData(_x2) {
         return _fetchSyncBlocksData.apply(this, arguments);
       }
       return fetchSyncBlocksData;
     }())
+  }, {
+    key: "processFetchedData",
+    value: function processFetchedData(data) {
+      var _this9 = this;
+      if (!data) {
+        return {
+          hasUnexpectedError: false,
+          hasExpectedError: false
+        };
+      }
+      var hasUnexpectedError = false;
+      var hasExpectedError = false;
+      data.forEach(function (syncBlockInstance) {
+        var _resolvedSyncBlockIns;
+        if (!syncBlockInstance.resourceId) {
+          var _this9$fireAnalyticsE, _syncBlockInstance$er2;
+          (_this9$fireAnalyticsE = _this9.fireAnalyticsEvent) === null || _this9$fireAnalyticsE === void 0 || _this9$fireAnalyticsE.call(_this9, fetchErrorPayload(((_syncBlockInstance$er2 = syncBlockInstance.error) === null || _syncBlockInstance$er2 === void 0 ? void 0 : _syncBlockInstance$er2.type) || 'Returned sync block instance does not have resource id'));
+          return;
+        }
+        var existingSyncBlock = _this9.getFromCache(syncBlockInstance.resourceId);
+        var resolvedSyncBlockInstance = existingSyncBlock ? resolveSyncBlockInstance(existingSyncBlock, syncBlockInstance) : syncBlockInstance;
+        _this9.updateCache(resolvedSyncBlockInstance);
+
+        // Check if this is a newly added unpublished sync block and notify
+        // Only trigger for sync blocks that were just added (not refreshed or loaded on page init)
+        if (!syncBlockInstance.error && ((_resolvedSyncBlockIns = resolvedSyncBlockInstance.data) === null || _resolvedSyncBlockIns === void 0 ? void 0 : _resolvedSyncBlockIns.status) === 'unpublished' && _this9.newlyAddedSyncBlocks.has(syncBlockInstance.resourceId) && _this9.onUnpublishedSyncBlockDetected) {
+          // Remove from newly added set after checking to prevent duplicate flags
+          _this9.newlyAddedSyncBlocks.delete(syncBlockInstance.resourceId);
+          _this9.onUnpublishedSyncBlockDetected(resolvedSyncBlockInstance.resourceId);
+        } else if (_this9.newlyAddedSyncBlocks.has(syncBlockInstance.resourceId)) {
+          // Remove from newly added set even if not unpublished (to clean up)
+          _this9.newlyAddedSyncBlocks.delete(syncBlockInstance.resourceId);
+        }
+        if (syncBlockInstance.error) {
+          var _this9$fireAnalyticsE2;
+          (_this9$fireAnalyticsE2 = _this9.fireAnalyticsEvent) === null || _this9$fireAnalyticsE2 === void 0 || _this9$fireAnalyticsE2.call(_this9, fetchErrorPayload(syncBlockInstance.error.type, syncBlockInstance.resourceId));
+          if (syncBlockInstance.error.type === SyncBlockError.NotFound || syncBlockInstance.error.type === SyncBlockError.Forbidden) {
+            hasExpectedError = true;
+          } else if (syncBlockInstance.error) {
+            hasUnexpectedError = true;
+          }
+          return;
+        } else {
+          var callbacks = _this9.subscriptions.get(syncBlockInstance.resourceId);
+          var localIds = callbacks ? Object.keys(callbacks) : [];
+          localIds.forEach(function (localId) {
+            var _this9$fireAnalyticsE3, _syncBlockInstance$da2;
+            (_this9$fireAnalyticsE3 = _this9.fireAnalyticsEvent) === null || _this9$fireAnalyticsE3 === void 0 || _this9$fireAnalyticsE3.call(_this9, fetchSuccessPayload(syncBlockInstance.resourceId, localId, (_syncBlockInstance$da2 = syncBlockInstance.data) === null || _syncBlockInstance$da2 === void 0 ? void 0 : _syncBlockInstance$da2.product));
+          });
+        }
+        _this9.fetchSyncBlockSourceInfo(resolvedSyncBlockInstance.resourceId);
+      });
+      return {
+        hasUnexpectedError: hasUnexpectedError,
+        hasExpectedError: hasExpectedError
+      };
+    }
   }, {
     key: "updateCacheWithSourceInfo",
     value: function updateCacheWithSourceInfo(resourceId, sourceInfo) {
@@ -748,7 +836,7 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
       var _this$dataProvider7,
         _this$dataProvider8,
         _this$dataProvider9,
-        _this8 = this;
+        _this0 = this;
       // Cancel any pending cache deletion for this resourceId.
       // This handles the case where a block is moved - the old component unmounts
       // (scheduling deletion) but the new component mounts and subscribes before
@@ -784,11 +872,11 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
           this.debouncedBatchedFetchSyncBlocks(resourceId);
         } else {
           this.fetchSyncBlocksData([syncBlockNode]).catch(function (error) {
-            var _this8$fireAnalyticsE;
+            var _this0$fireAnalyticsE;
             logException(error, {
               location: 'editor-synced-block-provider/referenceSyncBlockStoreManager'
             });
-            (_this8$fireAnalyticsE = _this8.fireAnalyticsEvent) === null || _this8$fireAnalyticsE === void 0 || _this8$fireAnalyticsE.call(_this8, fetchErrorPayload(error.message, resourceId));
+            (_this0$fireAnalyticsE = _this0.fireAnalyticsEvent) === null || _this0$fireAnalyticsE === void 0 || _this0$fireAnalyticsE.call(_this0, fetchErrorPayload(error.message, resourceId));
           });
         }
       }
@@ -798,19 +886,19 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
         this.setupGraphQLSubscription(resourceId);
       }
       return function () {
-        var resourceSubscriptions = _this8.subscriptions.get(resourceId);
+        var resourceSubscriptions = _this0.subscriptions.get(resourceId);
         if (resourceSubscriptions) {
           // Unsubscription means a reference synced block is removed from the document
-          _this8.isCacheDirty = true;
+          _this0.isCacheDirty = true;
           delete resourceSubscriptions[localId];
           if (Object.keys(resourceSubscriptions).length === 0) {
-            _this8.subscriptions.delete(resourceId);
+            _this0.subscriptions.delete(resourceId);
 
             // Clean up GraphQL subscription when no more local subscribers
-            _this8.cleanupGraphQLSubscription(resourceId);
+            _this0.cleanupGraphQLSubscription(resourceId);
 
             // Notify listeners that subscription was removed
-            _this8.notifySubscriptionChangeListeners();
+            _this0.notifySubscriptionChangeListeners();
 
             // Delay cache deletion to handle block moves (unmount/remount).
             // When a block is moved, the old component unmounts before the new one mounts.
@@ -819,14 +907,14 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
             // TODO: EDITOR-4152 - Rework this logic
             var deletionTimeout = setTimeout(function () {
               // Only delete if still no subscribers (wasn't re-subscribed)
-              if (!_this8.subscriptions.has(resourceId)) {
-                _this8.deleteFromCache(resourceId);
+              if (!_this0.subscriptions.has(resourceId)) {
+                _this0.deleteFromCache(resourceId);
               }
-              _this8.pendingCacheDeletions.delete(resourceId);
+              _this0.pendingCacheDeletions.delete(resourceId);
             }, 1000);
-            _this8.pendingCacheDeletions.set(resourceId, deletionTimeout);
+            _this0.pendingCacheDeletions.set(resourceId, deletionTimeout);
           } else {
-            _this8.subscriptions.set(resourceId, resourceSubscriptions);
+            _this0.subscriptions.set(resourceId, resourceSubscriptions);
           }
         }
       };
@@ -835,7 +923,7 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
     key: "subscribeToSourceTitle",
     value: function subscribeToSourceTitle(node, callback) {
       var _cachedData$data,
-        _this9 = this;
+        _this1 = this;
       // check node is a sync block, as we only support sync block subscriptions
       if (node.type.name !== 'syncBlock') {
         return function () {};
@@ -855,13 +943,13 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
       var resourceSubscriptions = this.titleSubscriptions.get(resourceId) || {};
       this.titleSubscriptions.set(resourceId, _objectSpread(_objectSpread({}, resourceSubscriptions), {}, _defineProperty({}, localId, callback)));
       return function () {
-        var resourceSubscriptions = _this9.titleSubscriptions.get(resourceId);
+        var resourceSubscriptions = _this1.titleSubscriptions.get(resourceId);
         if (resourceSubscriptions) {
           delete resourceSubscriptions[localId];
           if (Object.keys(resourceSubscriptions).length === 0) {
-            _this9.titleSubscriptions.delete(resourceId);
+            _this1.titleSubscriptions.delete(resourceId);
           } else {
-            _this9.titleSubscriptions.set(resourceId, resourceSubscriptions);
+            _this1.titleSubscriptions.set(resourceId, resourceSubscriptions);
           }
         }
       };
@@ -1055,19 +1143,19 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
   }, {
     key: "flush",
     value: (function () {
-      var _flush = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
+      var _flush = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4() {
         var success, _this$saveExperience, blocks, updateResult, _this$saveExperience2, _this$fireAnalyticsEv1, _this$saveExperience3, _this$fireAnalyticsEv10, _this$saveExperience4;
-        return _regeneratorRuntime.wrap(function _callee3$(_context4) {
-          while (1) switch (_context4.prev = _context4.next) {
+        return _regeneratorRuntime.wrap(function _callee4$(_context5) {
+          while (1) switch (_context5.prev = _context5.next) {
             case 0:
               if (this.isCacheDirty) {
-                _context4.next = 2;
+                _context5.next = 2;
                 break;
               }
-              return _context4.abrupt("return", true);
+              return _context5.abrupt("return", true);
             case 2:
               success = true;
-              _context4.prev = 3;
+              _context5.prev = 3;
               blocks = []; // Collect all reference synced blocks on the current document
               Array.from(this.subscriptions.entries()).forEach(function (_ref2) {
                 var _ref3 = _slicedToArray(_ref2, 2),
@@ -1081,7 +1169,7 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
                 });
               });
               if (this.dataProvider) {
-                _context4.next = 8;
+                _context5.next = 8;
                 break;
               }
               throw new Error('Data provider not set');
@@ -1093,10 +1181,10 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
               // exactly at a time when the updateReferenceData is being executed asynchronously.
               this.isCacheDirty = false;
               (_this$saveExperience = this.saveExperience) === null || _this$saveExperience === void 0 || _this$saveExperience.start();
-              _context4.next = 12;
+              _context5.next = 12;
               return this.dataProvider.updateReferenceData(blocks);
             case 12:
-              updateResult = _context4.sent;
+              updateResult = _context5.sent;
               if (!updateResult.success) {
                 success = false;
                 (_this$saveExperience2 = this.saveExperience) === null || _this$saveExperience2 === void 0 || _this$saveExperience2.failure({
@@ -1104,35 +1192,35 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
                 });
                 (_this$fireAnalyticsEv1 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv1 === void 0 || _this$fireAnalyticsEv1.call(this, updateReferenceErrorPayload(updateResult.error || 'Failed to update reference synced blocks on the document'));
               }
-              _context4.next = 22;
+              _context5.next = 22;
               break;
             case 16:
-              _context4.prev = 16;
-              _context4.t0 = _context4["catch"](3);
+              _context5.prev = 16;
+              _context5.t0 = _context5["catch"](3);
               success = false;
-              logException(_context4.t0, {
+              logException(_context5.t0, {
                 location: 'editor-synced-block-provider/referenceSyncBlockStoreManager'
               });
               (_this$saveExperience3 = this.saveExperience) === null || _this$saveExperience3 === void 0 || _this$saveExperience3.failure({
-                reason: _context4.t0.message
+                reason: _context5.t0.message
               });
-              (_this$fireAnalyticsEv10 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv10 === void 0 || _this$fireAnalyticsEv10.call(this, updateReferenceErrorPayload(_context4.t0.message));
+              (_this$fireAnalyticsEv10 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv10 === void 0 || _this$fireAnalyticsEv10.call(this, updateReferenceErrorPayload(_context5.t0.message));
             case 22:
-              _context4.prev = 22;
+              _context5.prev = 22;
               if (!success) {
                 // set isCacheDirty back to true for cases where it failed to update the reference synced blocks on the BE
                 this.isCacheDirty = true;
               } else {
                 (_this$saveExperience4 = this.saveExperience) === null || _this$saveExperience4 === void 0 || _this$saveExperience4.success();
               }
-              return _context4.finish(22);
+              return _context5.finish(22);
             case 25:
-              return _context4.abrupt("return", success);
+              return _context5.abrupt("return", success);
             case 26:
             case "end":
-              return _context4.stop();
+              return _context5.stop();
           }
-        }, _callee3, this, [[3, 16, 22, 25]]);
+        }, _callee4, this, [[3, 16, 22, 25]]);
       }));
       function flush() {
         return _flush.apply(this, arguments);
@@ -1142,7 +1230,7 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
   }, {
     key: "destroy",
     value: function destroy() {
-      var _this$saveExperience5, _this$fetchExperience5, _this$fetchSourceInfo2;
+      var _this$saveExperience5, _this$fetchExperience0, _this$fetchSourceInfo2;
       // Clean up all GraphQL subscriptions first
       this.cleanupAllGraphQLSubscriptions();
       if (fg('platform_synced_block_patch_1')) {
@@ -1171,7 +1259,7 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
       (_this$saveExperience5 = this.saveExperience) === null || _this$saveExperience5 === void 0 || _this$saveExperience5.abort({
         reason: 'editorDestroyed'
       });
-      (_this$fetchExperience5 = this.fetchExperience) === null || _this$fetchExperience5 === void 0 || _this$fetchExperience5.abort({
+      (_this$fetchExperience0 = this.fetchExperience) === null || _this$fetchExperience0 === void 0 || _this$fetchExperience0.abort({
         reason: 'editorDestroyed'
       });
       (_this$fetchSourceInfo2 = this.fetchSourceInfoExperience) === null || _this$fetchSourceInfo2 === void 0 || _this$fetchSourceInfo2.abort({

package/dist/types/common/types.d.ts

@@ -1,6 +1,6 @@
 import type { ADFEntity } from '@atlaskit/adf-utils/types';
 import type { JSONNode } from '@atlaskit/editor-json-transformer/types';
-import type { SyncBlockSourceInfo } from '../providers/types';
+import type { SyncBlockInstance, SyncBlockSourceInfo } from '../providers/types';
 import type { SYNC_BLOCK_PRODUCTS } from './consts';
 export type BlockInstanceId = string;
 export type ResourceId = string;
@@ -73,3 +73,7 @@ export type ReferencesSourceInfo = {
 };
 export type DeletionReason = 'source-block-deleted' | 'source-block-unsynced';
 export type DeletionReasonResponse = DeletionReason | 'source-document-deleted';
+export type SyncBlockPrefetchData = {
+    prefetchPromise: Promise<SyncBlockInstance[] | undefined>;
+    resourceIds: string[];
+};

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 export { rebaseTransaction } from './common/rebase-transaction';
 export { SyncBlockError } from './common/types';
-export type { ResourceId, SyncBlockData, SyncBlockNode, SyncBlockProduct, SyncBlockStatus, BlockInstanceId, SyncBlockAttrs, ReferenceSyncBlockData, ReferencesSourceInfo, DeletionReason, } from './common/types';
+export type { ResourceId, SyncBlockData, SyncBlockNode, SyncBlockProduct, SyncBlockStatus, BlockInstanceId, SyncBlockAttrs, ReferenceSyncBlockData, ReferencesSourceInfo, DeletionReason, SyncBlockPrefetchData, } 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 { generateBlockAri, generateBlockAriFromReference, getLocalIdFromBlockRes
 export { getConfluencePageAri, getPageIdAndTypeFromConfluencePageAri, } from './clients/confluence/ari';
 export { fetchMediaToken, type TokenData, type ConfigData, } from './clients/confluence/fetchMediaToken';
 export { getJiraWorkItemAri, getJiraWorkItemIdFromAri } from './clients/jira/ari';
-export { useMemoizedBlockServiceAPIProviders, useMemoizedBlockServiceFetchOnlyAPIProvider, } from './providers/block-service/blockServiceAPI';
+export { useMemoizedBlockServiceAPIProviders, useMemoizedBlockServiceFetchOnlyAPIProvider, fetchReferences, batchFetchData, } from './providers/block-service/blockServiceAPI';
 export { fetchConfluencePageInfo } from './clients/confluence/sourceInfo';
 export { SyncBlockProvider as SyncedBlockProvider, useMemoizedSyncedBlockProvider, } from './providers/syncBlockProvider';
 export type { ADFFetchProvider, ADFWriteProvider, BlockNodeIdentifiers, BlockSubscriptionErrorCallback, BlockUpdateCallback, SyncBlockDataProvider, SyncBlockInstance, MediaEmojiProviderOptions, SyncedBlockRendererProviderOptions, SyncBlockRendererProviderCreator, SyncedBlockRendererDataProviders, Unsubscribe, UpdateReferenceSyncBlockResult, WriteSyncBlockResult, SyncBlockParentInfo, SyncBlockSourceInfo, } from './providers/types';
@@ -19,4 +19,3 @@ export { parseResourceId, createResourceIdForReference } from './utils/resourceI
 export { createSyncBlockNode, convertSyncBlockPMNodeToSyncBlockData, convertSyncBlockJSONNodeToSyncBlockNode, convertPMNodesToSyncBlockNodes, getContentIdAndProductFromResourceId, } from './utils/utils';
 export { fetchErrorPayload } from './utils/errorHandling';
 export { normaliseSyncBlockProduct, normaliseSyncBlockStatus } from './utils/validValue';
-export { fetchReferences } from './providers/block-service/blockServiceAPI';

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

@@ -20,6 +20,19 @@ import type { ADFFetchProvider, ADFWriteProvider, BlockNodeIdentifiers, DeleteSy
 export declare const blockAriToResourceId: (blockAri: string) => ResourceId | null;
 export declare const convertToSyncBlockData: (data: BlockContentResponse, resourceId: ResourceId) => SyncBlockData;
 export declare const fetchReferences: (documentAri: string) => Promise<SyncBlockInstance[] | SyncBlockError>;
+/**
+ * Extracts the resourceId from a block ARI.
+ * Block ARI format: ari:cloud:blocks:<cloudId>:synced-block/<resourceId>
+ */
+export declare const extractResourceIdFromBlockAri: (blockAri: string) => string | undefined;
+/**
+ * Batch fetches multiple synced blocks by their resource IDs.
+ * @param cloudId - The cloudId of the block. E.G the cloudId of the confluence page, or the cloudId of the Jira instance
+ * @param parentAri - The ARI of the parent of the block. E.G the ARI of the confluence page, or the ARI of the Jira work item
+ * @param blockNodeIdentifiers - Array of block node identifiers to fetch
+ * @returns Array of SyncBlockInstance results
+ */
+export declare const batchFetchData: (cloudId: string, parentAri: string | undefined, blockNodeIdentifiers: BlockNodeIdentifiers[]) => Promise<SyncBlockInstance[]>;
 interface BlockServiceADFFetchProviderProps {
     cloudId: string;
     parentAri: string | undefined;
@@ -33,14 +46,9 @@ declare class BlockServiceADFFetchProvider implements ADFFetchProvider {
     constructor({ cloudId, parentAri }: BlockServiceADFFetchProviderProps);
     fetchData(resourceId: string): Promise<SyncBlockInstance>;
     fetchReferences(referenceResourceId: string): Promise<ReferenceSyncBlockData>;
-    /**
-     * Extracts the resourceId from a block ARI.
-     * Block ARI format: ari:cloud:blocks:<cloudId>:synced-block/<resourceId>
-     */
-    private extractResourceIdFromBlockAri;
     /**
      * Batch fetches multiple synced blocks by their resource IDs.
-     * @param resourceIds - Array of resource IDs to fetch
+     * @param blockNodeIdentifiers - Array of block node identifiers to fetch
      * @returns Array of SyncBlockInstance results
      */
     batchFetchData(blockNodeIdentifiers: BlockNodeIdentifiers[]): Promise<SyncBlockInstance[]>;

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

@@ -2,7 +2,7 @@ import { type RendererSyncBlockEventPayload } from '@atlaskit/editor-common/anal
 import type { Experience } from '@atlaskit/editor-common/experiences';
 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';
+import { type ResourceId, type SyncBlockNode, type SyncBlockPrefetchData } from '../common/types';
 import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProvider, TitleSubscriptionCallback, SyncBlockSourceInfo } from '../providers/types';
 export declare class ReferenceSyncBlockStoreManager {
     private dataProvider?;
@@ -102,12 +102,19 @@ export declare class ReferenceSyncBlockStoreManager {
     private cleanupAllGraphQLSubscriptions;
     fetchSyncBlockSourceInfoBySourceAri(sourceAri: string, hasAccess?: boolean, urlType?: 'view' | 'edit'): Promise<SyncBlockSourceInfo | undefined>;
     fetchSyncBlockSourceInfo(resourceId: ResourceId): Promise<SyncBlockSourceInfo | undefined>;
+    /**
+     * Processes prefetched data and updates the cache.
+     * @param prefetchedData - The prefetched data to process
+     * @returns {Promise<void>}
+     */
+    processPrefetchedData(prefetchedData: SyncBlockPrefetchData | undefined): Promise<void>;
     /**
      * 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<void>;
+    private processFetchedData;
     private updateCacheWithSourceInfo;
     private updateCache;
     private updateSourceTitleSubscriptions;

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

@@ -1,6 +1,6 @@
 import type { ADFEntity } from '@atlaskit/adf-utils/types';
 import type { JSONNode } from '@atlaskit/editor-json-transformer/types';
-import type { SyncBlockSourceInfo } from '../providers/types';
+import type { SyncBlockInstance, SyncBlockSourceInfo } from '../providers/types';
 import type { SYNC_BLOCK_PRODUCTS } from './consts';
 export type BlockInstanceId = string;
 export type ResourceId = string;
@@ -73,3 +73,7 @@ export type ReferencesSourceInfo = {
 };
 export type DeletionReason = 'source-block-deleted' | 'source-block-unsynced';
 export type DeletionReasonResponse = DeletionReason | 'source-document-deleted';
+export type SyncBlockPrefetchData = {
+    prefetchPromise: Promise<SyncBlockInstance[] | undefined>;
+    resourceIds: string[];
+};

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 { ResourceId, SyncBlockData, SyncBlockNode, SyncBlockProduct, SyncBlockStatus, BlockInstanceId, SyncBlockAttrs, ReferenceSyncBlockData, ReferencesSourceInfo, DeletionReason, } from './common/types';
+export type { ResourceId, SyncBlockData, SyncBlockNode, SyncBlockProduct, SyncBlockStatus, BlockInstanceId, SyncBlockAttrs, ReferenceSyncBlockData, ReferencesSourceInfo, DeletionReason, SyncBlockPrefetchData, } 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 { generateBlockAri, generateBlockAriFromReference, getLocalIdFromBlockRes
 export { getConfluencePageAri, getPageIdAndTypeFromConfluencePageAri, } from './clients/confluence/ari';
 export { fetchMediaToken, type TokenData, type ConfigData, } from './clients/confluence/fetchMediaToken';
 export { getJiraWorkItemAri, getJiraWorkItemIdFromAri } from './clients/jira/ari';
-export { useMemoizedBlockServiceAPIProviders, useMemoizedBlockServiceFetchOnlyAPIProvider, } from './providers/block-service/blockServiceAPI';
+export { useMemoizedBlockServiceAPIProviders, useMemoizedBlockServiceFetchOnlyAPIProvider, fetchReferences, batchFetchData, } from './providers/block-service/blockServiceAPI';
 export { fetchConfluencePageInfo } from './clients/confluence/sourceInfo';
 export { SyncBlockProvider as SyncedBlockProvider, useMemoizedSyncedBlockProvider, } from './providers/syncBlockProvider';
 export type { ADFFetchProvider, ADFWriteProvider, BlockNodeIdentifiers, BlockSubscriptionErrorCallback, BlockUpdateCallback, SyncBlockDataProvider, SyncBlockInstance, MediaEmojiProviderOptions, SyncedBlockRendererProviderOptions, SyncBlockRendererProviderCreator, SyncedBlockRendererDataProviders, Unsubscribe, UpdateReferenceSyncBlockResult, WriteSyncBlockResult, SyncBlockParentInfo, SyncBlockSourceInfo, } from './providers/types';
@@ -19,4 +19,3 @@ export { parseResourceId, createResourceIdForReference } from './utils/resourceI
 export { createSyncBlockNode, convertSyncBlockPMNodeToSyncBlockData, convertSyncBlockJSONNodeToSyncBlockNode, convertPMNodesToSyncBlockNodes, getContentIdAndProductFromResourceId, } from './utils/utils';
 export { fetchErrorPayload } from './utils/errorHandling';
 export { normaliseSyncBlockProduct, normaliseSyncBlockStatus } from './utils/validValue';
-export { fetchReferences } from './providers/block-service/blockServiceAPI';