@atlaskit/editor-synced-block-provider 2.15.2 → 2.15.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @atlaskit/editor-synced-block-provider
 
+## 2.15.3
+
+### Patch Changes
+
+- [`f14e76661c943`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/f14e76661c943) -
+  [EDITOR-2844] Save reference synced block on document to BE when a page is saved
+- Updated dependencies
+
 ## 2.15.2
 
 ### Patch Changes

package/dist/cjs/clients/block-service/blockService.js

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.updateSyncedBlock = exports.isBlockContentResponse = exports.getSyncedBlockContent = exports.getReferenceSyncedBlocks = exports.deleteSyncedBlock = exports.createSyncedBlock = exports.BlockError = void 0;
+exports.updateSyncedBlock = exports.updateReferenceSyncedBlockOnDocument = exports.isBlockContentResponse = exports.getSyncedBlockContent = exports.getReferenceSyncedBlocks = exports.deleteSyncedBlock = exports.createSyncedBlock = exports.BlockError = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
@@ -247,4 +247,45 @@ var createSyncedBlock = exports.createSyncedBlock = /*#__PURE__*/function () {
   return function createSyncedBlock(_x5) {
     return _ref9.apply(this, arguments);
   };
+}();
+var updateReferenceSyncedBlockOnDocument = exports.updateReferenceSyncedBlockOnDocument = /*#__PURE__*/function () {
+  var _ref1 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee6(_ref0) {
+    var documentAri, blocks, _ref0$noContent, noContent, response;
+    return _regenerator.default.wrap(function _callee6$(_context6) {
+      while (1) switch (_context6.prev = _context6.next) {
+        case 0:
+          documentAri = _ref0.documentAri, blocks = _ref0.blocks, _ref0$noContent = _ref0.noContent, noContent = _ref0$noContent === void 0 ? true : _ref0$noContent;
+          _context6.next = 3;
+          return (0, _retry.fetchWithRetry)("".concat(BLOCK_SERVICE_API_URL, "/block/document/").concat(encodeURIComponent(documentAri), "/references?noContent=").concat(noContent), {
+            method: 'PUT',
+            headers: COMMON_HEADERS,
+            body: JSON.stringify({
+              blocks: blocks
+            })
+          });
+        case 3:
+          response = _context6.sent;
+          if (response.ok) {
+            _context6.next = 6;
+            break;
+          }
+          throw new BlockError(response.status);
+        case 6:
+          if (noContent) {
+            _context6.next = 10;
+            break;
+          }
+          _context6.next = 9;
+          return response.json();
+        case 9:
+          return _context6.abrupt("return", _context6.sent);
+        case 10:
+        case "end":
+          return _context6.stop();
+      }
+    }, _callee6);
+  }));
+  return function updateReferenceSyncedBlockOnDocument(_x6) {
+    return _ref1.apply(this, arguments);
+  };
 }();

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

@@ -325,21 +325,30 @@ var BlockServiceADFWriteProvider = /*#__PURE__*/function () {
               _context5.prev = 7;
               _context5.t0 = _context5["catch"](1);
               if (!(_context5.t0 instanceof _blockService.BlockError)) {
-                _context5.next = 11;
+                _context5.next = 13;
+                break;
+              }
+              if (!(_context5.t0.status === 404)) {
+                _context5.next = 12;
                 break;
               }
+              return _context5.abrupt("return", {
+                resourceId: resourceId,
+                success: true
+              });
+            case 12:
               return _context5.abrupt("return", {
                 resourceId: resourceId,
                 success: false,
                 error: mapBlockError(_context5.t0)
               });
-            case 11:
+            case 13:
               return _context5.abrupt("return", {
                 resourceId: resourceId,
                 success: false,
                 error: (0, _errorHandling.stringifyError)(_context5.t0)
               });
-            case 12:
+            case 14:
             case "end":
               return _context5.stop();
           }
@@ -360,6 +369,56 @@ var BlockServiceADFWriteProvider = /*#__PURE__*/function () {
     value: function generateResourceId() {
       return crypto.randomUUID();
     }
+  }, {
+    key: "updateReferenceData",
+    value: function () {
+      var _updateReferenceData = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee6(blocks, noContent) {
+        var _this = this;
+        return _regenerator.default.wrap(function _callee6$(_context6) {
+          while (1) switch (_context6.prev = _context6.next) {
+            case 0:
+              _context6.prev = 0;
+              _context6.next = 3;
+              return (0, _blockService.updateReferenceSyncedBlockOnDocument)({
+                documentAri: this.sourceAri,
+                blocks: blocks.map(function (block) {
+                  return {
+                    blockAri: (0, _ari.generateBlockAriFromReference)(_this.sourceAri, block.resourceId),
+                    blockInstanceId: block.localId
+                  };
+                }, noContent)
+              });
+            case 3:
+              return _context6.abrupt("return", {
+                success: true
+              });
+            case 6:
+              _context6.prev = 6;
+              _context6.t0 = _context6["catch"](0);
+              if (!(_context6.t0 instanceof _blockService.BlockError)) {
+                _context6.next = 10;
+                break;
+              }
+              return _context6.abrupt("return", {
+                success: false,
+                error: mapBlockError(_context6.t0)
+              });
+            case 10:
+              return _context6.abrupt("return", {
+                success: false,
+                error: (0, _errorHandling.stringifyError)(_context6.t0)
+              });
+            case 11:
+            case "end":
+              return _context6.stop();
+          }
+        }, _callee6, this, [[0, 6]]);
+      }));
+      function updateReferenceData(_x6, _x7) {
+        return _updateReferenceData.apply(this, arguments);
+      }
+      return updateReferenceData;
+    }()
   }]);
 }();
 /**

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

@@ -409,6 +409,13 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
     value: function generateResourceIdForReference(sourceId) {
       return sourceId;
     }
+  }, {
+    key: "updateReferenceData",
+    value: function updateReferenceData(_blocks, _noContent) {
+      return Promise.resolve({
+        success: true
+      });
+    }
   }]);
 }();
 /**

package/dist/cjs/providers/syncBlockProvider.js

@@ -296,6 +296,11 @@ var SyncBlockProvider = exports.SyncBlockProvider = /*#__PURE__*/function (_Sync
           throw new Error("".concat(sourceProduct, " source product not supported"));
       }
     }
+  }, {
+    key: "updateReferenceData",
+    value: function updateReferenceData(blocks, noContent) {
+      return this.writeProvider.updateReferenceData(blocks, noContent);
+    }
   }]);
 }(_types2.SyncBlockDataProvider);
 var useMemoizedSyncedBlockProvider = exports.useMemoizedSyncedBlockProvider = function useMemoizedSyncedBlockProvider(fetchProvider, writeProvider, sourceId, providerOptions, getSSRData) {

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

@@ -30,6 +30,10 @@ function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length)
 var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
   function ReferenceSyncBlockStoreManager(dataProvider, fireAnalyticsEvent) {
     (0, _classCallCheck2.default)(this, ReferenceSyncBlockStoreManager);
+    // Keeps track of addition and deletion of reference synced blocks on the document
+    // This starts as true to always flush the cache when document is saved for the first time
+    // to cater the case when a editor seesion is closed without document being updated right after reference block is deleted
+    (0, _defineProperty2.default)(this, "isCacheDirty", true);
     (0, _defineProperty2.default)(this, "isRefreshingSubscriptions", false);
     this.syncBlockCache = new Map();
     this.subscriptions = new Map();
@@ -327,6 +331,9 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
       // add to subscriptions map
       var resourceSubscriptions = this.subscriptions.get(resourceId) || {};
       this.subscriptions.set(resourceId, _objectSpread(_objectSpread({}, resourceSubscriptions), {}, (0, _defineProperty2.default)({}, localId, callback)));
+
+      // New subscription means new reference synced block is added to the document
+      this.isCacheDirty = true;
       var syncBlockNode = (0, _utils.createSyncBlockNode)(localId, resourceId);
 
       // call the callback immediately if we have cached data
@@ -346,6 +353,8 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
       return function () {
         var resourceSubscriptions = _this3.subscriptions.get(resourceId);
         if (resourceSubscriptions) {
+          // Unsubscription means a reference synced block is removed from the document
+          _this3.isCacheDirty = true;
           delete resourceSubscriptions[localId];
           if (Object.keys(resourceSubscriptions).length === 0) {
             _this3.subscriptions.delete(resourceId);
@@ -515,6 +524,89 @@ var ReferenceSyncBlockStoreManager = exports.ReferenceSyncBlockStoreManager = /*
         }
       }
     }
+
+    /**
+     * Update reference synced blocks on the document with the BE
+     * 
+     * @returns true if the reference synced blocks are updated successfully, false otherwise
+     */
+  }, {
+    key: "flush",
+    value: (function () {
+      var _flush = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3() {
+        var success, blocks, updateResult, _this$fireAnalyticsEv9, _this$fireAnalyticsEv0;
+        return _regenerator.default.wrap(function _callee3$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
+            case 0:
+              if (this.isCacheDirty) {
+                _context4.next = 2;
+                break;
+              }
+              return _context4.abrupt("return", true);
+            case 2:
+              success = true;
+              _context4.prev = 3;
+              if (this.dataProvider) {
+                _context4.next = 6;
+                break;
+              }
+              throw new Error('Data provider not set');
+            case 6:
+              blocks = []; // Collect all reference synced blocks on the current document
+              Array.from(this.subscriptions.entries()).forEach(function (_ref2) {
+                var _ref3 = (0, _slicedToArray2.default)(_ref2, 2),
+                  resourceId = _ref3[0],
+                  callbacks = _ref3[1];
+                Object.keys(callbacks).forEach(function (localId) {
+                  blocks.push({
+                    resourceId: resourceId,
+                    localId: localId
+                  });
+                });
+              });
+              if (!(blocks.length === 0)) {
+                _context4.next = 10;
+                break;
+              }
+              return _context4.abrupt("return", true);
+            case 10:
+              _context4.next = 12;
+              return this.dataProvider.updateReferenceData(blocks);
+            case 12:
+              updateResult = _context4.sent;
+              if (!updateResult.success) {
+                success = false;
+                (_this$fireAnalyticsEv9 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv9 === void 0 || _this$fireAnalyticsEv9.call(this, (0, _errorHandling.updateReferenceErrorPayload)(updateResult.error || 'Failed to update reference synced blocks on the document'));
+              }
+              _context4.next = 21;
+              break;
+            case 16:
+              _context4.prev = 16;
+              _context4.t0 = _context4["catch"](3);
+              success = false;
+              (0, _monitoring.logException)(_context4.t0, {
+                location: 'editor-synced-block-provider/referenceSyncBlockStoreManager'
+              });
+              (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 || _this$fireAnalyticsEv0.call(this, (0, _errorHandling.updateReferenceErrorPayload)(_context4.t0.message));
+            case 21:
+              _context4.prev = 21;
+              if (success) {
+                this.isCacheDirty = false;
+              }
+              return _context4.finish(21);
+            case 24:
+              return _context4.abrupt("return", success);
+            case 25:
+            case "end":
+              return _context4.stop();
+          }
+        }, _callee3, this, [[3, 16, 21, 24]]);
+      }));
+      function flush() {
+        return _flush.apply(this, arguments);
+      }
+      return flush;
+    }())
   }, {
     key: "destroy",
     value: function destroy() {

package/dist/cjs/utils/errorHandling.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.updateErrorPayload = exports.updateCacheErrorPayload = exports.stringifyError = exports.getSourceInfoErrorPayload = exports.getErrorPayload = exports.fetchErrorPayload = exports.deleteErrorPayload = exports.createErrorPayload = void 0;
+exports.updateReferenceErrorPayload = exports.updateErrorPayload = exports.updateCacheErrorPayload = exports.stringifyError = exports.getSourceInfoErrorPayload = exports.getErrorPayload = exports.fetchErrorPayload = exports.deleteErrorPayload = exports.createErrorPayload = void 0;
 var _analytics = require("@atlaskit/editor-common/analytics");
 var stringifyError = exports.stringifyError = function stringifyError(error) {
   try {
@@ -32,6 +32,9 @@ var getSourceInfoErrorPayload = exports.getSourceInfoErrorPayload = function get
 var updateErrorPayload = exports.updateErrorPayload = function updateErrorPayload(error) {
   return getErrorPayload(_analytics.ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE, error);
 };
+var updateReferenceErrorPayload = exports.updateReferenceErrorPayload = function updateReferenceErrorPayload(error) {
+  return getErrorPayload(_analytics.ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_UPDATE, error);
+};
 var createErrorPayload = exports.createErrorPayload = function createErrorPayload(error) {
   return getErrorPayload(_analytics.ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error);
 };

package/dist/es2019/clients/block-service/blockService.js

@@ -127,4 +127,23 @@ export const createSyncedBlock = async ({
     throw new BlockError(response.status);
   }
   return await response.json();
+};
+export const updateReferenceSyncedBlockOnDocument = async ({
+  documentAri,
+  blocks,
+  noContent = true
+}) => {
+  const response = await fetchWithRetry(`${BLOCK_SERVICE_API_URL}/block/document/${encodeURIComponent(documentAri)}/references?noContent=${noContent}`, {
+    method: 'PUT',
+    headers: COMMON_HEADERS,
+    body: JSON.stringify({
+      blocks
+    })
+  });
+  if (!response.ok) {
+    throw new BlockError(response.status);
+  }
+  if (!noContent) {
+    return await response.json();
+  }
 };

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

@@ -1,7 +1,7 @@
 /* eslint-disable require-unicode-regexp  */
 import { useMemo } from 'react';
 import { generateBlockAri, generateBlockAriFromReference } from '../../clients/block-service/ari';
-import { BlockError, createSyncedBlock, deleteSyncedBlock, getReferenceSyncedBlocks, getSyncedBlockContent, updateSyncedBlock } from '../../clients/block-service/blockService';
+import { BlockError, createSyncedBlock, deleteSyncedBlock, getReferenceSyncedBlocks, getSyncedBlockContent, updateReferenceSyncedBlockOnDocument, updateSyncedBlock } from '../../clients/block-service/blockService';
 import { SyncBlockError } from '../../common/types';
 import { stringifyError } from '../../utils/errorHandling';
 const mapBlockError = error => {
@@ -212,6 +212,14 @@ class BlockServiceADFWriteProvider {
       };
     } catch (error) {
       if (error instanceof BlockError) {
+        if (error.status === 404) {
+          // User should not be blocked by not_found error when deleting, 
+          // hence returns successful result for 404 error
+          return {
+            resourceId,
+            success: true
+          };
+        }
         return {
           resourceId,
           success: false,
@@ -233,6 +241,31 @@ class BlockServiceADFWriteProvider {
   generateResourceId() {
     return crypto.randomUUID();
   }
+  async updateReferenceData(blocks, noContent) {
+    try {
+      await updateReferenceSyncedBlockOnDocument({
+        documentAri: this.sourceAri,
+        blocks: blocks.map(block => ({
+          blockAri: generateBlockAriFromReference(this.sourceAri, block.resourceId),
+          blockInstanceId: block.localId
+        }), noContent)
+      });
+      return {
+        success: true
+      };
+    } catch (error) {
+      if (error instanceof BlockError) {
+        return {
+          success: false,
+          error: mapBlockError(error)
+        };
+      }
+      return {
+        success: false,
+        error: stringifyError(error)
+      };
+    }
+  }
 }
 
 /**

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

@@ -275,6 +275,11 @@ class ConfluenceADFWriteProvider {
   generateResourceIdForReference(sourceId) {
     return sourceId;
   }
+  updateReferenceData(_blocks, _noContent) {
+    return Promise.resolve({
+      success: true
+    });
+  }
 }
 
 /**

package/dist/es2019/providers/syncBlockProvider.js

@@ -200,6 +200,9 @@ export class SyncBlockProvider extends SyncBlockDataProvider {
         throw new Error(`${sourceProduct} source product not supported`);
     }
   }
+  updateReferenceData(blocks, noContent) {
+    return this.writeProvider.updateReferenceData(blocks, noContent);
+  }
 }
 export const useMemoizedSyncedBlockProvider = (fetchProvider, writeProvider, sourceId, providerOptions, getSSRData) => {
   return useMemo(() => {

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

@@ -2,7 +2,7 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { logException } from '@atlaskit/editor-common/monitoring';
 import { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
 import { SyncBlockError } from '../common/types';
-import { fetchErrorPayload, getSourceInfoErrorPayload } from '../utils/errorHandling';
+import { fetchErrorPayload, getSourceInfoErrorPayload, updateReferenceErrorPayload } from '../utils/errorHandling';
 import { resolveSyncBlockInstance } from '../utils/resolveSyncBlockInstance';
 import { createSyncBlockNode } from '../utils/utils';
 
@@ -13,6 +13,10 @@ import { createSyncBlockNode } from '../utils/utils';
 // Can be used in both editor and renderer contexts.
 export class ReferenceSyncBlockStoreManager {
   constructor(dataProvider, fireAnalyticsEvent) {
+    // Keeps track of addition and deletion of reference synced blocks on the document
+    // This starts as true to always flush the cache when document is saved for the first time
+    // to cater the case when a editor seesion is closed without document being updated right after reference block is deleted
+    _defineProperty(this, "isCacheDirty", true);
     _defineProperty(this, "isRefreshingSubscriptions", false);
     this.syncBlockCache = new Map();
     this.subscriptions = new Map();
@@ -212,6 +216,9 @@ export class ReferenceSyncBlockStoreManager {
       ...resourceSubscriptions,
       [localId]: callback
     });
+
+    // New subscription means new reference synced block is added to the document
+    this.isCacheDirty = true;
     const syncBlockNode = createSyncBlockNode(localId, resourceId);
 
     // call the callback immediately if we have cached data
@@ -231,6 +238,8 @@ export class ReferenceSyncBlockStoreManager {
     return () => {
       const resourceSubscriptions = this.subscriptions.get(resourceId);
       if (resourceSubscriptions) {
+        // Unsubscription means a reference synced block is removed from the document
+        this.isCacheDirty = true;
         delete resourceSubscriptions[localId];
         if (Object.keys(resourceSubscriptions).length === 0) {
           this.subscriptions.delete(resourceId);
@@ -397,6 +406,55 @@ export class ReferenceSyncBlockStoreManager {
       }
     }
   }
+
+  /**
+   * Update reference synced blocks on the document with the BE
+   * 
+   * @returns true if the reference synced blocks are updated successfully, false otherwise
+   */
+  async flush() {
+    if (!this.isCacheDirty) {
+      return true;
+    }
+    let success = true;
+    try {
+      if (!this.dataProvider) {
+        throw new Error('Data provider not set');
+      }
+      const blocks = [];
+
+      // Collect all reference synced blocks on the current document
+      Array.from(this.subscriptions.entries()).forEach(([resourceId, callbacks]) => {
+        Object.keys(callbacks).forEach(localId => {
+          blocks.push({
+            resourceId,
+            localId
+          });
+        });
+      });
+      if (blocks.length === 0) {
+        return true;
+      }
+      const updateResult = await this.dataProvider.updateReferenceData(blocks);
+      if (!updateResult.success) {
+        var _this$fireAnalyticsEv10;
+        success = false;
+        (_this$fireAnalyticsEv10 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv10 === void 0 ? void 0 : _this$fireAnalyticsEv10.call(this, updateReferenceErrorPayload(updateResult.error || 'Failed to update reference synced blocks on the document'));
+      }
+    } catch (error) {
+      var _this$fireAnalyticsEv11;
+      success = false;
+      logException(error, {
+        location: 'editor-synced-block-provider/referenceSyncBlockStoreManager'
+      });
+      (_this$fireAnalyticsEv11 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv11 === void 0 ? void 0 : _this$fireAnalyticsEv11.call(this, updateReferenceErrorPayload(error.message));
+    } finally {
+      if (success) {
+        this.isCacheDirty = false;
+      }
+    }
+    return success;
+  }
   destroy() {
     this.dataProvider = undefined;
     this.syncBlockCache.clear();

package/dist/es2019/utils/errorHandling.js

@@ -18,6 +18,7 @@ export const getErrorPayload = (actionSubjectId, error) => ({
 export const fetchErrorPayload = error => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_FETCH, error);
 export const getSourceInfoErrorPayload = error => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_GET_SOURCE_INFO, error);
 export const updateErrorPayload = error => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE, error);
+export const updateReferenceErrorPayload = error => getErrorPayload(ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_UPDATE, error);
 export const createErrorPayload = error => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error);
 export const deleteErrorPayload = error => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_DELETE, error);
 export const updateCacheErrorPayload = error => getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE_CACHE, error);

package/dist/esm/clients/block-service/blockService.js

@@ -240,4 +240,45 @@ export var createSyncedBlock = /*#__PURE__*/function () {
   return function createSyncedBlock(_x5) {
     return _ref9.apply(this, arguments);
   };
+}();
+export var updateReferenceSyncedBlockOnDocument = /*#__PURE__*/function () {
+  var _ref1 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee6(_ref0) {
+    var documentAri, blocks, _ref0$noContent, noContent, response;
+    return _regeneratorRuntime.wrap(function _callee6$(_context6) {
+      while (1) switch (_context6.prev = _context6.next) {
+        case 0:
+          documentAri = _ref0.documentAri, blocks = _ref0.blocks, _ref0$noContent = _ref0.noContent, noContent = _ref0$noContent === void 0 ? true : _ref0$noContent;
+          _context6.next = 3;
+          return fetchWithRetry("".concat(BLOCK_SERVICE_API_URL, "/block/document/").concat(encodeURIComponent(documentAri), "/references?noContent=").concat(noContent), {
+            method: 'PUT',
+            headers: COMMON_HEADERS,
+            body: JSON.stringify({
+              blocks: blocks
+            })
+          });
+        case 3:
+          response = _context6.sent;
+          if (response.ok) {
+            _context6.next = 6;
+            break;
+          }
+          throw new BlockError(response.status);
+        case 6:
+          if (noContent) {
+            _context6.next = 10;
+            break;
+          }
+          _context6.next = 9;
+          return response.json();
+        case 9:
+          return _context6.abrupt("return", _context6.sent);
+        case 10:
+        case "end":
+          return _context6.stop();
+      }
+    }, _callee6);
+  }));
+  return function updateReferenceSyncedBlockOnDocument(_x6) {
+    return _ref1.apply(this, arguments);
+  };
 }();

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

@@ -6,7 +6,7 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
 /* eslint-disable require-unicode-regexp  */
 import { useMemo } from 'react';
 import { generateBlockAri, generateBlockAriFromReference } from '../../clients/block-service/ari';
-import { BlockError, createSyncedBlock, deleteSyncedBlock, getReferenceSyncedBlocks, getSyncedBlockContent, updateSyncedBlock } from '../../clients/block-service/blockService';
+import { BlockError, createSyncedBlock, deleteSyncedBlock, getReferenceSyncedBlocks, getSyncedBlockContent, updateReferenceSyncedBlockOnDocument, updateSyncedBlock } from '../../clients/block-service/blockService';
 import { SyncBlockError } from '../../common/types';
 import { stringifyError } from '../../utils/errorHandling';
 var mapBlockError = function mapBlockError(error) {
@@ -317,21 +317,30 @@ var BlockServiceADFWriteProvider = /*#__PURE__*/function () {
               _context5.prev = 7;
               _context5.t0 = _context5["catch"](1);
               if (!(_context5.t0 instanceof BlockError)) {
-                _context5.next = 11;
+                _context5.next = 13;
+                break;
+              }
+              if (!(_context5.t0.status === 404)) {
+                _context5.next = 12;
                 break;
               }
+              return _context5.abrupt("return", {
+                resourceId: resourceId,
+                success: true
+              });
+            case 12:
               return _context5.abrupt("return", {
                 resourceId: resourceId,
                 success: false,
                 error: mapBlockError(_context5.t0)
               });
-            case 11:
+            case 13:
               return _context5.abrupt("return", {
                 resourceId: resourceId,
                 success: false,
                 error: stringifyError(_context5.t0)
               });
-            case 12:
+            case 14:
             case "end":
               return _context5.stop();
           }
@@ -352,6 +361,56 @@ var BlockServiceADFWriteProvider = /*#__PURE__*/function () {
     value: function generateResourceId() {
       return crypto.randomUUID();
     }
+  }, {
+    key: "updateReferenceData",
+    value: function () {
+      var _updateReferenceData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee6(blocks, noContent) {
+        var _this = this;
+        return _regeneratorRuntime.wrap(function _callee6$(_context6) {
+          while (1) switch (_context6.prev = _context6.next) {
+            case 0:
+              _context6.prev = 0;
+              _context6.next = 3;
+              return updateReferenceSyncedBlockOnDocument({
+                documentAri: this.sourceAri,
+                blocks: blocks.map(function (block) {
+                  return {
+                    blockAri: generateBlockAriFromReference(_this.sourceAri, block.resourceId),
+                    blockInstanceId: block.localId
+                  };
+                }, noContent)
+              });
+            case 3:
+              return _context6.abrupt("return", {
+                success: true
+              });
+            case 6:
+              _context6.prev = 6;
+              _context6.t0 = _context6["catch"](0);
+              if (!(_context6.t0 instanceof BlockError)) {
+                _context6.next = 10;
+                break;
+              }
+              return _context6.abrupt("return", {
+                success: false,
+                error: mapBlockError(_context6.t0)
+              });
+            case 10:
+              return _context6.abrupt("return", {
+                success: false,
+                error: stringifyError(_context6.t0)
+              });
+            case 11:
+            case "end":
+              return _context6.stop();
+          }
+        }, _callee6, this, [[0, 6]]);
+      }));
+      function updateReferenceData(_x6, _x7) {
+        return _updateReferenceData.apply(this, arguments);
+      }
+      return updateReferenceData;
+    }()
   }]);
 }();
 /**

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

@@ -403,6 +403,13 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
     value: function generateResourceIdForReference(sourceId) {
       return sourceId;
     }
+  }, {
+    key: "updateReferenceData",
+    value: function updateReferenceData(_blocks, _noContent) {
+      return Promise.resolve({
+        success: true
+      });
+    }
   }]);
 }();
 /**

package/dist/esm/providers/syncBlockProvider.js

@@ -289,6 +289,11 @@ export var SyncBlockProvider = /*#__PURE__*/function (_SyncBlockDataProvide) {
           throw new Error("".concat(sourceProduct, " source product not supported"));
       }
     }
+  }, {
+    key: "updateReferenceData",
+    value: function updateReferenceData(blocks, noContent) {
+      return this.writeProvider.updateReferenceData(blocks, noContent);
+    }
   }]);
 }(SyncBlockDataProvider);
 export var useMemoizedSyncedBlockProvider = function useMemoizedSyncedBlockProvider(fetchProvider, writeProvider, sourceId, providerOptions, getSSRData) {

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

@@ -12,7 +12,7 @@ function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length)
 import { logException } from '@atlaskit/editor-common/monitoring';
 import { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
 import { SyncBlockError } from '../common/types';
-import { fetchErrorPayload, getSourceInfoErrorPayload } from '../utils/errorHandling';
+import { fetchErrorPayload, getSourceInfoErrorPayload, updateReferenceErrorPayload } from '../utils/errorHandling';
 import { resolveSyncBlockInstance } from '../utils/resolveSyncBlockInstance';
 import { createSyncBlockNode } from '../utils/utils';
 
@@ -24,6 +24,10 @@ import { createSyncBlockNode } from '../utils/utils';
 export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
   function ReferenceSyncBlockStoreManager(dataProvider, fireAnalyticsEvent) {
     _classCallCheck(this, ReferenceSyncBlockStoreManager);
+    // Keeps track of addition and deletion of reference synced blocks on the document
+    // This starts as true to always flush the cache when document is saved for the first time
+    // to cater the case when a editor seesion is closed without document being updated right after reference block is deleted
+    _defineProperty(this, "isCacheDirty", true);
     _defineProperty(this, "isRefreshingSubscriptions", false);
     this.syncBlockCache = new Map();
     this.subscriptions = new Map();
@@ -321,6 +325,9 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
       // add to subscriptions map
       var resourceSubscriptions = this.subscriptions.get(resourceId) || {};
       this.subscriptions.set(resourceId, _objectSpread(_objectSpread({}, resourceSubscriptions), {}, _defineProperty({}, localId, callback)));
+
+      // New subscription means new reference synced block is added to the document
+      this.isCacheDirty = true;
       var syncBlockNode = createSyncBlockNode(localId, resourceId);
 
       // call the callback immediately if we have cached data
@@ -340,6 +347,8 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
       return function () {
         var resourceSubscriptions = _this3.subscriptions.get(resourceId);
         if (resourceSubscriptions) {
+          // Unsubscription means a reference synced block is removed from the document
+          _this3.isCacheDirty = true;
           delete resourceSubscriptions[localId];
           if (Object.keys(resourceSubscriptions).length === 0) {
             _this3.subscriptions.delete(resourceId);
@@ -509,6 +518,89 @@ export var ReferenceSyncBlockStoreManager = /*#__PURE__*/function () {
         }
       }
     }
+
+    /**
+     * Update reference synced blocks on the document with the BE
+     * 
+     * @returns true if the reference synced blocks are updated successfully, false otherwise
+     */
+  }, {
+    key: "flush",
+    value: (function () {
+      var _flush = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
+        var success, blocks, updateResult, _this$fireAnalyticsEv9, _this$fireAnalyticsEv0;
+        return _regeneratorRuntime.wrap(function _callee3$(_context4) {
+          while (1) switch (_context4.prev = _context4.next) {
+            case 0:
+              if (this.isCacheDirty) {
+                _context4.next = 2;
+                break;
+              }
+              return _context4.abrupt("return", true);
+            case 2:
+              success = true;
+              _context4.prev = 3;
+              if (this.dataProvider) {
+                _context4.next = 6;
+                break;
+              }
+              throw new Error('Data provider not set');
+            case 6:
+              blocks = []; // Collect all reference synced blocks on the current document
+              Array.from(this.subscriptions.entries()).forEach(function (_ref2) {
+                var _ref3 = _slicedToArray(_ref2, 2),
+                  resourceId = _ref3[0],
+                  callbacks = _ref3[1];
+                Object.keys(callbacks).forEach(function (localId) {
+                  blocks.push({
+                    resourceId: resourceId,
+                    localId: localId
+                  });
+                });
+              });
+              if (!(blocks.length === 0)) {
+                _context4.next = 10;
+                break;
+              }
+              return _context4.abrupt("return", true);
+            case 10:
+              _context4.next = 12;
+              return this.dataProvider.updateReferenceData(blocks);
+            case 12:
+              updateResult = _context4.sent;
+              if (!updateResult.success) {
+                success = false;
+                (_this$fireAnalyticsEv9 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv9 === void 0 || _this$fireAnalyticsEv9.call(this, updateReferenceErrorPayload(updateResult.error || 'Failed to update reference synced blocks on the document'));
+              }
+              _context4.next = 21;
+              break;
+            case 16:
+              _context4.prev = 16;
+              _context4.t0 = _context4["catch"](3);
+              success = false;
+              logException(_context4.t0, {
+                location: 'editor-synced-block-provider/referenceSyncBlockStoreManager'
+              });
+              (_this$fireAnalyticsEv0 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv0 === void 0 || _this$fireAnalyticsEv0.call(this, updateReferenceErrorPayload(_context4.t0.message));
+            case 21:
+              _context4.prev = 21;
+              if (success) {
+                this.isCacheDirty = false;
+              }
+              return _context4.finish(21);
+            case 24:
+              return _context4.abrupt("return", success);
+            case 25:
+            case "end":
+              return _context4.stop();
+          }
+        }, _callee3, this, [[3, 16, 21, 24]]);
+      }));
+      function flush() {
+        return _flush.apply(this, arguments);
+      }
+      return flush;
+    }())
   }, {
     key: "destroy",
     value: function destroy() {

package/dist/esm/utils/errorHandling.js

@@ -26,6 +26,9 @@ export var getSourceInfoErrorPayload = function getSourceInfoErrorPayload(error)
 export var updateErrorPayload = function updateErrorPayload(error) {
   return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_UPDATE, error);
 };
+export var updateReferenceErrorPayload = function updateReferenceErrorPayload(error) {
+  return getErrorPayload(ACTION_SUBJECT_ID.REFERENCE_SYNCED_BLOCK_UPDATE, error);
+};
 export var createErrorPayload = function createErrorPayload(error) {
   return getErrorPayload(ACTION_SUBJECT_ID.SYNCED_BLOCK_CREATE, error);
 };

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

@@ -15,6 +15,10 @@ export type BlockContentErrorResponse = {
     code: string;
     reason: string;
 };
+type ReferenceSyncedBlockResponse = {
+    blocks?: Array<BlockContentResponse>;
+    errors?: Array<BlockContentErrorResponse>;
+};
 export declare const isBlockContentResponse: (response: BlockContentResponse | BlockContentErrorResponse) => response is BlockContentResponse;
 /**
  * Retrieves all synced blocks referenced in a document.
@@ -58,10 +62,7 @@ export declare const isBlockContentResponse: (response: BlockContentResponse | B
  * ```
  * Check https://block-service.dev.atl-paas.net/ for latest API documentation.
  */
-export declare const getReferenceSyncedBlocks: (documentAri: string) => Promise<{
-    blocks?: Array<BlockContentResponse>;
-    errors?: Array<BlockContentErrorResponse>;
-}>;
+export declare const getReferenceSyncedBlocks: (documentAri: string) => Promise<ReferenceSyncedBlockResponse>;
 export type GetSyncedBlockContentRequest = {
     blockAri: string;
 };
@@ -79,6 +80,15 @@ export type CreateSyncedBlockRequest = {
     product: SyncBlockProduct;
     sourceAri: string;
 };
+type ReferenceSyncedBlockIDs = {
+    blockAri: string;
+    blockInstanceId: string;
+};
+type UpdateReferenceSyncedBlockOnDocumentRequest = {
+    blocks: ReferenceSyncedBlockIDs[];
+    documentAri: string;
+    noContent?: boolean;
+};
 export declare class BlockError extends Error {
     readonly status: number;
     constructor(status: number);
@@ -87,3 +97,5 @@ export declare const getSyncedBlockContent: ({ blockAri, }: GetSyncedBlockConten
 export declare const deleteSyncedBlock: ({ blockAri }: DeleteSyncedBlockRequest) => Promise<void>;
 export declare const updateSyncedBlock: ({ blockAri, content, }: UpdateSyncedBlockRequest) => Promise<void>;
 export declare const createSyncedBlock: ({ blockAri, blockInstanceId, sourceAri, product, content, }: CreateSyncedBlockRequest) => Promise<BlockContentResponse>;
+export declare const updateReferenceSyncedBlockOnDocument: ({ documentAri, blocks, noContent, }: UpdateReferenceSyncedBlockOnDocumentRequest) => Promise<ReferenceSyncedBlockResponse | void>;
+export {};

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

@@ -1,5 +1,5 @@
-import { SyncBlockError, type ResourceId, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
-import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, WriteSyncBlockResult } from '../types';
+import { SyncBlockError, type ResourceId, type SyncBlockAttrs, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
+import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, UpdateReferenceSyncBlockResult, WriteSyncBlockResult } from '../types';
 export declare const fetchReferences: (documentAri: string) => Promise<SyncBlockInstance[] | SyncBlockError>;
 /**
  * ADFFetchProvider implementation that fetches synced block data from Block Service API
@@ -22,6 +22,7 @@ declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
     deleteData(resourceId: string): Promise<DeleteSyncBlockResult>;
     generateResourceIdForReference(sourceId: ResourceId): ResourceId;
     generateResourceId(): ResourceId;
+    updateReferenceData(blocks: SyncBlockAttrs[], noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
 }
 export declare const useMemoizedBlockServiceAPIProviders: (sourceAri: string, product: SyncBlockProduct, sourceDocumentId: string) => {
     fetchProvider: BlockServiceADFFetchProvider;

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

@@ -1,5 +1,5 @@
-import { type ResourceId, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
-import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, WriteSyncBlockResult } from '../types';
+import { type ResourceId, type SyncBlockAttrs, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
+import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, UpdateReferenceSyncBlockResult, WriteSyncBlockResult } from '../types';
 /**
  * Configuration for Content API providers
  */
@@ -28,6 +28,7 @@ declare class ConfluenceADFWriteProvider implements ADFWriteProvider {
     deleteData(resourceId: string): Promise<DeleteSyncBlockResult>;
     generateResourceId(sourceId: string, localId: string): string;
     generateResourceIdForReference(sourceId: ResourceId): ResourceId;
+    updateReferenceData(_blocks: SyncBlockAttrs[], _noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
 }
 /**
  * Convenience function to create providers with default content property key

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

@@ -1,7 +1,7 @@
 import type { RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { JSONNode } from '@atlaskit/editor-json-transformer/types';
-import { type BlockInstanceId, type ResourceId, type SyncBlockData, type SyncBlockNode, type SyncBlockProduct } from '../common/types';
-import { SyncBlockDataProvider, type ADFFetchProvider, type ADFWriteProvider, type DeleteSyncBlockResult, type SyncBlockInstance, type SyncBlockParentInfo, type SyncBlockSourceInfo, type SyncedBlockRendererProviderOptions, type WriteSyncBlockResult } from '../providers/types';
+import { type BlockInstanceId, type ResourceId, type SyncBlockAttrs, type SyncBlockData, type SyncBlockNode, type SyncBlockProduct } from '../common/types';
+import { SyncBlockDataProvider, type ADFFetchProvider, type ADFWriteProvider, type DeleteSyncBlockResult, type SyncBlockInstance, type SyncBlockParentInfo, type SyncBlockSourceInfo, type SyncedBlockRendererProviderOptions, type UpdateReferenceSyncBlockResult, type WriteSyncBlockResult } from '../providers/types';
 export declare class SyncBlockProvider extends SyncBlockDataProvider {
     name: string;
     private fetchProvider;
@@ -94,5 +94,6 @@ export declare class SyncBlockProvider extends SyncBlockDataProvider {
      * @returns The parent info for the sync block
      */
     retrieveSyncBlockParentInfo(sourceAri: string, sourceProduct: SyncBlockProduct): SyncBlockParentInfo | undefined;
+    updateReferenceData(blocks: SyncBlockAttrs[], noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
 }
 export declare const useMemoizedSyncedBlockProvider: (fetchProvider: ADFFetchProvider, writeProvider: ADFWriteProvider, sourceId: string, providerOptions: SyncedBlockRendererProviderOptions, getSSRData?: () => Record<string, SyncBlockInstance> | undefined) => SyncBlockProvider;

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

@@ -4,7 +4,7 @@ import type { EmojiProvider } from '@atlaskit/emoji';
 import type { MentionProvider } from '@atlaskit/mention/types';
 import { NodeDataProvider } from '@atlaskit/node-data-provider';
 import type { TaskDecisionProvider } from '@atlaskit/task-decision/types';
-import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBlockProduct, BlockInstanceId } from '../common/types';
+import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBlockProduct, BlockInstanceId, SyncBlockAttrs } from '../common/types';
 /**
  * The instance of a sync block, containing its data and metadata.
  * Mainly used for representing the state of a sync block after fetching from a data provider.
@@ -39,15 +39,26 @@ export type SourceInfoFetchData = {
     pageARI: string;
     sourceLocalId?: string;
 };
+export type UpdateReferenceSyncBlockResult = {
+    error?: string;
+    success: boolean;
+};
 export interface ADFFetchProvider {
     fetchData: (resourceId: ResourceId) => Promise<SyncBlockInstance>;
 }
 export interface ADFWriteProvider {
     createData: (data: SyncBlockData) => Promise<WriteSyncBlockResult>;
+    /**
+     * Delete source block.
+     * @param resourceId the resourceId of the block to be deleted
+     * @returns Object representing the result of the deletion. {resourceId: string, success: boolean, error?: string}.
+     * User should not be blocked by not_found error when deleting, so successful result should be returned for 404 error
+     */
     deleteData: (resourceId: ResourceId) => Promise<DeleteSyncBlockResult>;
     generateResourceId: (sourceId: string, localId: string) => ResourceId;
     generateResourceIdForReference: (sourceId: ResourceId) => ResourceId;
     product: SyncBlockProduct;
+    updateReferenceData: (blocks: SyncBlockAttrs[], noContent?: boolean) => Promise<UpdateReferenceSyncBlockResult>;
     writeData: (data: SyncBlockData) => Promise<WriteSyncBlockResult>;
 }
 export type MediaEmojiProviderOptions = {
@@ -84,6 +95,7 @@ export declare abstract class SyncBlockDataProvider extends NodeDataProvider<Syn
      */
     abstract generateResourceId(sourceId: ResourceId, localId: BlockInstanceId): ResourceId;
     abstract generateResourceIdForReference(sourceId: ResourceId): ResourceId;
+    abstract updateReferenceData(blocks: SyncBlockAttrs[], noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
 }
 export type SubscriptionCallback = (data: SyncBlockInstance) => void;
 export type TitleSubscriptionCallback = (title: string) => void;

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

@@ -6,6 +6,7 @@ import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProvider, Ti
 export declare class ReferenceSyncBlockStoreManager {
     private dataProvider?;
     private syncBlockCache;
+    private isCacheDirty;
     private subscriptions;
     private titleSubscriptions;
     private providerFactories;
@@ -44,5 +45,11 @@ export declare class ReferenceSyncBlockStoreManager {
     getSyncBlockURL(resourceId: ResourceId): string | undefined;
     getProviderFactory(resourceId: ResourceId): ProviderFactory | undefined;
     private retrieveDynamicProviders;
+    /**
+     * Update reference synced blocks on the document with the BE
+     *
+     * @returns true if the reference synced blocks are updated successfully, false otherwise
+     */
+    flush(): Promise<boolean>;
     destroy(): void;
 }

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

@@ -6,6 +6,7 @@ export declare const getErrorPayload: <T extends ACTION_SUBJECT_ID>(actionSubjec
 export declare const fetchErrorPayload: (error: string) => RendererSyncBlockEventPayload;
 export declare const getSourceInfoErrorPayload: (error: string) => RendererSyncBlockEventPayload;
 export declare const updateErrorPayload: (error: string) => SyncBlockEventPayload;
+export declare const updateReferenceErrorPayload: (error: string) => RendererSyncBlockEventPayload;
 export declare const createErrorPayload: (error: string) => SyncBlockEventPayload;
 export declare const deleteErrorPayload: (error: string) => SyncBlockEventPayload;
 export declare const updateCacheErrorPayload: (error: string) => SyncBlockEventPayload;

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

@@ -15,6 +15,10 @@ export type BlockContentErrorResponse = {
     code: string;
     reason: string;
 };
+type ReferenceSyncedBlockResponse = {
+    blocks?: Array<BlockContentResponse>;
+    errors?: Array<BlockContentErrorResponse>;
+};
 export declare const isBlockContentResponse: (response: BlockContentResponse | BlockContentErrorResponse) => response is BlockContentResponse;
 /**
  * Retrieves all synced blocks referenced in a document.
@@ -58,10 +62,7 @@ export declare const isBlockContentResponse: (response: BlockContentResponse | B
  * ```
  * Check https://block-service.dev.atl-paas.net/ for latest API documentation.
  */
-export declare const getReferenceSyncedBlocks: (documentAri: string) => Promise<{
-    blocks?: Array<BlockContentResponse>;
-    errors?: Array<BlockContentErrorResponse>;
-}>;
+export declare const getReferenceSyncedBlocks: (documentAri: string) => Promise<ReferenceSyncedBlockResponse>;
 export type GetSyncedBlockContentRequest = {
     blockAri: string;
 };
@@ -79,6 +80,15 @@ export type CreateSyncedBlockRequest = {
     product: SyncBlockProduct;
     sourceAri: string;
 };
+type ReferenceSyncedBlockIDs = {
+    blockAri: string;
+    blockInstanceId: string;
+};
+type UpdateReferenceSyncedBlockOnDocumentRequest = {
+    blocks: ReferenceSyncedBlockIDs[];
+    documentAri: string;
+    noContent?: boolean;
+};
 export declare class BlockError extends Error {
     readonly status: number;
     constructor(status: number);
@@ -87,3 +97,5 @@ export declare const getSyncedBlockContent: ({ blockAri, }: GetSyncedBlockConten
 export declare const deleteSyncedBlock: ({ blockAri }: DeleteSyncedBlockRequest) => Promise<void>;
 export declare const updateSyncedBlock: ({ blockAri, content, }: UpdateSyncedBlockRequest) => Promise<void>;
 export declare const createSyncedBlock: ({ blockAri, blockInstanceId, sourceAri, product, content, }: CreateSyncedBlockRequest) => Promise<BlockContentResponse>;
+export declare const updateReferenceSyncedBlockOnDocument: ({ documentAri, blocks, noContent, }: UpdateReferenceSyncedBlockOnDocumentRequest) => Promise<ReferenceSyncedBlockResponse | void>;
+export {};

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

@@ -1,5 +1,5 @@
-import { SyncBlockError, type ResourceId, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
-import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, WriteSyncBlockResult } from '../types';
+import { SyncBlockError, type ResourceId, type SyncBlockAttrs, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
+import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, UpdateReferenceSyncBlockResult, WriteSyncBlockResult } from '../types';
 export declare const fetchReferences: (documentAri: string) => Promise<SyncBlockInstance[] | SyncBlockError>;
 /**
  * ADFFetchProvider implementation that fetches synced block data from Block Service API
@@ -22,6 +22,7 @@ declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
     deleteData(resourceId: string): Promise<DeleteSyncBlockResult>;
     generateResourceIdForReference(sourceId: ResourceId): ResourceId;
     generateResourceId(): ResourceId;
+    updateReferenceData(blocks: SyncBlockAttrs[], noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
 }
 export declare const useMemoizedBlockServiceAPIProviders: (sourceAri: string, product: SyncBlockProduct, sourceDocumentId: string) => {
     fetchProvider: BlockServiceADFFetchProvider;

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

@@ -1,5 +1,5 @@
-import { type ResourceId, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
-import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, WriteSyncBlockResult } from '../types';
+import { type ResourceId, type SyncBlockAttrs, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
+import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, UpdateReferenceSyncBlockResult, WriteSyncBlockResult } from '../types';
 /**
  * Configuration for Content API providers
  */
@@ -28,6 +28,7 @@ declare class ConfluenceADFWriteProvider implements ADFWriteProvider {
     deleteData(resourceId: string): Promise<DeleteSyncBlockResult>;
     generateResourceId(sourceId: string, localId: string): string;
     generateResourceIdForReference(sourceId: ResourceId): ResourceId;
+    updateReferenceData(_blocks: SyncBlockAttrs[], _noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
 }
 /**
  * Convenience function to create providers with default content property key

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

@@ -1,7 +1,7 @@
 import type { RendererSyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
 import type { JSONNode } from '@atlaskit/editor-json-transformer/types';
-import { type BlockInstanceId, type ResourceId, type SyncBlockData, type SyncBlockNode, type SyncBlockProduct } from '../common/types';
-import { SyncBlockDataProvider, type ADFFetchProvider, type ADFWriteProvider, type DeleteSyncBlockResult, type SyncBlockInstance, type SyncBlockParentInfo, type SyncBlockSourceInfo, type SyncedBlockRendererProviderOptions, type WriteSyncBlockResult } from '../providers/types';
+import { type BlockInstanceId, type ResourceId, type SyncBlockAttrs, type SyncBlockData, type SyncBlockNode, type SyncBlockProduct } from '../common/types';
+import { SyncBlockDataProvider, type ADFFetchProvider, type ADFWriteProvider, type DeleteSyncBlockResult, type SyncBlockInstance, type SyncBlockParentInfo, type SyncBlockSourceInfo, type SyncedBlockRendererProviderOptions, type UpdateReferenceSyncBlockResult, type WriteSyncBlockResult } from '../providers/types';
 export declare class SyncBlockProvider extends SyncBlockDataProvider {
     name: string;
     private fetchProvider;
@@ -94,5 +94,6 @@ export declare class SyncBlockProvider extends SyncBlockDataProvider {
      * @returns The parent info for the sync block
      */
     retrieveSyncBlockParentInfo(sourceAri: string, sourceProduct: SyncBlockProduct): SyncBlockParentInfo | undefined;
+    updateReferenceData(blocks: SyncBlockAttrs[], noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
 }
 export declare const useMemoizedSyncedBlockProvider: (fetchProvider: ADFFetchProvider, writeProvider: ADFWriteProvider, sourceId: string, providerOptions: SyncedBlockRendererProviderOptions, getSSRData?: () => Record<string, SyncBlockInstance> | undefined) => SyncBlockProvider;

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

@@ -4,7 +4,7 @@ import type { EmojiProvider } from '@atlaskit/emoji';
 import type { MentionProvider } from '@atlaskit/mention/types';
 import { NodeDataProvider } from '@atlaskit/node-data-provider';
 import type { TaskDecisionProvider } from '@atlaskit/task-decision/types';
-import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBlockProduct, BlockInstanceId } from '../common/types';
+import type { SyncBlockData, ResourceId, SyncBlockError, SyncBlockNode, SyncBlockProduct, BlockInstanceId, SyncBlockAttrs } from '../common/types';
 /**
  * The instance of a sync block, containing its data and metadata.
  * Mainly used for representing the state of a sync block after fetching from a data provider.
@@ -39,15 +39,26 @@ export type SourceInfoFetchData = {
     pageARI: string;
     sourceLocalId?: string;
 };
+export type UpdateReferenceSyncBlockResult = {
+    error?: string;
+    success: boolean;
+};
 export interface ADFFetchProvider {
     fetchData: (resourceId: ResourceId) => Promise<SyncBlockInstance>;
 }
 export interface ADFWriteProvider {
     createData: (data: SyncBlockData) => Promise<WriteSyncBlockResult>;
+    /**
+     * Delete source block.
+     * @param resourceId the resourceId of the block to be deleted
+     * @returns Object representing the result of the deletion. {resourceId: string, success: boolean, error?: string}.
+     * User should not be blocked by not_found error when deleting, so successful result should be returned for 404 error
+     */
     deleteData: (resourceId: ResourceId) => Promise<DeleteSyncBlockResult>;
     generateResourceId: (sourceId: string, localId: string) => ResourceId;
     generateResourceIdForReference: (sourceId: ResourceId) => ResourceId;
     product: SyncBlockProduct;
+    updateReferenceData: (blocks: SyncBlockAttrs[], noContent?: boolean) => Promise<UpdateReferenceSyncBlockResult>;
     writeData: (data: SyncBlockData) => Promise<WriteSyncBlockResult>;
 }
 export type MediaEmojiProviderOptions = {
@@ -84,6 +95,7 @@ export declare abstract class SyncBlockDataProvider extends NodeDataProvider<Syn
      */
     abstract generateResourceId(sourceId: ResourceId, localId: BlockInstanceId): ResourceId;
     abstract generateResourceIdForReference(sourceId: ResourceId): ResourceId;
+    abstract updateReferenceData(blocks: SyncBlockAttrs[], noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
 }
 export type SubscriptionCallback = (data: SyncBlockInstance) => void;
 export type TitleSubscriptionCallback = (title: string) => void;

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

@@ -6,6 +6,7 @@ import type { SyncBlockInstance, SubscriptionCallback, SyncBlockDataProvider, Ti
 export declare class ReferenceSyncBlockStoreManager {
     private dataProvider?;
     private syncBlockCache;
+    private isCacheDirty;
     private subscriptions;
     private titleSubscriptions;
     private providerFactories;
@@ -44,5 +45,11 @@ export declare class ReferenceSyncBlockStoreManager {
     getSyncBlockURL(resourceId: ResourceId): string | undefined;
     getProviderFactory(resourceId: ResourceId): ProviderFactory | undefined;
     private retrieveDynamicProviders;
+    /**
+     * Update reference synced blocks on the document with the BE
+     *
+     * @returns true if the reference synced blocks are updated successfully, false otherwise
+     */
+    flush(): Promise<boolean>;
     destroy(): void;
 }

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

@@ -6,6 +6,7 @@ export declare const getErrorPayload: <T extends ACTION_SUBJECT_ID>(actionSubjec
 export declare const fetchErrorPayload: (error: string) => RendererSyncBlockEventPayload;
 export declare const getSourceInfoErrorPayload: (error: string) => RendererSyncBlockEventPayload;
 export declare const updateErrorPayload: (error: string) => SyncBlockEventPayload;
+export declare const updateReferenceErrorPayload: (error: string) => RendererSyncBlockEventPayload;
 export declare const createErrorPayload: (error: string) => SyncBlockEventPayload;
 export declare const deleteErrorPayload: (error: string) => SyncBlockEventPayload;
 export declare const updateCacheErrorPayload: (error: string) => SyncBlockEventPayload;

package/package.json

@@ -24,10 +24,9 @@
 	],
 	"atlaskit:src": "src/index.ts",
 	"dependencies": {
-		"@atlaskit/adf-schema": "^51.5.1",
 		"@atlaskit/adf-utils": "^19.26.0",
 		"@atlaskit/editor-json-transformer": "^8.31.0",
-		"@atlaskit/editor-prosemirror": "7.0.0",
+		"@atlaskit/editor-prosemirror": "^7.2.0",
 		"@atlaskit/node-data-provider": "^7.5.0",
 		"@babel/runtime": "^7.0.0",
 		"@compiled/react": "^0.18.6",
@@ -77,7 +76,7 @@
 		}
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "2.15.2",
+	"version": "2.15.3",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",