@atlaskit/editor-synced-block-provider 3.4.0 → 3.5.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @atlaskit/editor-synced-block-provider
 
+## 3.5.0
+
+### Minor Changes
+
+- [`25da5a5d67a2a`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/25da5a5d67a2a) -
+  EDITOR-2257 implement resourceId conversion and enable SSR
+
+## 3.4.1
+
+### Patch Changes
+
+- [`656adaeec9d0b`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/656adaeec9d0b) -
+  [ux] EDITOR-1665 add experience tracking for create sync block
+- Updated dependencies
+
 ## 3.4.0
 
 ### Minor Changes

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

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.useMemoizedBlockServiceFetchOnlyAPIProvider = exports.useMemoizedBlockServiceAPIProviders = exports.fetchReferences = exports.createBlockServiceFetchOnlyAPIProvider = exports.createBlockServiceAPIProviders = void 0;
+exports.useMemoizedBlockServiceFetchOnlyAPIProvider = exports.useMemoizedBlockServiceAPIProviders = exports.fetchReferences = exports.createBlockServiceFetchOnlyAPIProvider = exports.createBlockServiceAPIProviders = exports.convertToSyncBlockData = exports.blockAriToResourceId = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
@@ -39,6 +39,32 @@ var mapBlockError = function mapBlockError(error) {
   return _types.SyncBlockError.Errored;
 };
 
+/**
+ * Extracts the ResourceId from a block ARI by returning the full path after synced-block/.
+ *
+ * Document ARI format from Block Service API:
+ * "ari:cloud:blocks:{uuid}:synced-block/{product}/{parentId}/{resourceId}"
+ *
+ * ResourceId format (extracted from ARI):
+ * "{product}/{parentId}/{resourceId}" (the full path after synced-block/)
+ *
+ * Example in context:
+ * Input:  "ari:cloud:blocks:{uuid}:synced-block/confluence-page/{pageId}/{resourceId}"
+ * Output: "confluence-page/{pageId}/{resourceId}"
+ *
+ * @param blockAri - The block ARI string from Block Service API
+ * @returns The ResourceId (full path after synced-block/)
+ */
+var blockAriToResourceId = exports.blockAriToResourceId = function blockAriToResourceId(blockAri) {
+  // Validate ARI format and extract resourceId using regex
+  // Format: ari:cloud:blocks:{uuid}:synced-block/{product}/{parentId}/{resourceId}
+  // The regex captures the full path after synced-block/
+  // e.g. ari:cloud:blocks:DUMMY-a5a01d21-1cc3-4f29-9565-f2bb8cd969f5:synced-block/confluence-page/455232061495/e8cf64e3-1b6e-489b-ad86-8465b0905bb4
+  // should return confluence-page/455232061495/e8cf64e3-1b6e-489b-ad86-8465b0905bb4
+  var match = blockAri.match(/^ari:cloud:blocks:.*:synced-block\/(.+)$/);
+  return (match === null || match === void 0 ? void 0 : match[1]) || null;
+};
+
 // convert BlockContentResponse to SyncBlockData
 // throws exception if JSON parsing fails
 // what's missing from BlockContentResponse to SyncBlockData:
@@ -46,9 +72,9 @@ var mapBlockError = function mapBlockError(error) {
 // - sourceURL
 // - sourceTitle
 // - isSynced
-var convertToSyncBlockData = function convertToSyncBlockData(data) {
+var convertToSyncBlockData = exports.convertToSyncBlockData = function convertToSyncBlockData(data, resourceId) {
   var createdAt;
-  if (data.createdAt) {
+  if (data.createdAt !== undefined && data.createdAt !== null) {
     try {
       // BE returns microseconds, convert to milliseconds
       // BE should fix this in the future
@@ -65,7 +91,7 @@ var convertToSyncBlockData = function convertToSyncBlockData(data) {
     createdAt: createdAt,
     createdBy: data.createdBy,
     product: data.product,
-    resourceId: data.blockAri,
+    resourceId: resourceId,
     sourceAri: data.sourceAri
   };
 };
@@ -96,9 +122,17 @@ var fetchReferences = exports.fetchReferences = /*#__PURE__*/function () {
           _ref2 = response || {}, blocks = _ref2.blocks, errors = _ref2.errors;
           blocksInstances = (blocks || []).map(function (blockContentResponse) {
             try {
+              var resourceId = blockAriToResourceId(blockContentResponse.blockAri);
+              if (!resourceId) {
+                // could not extract resourceId from blockAri, return InvalidContent error
+                return {
+                  error: _types.SyncBlockError.InvalidContent,
+                  resourceId: blockContentResponse.blockAri
+                };
+              }
               return {
-                data: convertToSyncBlockData(blockContentResponse),
-                resourceId: blockContentResponse.blockAri
+                data: convertToSyncBlockData(blockContentResponse, resourceId),
+                resourceId: resourceId
               };
             } catch (_unused) {
               // JSON parsing error, return InvalidContent error

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

@@ -11,6 +11,7 @@ var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/cl
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _monitoring = require("@atlaskit/editor-common/monitoring");
+var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _types = require("../common/types");
 var _errorHandling = require("../utils/errorHandling");
 var _utils = require("../utils/utils");
@@ -39,6 +40,11 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
     value: function setFireAnalyticsEvent(fireAnalyticsEvent) {
       this.fireAnalyticsEvent = fireAnalyticsEvent;
     }
+  }, {
+    key: "setCreateExperience",
+    value: function setCreateExperience(createExperience) {
+      this.createExperience = createExperience;
+    }
   }, {
     key: "isSourceBlock",
     value: function isSourceBlock(node) {
@@ -271,28 +277,49 @@ var SourceSyncBlockStoreManager = exports.SourceSyncBlockStoreManager = /*#__PUR
           if (resourceId) {
             _this4.commitPendingCreation(true);
           } else {
-            var _this4$fireAnalyticsE;
             _this4.commitPendingCreation(false);
-            (_this4$fireAnalyticsE = _this4.fireAnalyticsEvent) === null || _this4$fireAnalyticsE === void 0 || _this4$fireAnalyticsE.call(_this4, (0, _errorHandling.createErrorPayload)(result.error || 'Failed to create bodied sync block'));
+            if ((0, _platformFeatureFlags.fg)('platform_synced_block_dogfooding')) {
+              var _this4$createExperien;
+              (_this4$createExperien = _this4.createExperience) === null || _this4$createExperien === void 0 || _this4$createExperien.failure({
+                reason: result.error || 'Failed to create bodied sync block'
+              });
+            } else {
+              var _this4$fireAnalyticsE;
+              (_this4$fireAnalyticsE = _this4.fireAnalyticsEvent) === null || _this4$fireAnalyticsE === void 0 || _this4$fireAnalyticsE.call(_this4, (0, _errorHandling.createErrorPayload)(result.error || 'Failed to create bodied sync block'));
+            }
           }
         }).catch(function (error) {
-          var _this4$fireAnalyticsE2;
           _this4.commitPendingCreation(false);
           (0, _monitoring.logException)(error, {
             location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
           });
-          (_this4$fireAnalyticsE2 = _this4.fireAnalyticsEvent) === null || _this4$fireAnalyticsE2 === void 0 || _this4$fireAnalyticsE2.call(_this4, (0, _errorHandling.createErrorPayload)(error.message));
+          if ((0, _platformFeatureFlags.fg)('platform_synced_block_dogfooding')) {
+            var _this4$createExperien2;
+            (_this4$createExperien2 = _this4.createExperience) === null || _this4$createExperien2 === void 0 || _this4$createExperien2.failure({
+              reason: error.message
+            });
+          } else {
+            var _this4$fireAnalyticsE2;
+            (_this4$fireAnalyticsE2 = _this4.fireAnalyticsEvent) === null || _this4$fireAnalyticsE2 === void 0 || _this4$fireAnalyticsE2.call(_this4, (0, _errorHandling.createErrorPayload)(error.message));
+          }
         });
         this.registerPendingCreation(resourceId);
       } catch (error) {
-        var _this$fireAnalyticsEv3;
         if (this.hasPendingCreation()) {
           this.commitPendingCreation(false);
         }
         (0, _monitoring.logException)(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, (0, _errorHandling.createErrorPayload)(error.message));
+        if ((0, _platformFeatureFlags.fg)('platform_synced_block_dogfooding')) {
+          var _this$createExperienc;
+          (_this$createExperienc = this.createExperience) === null || _this$createExperienc === void 0 || _this$createExperienc.failure({
+            reason: error.message
+          });
+        } else {
+          var _this$fireAnalyticsEv3;
+          (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, (0, _errorHandling.createErrorPayload)(error.message));
+        }
       }
     }
   }, {

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

@@ -25,6 +25,32 @@ const mapBlockError = error => {
   return SyncBlockError.Errored;
 };
 
+/**
+ * Extracts the ResourceId from a block ARI by returning the full path after synced-block/.
+ *
+ * Document ARI format from Block Service API:
+ * "ari:cloud:blocks:{uuid}:synced-block/{product}/{parentId}/{resourceId}"
+ *
+ * ResourceId format (extracted from ARI):
+ * "{product}/{parentId}/{resourceId}" (the full path after synced-block/)
+ *
+ * Example in context:
+ * Input:  "ari:cloud:blocks:{uuid}:synced-block/confluence-page/{pageId}/{resourceId}"
+ * Output: "confluence-page/{pageId}/{resourceId}"
+ *
+ * @param blockAri - The block ARI string from Block Service API
+ * @returns The ResourceId (full path after synced-block/)
+ */
+export const blockAriToResourceId = blockAri => {
+  // Validate ARI format and extract resourceId using regex
+  // Format: ari:cloud:blocks:{uuid}:synced-block/{product}/{parentId}/{resourceId}
+  // The regex captures the full path after synced-block/
+  // e.g. ari:cloud:blocks:DUMMY-a5a01d21-1cc3-4f29-9565-f2bb8cd969f5:synced-block/confluence-page/455232061495/e8cf64e3-1b6e-489b-ad86-8465b0905bb4
+  // should return confluence-page/455232061495/e8cf64e3-1b6e-489b-ad86-8465b0905bb4
+  const match = blockAri.match(/^ari:cloud:blocks:.*:synced-block\/(.+)$/);
+  return (match === null || match === void 0 ? void 0 : match[1]) || null;
+};
+
 // convert BlockContentResponse to SyncBlockData
 // throws exception if JSON parsing fails
 // what's missing from BlockContentResponse to SyncBlockData:
@@ -32,9 +58,9 @@ const mapBlockError = error => {
 // - sourceURL
 // - sourceTitle
 // - isSynced
-const convertToSyncBlockData = data => {
+export const convertToSyncBlockData = (data, resourceId) => {
   let createdAt;
-  if (data.createdAt) {
+  if (data.createdAt !== undefined && data.createdAt !== null) {
     try {
       // BE returns microseconds, convert to milliseconds
       // BE should fix this in the future
@@ -51,7 +77,7 @@ const convertToSyncBlockData = data => {
     createdAt,
     createdBy: data.createdBy,
     product: data.product,
-    resourceId: data.blockAri,
+    resourceId,
     sourceAri: data.sourceAri
   };
 };
@@ -71,9 +97,17 @@ export const fetchReferences = async documentAri => {
   } = response || {};
   const blocksInstances = (blocks || []).map(blockContentResponse => {
     try {
+      const resourceId = blockAriToResourceId(blockContentResponse.blockAri);
+      if (!resourceId) {
+        // could not extract resourceId from blockAri, return InvalidContent error
+        return {
+          error: SyncBlockError.InvalidContent,
+          resourceId: blockContentResponse.blockAri
+        };
+      }
       return {
-        data: convertToSyncBlockData(blockContentResponse),
-        resourceId: blockContentResponse.blockAri
+        data: convertToSyncBlockData(blockContentResponse, resourceId),
+        resourceId
       };
     } catch {
       // JSON parsing error, return InvalidContent error

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

@@ -1,5 +1,6 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { logException } from '@atlaskit/editor-common/monitoring';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { SyncBlockError } from '../common/types';
 import { updateErrorPayload, createErrorPayload, deleteErrorPayload, updateCacheErrorPayload } from '../utils/errorHandling';
 import { convertSyncBlockPMNodeToSyncBlockData } from '../utils/utils';
@@ -22,6 +23,9 @@ export class SourceSyncBlockStoreManager {
   setFireAnalyticsEvent(fireAnalyticsEvent) {
     this.fireAnalyticsEvent = fireAnalyticsEvent;
   }
+  setCreateExperience(createExperience) {
+    this.createExperience = createExperience;
+  }
   isSourceBlock(node) {
     return node.type.name === 'bodiedSyncBlock';
   }
@@ -201,28 +205,49 @@ export class SourceSyncBlockStoreManager {
         if (resourceId) {
           this.commitPendingCreation(true);
         } else {
-          var _this$fireAnalyticsEv4;
           this.commitPendingCreation(false);
-          (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 ? void 0 : _this$fireAnalyticsEv4.call(this, createErrorPayload(result.error || 'Failed to create bodied sync block'));
+          if (fg('platform_synced_block_dogfooding')) {
+            var _this$createExperienc;
+            (_this$createExperienc = this.createExperience) === null || _this$createExperienc === void 0 ? void 0 : _this$createExperienc.failure({
+              reason: result.error || 'Failed to create bodied sync block'
+            });
+          } else {
+            var _this$fireAnalyticsEv4;
+            (_this$fireAnalyticsEv4 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv4 === void 0 ? void 0 : _this$fireAnalyticsEv4.call(this, createErrorPayload(result.error || 'Failed to create bodied sync block'));
+          }
         }
       }).catch(error => {
-        var _this$fireAnalyticsEv5;
         this.commitPendingCreation(false);
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 ? void 0 : _this$fireAnalyticsEv5.call(this, createErrorPayload(error.message));
+        if (fg('platform_synced_block_dogfooding')) {
+          var _this$createExperienc2;
+          (_this$createExperienc2 = this.createExperience) === null || _this$createExperienc2 === void 0 ? void 0 : _this$createExperienc2.failure({
+            reason: error.message
+          });
+        } else {
+          var _this$fireAnalyticsEv5;
+          (_this$fireAnalyticsEv5 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv5 === void 0 ? void 0 : _this$fireAnalyticsEv5.call(this, createErrorPayload(error.message));
+        }
       });
       this.registerPendingCreation(resourceId);
     } catch (error) {
-      var _this$fireAnalyticsEv6;
       if (this.hasPendingCreation()) {
         this.commitPendingCreation(false);
       }
       logException(error, {
         location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
       });
-      (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 ? void 0 : _this$fireAnalyticsEv6.call(this, createErrorPayload(error.message));
+      if (fg('platform_synced_block_dogfooding')) {
+        var _this$createExperienc3;
+        (_this$createExperienc3 = this.createExperience) === null || _this$createExperienc3 === void 0 ? void 0 : _this$createExperienc3.failure({
+          reason: error.message
+        });
+      } else {
+        var _this$fireAnalyticsEv6;
+        (_this$fireAnalyticsEv6 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv6 === void 0 ? void 0 : _this$fireAnalyticsEv6.call(this, createErrorPayload(error.message));
+      }
     }
   }
   async delete(syncBlockIds, onDelete, onDeleteCompleted) {

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

@@ -33,6 +33,32 @@ var mapBlockError = function mapBlockError(error) {
   return SyncBlockError.Errored;
 };
 
+/**
+ * Extracts the ResourceId from a block ARI by returning the full path after synced-block/.
+ *
+ * Document ARI format from Block Service API:
+ * "ari:cloud:blocks:{uuid}:synced-block/{product}/{parentId}/{resourceId}"
+ *
+ * ResourceId format (extracted from ARI):
+ * "{product}/{parentId}/{resourceId}" (the full path after synced-block/)
+ *
+ * Example in context:
+ * Input:  "ari:cloud:blocks:{uuid}:synced-block/confluence-page/{pageId}/{resourceId}"
+ * Output: "confluence-page/{pageId}/{resourceId}"
+ *
+ * @param blockAri - The block ARI string from Block Service API
+ * @returns The ResourceId (full path after synced-block/)
+ */
+export var blockAriToResourceId = function blockAriToResourceId(blockAri) {
+  // Validate ARI format and extract resourceId using regex
+  // Format: ari:cloud:blocks:{uuid}:synced-block/{product}/{parentId}/{resourceId}
+  // The regex captures the full path after synced-block/
+  // e.g. ari:cloud:blocks:DUMMY-a5a01d21-1cc3-4f29-9565-f2bb8cd969f5:synced-block/confluence-page/455232061495/e8cf64e3-1b6e-489b-ad86-8465b0905bb4
+  // should return confluence-page/455232061495/e8cf64e3-1b6e-489b-ad86-8465b0905bb4
+  var match = blockAri.match(/^ari:cloud:blocks:.*:synced-block\/(.+)$/);
+  return (match === null || match === void 0 ? void 0 : match[1]) || null;
+};
+
 // convert BlockContentResponse to SyncBlockData
 // throws exception if JSON parsing fails
 // what's missing from BlockContentResponse to SyncBlockData:
@@ -40,9 +66,9 @@ var mapBlockError = function mapBlockError(error) {
 // - sourceURL
 // - sourceTitle
 // - isSynced
-var convertToSyncBlockData = function convertToSyncBlockData(data) {
+export var convertToSyncBlockData = function convertToSyncBlockData(data, resourceId) {
   var createdAt;
-  if (data.createdAt) {
+  if (data.createdAt !== undefined && data.createdAt !== null) {
     try {
       // BE returns microseconds, convert to milliseconds
       // BE should fix this in the future
@@ -59,7 +85,7 @@ var convertToSyncBlockData = function convertToSyncBlockData(data) {
     createdAt: createdAt,
     createdBy: data.createdBy,
     product: data.product,
-    resourceId: data.blockAri,
+    resourceId: resourceId,
     sourceAri: data.sourceAri
   };
 };
@@ -90,9 +116,17 @@ export var fetchReferences = /*#__PURE__*/function () {
           _ref2 = response || {}, blocks = _ref2.blocks, errors = _ref2.errors;
           blocksInstances = (blocks || []).map(function (blockContentResponse) {
             try {
+              var resourceId = blockAriToResourceId(blockContentResponse.blockAri);
+              if (!resourceId) {
+                // could not extract resourceId from blockAri, return InvalidContent error
+                return {
+                  error: SyncBlockError.InvalidContent,
+                  resourceId: blockContentResponse.blockAri
+                };
+              }
               return {
-                data: convertToSyncBlockData(blockContentResponse),
-                resourceId: blockContentResponse.blockAri
+                data: convertToSyncBlockData(blockContentResponse, resourceId),
+                resourceId: resourceId
               };
             } catch (_unused) {
               // JSON parsing error, return InvalidContent error

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

@@ -6,6 +6,7 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 import { logException } from '@atlaskit/editor-common/monitoring';
+import { fg } from '@atlaskit/platform-feature-flags';
 import { SyncBlockError } from '../common/types';
 import { updateErrorPayload, createErrorPayload, deleteErrorPayload, updateCacheErrorPayload } from '../utils/errorHandling';
 import { convertSyncBlockPMNodeToSyncBlockData } from '../utils/utils';
@@ -32,6 +33,11 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
     value: function setFireAnalyticsEvent(fireAnalyticsEvent) {
       this.fireAnalyticsEvent = fireAnalyticsEvent;
     }
+  }, {
+    key: "setCreateExperience",
+    value: function setCreateExperience(createExperience) {
+      this.createExperience = createExperience;
+    }
   }, {
     key: "isSourceBlock",
     value: function isSourceBlock(node) {
@@ -264,28 +270,49 @@ export var SourceSyncBlockStoreManager = /*#__PURE__*/function () {
           if (resourceId) {
             _this4.commitPendingCreation(true);
           } else {
-            var _this4$fireAnalyticsE;
             _this4.commitPendingCreation(false);
-            (_this4$fireAnalyticsE = _this4.fireAnalyticsEvent) === null || _this4$fireAnalyticsE === void 0 || _this4$fireAnalyticsE.call(_this4, createErrorPayload(result.error || 'Failed to create bodied sync block'));
+            if (fg('platform_synced_block_dogfooding')) {
+              var _this4$createExperien;
+              (_this4$createExperien = _this4.createExperience) === null || _this4$createExperien === void 0 || _this4$createExperien.failure({
+                reason: result.error || 'Failed to create bodied sync block'
+              });
+            } else {
+              var _this4$fireAnalyticsE;
+              (_this4$fireAnalyticsE = _this4.fireAnalyticsEvent) === null || _this4$fireAnalyticsE === void 0 || _this4$fireAnalyticsE.call(_this4, createErrorPayload(result.error || 'Failed to create bodied sync block'));
+            }
           }
         }).catch(function (error) {
-          var _this4$fireAnalyticsE2;
           _this4.commitPendingCreation(false);
           logException(error, {
             location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
           });
-          (_this4$fireAnalyticsE2 = _this4.fireAnalyticsEvent) === null || _this4$fireAnalyticsE2 === void 0 || _this4$fireAnalyticsE2.call(_this4, createErrorPayload(error.message));
+          if (fg('platform_synced_block_dogfooding')) {
+            var _this4$createExperien2;
+            (_this4$createExperien2 = _this4.createExperience) === null || _this4$createExperien2 === void 0 || _this4$createExperien2.failure({
+              reason: error.message
+            });
+          } else {
+            var _this4$fireAnalyticsE2;
+            (_this4$fireAnalyticsE2 = _this4.fireAnalyticsEvent) === null || _this4$fireAnalyticsE2 === void 0 || _this4$fireAnalyticsE2.call(_this4, createErrorPayload(error.message));
+          }
         });
         this.registerPendingCreation(resourceId);
       } catch (error) {
-        var _this$fireAnalyticsEv3;
         if (this.hasPendingCreation()) {
           this.commitPendingCreation(false);
         }
         logException(error, {
           location: 'editor-synced-block-provider/sourceSyncBlockStoreManager'
         });
-        (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, createErrorPayload(error.message));
+        if (fg('platform_synced_block_dogfooding')) {
+          var _this$createExperienc;
+          (_this$createExperienc = this.createExperience) === null || _this$createExperienc === void 0 || _this$createExperienc.failure({
+            reason: error.message
+          });
+        } else {
+          var _this$fireAnalyticsEv3;
+          (_this$fireAnalyticsEv3 = this.fireAnalyticsEvent) === null || _this$fireAnalyticsEv3 === void 0 || _this$fireAnalyticsEv3.call(this, createErrorPayload(error.message));
+        }
       }
     }
   }, {

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

@@ -1,5 +1,24 @@
+import { type BlockContentResponse } from '../../clients/block-service/blockService';
 import { SyncBlockError, type ResourceId, type SyncBlockAttrs, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
 import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, UpdateReferenceSyncBlockResult, WriteSyncBlockResult } from '../types';
+/**
+ * Extracts the ResourceId from a block ARI by returning the full path after synced-block/.
+ *
+ * Document ARI format from Block Service API:
+ * "ari:cloud:blocks:{uuid}:synced-block/{product}/{parentId}/{resourceId}"
+ *
+ * ResourceId format (extracted from ARI):
+ * "{product}/{parentId}/{resourceId}" (the full path after synced-block/)
+ *
+ * Example in context:
+ * Input:  "ari:cloud:blocks:{uuid}:synced-block/confluence-page/{pageId}/{resourceId}"
+ * Output: "confluence-page/{pageId}/{resourceId}"
+ *
+ * @param blockAri - The block ARI string from Block Service API
+ * @returns The ResourceId (full path after synced-block/)
+ */
+export declare const blockAriToResourceId: (blockAri: string) => ResourceId | null;
+export declare const convertToSyncBlockData: (data: BlockContentResponse, resourceId: ResourceId) => SyncBlockData;
 export declare const fetchReferences: (documentAri: string) => Promise<SyncBlockInstance[] | SyncBlockError>;
 interface BlockServiceADFFetchProviderProps {
     cloudId: string;

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

@@ -1,4 +1,5 @@
 import { type SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import type { Experience } from '@atlaskit/editor-common/experiences';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import { type ResourceId, type SyncBlockAttrs } from '../common/types';
 import type { SyncBlockDataProvider } from '../providers/types';
@@ -15,8 +16,10 @@ export declare class SourceSyncBlockStoreManager {
     private deletionRetryInfo?;
     private pendingResourceId?;
     private creationCallback?;
+    createExperience: Experience | undefined;
     constructor(dataProvider?: SyncBlockDataProvider);
     setFireAnalyticsEvent(fireAnalyticsEvent?: (payload: SyncBlockEventPayload) => void): void;
+    setCreateExperience(createExperience: Experience): void;
     isSourceBlock(node: PMNode): boolean;
     /**
      * Add/update a sync block node to/from the local cache

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

@@ -1,5 +1,24 @@
+import { type BlockContentResponse } from '../../clients/block-service/blockService';
 import { SyncBlockError, type ResourceId, type SyncBlockAttrs, type SyncBlockData, type SyncBlockProduct } from '../../common/types';
 import type { ADFFetchProvider, ADFWriteProvider, DeleteSyncBlockResult, SyncBlockInstance, UpdateReferenceSyncBlockResult, WriteSyncBlockResult } from '../types';
+/**
+ * Extracts the ResourceId from a block ARI by returning the full path after synced-block/.
+ *
+ * Document ARI format from Block Service API:
+ * "ari:cloud:blocks:{uuid}:synced-block/{product}/{parentId}/{resourceId}"
+ *
+ * ResourceId format (extracted from ARI):
+ * "{product}/{parentId}/{resourceId}" (the full path after synced-block/)
+ *
+ * Example in context:
+ * Input:  "ari:cloud:blocks:{uuid}:synced-block/confluence-page/{pageId}/{resourceId}"
+ * Output: "confluence-page/{pageId}/{resourceId}"
+ *
+ * @param blockAri - The block ARI string from Block Service API
+ * @returns The ResourceId (full path after synced-block/)
+ */
+export declare const blockAriToResourceId: (blockAri: string) => ResourceId | null;
+export declare const convertToSyncBlockData: (data: BlockContentResponse, resourceId: ResourceId) => SyncBlockData;
 export declare const fetchReferences: (documentAri: string) => Promise<SyncBlockInstance[] | SyncBlockError>;
 interface BlockServiceADFFetchProviderProps {
     cloudId: string;

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

@@ -1,4 +1,5 @@
 import { type SyncBlockEventPayload } from '@atlaskit/editor-common/analytics';
+import type { Experience } from '@atlaskit/editor-common/experiences';
 import { type Node as PMNode } from '@atlaskit/editor-prosemirror/model';
 import { type ResourceId, type SyncBlockAttrs } from '../common/types';
 import type { SyncBlockDataProvider } from '../providers/types';
@@ -15,8 +16,10 @@ export declare class SourceSyncBlockStoreManager {
     private deletionRetryInfo?;
     private pendingResourceId?;
     private creationCallback?;
+    createExperience: Experience | undefined;
     constructor(dataProvider?: SyncBlockDataProvider);
     setFireAnalyticsEvent(fireAnalyticsEvent?: (payload: SyncBlockEventPayload) => void): void;
+    setCreateExperience(createExperience: Experience): void;
     isSourceBlock(node: PMNode): boolean;
     /**
      * Add/update a sync block node to/from the local cache

package/package.json

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