@atlaskit/editor-synced-block-provider 3.13.1 → 3.14.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @atlaskit/editor-synced-block-provider
 
+## 3.14.0
+
+### Minor Changes
+
+- [`55d9a4080dfa8`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/55d9a4080dfa8) -
+  parentAri field for fetch/write providers are mandatory
+
+## 3.13.2
+
+### Patch Changes
+
+- [`87abc5dda86fe`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/87abc5dda86fe) -
+  [ux] Show last edited time in sync block tooltip
+- Updated dependencies
+
 ## 3.13.1
 
 ### Patch Changes

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

@@ -48,7 +48,7 @@ var isBlockContentResponse = exports.isBlockContentResponse = function isBlockCo
  *       "status": "active",
  *       "createdAt": "2025-10-08T10:30:00.000Z",
  *       "createdBy": "557058:xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx",
- *       "updatedAt": "2025-10-08T10:30:00.000Z"
+ *       "contentUpdatedAt": "2025-10-08T10:30:00.000Z"
  *     }
  *   ],
  *   "errors": [
@@ -122,7 +122,7 @@ var BLOCK_SERVICE_API_URL = '/gateway/api/blocks/v1';
 var GRAPHQL_ENDPOINT = '/gateway/api/graphql';
 var GET_DOCUMENT_REFERENCE_BLOCKS_OPERATION_NAME = 'EDITOR_SYNCED_BLOCK_GET_DOCUMENT_REFERENCE_BLOCKS';
 var buildGetDocumentReferenceBlocksQuery = function buildGetDocumentReferenceBlocksQuery(documentAri) {
-  return "query ".concat(GET_DOCUMENT_REFERENCE_BLOCKS_OPERATION_NAME, " {\n\tblockService_getDocumentReferenceBlocks(documentAri: \"").concat(documentAri, "\") {\n\t\tblocks {\n\t\t\tblockAri\n\t\t\tblockInstanceId\n\t\t\tcontent\n\t\t\tcreatedAt\n\t\t\tcreatedBy\n\t\t\tproduct\n\t\t\tsourceAri\n\t\t\tstatus\n\t\t\tversion\n\t\t}\n\t\terrors {\n\t\t\tblockAri\n\t\t\tcode\n\t\t\treason\n\t\t}\n\t}\n}");
+  return "query ".concat(GET_DOCUMENT_REFERENCE_BLOCKS_OPERATION_NAME, " {\n\tblockService_getDocumentReferenceBlocks(documentAri: \"").concat(documentAri, "\") {\n\t\tblocks {\n\t\t\tblockAri\n\t\t\tblockInstanceId\n\t\t\tcontent\n\t\t\tcontentUpdatedAt\n\t\t\tcreatedAt\n\t\t\tcreatedBy\n\t\t\tproduct\n\t\t\tsourceAri\n\t\t\tstatus\n\t\t\tversion\n\t\t}\n\t\terrors {\n\t\t\tblockAri\n\t\t\tcode\n\t\t\treason\n\t\t}\n\t}\n}");
 };
 var BlockError = exports.BlockError = /*#__PURE__*/function (_Error) {
   function BlockError(status) {
@@ -137,11 +137,11 @@ var BlockError = exports.BlockError = /*#__PURE__*/function (_Error) {
 }( /*#__PURE__*/(0, _wrapNativeSuper2.default)(Error));
 var getSyncedBlockContent = exports.getSyncedBlockContent = /*#__PURE__*/function () {
   var _ref3 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(_ref2) {
-    var blockAri, documentAri, queryParams, response;
+    var blockAri, queryParams, response;
     return _regenerator.default.wrap(function _callee2$(_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
-          blockAri = _ref2.blockAri, documentAri = _ref2.documentAri;
+          blockAri = _ref2.blockAri;
           // Disable sending documentAri for now. We'll add it back if we find a way to update references that follows the save & refresh principle.
           // Slack discussion here: https://atlassian.slack.com/archives/C09DZT1TBNW/p1767836775552099?thread_ts=1767836754.024889&cid=C09DZT1TBNW
           // const queryParams = documentAri ? `?documentAri=${encodeURIComponent(documentAri)}` : '';

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

@@ -94,7 +94,6 @@ var blockAriToResourceId = exports.blockAriToResourceId = function blockAriToRes
 // convert BlockContentResponse to SyncBlockData
 // throws exception if JSON parsing fails
 // what's missing from BlockContentResponse to SyncBlockData:
-// - updatedAt
 // - sourceURL
 // - sourceTitle
 // - isSynced
@@ -111,9 +110,18 @@ var convertToSyncBlockData = exports.convertToSyncBlockData = function convertTo
       createdAt = undefined;
     }
   }
+  var contentUpdatedAt;
+  if (typeof data.contentUpdatedAt === 'number' && (0, _platformFeatureFlags.fg)('platform_synced_block_dogfooding')) {
+    try {
+      contentUpdatedAt = new Date(data.contentUpdatedAt).toISOString();
+    } catch (e) {
+      contentUpdatedAt = undefined;
+    }
+  }
   return {
     blockInstanceId: data.blockInstanceId,
     content: JSON.parse(data.content),
+    contentUpdatedAt: contentUpdatedAt,
     createdAt: createdAt,
     createdBy: data.createdBy,
     product: data.product,
@@ -204,7 +212,7 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
     key: "fetchData",
     value: function () {
       var _fetchData = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(resourceId) {
-        var blockAri, blockContentResponse, value, syncedBlockData;
+        var blockAri, blockContentResponse, value, syncedBlockData, contentUpdatedAt;
         return _regenerator.default.wrap(function _callee2$(_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
@@ -232,39 +240,47 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
             case 8:
               // Parse the synced block content from the response's content
               syncedBlockData = JSON.parse(value);
+              if (typeof blockContentResponse.contentUpdatedAt === 'number' && (0, _platformFeatureFlags.fg)('platform_synced_block_dogfooding')) {
+                try {
+                  contentUpdatedAt = new Date(blockContentResponse.contentUpdatedAt).toISOString();
+                } catch (e) {
+                  contentUpdatedAt = undefined;
+                }
+              }
               return _context2.abrupt("return", {
                 data: {
                   content: syncedBlockData,
                   resourceId: blockAri,
                   blockInstanceId: blockContentResponse.blockInstanceId,
                   // this was the node's localId, but has become the resourceId.
+                  contentUpdatedAt: contentUpdatedAt,
                   sourceAri: blockContentResponse.sourceAri,
                   product: blockContentResponse.product,
                   status: blockContentResponse.status
                 },
                 resourceId: resourceId
               });
-            case 12:
-              _context2.prev = 12;
+            case 13:
+              _context2.prev = 13;
               _context2.t0 = _context2["catch"](1);
               if (!(_context2.t0 instanceof _blockService.BlockError)) {
-                _context2.next = 16;
+                _context2.next = 17;
                 break;
               }
               return _context2.abrupt("return", {
                 error: mapBlockError(_context2.t0),
                 resourceId: resourceId
               });
-            case 16:
+            case 17:
               return _context2.abrupt("return", {
                 error: _types.SyncBlockError.Errored,
                 resourceId: resourceId
               });
-            case 17:
+            case 18:
             case "end":
               return _context2.stop();
           }
-        }, _callee2, this, [[1, 12]]);
+        }, _callee2, this, [[1, 13]]);
       }));
       function fetchData(_x2) {
         return _fetchData.apply(this, arguments);
@@ -357,7 +373,7 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
     value: (function () {
       var _batchFetchData = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee4(blockNodeIdentifiers) {
         var _this2 = this;
-        var blockIdentifiers, validResourceIds, processedResourceIds, response, results, _iterator, _step, blockContentResponse, resourceId, value, syncedBlockData, _iterator2, _step2, errorResponse, _resourceId, _iterator3, _step3, blockNodeIdentifier;
+        var blockIdentifiers, validResourceIds, processedResourceIds, response, results, _iterator, _step, blockContentResponse, resourceId, value, syncedBlockData, contentUpdatedAt, _iterator2, _step2, errorResponse, _resourceId, _iterator3, _step3, blockNodeIdentifier;
         return _regenerator.default.wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
@@ -429,10 +445,19 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
             case 24:
               try {
                 syncedBlockData = JSON.parse(value);
+                contentUpdatedAt = void 0;
+                if (typeof blockContentResponse.contentUpdatedAt === 'number' && (0, _platformFeatureFlags.fg)('platform_synced_block_dogfooding')) {
+                  try {
+                    contentUpdatedAt = new Date(blockContentResponse.contentUpdatedAt).toISOString();
+                  } catch (e) {
+                    contentUpdatedAt = undefined;
+                  }
+                }
                 results.push({
                   data: {
                     content: syncedBlockData,
                     resourceId: blockContentResponse.blockAri,
+                    contentUpdatedAt: contentUpdatedAt,
                     blockInstanceId: blockContentResponse.blockInstanceId,
                     sourceAri: blockContentResponse.sourceAri,
                     product: blockContentResponse.product,
@@ -878,7 +903,7 @@ var createBlockServiceAPIProviders = function createBlockServiceAPIProviders(_re
   return {
     fetchProvider: new BlockServiceADFFetchProvider({
       cloudId: cloudId,
-      parentAri: (0, _platformFeatureFlags.fg)('platform_synced_block_dogfooding') ? parentAri : undefined
+      parentAri: parentAri
     }),
     writeProvider: new BlockServiceADFWriteProvider({
       cloudId: cloudId,
@@ -916,6 +941,10 @@ var createBlockServiceFetchOnlyAPIProvider = function createBlockServiceFetchOnl
     writeProvider: undefined
   };
 };
+
+/**
+ * If the parentAri is not a valid ARI, pass in an empty string.
+ */
 var useMemoizedBlockServiceFetchOnlyAPIProvider = exports.useMemoizedBlockServiceFetchOnlyAPIProvider = function useMemoizedBlockServiceFetchOnlyAPIProvider(_ref8) {
   var cloudId = _ref8.cloudId,
     parentAri = _ref8.parentAri;

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

@@ -31,7 +31,7 @@ export const isBlockContentResponse = response => {
  *       "status": "active",
  *       "createdAt": "2025-10-08T10:30:00.000Z",
  *       "createdBy": "557058:xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx",
- *       "updatedAt": "2025-10-08T10:30:00.000Z"
+ *       "contentUpdatedAt": "2025-10-08T10:30:00.000Z"
  *     }
  *   ],
  *   "errors": [
@@ -79,6 +79,7 @@ const buildGetDocumentReferenceBlocksQuery = documentAri => `query ${GET_DOCUMEN
 			blockAri
 			blockInstanceId
 			content
+			contentUpdatedAt
 			createdAt
 			createdBy
 			product
@@ -100,8 +101,7 @@ export class BlockError extends Error {
   }
 }
 export const getSyncedBlockContent = async ({
-  blockAri,
-  documentAri
+  blockAri
 }) => {
   // Disable sending documentAri for now. We'll add it back if we find a way to update references that follows the save & refresh principle.
   // Slack discussion here: https://atlassian.slack.com/archives/C09DZT1TBNW/p1767836775552099?thread_ts=1767836754.024889&cid=C09DZT1TBNW

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

@@ -77,7 +77,6 @@ export const blockAriToResourceId = blockAri => {
 // convert BlockContentResponse to SyncBlockData
 // throws exception if JSON parsing fails
 // what's missing from BlockContentResponse to SyncBlockData:
-// - updatedAt
 // - sourceURL
 // - sourceTitle
 // - isSynced
@@ -94,9 +93,18 @@ export const convertToSyncBlockData = (data, resourceId) => {
       createdAt = undefined;
     }
   }
+  let contentUpdatedAt;
+  if (typeof data.contentUpdatedAt === 'number' && fg('platform_synced_block_dogfooding')) {
+    try {
+      contentUpdatedAt = new Date(data.contentUpdatedAt).toISOString();
+    } catch (e) {
+      contentUpdatedAt = undefined;
+    }
+  }
   return {
     blockInstanceId: data.blockInstanceId,
     content: JSON.parse(data.content),
+    contentUpdatedAt,
     createdAt,
     createdBy: data.createdBy,
     product: data.product,
@@ -181,12 +189,21 @@ class BlockServiceADFFetchProvider {
 
       // Parse the synced block content from the response's content
       const syncedBlockData = JSON.parse(value);
+      let contentUpdatedAt;
+      if (typeof blockContentResponse.contentUpdatedAt === 'number' && fg('platform_synced_block_dogfooding')) {
+        try {
+          contentUpdatedAt = new Date(blockContentResponse.contentUpdatedAt).toISOString();
+        } catch (e) {
+          contentUpdatedAt = undefined;
+        }
+      }
       return {
         data: {
           content: syncedBlockData,
           resourceId: blockAri,
           blockInstanceId: blockContentResponse.blockInstanceId,
           // this was the node's localId, but has become the resourceId.
+          contentUpdatedAt,
           sourceAri: blockContentResponse.sourceAri,
           product: blockContentResponse.product,
           status: blockContentResponse.status
@@ -308,10 +325,19 @@ class BlockServiceADFFetchProvider {
           }
           try {
             const syncedBlockData = JSON.parse(value);
+            let contentUpdatedAt;
+            if (typeof blockContentResponse.contentUpdatedAt === 'number' && fg('platform_synced_block_dogfooding')) {
+              try {
+                contentUpdatedAt = new Date(blockContentResponse.contentUpdatedAt).toISOString();
+              } catch (e) {
+                contentUpdatedAt = undefined;
+              }
+            }
             results.push({
               data: {
                 content: syncedBlockData,
                 resourceId: blockContentResponse.blockAri,
+                contentUpdatedAt,
                 blockInstanceId: blockContentResponse.blockInstanceId,
                 sourceAri: blockContentResponse.sourceAri,
                 product: blockContentResponse.product,
@@ -595,7 +621,7 @@ const createBlockServiceAPIProviders = ({
   return {
     fetchProvider: new BlockServiceADFFetchProvider({
       cloudId,
-      parentAri: fg('platform_synced_block_dogfooding') ? parentAri : undefined
+      parentAri
     }),
     writeProvider: new BlockServiceADFWriteProvider({
       cloudId,
@@ -635,6 +661,10 @@ const createBlockServiceFetchOnlyAPIProvider = ({
     writeProvider: undefined
   };
 };
+
+/**
+ * If the parentAri is not a valid ARI, pass in an empty string.
+ */
 export const useMemoizedBlockServiceFetchOnlyAPIProvider = ({
   cloudId,
   parentAri

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

@@ -41,7 +41,7 @@ export var isBlockContentResponse = function isBlockContentResponse(response) {
  *       "status": "active",
  *       "createdAt": "2025-10-08T10:30:00.000Z",
  *       "createdBy": "557058:xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx",
- *       "updatedAt": "2025-10-08T10:30:00.000Z"
+ *       "contentUpdatedAt": "2025-10-08T10:30:00.000Z"
  *     }
  *   ],
  *   "errors": [
@@ -115,7 +115,7 @@ var BLOCK_SERVICE_API_URL = '/gateway/api/blocks/v1';
 var GRAPHQL_ENDPOINT = '/gateway/api/graphql';
 var GET_DOCUMENT_REFERENCE_BLOCKS_OPERATION_NAME = 'EDITOR_SYNCED_BLOCK_GET_DOCUMENT_REFERENCE_BLOCKS';
 var buildGetDocumentReferenceBlocksQuery = function buildGetDocumentReferenceBlocksQuery(documentAri) {
-  return "query ".concat(GET_DOCUMENT_REFERENCE_BLOCKS_OPERATION_NAME, " {\n\tblockService_getDocumentReferenceBlocks(documentAri: \"").concat(documentAri, "\") {\n\t\tblocks {\n\t\t\tblockAri\n\t\t\tblockInstanceId\n\t\t\tcontent\n\t\t\tcreatedAt\n\t\t\tcreatedBy\n\t\t\tproduct\n\t\t\tsourceAri\n\t\t\tstatus\n\t\t\tversion\n\t\t}\n\t\terrors {\n\t\t\tblockAri\n\t\t\tcode\n\t\t\treason\n\t\t}\n\t}\n}");
+  return "query ".concat(GET_DOCUMENT_REFERENCE_BLOCKS_OPERATION_NAME, " {\n\tblockService_getDocumentReferenceBlocks(documentAri: \"").concat(documentAri, "\") {\n\t\tblocks {\n\t\t\tblockAri\n\t\t\tblockInstanceId\n\t\t\tcontent\n\t\t\tcontentUpdatedAt\n\t\t\tcreatedAt\n\t\t\tcreatedBy\n\t\t\tproduct\n\t\t\tsourceAri\n\t\t\tstatus\n\t\t\tversion\n\t\t}\n\t\terrors {\n\t\t\tblockAri\n\t\t\tcode\n\t\t\treason\n\t\t}\n\t}\n}");
 };
 export var BlockError = /*#__PURE__*/function (_Error) {
   function BlockError(status) {
@@ -130,11 +130,11 @@ export var BlockError = /*#__PURE__*/function (_Error) {
 }( /*#__PURE__*/_wrapNativeSuper(Error));
 export var getSyncedBlockContent = /*#__PURE__*/function () {
   var _ref3 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(_ref2) {
-    var blockAri, documentAri, queryParams, response;
+    var blockAri, queryParams, response;
     return _regeneratorRuntime.wrap(function _callee2$(_context2) {
       while (1) switch (_context2.prev = _context2.next) {
         case 0:
-          blockAri = _ref2.blockAri, documentAri = _ref2.documentAri;
+          blockAri = _ref2.blockAri;
           // Disable sending documentAri for now. We'll add it back if we find a way to update references that follows the save & refresh principle.
           // Slack discussion here: https://atlassian.slack.com/archives/C09DZT1TBNW/p1767836775552099?thread_ts=1767836754.024889&cid=C09DZT1TBNW
           // const queryParams = documentAri ? `?documentAri=${encodeURIComponent(documentAri)}` : '';

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

@@ -88,7 +88,6 @@ export var blockAriToResourceId = function blockAriToResourceId(blockAri) {
 // convert BlockContentResponse to SyncBlockData
 // throws exception if JSON parsing fails
 // what's missing from BlockContentResponse to SyncBlockData:
-// - updatedAt
 // - sourceURL
 // - sourceTitle
 // - isSynced
@@ -105,9 +104,18 @@ export var convertToSyncBlockData = function convertToSyncBlockData(data, resour
       createdAt = undefined;
     }
   }
+  var contentUpdatedAt;
+  if (typeof data.contentUpdatedAt === 'number' && fg('platform_synced_block_dogfooding')) {
+    try {
+      contentUpdatedAt = new Date(data.contentUpdatedAt).toISOString();
+    } catch (e) {
+      contentUpdatedAt = undefined;
+    }
+  }
   return {
     blockInstanceId: data.blockInstanceId,
     content: JSON.parse(data.content),
+    contentUpdatedAt: contentUpdatedAt,
     createdAt: createdAt,
     createdBy: data.createdBy,
     product: data.product,
@@ -198,7 +206,7 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
     key: "fetchData",
     value: function () {
       var _fetchData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee2(resourceId) {
-        var blockAri, blockContentResponse, value, syncedBlockData;
+        var blockAri, blockContentResponse, value, syncedBlockData, contentUpdatedAt;
         return _regeneratorRuntime.wrap(function _callee2$(_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
@@ -226,39 +234,47 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
             case 8:
               // Parse the synced block content from the response's content
               syncedBlockData = JSON.parse(value);
+              if (typeof blockContentResponse.contentUpdatedAt === 'number' && fg('platform_synced_block_dogfooding')) {
+                try {
+                  contentUpdatedAt = new Date(blockContentResponse.contentUpdatedAt).toISOString();
+                } catch (e) {
+                  contentUpdatedAt = undefined;
+                }
+              }
               return _context2.abrupt("return", {
                 data: {
                   content: syncedBlockData,
                   resourceId: blockAri,
                   blockInstanceId: blockContentResponse.blockInstanceId,
                   // this was the node's localId, but has become the resourceId.
+                  contentUpdatedAt: contentUpdatedAt,
                   sourceAri: blockContentResponse.sourceAri,
                   product: blockContentResponse.product,
                   status: blockContentResponse.status
                 },
                 resourceId: resourceId
               });
-            case 12:
-              _context2.prev = 12;
+            case 13:
+              _context2.prev = 13;
               _context2.t0 = _context2["catch"](1);
               if (!(_context2.t0 instanceof BlockError)) {
-                _context2.next = 16;
+                _context2.next = 17;
                 break;
               }
               return _context2.abrupt("return", {
                 error: mapBlockError(_context2.t0),
                 resourceId: resourceId
               });
-            case 16:
+            case 17:
               return _context2.abrupt("return", {
                 error: SyncBlockError.Errored,
                 resourceId: resourceId
               });
-            case 17:
+            case 18:
             case "end":
               return _context2.stop();
           }
-        }, _callee2, this, [[1, 12]]);
+        }, _callee2, this, [[1, 13]]);
       }));
       function fetchData(_x2) {
         return _fetchData.apply(this, arguments);
@@ -351,7 +367,7 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
     value: (function () {
       var _batchFetchData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4(blockNodeIdentifiers) {
         var _this2 = this;
-        var blockIdentifiers, validResourceIds, processedResourceIds, response, results, _iterator, _step, blockContentResponse, resourceId, value, syncedBlockData, _iterator2, _step2, errorResponse, _resourceId, _iterator3, _step3, blockNodeIdentifier;
+        var blockIdentifiers, validResourceIds, processedResourceIds, response, results, _iterator, _step, blockContentResponse, resourceId, value, syncedBlockData, contentUpdatedAt, _iterator2, _step2, errorResponse, _resourceId, _iterator3, _step3, blockNodeIdentifier;
         return _regeneratorRuntime.wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
@@ -423,10 +439,19 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
             case 24:
               try {
                 syncedBlockData = JSON.parse(value);
+                contentUpdatedAt = void 0;
+                if (typeof blockContentResponse.contentUpdatedAt === 'number' && fg('platform_synced_block_dogfooding')) {
+                  try {
+                    contentUpdatedAt = new Date(blockContentResponse.contentUpdatedAt).toISOString();
+                  } catch (e) {
+                    contentUpdatedAt = undefined;
+                  }
+                }
                 results.push({
                   data: {
                     content: syncedBlockData,
                     resourceId: blockContentResponse.blockAri,
+                    contentUpdatedAt: contentUpdatedAt,
                     blockInstanceId: blockContentResponse.blockInstanceId,
                     sourceAri: blockContentResponse.sourceAri,
                     product: blockContentResponse.product,
@@ -872,7 +897,7 @@ var createBlockServiceAPIProviders = function createBlockServiceAPIProviders(_re
   return {
     fetchProvider: new BlockServiceADFFetchProvider({
       cloudId: cloudId,
-      parentAri: fg('platform_synced_block_dogfooding') ? parentAri : undefined
+      parentAri: parentAri
     }),
     writeProvider: new BlockServiceADFWriteProvider({
       cloudId: cloudId,
@@ -910,6 +935,10 @@ var createBlockServiceFetchOnlyAPIProvider = function createBlockServiceFetchOnl
     writeProvider: undefined
   };
 };
+
+/**
+ * If the parentAri is not a valid ARI, pass in an empty string.
+ */
 export var useMemoizedBlockServiceFetchOnlyAPIProvider = function useMemoizedBlockServiceFetchOnlyAPIProvider(_ref8) {
   var cloudId = _ref8.cloudId,
     parentAri = _ref8.parentAri;

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

@@ -3,6 +3,7 @@ export type BlockContentResponse = {
     blockAri: string;
     blockInstanceId: string;
     content: string;
+    contentUpdatedAt: number;
     createdAt: number;
     createdBy: string;
     product: SyncBlockProduct;
@@ -49,7 +50,7 @@ export declare const isBlockContentResponse: (response: BlockContentResponse | E
  *       "status": "active",
  *       "createdAt": "2025-10-08T10:30:00.000Z",
  *       "createdBy": "557058:xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx",
- *       "updatedAt": "2025-10-08T10:30:00.000Z"
+ *       "contentUpdatedAt": "2025-10-08T10:30:00.000Z"
  *     }
  *   ],
  *   "errors": [
@@ -116,7 +117,7 @@ export declare class BlockError extends Error {
     readonly status: number;
     constructor(status: number);
 }
-export declare const getSyncedBlockContent: ({ blockAri, documentAri, }: GetSyncedBlockContentRequest) => Promise<BlockContentResponse>;
+export declare const getSyncedBlockContent: ({ blockAri }: GetSyncedBlockContentRequest) => Promise<BlockContentResponse>;
 /**
  * Batch retrieves multiple synced blocks by their ARIs.
  *

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

@@ -29,6 +29,7 @@ export declare enum SyncBlockError {
 export interface SyncBlockData {
     blockInstanceId: BlockInstanceId;
     content: Array<ADFEntity>;
+    contentUpdatedAt?: string;
     createdAt?: string;
     createdBy?: string;
     isSynced?: boolean;
@@ -45,12 +46,12 @@ export interface SyncBlockData {
     sourceSubType?: string | null;
     sourceTitle?: string;
     sourceURL?: string;
-    updatedAt?: string;
     status?: SyncBlockStatus;
 }
 export interface ReferenceSyncBlockResponse {
     blockAri: string;
     blockInstanceId?: BlockInstanceId;
+    contentUpdatedAt?: string;
     createdAt?: string;
     createdBy?: string;
     documentAri: string;

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

@@ -22,14 +22,14 @@ export declare const convertToSyncBlockData: (data: BlockContentResponse, resour
 export declare const fetchReferences: (documentAri: string) => Promise<SyncBlockInstance[] | SyncBlockError>;
 interface BlockServiceADFFetchProviderProps {
     cloudId: string;
-    parentAri?: string;
+    parentAri: string | undefined;
 }
 /**
  * ADFFetchProvider implementation that fetches synced block data from Block Service API
  */
 declare class BlockServiceADFFetchProvider implements ADFFetchProvider {
     private cloudId;
-    private parentAri?;
+    private parentAri;
     constructor({ cloudId, parentAri }: BlockServiceADFFetchProviderProps);
     fetchData(resourceId: string): Promise<SyncBlockInstance>;
     fetchReferences(referenceResourceId: string): Promise<ReferenceSyncBlockData>;
@@ -56,7 +56,7 @@ declare class BlockServiceADFFetchProvider implements ADFFetchProvider {
 interface BlockServiceADFWriteProviderProps {
     cloudId: string;
     getVersion?: () => number | undefined;
-    parentAri?: string;
+    parentAri: string | undefined;
     parentId?: string;
     product: SyncBlockProduct;
 }
@@ -68,7 +68,7 @@ declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
     private parentId?;
     private getVersion?;
     product: SyncBlockProduct;
-    parentAri?: string;
+    parentAri: string | undefined;
     constructor({ cloudId, parentAri, parentId, product, getVersion, }: BlockServiceADFWriteProviderProps);
     writeData(data: SyncBlockData): Promise<WriteSyncBlockResult>;
     createData(data: SyncBlockData): Promise<WriteSyncBlockResult>;
@@ -80,7 +80,7 @@ declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
 interface BlockServiceAPIProvidersProps {
     cloudId: string;
     getVersion?: () => number | undefined;
-    parentAri?: string;
+    parentAri: string | undefined;
     parentId?: string;
     product: SyncBlockProduct;
 }
@@ -90,8 +90,11 @@ export declare const useMemoizedBlockServiceAPIProviders: ({ cloudId, parentAri,
 };
 interface BlockServiceFetchOnlyAPIProviderProps {
     cloudId: string;
-    parentAri?: string;
+    parentAri: string | undefined;
 }
+/**
+ * If the parentAri is not a valid ARI, pass in an empty string.
+ */
 export declare const useMemoizedBlockServiceFetchOnlyAPIProvider: ({ cloudId, parentAri, }: BlockServiceFetchOnlyAPIProviderProps) => {
     fetchProvider: BlockServiceADFFetchProvider;
     writeProvider: undefined;

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

@@ -3,6 +3,7 @@ export type BlockContentResponse = {
     blockAri: string;
     blockInstanceId: string;
     content: string;
+    contentUpdatedAt: number;
     createdAt: number;
     createdBy: string;
     product: SyncBlockProduct;
@@ -49,7 +50,7 @@ export declare const isBlockContentResponse: (response: BlockContentResponse | E
  *       "status": "active",
  *       "createdAt": "2025-10-08T10:30:00.000Z",
  *       "createdBy": "557058:xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx",
- *       "updatedAt": "2025-10-08T10:30:00.000Z"
+ *       "contentUpdatedAt": "2025-10-08T10:30:00.000Z"
  *     }
  *   ],
  *   "errors": [
@@ -116,7 +117,7 @@ export declare class BlockError extends Error {
     readonly status: number;
     constructor(status: number);
 }
-export declare const getSyncedBlockContent: ({ blockAri, documentAri, }: GetSyncedBlockContentRequest) => Promise<BlockContentResponse>;
+export declare const getSyncedBlockContent: ({ blockAri }: GetSyncedBlockContentRequest) => Promise<BlockContentResponse>;
 /**
  * Batch retrieves multiple synced blocks by their ARIs.
  *

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

@@ -29,6 +29,7 @@ export declare enum SyncBlockError {
 export interface SyncBlockData {
     blockInstanceId: BlockInstanceId;
     content: Array<ADFEntity>;
+    contentUpdatedAt?: string;
     createdAt?: string;
     createdBy?: string;
     isSynced?: boolean;
@@ -45,12 +46,12 @@ export interface SyncBlockData {
     sourceSubType?: string | null;
     sourceTitle?: string;
     sourceURL?: string;
-    updatedAt?: string;
     status?: SyncBlockStatus;
 }
 export interface ReferenceSyncBlockResponse {
     blockAri: string;
     blockInstanceId?: BlockInstanceId;
+    contentUpdatedAt?: string;
     createdAt?: string;
     createdBy?: string;
     documentAri: string;

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

@@ -22,14 +22,14 @@ export declare const convertToSyncBlockData: (data: BlockContentResponse, resour
 export declare const fetchReferences: (documentAri: string) => Promise<SyncBlockInstance[] | SyncBlockError>;
 interface BlockServiceADFFetchProviderProps {
     cloudId: string;
-    parentAri?: string;
+    parentAri: string | undefined;
 }
 /**
  * ADFFetchProvider implementation that fetches synced block data from Block Service API
  */
 declare class BlockServiceADFFetchProvider implements ADFFetchProvider {
     private cloudId;
-    private parentAri?;
+    private parentAri;
     constructor({ cloudId, parentAri }: BlockServiceADFFetchProviderProps);
     fetchData(resourceId: string): Promise<SyncBlockInstance>;
     fetchReferences(referenceResourceId: string): Promise<ReferenceSyncBlockData>;
@@ -56,7 +56,7 @@ declare class BlockServiceADFFetchProvider implements ADFFetchProvider {
 interface BlockServiceADFWriteProviderProps {
     cloudId: string;
     getVersion?: () => number | undefined;
-    parentAri?: string;
+    parentAri: string | undefined;
     parentId?: string;
     product: SyncBlockProduct;
 }
@@ -68,7 +68,7 @@ declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
     private parentId?;
     private getVersion?;
     product: SyncBlockProduct;
-    parentAri?: string;
+    parentAri: string | undefined;
     constructor({ cloudId, parentAri, parentId, product, getVersion, }: BlockServiceADFWriteProviderProps);
     writeData(data: SyncBlockData): Promise<WriteSyncBlockResult>;
     createData(data: SyncBlockData): Promise<WriteSyncBlockResult>;
@@ -80,7 +80,7 @@ declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
 interface BlockServiceAPIProvidersProps {
     cloudId: string;
     getVersion?: () => number | undefined;
-    parentAri?: string;
+    parentAri: string | undefined;
     parentId?: string;
     product: SyncBlockProduct;
 }
@@ -90,8 +90,11 @@ export declare const useMemoizedBlockServiceAPIProviders: ({ cloudId, parentAri,
 };
 interface BlockServiceFetchOnlyAPIProviderProps {
     cloudId: string;
-    parentAri?: string;
+    parentAri: string | undefined;
 }
+/**
+ * If the parentAri is not a valid ARI, pass in an empty string.
+ */
 export declare const useMemoizedBlockServiceFetchOnlyAPIProvider: ({ cloudId, parentAri, }: BlockServiceFetchOnlyAPIProviderProps) => {
     fetchProvider: BlockServiceADFFetchProvider;
     writeProvider: undefined;

package/package.json

@@ -78,7 +78,7 @@
 		}
 	},
 	"name": "@atlaskit/editor-synced-block-provider",
-	"version": "3.13.1",
+	"version": "3.14.0",
 	"description": "Synced Block Provider for @atlaskit/editor-plugin-synced-block",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",