@atlaskit/editor-synced-block-provider 0.2.0 → 0.4.0

package/dist/cjs/utils/contentProperty.js

@@ -0,0 +1,192 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.updateContentProperty = exports.getContentProperty = exports.createContentProperty = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _ari = require("./ari");
+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) { (0, _defineProperty2.default)(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; }
+var COMMON_HEADERS = {
+  'Content-Type': 'application/json',
+  Accept: 'application/json'
+};
+var AGG_HEADERS = {
+  'X-ExperimentalApi': 'confluence-agg-beta'
+};
+var GRAPHQL_ENDPOINT = '/gateway/api/graphql';
+var GET_OPERATION_NAME = 'EDITOR_SYNCED_BLOCK_GET';
+var CREATE_OPERATION_NAME = 'EDITOR_SYNCED_BLOCK_CREATE';
+var UPDATE_OPERATION_NAME = 'EDITOR_SYNCED_BLOCK_UPDATE';
+/**
+ * Query to get the page property by key
+ * @param documentARI
+ * @param key
+ * @returns
+ */
+var GET_QUERY = "query ".concat(GET_OPERATION_NAME, " ($id: ID!, $keys: [String]!) {\n\t\t\t\t\tconfluence {\n\t\t\t\t\t\tpage (id: $id) {\n\t\t\t\t\t\t\tproperties(keys: $keys) {\n\t\t\t\t\t\t\t\tkey,\n\t\t\t\t\t\t\t\tvalue\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}");
+
+/**
+ * Query to create a page property with key and value
+ * @param documentARI
+ * @param key
+ * @param value
+ * @returns
+ */
+var CREATE_QUERY = "mutation ".concat(CREATE_OPERATION_NAME, " ($input: ConfluenceCreatePagePropertyInput!){\n\t\t\t\t\t\tconfluence {\n\t\t\t\t\t\t\tcreatePageProperty(input: $input) {\n\t\t\t\t\t\t\t\tpageProperty {\n\t\t\t\t\t\t\t\t\tkey,\n\t\t\t\t\t\t\t\t\tvalue\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}");
+
+/**
+ * Query to update a page property with key and value without bumping the version
+ * @param documentARI
+ * @param key
+ * @param value
+ * @returns
+ */
+var UPDATE_QUERY = "mutation ".concat(UPDATE_OPERATION_NAME, " ($input: ConfluenceUpdateValuePagePropertyInput!) {\n\t\t\t\t\t\tconfluence {\n\t\t\t\t\t\t\tupdateValuePageProperty(input: $input) {\n\t\t\t\t\t\t\t\tpageProperty {\n\t\t\t\t\t\t\t\t\tkey,\n\t\t\t\t\t\t\t\t\tvalue\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}");
+var getContentProperty = exports.getContentProperty = /*#__PURE__*/function () {
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
+    var pageId, key, cloudId, documentARI, bodyData, response, contentProperty;
+    return _regenerator.default.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          pageId = _ref.pageId, key = _ref.key, cloudId = _ref.cloudId;
+          documentARI = (0, _ari.getConfluencePageAri)(pageId, cloudId);
+          bodyData = {
+            query: GET_QUERY,
+            operationName: GET_OPERATION_NAME,
+            variables: {
+              id: documentARI,
+              keys: [key]
+            }
+          };
+          _context.next = 5;
+          return fetch(GRAPHQL_ENDPOINT, {
+            method: 'POST',
+            headers: _objectSpread(_objectSpread({}, COMMON_HEADERS), AGG_HEADERS),
+            body: JSON.stringify(bodyData)
+          });
+        case 5:
+          response = _context.sent;
+          if (response.ok) {
+            _context.next = 8;
+            break;
+          }
+          throw new Error("Failed to get content property: ".concat(response.statusText));
+        case 8:
+          _context.next = 10;
+          return response.json();
+        case 10:
+          contentProperty = _context.sent;
+          return _context.abrupt("return", contentProperty);
+        case 12:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function getContentProperty(_x) {
+    return _ref2.apply(this, arguments);
+  };
+}();
+var updateContentProperty = exports.updateContentProperty = /*#__PURE__*/function () {
+  var _ref4 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(_ref3) {
+    var pageId, key, value, cloudId, documentARI, bodyData, response, contentProperty;
+    return _regenerator.default.wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          pageId = _ref3.pageId, key = _ref3.key, value = _ref3.value, cloudId = _ref3.cloudId;
+          documentARI = (0, _ari.getConfluencePageAri)(pageId, cloudId);
+          bodyData = {
+            query: UPDATE_QUERY,
+            operationName: UPDATE_OPERATION_NAME,
+            variables: {
+              input: {
+                pageId: documentARI,
+                key: key,
+                value: value,
+                useSameVersion: true
+              }
+            }
+          };
+          _context2.next = 5;
+          return fetch(GRAPHQL_ENDPOINT, {
+            method: 'POST',
+            headers: _objectSpread(_objectSpread({}, COMMON_HEADERS), AGG_HEADERS),
+            body: JSON.stringify(bodyData)
+          });
+        case 5:
+          response = _context2.sent;
+          if (response.ok) {
+            _context2.next = 8;
+            break;
+          }
+          throw new Error("Failed to update content property: ".concat(response.statusText));
+        case 8:
+          _context2.next = 10;
+          return response.json();
+        case 10:
+          contentProperty = _context2.sent;
+          return _context2.abrupt("return", contentProperty);
+        case 12:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  return function updateContentProperty(_x2) {
+    return _ref4.apply(this, arguments);
+  };
+}();
+var createContentProperty = exports.createContentProperty = /*#__PURE__*/function () {
+  var _ref6 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee3(_ref5) {
+    var pageId, key, value, cloudId, documentARI, escapedValue, bodyData, response, contentProperty;
+    return _regenerator.default.wrap(function _callee3$(_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
+        case 0:
+          pageId = _ref5.pageId, key = _ref5.key, value = _ref5.value, cloudId = _ref5.cloudId;
+          documentARI = (0, _ari.getConfluencePageAri)(pageId, cloudId); // eslint-disable-next-line require-unicode-regexp
+          escapedValue = value.replace(/"/g, '\\"');
+          bodyData = {
+            query: CREATE_QUERY,
+            operationName: CREATE_OPERATION_NAME,
+            variables: {
+              input: {
+                pageId: documentARI,
+                key: key,
+                value: escapedValue
+              }
+            }
+          };
+          _context3.next = 6;
+          return fetch(GRAPHQL_ENDPOINT, {
+            method: 'POST',
+            headers: _objectSpread(_objectSpread({}, COMMON_HEADERS), AGG_HEADERS),
+            body: JSON.stringify(bodyData)
+          });
+        case 6:
+          response = _context3.sent;
+          if (response.ok) {
+            _context3.next = 9;
+            break;
+          }
+          throw new Error("Failed to create content property: ".concat(response.statusText));
+        case 9:
+          _context3.next = 11;
+          return response.json();
+        case 11:
+          contentProperty = _context3.sent;
+          return _context3.abrupt("return", contentProperty);
+        case 13:
+        case "end":
+          return _context3.stop();
+      }
+    }, _callee3);
+  }));
+  return function createContentProperty(_x3) {
+    return _ref6.apply(this, arguments);
+  };
+}();

package/dist/es2019/common/rebase-transaction.js

@@ -0,0 +1,26 @@
+import { Mapping } from '@atlaskit/editor-prosemirror/transform';
+
+/**
+ * Rebase `currentTr` over `incomingTr` based on the provided `state`.
+ * This function adjusts the steps in `currentTr` to account for the changes made by `incomingTr`.
+ *
+ * @param currentTr - The transaction to be rebased.
+ * @param incomingTr - The transaction that has already been applied to the state.
+ * @param state - The editor state after applying `incomingTr`.
+ * @returns A new transaction that represents `currentTr` rebased over `incomingTr`.
+ */
+export const rebaseTransaction = (currentTr, incomingTr, state) => {
+  if (!incomingTr.docChanged) {
+    return currentTr;
+  }
+  const currentMapping = new Mapping(incomingTr.mapping.maps);
+  const rebasedTransaction = state.tr;
+  currentTr.steps.forEach(step => {
+    const mappedStep = step.map(currentMapping);
+    if (mappedStep) {
+      rebasedTransaction.step(mappedStep);
+      currentMapping.appendMap(mappedStep.getMap());
+    }
+  });
+  return rebasedTransaction;
+};

package/dist/es2019/common/syncBlockProvider.js

@@ -1,5 +1,5 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import { useEffect, useState } from 'react';
+import { useEffect, useState, useMemo } from 'react';
 import { convertSyncBlockPMNodeToSyncBlockData } from '../utils/utils';
 import { SyncBlockDataProvider } from './types';
 export class SyncBlockProvider extends SyncBlockDataProvider {
@@ -32,6 +32,9 @@ export class SyncBlockProvider extends SyncBlockDataProvider {
       });
       return Promise.all(resourceIds);
     });
+    _defineProperty(this, "getSourceId", () => {
+      return this.sourceId;
+    });
     this.fetchProvider = fetchProvider;
     this.writeProvider = writeProvider;
     this.sourceId = sourceId;
@@ -39,26 +42,35 @@ export class SyncBlockProvider extends SyncBlockDataProvider {
 }
 export const useFetchDocNode = (editorView, node, defaultDocNode, provider) => {
   const [docNode, setDocNode] = useState(defaultDocNode);
+  const fetchNode = (editorView, node, provider) => {
+    const nodes = [convertSyncBlockPMNodeToSyncBlockData(node, false)];
+    provider === null || provider === void 0 ? void 0 : provider.fetchNodesData(nodes).then(data => {
+      var _data$;
+      if (data && (_data$ = data[0]) !== null && _data$ !== void 0 && _data$.content) {
+        const newNode = editorView.state.schema.nodeFromJSON(data[0].content);
+        setDocNode({
+          ...newNode.toJSON(),
+          version: 1
+        });
+      }
+    });
+  };
   useEffect(() => {
     if (!provider) {
       return;
     }
+    fetchNode(editorView, node, provider);
     const interval = window.setInterval(() => {
-      const nodes = [convertSyncBlockPMNodeToSyncBlockData(node, false)];
-      provider === null || provider === void 0 ? void 0 : provider.fetchNodesData(nodes).then(data => {
-        var _data$;
-        if (data && (_data$ = data[0]) !== null && _data$ !== void 0 && _data$.content) {
-          const newNode = editorView.state.schema.nodeFromJSON(data[0].content);
-          setDocNode({
-            ...newNode.toJSON(),
-            version: 1
-          });
-        }
-      });
-    }, 1000);
+      fetchNode(editorView, node, provider);
+    }, 3000);
     return () => {
       window.clearInterval(interval);
     };
   }, [editorView, node, provider]);
   return docNode;
+};
+export const useMemoizedSyncedBlockProvider = (fetchProvider, writeProvider, sourceId) => {
+  return useMemo(() => {
+    return new SyncBlockProvider(fetchProvider, writeProvider, sourceId);
+  }, [fetchProvider, writeProvider, sourceId]);
 };

package/dist/es2019/common/syncBlockStoreManager.js

@@ -1,4 +1,5 @@
 import uuid from 'uuid';
+import { rebaseTransaction } from './rebase-transaction';
 
 // Do this typedef to make it clear that
 // this is a local identifier for a resource for local use
@@ -9,14 +10,14 @@ import uuid from 'uuid';
 // Handles caching, debouncing updates, and publish/subscribe for local changes.
 // Ensures consistency between local and remote state, and can be used in both editor and renderer contexts.
 export class SyncBlockStoreManager {
-  constructor(_dataProvider) {
+  constructor(dataProvider) {
     this.syncBlocks = new Map();
+    this.dataProvider = dataProvider;
   }
   setEditorView(editorView) {
     this.editorView = editorView;
   }
   isSourceBlock(node) {
-    var _this$syncBlocks$get;
     if (node.type.name !== 'syncBlock') {
       return false;
     }
@@ -24,7 +25,7 @@ export class SyncBlockStoreManager {
       resourceId,
       localId
     } = node.attrs;
-    return this.syncBlocks.has(resourceId) && ((_this$syncBlocks$get = this.syncBlocks.get(resourceId)) === null || _this$syncBlocks$get === void 0 ? void 0 : _this$syncBlocks$get.sourceLocalId) === localId;
+    return resourceId.includes(localId);
   }
   registerConfirmationCallback(callback) {
     this.confirmationCallback = callback;
@@ -36,15 +37,18 @@ export class SyncBlockStoreManager {
     return !!this.confirmationCallback;
   }
   createSyncBlockNode() {
+    var _this$dataProvider;
     // TODO: EDITOR-1644 - properly implement creation of the synced block
     // below is a temporary implementation for the creation of the synced block
     // the resource id needs to have pageId and content property key in it
+    // Note: If the data provider is not set, the resource id will be the local id
 
-    const blockInstanceId = uuid();
     const localId = uuid();
+    const sourceId = (_this$dataProvider = this.dataProvider) === null || _this$dataProvider === void 0 ? void 0 : _this$dataProvider.getSourceId();
+    const resourceId = sourceId ? `${sourceId}/${localId}` : localId;
     const syncBlockNode = {
       attrs: {
-        resourceId: `ari:cloud:confluence:fake_cloud_id:page/fake_page_id/${blockInstanceId}`,
+        resourceId,
         localId
       },
       type: 'syncBlock'
@@ -57,16 +61,23 @@ export class SyncBlockStoreManager {
   }
   async deleteSyncBlocksWithConfirmation(tr, syncBlockIds) {
     if (this.confirmationCallback) {
+      this.confirmationTransaction = tr;
       const confirmed = await this.confirmationCallback();
       if (confirmed) {
         var _this$editorView;
-        // TODO: EDITOR-1779 - "rebase" the transaction to reflect the latest document state
-        (_this$editorView = this.editorView) === null || _this$editorView === void 0 ? void 0 : _this$editorView.dispatch(tr.setMeta('isConfirmedSyncBlockDeletion', true));
+        (_this$editorView = this.editorView) === null || _this$editorView === void 0 ? void 0 : _this$editorView.dispatch(this.confirmationTransaction.setMeta('isConfirmedSyncBlockDeletion', true));
         // Need to update the BE on deletion
         syncBlockIds.forEach(({
           resourceId
         }) => this.syncBlocks.delete(resourceId));
       }
+      this.confirmationTransaction = undefined;
     }
   }
+  rebaseTransaction(incomingTr, state) {
+    if (!this.confirmationTransaction) {
+      return;
+    }
+    this.confirmationTransaction = rebaseTransaction(this.confirmationTransaction, incomingTr, state);
+  }
 }

package/dist/es2019/index.js

@@ -1,7 +1,10 @@
 /* eslint-disable @atlaskit/editor/no-re-export */
 
-export { SyncBlockProvider as SyncedBlockProvider, useFetchDocNode } from './common/syncBlockProvider';
+export { SyncBlockProvider as SyncedBlockProvider, useFetchDocNode, useMemoizedSyncedBlockProvider } from './common/syncBlockProvider';
 export { SyncBlockStoreManager } from './common/syncBlockStoreManager';
 export { inMemoryFetchProvider, inMemoryWriteProvider } from './providers/inMemory';
+export { getDefaultSyncBlockSchema } from './common/schema';
+export { createContentAPIProvidersWithDefaultKey, useMemoizedContentAPIProviders } from './providers/confluenceContentAPI';
+export { getConfluencePageAri } from './utils/ari';
 export { convertSyncBlockPMNodeToSyncBlockData, generateSyncBlockSourceUrl } from './utils/utils';
-export { getDefaultSyncBlockSchema } from './common/schema';
+export { rebaseTransaction } from './common/rebase-transaction';

package/dist/es2019/providers/confluenceContentAPI.js

@@ -0,0 +1,150 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import { useMemo } from 'react';
+import { getLocalIdFromAri, getPageIdFromAri } from '../utils/ari';
+import { getContentProperty, createContentProperty, updateContentProperty } from '../utils/contentProperty';
+
+/**
+ * Configuration for Content API providers
+ */
+
+const getContentPropertyKey = (contentPropertyKey, localId) => {
+  return contentPropertyKey + '-' + localId;
+};
+const parseSyncedBlockContentPropertyValue = value => {
+  try {
+    if (typeof value === 'string') {
+      return JSON.parse(value);
+    }
+    return value;
+  } catch (error) {
+    // eslint-disable-next-line no-console
+    console.error('Failed to parse synced block content:', error);
+    return {
+      content: undefined
+    };
+  }
+};
+
+/**
+ * ADFFetchProvider implementation that fetches synced block data from Confluence Content API
+ */
+class ConfluenceADFFetchProvider {
+  constructor(config) {
+    this.config = config;
+  }
+  async fetchData(resourceId) {
+    try {
+      var _contentProperty$data, _contentProperty$data2;
+      const pageId = getPageIdFromAri(resourceId);
+      const localId = getLocalIdFromAri(resourceId);
+      const key = getContentPropertyKey(this.config.contentPropertyKey, localId);
+      const options = {
+        pageId,
+        key,
+        cloudId: this.config.cloudId
+      };
+      const contentProperty = await getContentProperty(options);
+      const value = (_contentProperty$data = contentProperty.data.confluence.page.properties) === null || _contentProperty$data === void 0 ? void 0 : (_contentProperty$data2 = _contentProperty$data[0]) === null || _contentProperty$data2 === void 0 ? void 0 : _contentProperty$data2.value;
+      if (!value) {
+        throw new Error('Content property value does not exist');
+      }
+
+      // Parse the synced block content from the property value
+      const syncedBlockData = parseSyncedBlockContentPropertyValue(value);
+      return {
+        content: syncedBlockData.content
+      };
+    } catch (error) {
+      // eslint-disable-next-line no-console
+      console.error('Failed to fetch synced block data:', error);
+      return {
+        content: undefined
+      };
+    }
+  }
+}
+
+/**
+ * ADFWriteProvider implementation that writes synced block data to Confluence Content API
+ */
+class ConfluenceADFWriteProvider {
+  constructor(config) {
+    _defineProperty(this, "createNewContentProperty", async (pageId, key, value) => {
+      var _contentProperty$data3;
+      const contentProperty = await createContentProperty({
+        pageId,
+        key,
+        value,
+        cloudId: this.config.cloudId
+      });
+      if (((_contentProperty$data3 = contentProperty.data.confluence.createPageProperty.pageProperty) === null || _contentProperty$data3 === void 0 ? void 0 : _contentProperty$data3.key) === key) {
+        return key;
+      } else {
+        throw new Error('Failed to create content property');
+      }
+    });
+    this.config = config;
+  }
+  async writeData(sourceId, localId, data, resourceId) {
+    try {
+      const pageId = getPageIdFromAri(sourceId);
+      const syncedBlockValue = JSON.stringify({
+        content: data
+      });
+      if (resourceId) {
+        var _contentProperty$data4;
+        // Update existing content property
+        const localId = getLocalIdFromAri(resourceId);
+        const key = getContentPropertyKey(this.config.contentPropertyKey, localId);
+        const contentProperty = await updateContentProperty({
+          pageId,
+          key,
+          value: syncedBlockValue,
+          cloudId: this.config.cloudId
+        });
+        if (((_contentProperty$data4 = contentProperty.data.confluence.updateValuePageProperty.pageProperty) === null || _contentProperty$data4 === void 0 ? void 0 : _contentProperty$data4.key) === key) {
+          return key;
+        } else if (contentProperty.data.confluence.updateValuePageProperty.pageProperty === null) {
+          return this.createNewContentProperty(pageId, key, syncedBlockValue);
+        } else {
+          throw new Error('Failed to update content property');
+        }
+      } else {
+        // Create new content property
+        const key = getContentPropertyKey(this.config.contentPropertyKey, localId);
+        return this.createNewContentProperty(pageId, key, syncedBlockValue);
+      }
+    } catch (error) {
+      // eslint-disable-next-line no-console
+      console.error('Failed to write synced block data:', error);
+      return Promise.reject(error);
+    }
+  }
+}
+
+/**
+ * Factory function to create both providers with shared configuration
+ */
+const createContentAPIProviders = config => {
+  const fetchProvider = new ConfluenceADFFetchProvider(config);
+  const writeProvider = new ConfluenceADFWriteProvider(config);
+  return {
+    fetchProvider,
+    writeProvider
+  };
+};
+
+/**
+ * Convenience function to create providers with default content property key
+ */
+export const createContentAPIProvidersWithDefaultKey = cloudId => {
+  return createContentAPIProviders({
+    cloudId,
+    contentPropertyKey: 'editor-synced-block'
+  });
+};
+export const useMemoizedContentAPIProviders = cloudId => {
+  return useMemo(() => {
+    return createContentAPIProvidersWithDefaultKey(cloudId);
+  }, [cloudId]);
+};

package/dist/es2019/utils/ari.js

@@ -0,0 +1,32 @@
+export const getConfluencePageAri = (pageId, cloudId) => `ari:cloud:confluence:${cloudId}:page/${pageId}`;
+export const getPageIdFromAri = ari => {
+  // eslint-disable-next-line require-unicode-regexp
+  const match = ari.match(/ari:cloud:confluence:[^:]+:page\/(\d+)/);
+  if (match !== null && match !== void 0 && match[1]) {
+    return match[1];
+  }
+  throw new Error(`Invalid page ARI: ${ari}`);
+};
+
+/**
+ *
+ * @param ari ari:cloud:confluence:<cloudId>:page/<pageId>/<localId>
+ * @returns
+ */
+export const getLocalIdFromAri = ari => {
+  // eslint-disable-next-line require-unicode-regexp
+  const match = ari.match(/ari:cloud:confluence:[^:]+:page\/\d+\/([a-zA-Z0-9-]+)/);
+  if (match !== null && match !== void 0 && match[1]) {
+    return match[1];
+  }
+  throw new Error(`Invalid page ARI: ${ari}`);
+};
+export const getContentPropertyAri = (contentPropertyId, cloudId) => `ari:cloud:confluence:${cloudId}:content/${contentPropertyId}`;
+export const getContentPropertyIdFromAri = ari => {
+  // eslint-disable-next-line require-unicode-regexp
+  const match = ari.match(/ari:cloud:confluence:[^:]+:content\/([^/]+)/);
+  if (match) {
+    return match[1];
+  }
+  throw new Error(`Invalid content property ARI: ${ari}`);
+};