@atlaskit/editor-synced-block-provider 2.15.6 → 2.16.1

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

@@ -134,10 +134,11 @@ class BlockServiceADFFetchProvider {
  * ADFWriteProvider implementation that writes synced block data to Block Service API
  */
 class BlockServiceADFWriteProvider {
-  constructor(sourceAri, product, sourceDocumentId) {
+  constructor(sourceAri, product, sourceDocumentId, getVersion) {
     this.sourceAri = sourceAri;
     this.product = product;
     this.sourceDocumentId = sourceDocumentId;
+    this.getVersion = getVersion;
   }
 
   // it will first try to update and if it can't (404) then it will try to create
@@ -146,11 +147,13 @@ class BlockServiceADFWriteProvider {
       resourceId
     } = data;
     const blockAri = generateBlockAri(this.sourceAri, resourceId, this.product);
+    const stepVersion = this.getVersion ? this.getVersion() : undefined;
     try {
       // Try update existing block's content
       await updateSyncedBlock({
         blockAri,
-        content: JSON.stringify(data.content)
+        content: JSON.stringify(data.content),
+        stepVersion
       });
       return {
         resourceId
@@ -173,13 +176,15 @@ class BlockServiceADFWriteProvider {
       resourceId
     } = data;
     const blockAri = generateBlockAri(this.sourceAri, resourceId, this.product);
+    const stepVersion = this.getVersion ? this.getVersion() : undefined;
     try {
       await createSyncedBlock({
         blockAri,
         blockInstanceId: data.blockInstanceId,
         sourceAri: this.sourceAri,
         product: this.product,
-        content: JSON.stringify(data.content)
+        content: JSON.stringify(data.content),
+        stepVersion
       });
       return {
         resourceId
@@ -272,14 +277,14 @@ class BlockServiceADFWriteProvider {
 /**
  * Factory function to create both providers with shared configuration
  */
-const createBlockServiceAPIProviders = (sourceAri, product, sourceDocumentId) => {
+const createBlockServiceAPIProviders = (sourceAri, product, sourceDocumentId, getVersion) => {
   const fetchProvider = new BlockServiceADFFetchProvider(sourceAri);
-  const writeProvider = new BlockServiceADFWriteProvider(sourceAri, product, sourceDocumentId);
+  const writeProvider = new BlockServiceADFWriteProvider(sourceAri, product, sourceDocumentId, getVersion);
   return {
     fetchProvider,
     writeProvider
   };
 };
-export const useMemoizedBlockServiceAPIProviders = (sourceAri, product, sourceDocumentId) => {
-  return useMemo(() => createBlockServiceAPIProviders(sourceAri, product, sourceDocumentId), [sourceAri, product, sourceDocumentId]);
+export const useMemoizedBlockServiceAPIProviders = (sourceAri, product, sourceDocumentId, getVersion) => {
+  return useMemo(() => createBlockServiceAPIProviders(sourceAri, product, sourceDocumentId, getVersion), [sourceAri, product, sourceDocumentId, getVersion]);
 };

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

@@ -1,6 +1,6 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { useMemo } from 'react';
-import { getConfluencePageAri, getLocalIdFromConfluencePageAri, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId } from '../../clients/confluence/ari';
+import { getConfluencePageAri, getLocalIdFromContentPropertyResourceId, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId } from '../../clients/confluence/ari';
 import { getContentProperty, createContentProperty, updateContentProperty, deleteContentProperty } from '../../clients/confluence/contentProperty';
 import { isBlogPageType } from '../../clients/confluence/utils';
 import { SyncBlockError } from '../../common/types';
@@ -52,7 +52,7 @@ class ConfluenceADFFetchProvider {
       id: pageId,
       type: pageType
     } = getPageIdAndTypeFromConfluencePageAri(resourceId);
-    const localId = getLocalIdFromConfluencePageAri(resourceId);
+    const localId = getLocalIdFromContentPropertyResourceId(resourceId);
     try {
       const key = getContentPropertyKey(this.config.contentPropertyKey, localId);
       const options = {
@@ -162,7 +162,7 @@ class ConfluenceADFWriteProvider {
     } = match;
     try {
       // Update existing content property
-      const localId = getLocalIdFromConfluencePageAri(resourceId);
+      const localId = getLocalIdFromContentPropertyResourceId(resourceId);
       const key = getContentPropertyKey(this.config.contentPropertyKey, localId);
       const sourceAri = getConfluencePageAri(pageId, this.config.cloudId, pageType);
       const syncBlockDataWithSourceDocumentAri = {
@@ -211,7 +211,7 @@ class ConfluenceADFWriteProvider {
       type: pageType
     } = match;
     try {
-      const localId = getLocalIdFromConfluencePageAri(resourceId);
+      const localId = getLocalIdFromContentPropertyResourceId(resourceId);
       const key = getContentPropertyKey(this.config.contentPropertyKey, localId);
       const sourceAri = getConfluencePageAri(pageId, this.config.cloudId, pageType);
       const syncBlockDataWithSourceDocumentAri = {
@@ -245,7 +245,7 @@ class ConfluenceADFWriteProvider {
       type: pageType
     } = match;
     try {
-      const localId = getLocalIdFromConfluencePageAri(resourceId);
+      const localId = getLocalIdFromContentPropertyResourceId(resourceId);
       const key = getContentPropertyKey(this.config.contentPropertyKey, localId);
       const options = {
         pageId,

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

@@ -17,7 +17,7 @@ export var generateBlockAri = function generateBlockAri(sourceAri, resourceId, p
 };
 
 /**
- *
+ * Generates the block ARI from the reference synced block ARI and the resource ID
  * @param sourceAri - the ARI of the document. E.G ari:cloud:confluence:cloudId:page/pageId
  * @param resourceId - the resource ID of the reference synced block. E.G confluence-page/pageId/sourceResourceId
  * @returns the block ARI. E.G ari:cloud:blocks:<cloudId>:synced-block/<product>/<pageId>/<resourceId>

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

@@ -170,27 +170,31 @@ export var deleteSyncedBlock = /*#__PURE__*/function () {
 }();
 export var updateSyncedBlock = /*#__PURE__*/function () {
   var _ref7 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4(_ref6) {
-    var blockAri, content, response;
+    var blockAri, content, stepVersion, requestBody, response;
     return _regeneratorRuntime.wrap(function _callee4$(_context4) {
       while (1) switch (_context4.prev = _context4.next) {
         case 0:
-          blockAri = _ref6.blockAri, content = _ref6.content;
-          _context4.next = 3;
+          blockAri = _ref6.blockAri, content = _ref6.content, stepVersion = _ref6.stepVersion;
+          requestBody = {
+            content: content
+          };
+          if (stepVersion !== undefined) {
+            requestBody.stepVersion = stepVersion;
+          }
+          _context4.next = 5;
           return fetchWithRetry("".concat(BLOCK_SERVICE_API_URL, "/block/").concat(encodeURIComponent(blockAri)), {
             method: 'PUT',
             headers: COMMON_HEADERS,
-            body: JSON.stringify({
-              content: content
-            })
+            body: JSON.stringify(requestBody)
           });
-        case 3:
+        case 5:
           response = _context4.sent;
           if (response.ok) {
-            _context4.next = 6;
+            _context4.next = 8;
             break;
           }
           throw new BlockError(response.status);
-        case 6:
+        case 8:
         case "end":
           return _context4.stop();
       }
@@ -202,36 +206,40 @@ export var updateSyncedBlock = /*#__PURE__*/function () {
 }();
 export var createSyncedBlock = /*#__PURE__*/function () {
   var _ref9 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee5(_ref8) {
-    var blockAri, blockInstanceId, sourceAri, product, content, response;
+    var blockAri, blockInstanceId, sourceAri, product, content, stepVersion, requestBody, response;
     return _regeneratorRuntime.wrap(function _callee5$(_context5) {
       while (1) switch (_context5.prev = _context5.next) {
         case 0:
-          blockAri = _ref8.blockAri, blockInstanceId = _ref8.blockInstanceId, sourceAri = _ref8.sourceAri, product = _ref8.product, content = _ref8.content;
-          _context5.next = 3;
+          blockAri = _ref8.blockAri, blockInstanceId = _ref8.blockInstanceId, sourceAri = _ref8.sourceAri, product = _ref8.product, content = _ref8.content, stepVersion = _ref8.stepVersion;
+          requestBody = {
+            blockAri: blockAri,
+            blockInstanceId: blockInstanceId,
+            sourceAri: sourceAri,
+            product: product,
+            content: content
+          };
+          if (stepVersion !== undefined) {
+            requestBody.stepVersion = stepVersion;
+          }
+          _context5.next = 5;
           return fetchWithRetry("".concat(BLOCK_SERVICE_API_URL, "/block"), {
             method: 'POST',
             headers: COMMON_HEADERS,
-            body: JSON.stringify({
-              blockAri: blockAri,
-              blockInstanceId: blockInstanceId,
-              sourceAri: sourceAri,
-              product: product,
-              content: content
-            })
+            body: JSON.stringify(requestBody)
           });
-        case 3:
+        case 5:
           response = _context5.sent;
           if (response.ok) {
-            _context5.next = 6;
+            _context5.next = 8;
             break;
           }
           throw new BlockError(response.status);
-        case 6:
-          _context5.next = 8;
-          return response.json();
         case 8:
+          _context5.next = 10;
+          return response.json();
+        case 10:
           return _context5.abrupt("return", _context5.sent);
-        case 9:
+        case 11:
         case "end":
           return _context5.stop();
       }

package/dist/esm/clients/confluence/ari.js

@@ -1,11 +1,26 @@
 /* eslint-disable require-unicode-regexp  */
 
+/**
+ * The type of the Confluence page
+ */
+
+/**
+ * Generates the Confluence page ARI
+ * @param pageId - the ID of the page
+ * @param cloudId - the cloud ID
+ * @param pageType - the type of the page
+ * @returns the Confluence page ARI
+ */
 export var getConfluencePageAri = function getConfluencePageAri(pageId, cloudId) {
   var pageType = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'page';
   return "ari:cloud:confluence:".concat(cloudId, ":").concat(pageType, "/").concat(pageId);
 };
 
-// For extracting from Page ARI and also the content property's version of resourceId
+/**
+ * Extracts the page ID and type from the Confluence page ARI
+ * @param ari - the Confluence page ARI
+ * @returns the page ID and type
+ */
 export var getPageIdAndTypeFromConfluencePageAri = function getPageIdAndTypeFromConfluencePageAri(ari) {
   var match = ari.match(/ari:cloud:confluence:[^:]+:(page|blogpost)\/(\d+)/);
   if (match !== null && match !== void 0 && match[2]) {
@@ -16,20 +31,39 @@ export var getPageIdAndTypeFromConfluencePageAri = function getPageIdAndTypeFrom
   }
   throw new Error("Invalid page ARI: ".concat(ari));
 };
-export var getLocalIdFromConfluencePageAri = function getLocalIdFromConfluencePageAri(ari) {
-  var match = ari.match(/ari:cloud:confluence:[^:]+:(page|blogpost)\/\d+\/([a-zA-Z0-9-]+)/);
+
+/**
+ * Extracts the local ID from the Confluence page content property resource ID
+ * @param resourceId - the Confluence page content property resource ID
+ * @returns the local ID
+ */
+export var getLocalIdFromContentPropertyResourceId = function getLocalIdFromContentPropertyResourceId(resourceId) {
+  var match = resourceId.match(/ari:cloud:confluence:[^:]+:(page|blogpost)\/\d+\/([a-zA-Z0-9-]+)/);
   if (match !== null && match !== void 0 && match[2]) {
     return match[2];
   }
-  throw new Error("Invalid page ARI: ".concat(ari));
+  throw new Error("Invalid resourceId: ".concat(resourceId));
 };
-export var getPageARIFromContentPropertyResourceId = function getPageARIFromContentPropertyResourceId(resourceId) {
+
+/**
+ * Extracts the Confluence page ARI from the Confluence content property resource ID
+ * @param resourceId - the Confluence content property resource ID
+ * @returns the Confluence page ARI
+ */
+export var getPageAriFromContentPropertyResourceId = function getPageAriFromContentPropertyResourceId(resourceId) {
   var match = resourceId.match(/(ari:cloud:confluence:[^:]+:(page|blogpost)\/\d+)\/([a-zA-Z0-9-]+)$/);
   if (match !== null && match !== void 0 && match[1]) {
     return match[1];
   }
   throw new Error("Invalid resourceId: ".concat(resourceId));
 };
+
+/**
+ * Generates the Confluence page content property resource ID from the source ID and local ID
+ * @param sourceId - the source ID
+ * @param localId - the local ID
+ * @returns the Confluence page content property resource ID
+ */
 export var resourceIdFromConfluencePageSourceIdAndLocalId = function resourceIdFromConfluencePageSourceIdAndLocalId(sourceId, localId) {
-  return sourceId + '/' + localId;
+  return "".concat(sourceId, "/").concat(localId);
 };

package/dist/esm/clients/jira/ari.js

@@ -0,0 +1,24 @@
+/* eslint-disable require-unicode-regexp  */
+
+/**
+ * Generates the Jira work item ARI
+ * @param workItemId - the ID of the work item
+ * @param cloudId - the cloud ID
+ * @returns the Jira work item ARI
+ */
+export var getJiraWorkItemAri = function getJiraWorkItemAri(workItemId, cloudId) {
+  return "ari:cloud:jira:".concat(cloudId, ":issue/").concat(workItemId);
+};
+
+/**
+ * Extracts the Jira work item ID from the Jira work item ARI
+ * @param ari - the Jira work item ARI
+ * @returns the Jira work item ID
+ */
+export var getJiraWorkItemIdFromAri = function getJiraWorkItemIdFromAri(ari) {
+  var match = ari.match(/ari:cloud:jira:([^:]+):issue\/(\d+)/);
+  if (match !== null && match !== void 0 && match[2]) {
+    return match[2];
+  }
+  throw new Error("Invalid Jira work item ARI: ".concat(ari));
+};

package/dist/esm/index.js

@@ -10,7 +10,8 @@ export { useHandleContentChanges } from './hooks/useHandleContentChanges';
 
 // clients
 export { generateBlockAri, generateBlockAriFromReference, getLocalIdFromBlockResourceId } from './clients/block-service/ari';
-export { getConfluencePageAri, getLocalIdFromConfluencePageAri, getPageARIFromContentPropertyResourceId, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId } from './clients/confluence/ari';
+export { getConfluencePageAri, getLocalIdFromContentPropertyResourceId, getPageAriFromContentPropertyResourceId, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId } from './clients/confluence/ari';
+export { getJiraWorkItemAri, getJiraWorkItemIdFromAri } from './clients/jira/ari';
 
 // providers
 export { useMemoizedBlockServiceAPIProviders } from './providers/block-service/blockServiceAPI';

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

@@ -188,11 +188,12 @@ var BlockServiceADFFetchProvider = /*#__PURE__*/function () {
  * ADFWriteProvider implementation that writes synced block data to Block Service API
  */
 var BlockServiceADFWriteProvider = /*#__PURE__*/function () {
-  function BlockServiceADFWriteProvider(sourceAri, product, sourceDocumentId) {
+  function BlockServiceADFWriteProvider(sourceAri, product, sourceDocumentId, getVersion) {
     _classCallCheck(this, BlockServiceADFWriteProvider);
     this.sourceAri = sourceAri;
     this.product = product;
     this.sourceDocumentId = sourceDocumentId;
+    this.getVersion = getVersion;
   }
 
   // it will first try to update and if it can't (404) then it will try to create
@@ -200,43 +201,45 @@ var BlockServiceADFWriteProvider = /*#__PURE__*/function () {
     key: "writeData",
     value: function () {
       var _writeData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee3(data) {
-        var resourceId, blockAri;
+        var resourceId, blockAri, stepVersion;
         return _regeneratorRuntime.wrap(function _callee3$(_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
               resourceId = data.resourceId;
               blockAri = generateBlockAri(this.sourceAri, resourceId, this.product);
-              _context3.prev = 2;
-              _context3.next = 5;
+              stepVersion = this.getVersion ? this.getVersion() : undefined;
+              _context3.prev = 3;
+              _context3.next = 6;
               return updateSyncedBlock({
                 blockAri: blockAri,
-                content: JSON.stringify(data.content)
+                content: JSON.stringify(data.content),
+                stepVersion: stepVersion
               });
-            case 5:
+            case 6:
               return _context3.abrupt("return", {
                 resourceId: resourceId
               });
-            case 8:
-              _context3.prev = 8;
-              _context3.t0 = _context3["catch"](2);
+            case 9:
+              _context3.prev = 9;
+              _context3.t0 = _context3["catch"](3);
               if (!(_context3.t0 instanceof BlockError)) {
-                _context3.next = 12;
+                _context3.next = 13;
                 break;
               }
               return _context3.abrupt("return", {
                 error: mapBlockError(_context3.t0),
                 resourceId: resourceId
               });
-            case 12:
+            case 13:
               return _context3.abrupt("return", {
                 error: stringifyError(_context3.t0),
                 resourceId: resourceId
               });
-            case 13:
+            case 14:
             case "end":
               return _context3.stop();
           }
-        }, _callee3, this, [[2, 8]]);
+        }, _callee3, this, [[3, 9]]);
       }));
       function writeData(_x3) {
         return _writeData.apply(this, arguments);
@@ -247,46 +250,48 @@ var BlockServiceADFWriteProvider = /*#__PURE__*/function () {
     key: "createData",
     value: function () {
       var _createData = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4(data) {
-        var resourceId, blockAri;
+        var resourceId, blockAri, stepVersion;
         return _regeneratorRuntime.wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
               resourceId = data.resourceId;
               blockAri = generateBlockAri(this.sourceAri, resourceId, this.product);
-              _context4.prev = 2;
-              _context4.next = 5;
+              stepVersion = this.getVersion ? this.getVersion() : undefined;
+              _context4.prev = 3;
+              _context4.next = 6;
               return createSyncedBlock({
                 blockAri: blockAri,
                 blockInstanceId: data.blockInstanceId,
                 sourceAri: this.sourceAri,
                 product: this.product,
-                content: JSON.stringify(data.content)
+                content: JSON.stringify(data.content),
+                stepVersion: stepVersion
               });
-            case 5:
+            case 6:
               return _context4.abrupt("return", {
                 resourceId: resourceId
               });
-            case 8:
-              _context4.prev = 8;
-              _context4.t0 = _context4["catch"](2);
+            case 9:
+              _context4.prev = 9;
+              _context4.t0 = _context4["catch"](3);
               if (!(_context4.t0 instanceof BlockError)) {
-                _context4.next = 12;
+                _context4.next = 13;
                 break;
               }
               return _context4.abrupt("return", {
                 error: mapBlockError(_context4.t0),
                 resourceId: resourceId
               });
-            case 12:
+            case 13:
               return _context4.abrupt("return", {
                 error: stringifyError(_context4.t0),
                 resourceId: resourceId
               });
-            case 13:
+            case 14:
             case "end":
               return _context4.stop();
           }
-        }, _callee4, this, [[2, 8]]);
+        }, _callee4, this, [[3, 9]]);
       }));
       function createData(_x4) {
         return _createData.apply(this, arguments);
@@ -417,16 +422,16 @@ var BlockServiceADFWriteProvider = /*#__PURE__*/function () {
 /**
  * Factory function to create both providers with shared configuration
  */
-var createBlockServiceAPIProviders = function createBlockServiceAPIProviders(sourceAri, product, sourceDocumentId) {
+var createBlockServiceAPIProviders = function createBlockServiceAPIProviders(sourceAri, product, sourceDocumentId, getVersion) {
   var fetchProvider = new BlockServiceADFFetchProvider(sourceAri);
-  var writeProvider = new BlockServiceADFWriteProvider(sourceAri, product, sourceDocumentId);
+  var writeProvider = new BlockServiceADFWriteProvider(sourceAri, product, sourceDocumentId, getVersion);
   return {
     fetchProvider: fetchProvider,
     writeProvider: writeProvider
   };
 };
-export var useMemoizedBlockServiceAPIProviders = function useMemoizedBlockServiceAPIProviders(sourceAri, product, sourceDocumentId) {
+export var useMemoizedBlockServiceAPIProviders = function useMemoizedBlockServiceAPIProviders(sourceAri, product, sourceDocumentId, getVersion) {
   return useMemo(function () {
-    return createBlockServiceAPIProviders(sourceAri, product, sourceDocumentId);
-  }, [sourceAri, product, sourceDocumentId]);
+    return createBlockServiceAPIProviders(sourceAri, product, sourceDocumentId, getVersion);
+  }, [sourceAri, product, sourceDocumentId, getVersion]);
 };

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

@@ -7,7 +7,7 @@ function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbol
 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 _regeneratorRuntime from "@babel/runtime/regenerator";
 import { useMemo } from 'react';
-import { getConfluencePageAri, getLocalIdFromConfluencePageAri, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId } from '../../clients/confluence/ari';
+import { getConfluencePageAri, getLocalIdFromContentPropertyResourceId, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId } from '../../clients/confluence/ari';
 import { getContentProperty, createContentProperty, updateContentProperty, deleteContentProperty } from '../../clients/confluence/contentProperty';
 import { isBlogPageType } from '../../clients/confluence/utils';
 import { SyncBlockError } from '../../common/types';
@@ -64,7 +64,7 @@ var ConfluenceADFFetchProvider = /*#__PURE__*/function () {
           while (1) switch (_context.prev = _context.next) {
             case 0:
               _getPageIdAndTypeFrom = getPageIdAndTypeFromConfluencePageAri(resourceId), pageId = _getPageIdAndTypeFrom.id, pageType = _getPageIdAndTypeFrom.type;
-              localId = getLocalIdFromConfluencePageAri(resourceId);
+              localId = getLocalIdFromContentPropertyResourceId(resourceId);
               _context.prev = 2;
               key = getContentPropertyKey(this.config.contentPropertyKey, localId);
               options = {
@@ -228,7 +228,7 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
               _match = match, pageId = _match.id, pageType = _match.type;
               _context3.prev = 9;
               // Update existing content property
-              localId = getLocalIdFromConfluencePageAri(resourceId);
+              localId = getLocalIdFromContentPropertyResourceId(resourceId);
               key = getContentPropertyKey(this.config.contentPropertyKey, localId);
               sourceAri = getConfluencePageAri(pageId, this.config.cloudId, pageType);
               syncBlockDataWithSourceDocumentAri = _objectSpread(_objectSpread({}, syncBlockData), {}, {
@@ -300,7 +300,7 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
             case 8:
               _match2 = match, pageId = _match2.id, pageType = _match2.type;
               _context4.prev = 9;
-              localId = getLocalIdFromConfluencePageAri(resourceId);
+              localId = getLocalIdFromContentPropertyResourceId(resourceId);
               key = getContentPropertyKey(this.config.contentPropertyKey, localId);
               sourceAri = getConfluencePageAri(pageId, this.config.cloudId, pageType);
               syncBlockDataWithSourceDocumentAri = _objectSpread(_objectSpread({}, syncBlockData), {}, {
@@ -353,7 +353,7 @@ var ConfluenceADFWriteProvider = /*#__PURE__*/function () {
             case 7:
               _match3 = match, pageId = _match3.id, pageType = _match3.type;
               _context5.prev = 8;
-              localId = getLocalIdFromConfluencePageAri(resourceId);
+              localId = getLocalIdFromContentPropertyResourceId(resourceId);
               key = getContentPropertyKey(this.config.contentPropertyKey, localId);
               options = {
                 pageId: pageId,

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

@@ -7,7 +7,7 @@ import { type SyncBlockProduct } from '../../common/types';
  */
 export declare const generateBlockAri: (sourceAri: string, resourceId: string, product: SyncBlockProduct) => string;
 /**
- *
+ * Generates the block ARI from the reference synced block ARI and the resource ID
  * @param sourceAri - the ARI of the document. E.G ari:cloud:confluence:cloudId:page/pageId
  * @param resourceId - the resource ID of the reference synced block. E.G confluence-page/pageId/sourceResourceId
  * @returns the block ARI. E.G ari:cloud:blocks:<cloudId>:synced-block/<product>/<pageId>/<resourceId>

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

@@ -72,6 +72,7 @@ export type DeleteSyncedBlockRequest = {
 export type UpdateSyncedBlockRequest = {
     blockAri: string;
     content: string;
+    stepVersion?: number;
 };
 export type CreateSyncedBlockRequest = {
     blockAri: string;
@@ -79,6 +80,7 @@ export type CreateSyncedBlockRequest = {
     content: string;
     product: SyncBlockProduct;
     sourceAri: string;
+    stepVersion?: number;
 };
 type ReferenceSyncedBlockIDs = {
     blockAri: string;
@@ -95,7 +97,7 @@ export declare class BlockError extends Error {
 }
 export declare const getSyncedBlockContent: ({ blockAri, }: GetSyncedBlockContentRequest) => Promise<BlockContentResponse>;
 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 updateSyncedBlock: ({ blockAri, content, stepVersion, }: UpdateSyncedBlockRequest) => Promise<void>;
+export declare const createSyncedBlock: ({ blockAri, blockInstanceId, sourceAri, product, content, stepVersion, }: CreateSyncedBlockRequest) => Promise<BlockContentResponse>;
 export declare const updateReferenceSyncedBlockOnDocument: ({ documentAri, blocks, noContent, }: UpdateReferenceSyncedBlockOnDocumentRequest) => Promise<ReferenceSyncedBlockResponse | void>;
 export {};

package/dist/types/clients/confluence/ari.d.ts

@@ -1,9 +1,40 @@
+/**
+ * The type of the Confluence page
+ */
 export type PAGE_TYPE = 'page' | 'blogpost';
+/**
+ * Generates the Confluence page ARI
+ * @param pageId - the ID of the page
+ * @param cloudId - the cloud ID
+ * @param pageType - the type of the page
+ * @returns the Confluence page ARI
+ */
 export declare const getConfluencePageAri: (pageId: string, cloudId: string, pageType?: PAGE_TYPE) => string;
+/**
+ * Extracts the page ID and type from the Confluence page ARI
+ * @param ari - the Confluence page ARI
+ * @returns the page ID and type
+ */
 export declare const getPageIdAndTypeFromConfluencePageAri: (ari: string) => {
     id: string;
     type: PAGE_TYPE;
 };
-export declare const getLocalIdFromConfluencePageAri: (ari: string) => string;
-export declare const getPageARIFromContentPropertyResourceId: (resourceId: string) => string;
+/**
+ * Extracts the local ID from the Confluence page content property resource ID
+ * @param resourceId - the Confluence page content property resource ID
+ * @returns the local ID
+ */
+export declare const getLocalIdFromContentPropertyResourceId: (resourceId: string) => string;
+/**
+ * Extracts the Confluence page ARI from the Confluence content property resource ID
+ * @param resourceId - the Confluence content property resource ID
+ * @returns the Confluence page ARI
+ */
+export declare const getPageAriFromContentPropertyResourceId: (resourceId: string) => string;
+/**
+ * Generates the Confluence page content property resource ID from the source ID and local ID
+ * @param sourceId - the source ID
+ * @param localId - the local ID
+ * @returns the Confluence page content property resource ID
+ */
 export declare const resourceIdFromConfluencePageSourceIdAndLocalId: (sourceId: string, localId: string) => string;

package/dist/types/clients/jira/ari.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generates the Jira work item ARI
+ * @param workItemId - the ID of the work item
+ * @param cloudId - the cloud ID
+ * @returns the Jira work item ARI
+ */
+export declare const getJiraWorkItemAri: (workItemId: string, cloudId: string) => string;
+/**
+ * Extracts the Jira work item ID from the Jira work item ARI
+ * @param ari - the Jira work item ARI
+ * @returns the Jira work item ID
+ */
+export declare const getJiraWorkItemIdFromAri: (ari: string) => string;

package/dist/types/index.d.ts

@@ -5,7 +5,8 @@ export { useFetchSyncBlockData, type UseFetchSyncBlockDataResult, } from './hook
 export { useFetchSyncBlockTitle } from './hooks/useFetchSyncBlockTitle';
 export { useHandleContentChanges } from './hooks/useHandleContentChanges';
 export { generateBlockAri, generateBlockAriFromReference, getLocalIdFromBlockResourceId, } from './clients/block-service/ari';
-export { getConfluencePageAri, getLocalIdFromConfluencePageAri, getPageARIFromContentPropertyResourceId, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId, } from './clients/confluence/ari';
+export { getConfluencePageAri, getLocalIdFromContentPropertyResourceId, getPageAriFromContentPropertyResourceId, getPageIdAndTypeFromConfluencePageAri, resourceIdFromConfluencePageSourceIdAndLocalId, } from './clients/confluence/ari';
+export { getJiraWorkItemAri, getJiraWorkItemIdFromAri } from './clients/jira/ari';
 export { useMemoizedBlockServiceAPIProviders } from './providers/block-service/blockServiceAPI';
 export { createContentAPIProvidersWithDefaultKey, useMemoizedContentAPIProviders, } from './providers/confluence/confluenceContentAPI';
 export { fetchConfluencePageInfo } from './clients/confluence/sourceInfo';

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

@@ -15,8 +15,9 @@ declare class BlockServiceADFFetchProvider implements ADFFetchProvider {
 declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
     private sourceAri;
     private sourceDocumentId;
+    private getVersion?;
     product: SyncBlockProduct;
-    constructor(sourceAri: string, product: SyncBlockProduct, sourceDocumentId: string);
+    constructor(sourceAri: string, product: SyncBlockProduct, sourceDocumentId: string, getVersion?: () => number | undefined);
     writeData(data: SyncBlockData): Promise<WriteSyncBlockResult>;
     createData(data: SyncBlockData): Promise<WriteSyncBlockResult>;
     deleteData(resourceId: string): Promise<DeleteSyncBlockResult>;
@@ -24,7 +25,7 @@ declare class BlockServiceADFWriteProvider implements ADFWriteProvider {
     generateResourceId(): ResourceId;
     updateReferenceData(blocks: SyncBlockAttrs[], noContent?: boolean): Promise<UpdateReferenceSyncBlockResult>;
 }
-export declare const useMemoizedBlockServiceAPIProviders: (sourceAri: string, product: SyncBlockProduct, sourceDocumentId: string) => {
+export declare const useMemoizedBlockServiceAPIProviders: (sourceAri: string, product: SyncBlockProduct, sourceDocumentId: string, getVersion?: () => number | undefined) => {
     fetchProvider: BlockServiceADFFetchProvider;
     writeProvider: BlockServiceADFWriteProvider;
 };