@atlaskit/editor-common 111.17.1 → 111.18.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @atlaskit/editor-common
 
+## 111.18.0
+
+### Minor Changes
+
+- [`1a363f7706a2f`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/1a363f7706a2f) -
+  EDITOR-4193 add anaytics for ssr errors
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 111.17.1
 
 ### Patch Changes

package/dist/cjs/analytics/types/enums.js

@@ -565,6 +565,7 @@ var ACTION_SUBJECT_ID = exports.ACTION_SUBJECT_ID = /*#__PURE__*/function (ACTIO
   ACTION_SUBJECT_ID["SYNCED_BLOCK_FETCH"] = "syncedBlockFetch";
   ACTION_SUBJECT_ID["SYNCED_BLOCK_FETCH_REFERENCES"] = "syncedBlockFetchReferences";
   ACTION_SUBJECT_ID["SYNCED_BLOCK_CLICK_SYNCED_LOCATION"] = "syncedBlockClickSyncedLocation";
+  ACTION_SUBJECT_ID["SYNCED_BLOCK_SSR_ERROR"] = "syncedBlockSSRError";
   ACTION_SUBJECT_ID["TABLE_STICKY_HEADER"] = "tableStickyHeader";
   return ACTION_SUBJECT_ID;
 }({});

package/dist/cjs/monitoring/error.js

@@ -19,7 +19,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 var SENTRY_DSN = 'https://0b10c8e02fb44d8796c047b102c9bee8@o55978.ingest.sentry.io/4505129224110080';
 var packageName = 'editor-common'; // Sentry doesn't accept '/' in its releases https://docs.sentry.io/platforms/javascript/configuration/releases/
-var packageVersion = "111.17.0";
+var packageVersion = "111.17.1";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/cjs/sync-block/ssr_error.js

@@ -0,0 +1,127 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.handleSSRErrorsAnalytics = exports.SyncedBlocksSSRErrorCodeMap = void 0;
+var _typeof2 = _interopRequireDefault(require("@babel/runtime/helpers/typeof"));
+var _analytics = require("../analytics");
+var _coreUtils = require("../core-utils");
+/**
+ * Error codes for synced blocks preloading
+ * Used for tracking and monitoring errors during SSR preload phase
+ */
+var SyncedBlocksSSRErrorCodeMap = exports.SyncedBlocksSSRErrorCodeMap = {
+  /**
+   * Occurs when the fetch operation returns fewer results than requested.
+   * This indicates incomplete data retrieval or potential data loss.
+   * Included in error: list of missing block identifiers
+   */
+  FETCH_INCOMPLETE: 'SYNCED_BLOCKS_FETCH_INCOMPLETE',
+  /**
+   * Occurs when the batch fetch operation throws an error during execution.
+   * This indicates a network error, timeout, or API failure.
+   * Included in error: resource IDs that failed to fetch
+   */
+  BATCH_FETCH_FAILED: 'SYNCED_BLOCKS_BATCH_FETCH_FAILED',
+  /**
+   * Occurs when the fetch operation times out without returning results.
+   * This is specific to the bulk fetch operation with a configurable timeout.
+   */
+  FETCH_TIMEOUT: 'SYNCED_BLOCKS_FETCH_TIMEOUT'
+};
+
+/**
+ * This is the metadata structure for SSR errors stored in the window object.
+ */
+
+var isSyncedBlocksSSRErrorObj = function isSyncedBlocksSSRErrorObj(maybeSSRErrorObj) {
+  if (!maybeSSRErrorObj || (0, _typeof2.default)(maybeSSRErrorObj) !== 'object') {
+    return false;
+  }
+  var errorWrapper = maybeSSRErrorObj;
+
+  // Check for meta object with valid code
+  var hasValidMeta = errorWrapper.meta && (0, _typeof2.default)(errorWrapper.meta) === 'object' && Object.values(SyncedBlocksSSRErrorCodeMap).includes(errorWrapper.meta.code);
+  return Boolean(hasValidMeta);
+};
+
+/**
+ * Get the first SSR error for synced blocks from the window.__SSR_ERROR__ array.
+ *
+ * Expected structure of error objects stored in confluence window.__SSR_ERROR__ for synced blocks SSR errors:
+ *
+ * @example
+ * {
+ *   error: {
+ *     message: "Synced blocks fetch operation timed out",
+ *     stack: "Error: Synced blocks fetch operation timed out\n    at /tmp/script.js:xxx:xxx"
+ *   },
+ *   meta: {
+ *     code: "SYNCED_BLOCKS_FETCH_TIMEOUT",
+ *     contentId: "XXXXXX",
+ *     cloudId: "XXXX-XXXX-XXXX-XXXX-XXXX",
+ *     isBlog: false,
+ *     identifiers: [
+ *       {
+ *         resourceId: "confluence-page/XXXXXX/XXXX-XXXX-XXXX-XXXX-XXXX",
+ *         blockInstanceId: "XXXX-XXXX-XXXX-XXXX-XXXX"
+ *       }
+ *     ]
+ *   }
+ * }
+ *
+ * @returns The first SSR error metadata, or undefined if no error found
+ */
+var getSyncedBlocksSSRError = function getSyncedBlocksSSRError() {
+  if ((0, _coreUtils.isSSR)()) {
+    return undefined;
+  }
+  var ssrErrors = window.__SSR_ERROR__;
+  if (Array.isArray(ssrErrors)) {
+    var syncedBlockErrors = ssrErrors.filter(isSyncedBlocksSSRErrorObj).map(function (errorWrapper) {
+      return errorWrapper.meta;
+    });
+    return syncedBlockErrors.length > 0 ? syncedBlockErrors[0] : undefined;
+  }
+  return undefined;
+};
+
+/**
+ * Fire analytics event for the first unprocessed SSR error that occurred during page rendering.
+ * This function only runs ONCE per browser session to avoid duplicate analytics events.
+ *
+ * @param fireAnalyticsEvent - Function to fire analytics events
+ */
+var handleSSRErrorsAnalytics = exports.handleSSRErrorsAnalytics = function () {
+  var called = false;
+  // I want this fireAnalyticsEvent only takes in SyncedBlockSSRErrorAEP
+  return function (fireAnalyticsEvent) {
+    if (called) {
+      return;
+    }
+    called = true;
+    if (!fireAnalyticsEvent) {
+      return;
+    }
+    var error = getSyncedBlocksSSRError();
+    if (error) {
+      var _error$identifiers, _error$missingIdentif;
+      fireAnalyticsEvent({
+        action: _analytics.ACTION.ERROR,
+        actionSubject: _analytics.ACTION_SUBJECT.SYNCED_BLOCK,
+        actionSubjectId: _analytics.ACTION_SUBJECT_ID.SYNCED_BLOCK_SSR_ERROR,
+        eventType: _analytics.EVENT_TYPE.OPERATIONAL,
+        attributes: {
+          code: error.code,
+          isBlog: error.isBlog,
+          syncedBlocksCount: ((_error$identifiers = error.identifiers) === null || _error$identifiers === void 0 ? void 0 : _error$identifiers.length) || 0,
+          missingSyncedBlocksCount: ((_error$missingIdentif = error.missingIdentifiers) === null || _error$missingIdentif === void 0 ? void 0 : _error$missingIdentif.length) || 0,
+          errorMessage: error.errorMessage,
+          errorName: error.errorName
+        }
+      });
+    }
+  };
+}();

package/dist/cjs/sync-block/types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/cjs/sync-block.js

@@ -39,6 +39,18 @@ Object.defineProperty(exports, "SyncBlockStateCssClassName", {
     return _syncBlock.SyncBlockStateCssClassName;
   }
 });
+Object.defineProperty(exports, "SyncedBlocksSSRErrorCodeMap", {
+  enumerable: true,
+  get: function get() {
+    return _ssr_error.SyncedBlocksSSRErrorCodeMap;
+  }
+});
+Object.defineProperty(exports, "handleSSRErrorsAnalytics", {
+  enumerable: true,
+  get: function get() {
+    return _ssr_error.handleSSRErrorsAnalytics;
+  }
+});
 Object.defineProperty(exports, "useSyncBlockActions", {
   enumerable: true,
   get: function get() {
@@ -46,4 +58,5 @@ Object.defineProperty(exports, "useSyncBlockActions", {
   }
 });
 var _syncBlock = require("./styles/shared/sync-block");
-var _SyncBlockActionsContext = require("./sync-block/SyncBlockActionsContext");
+var _SyncBlockActionsContext = require("./sync-block/SyncBlockActionsContext");
+var _ssr_error = require("./sync-block/ssr_error");

package/dist/cjs/ui/DropList/index.js

@@ -24,7 +24,7 @@ function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.
  * @jsx jsx
  */ // eslint-disable-next-line @atlaskit/ui-styling-standard/use-compiled -- Ignored via go/DSP-18766
 var packageName = "@atlaskit/editor-common";
-var packageVersion = "111.17.0";
+var packageVersion = "111.17.1";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = (0, _react2.keyframes)({

package/dist/es2019/analytics/types/enums.js

@@ -559,6 +559,7 @@ export let ACTION_SUBJECT_ID = /*#__PURE__*/function (ACTION_SUBJECT_ID) {
   ACTION_SUBJECT_ID["SYNCED_BLOCK_FETCH"] = "syncedBlockFetch";
   ACTION_SUBJECT_ID["SYNCED_BLOCK_FETCH_REFERENCES"] = "syncedBlockFetchReferences";
   ACTION_SUBJECT_ID["SYNCED_BLOCK_CLICK_SYNCED_LOCATION"] = "syncedBlockClickSyncedLocation";
+  ACTION_SUBJECT_ID["SYNCED_BLOCK_SSR_ERROR"] = "syncedBlockSSRError";
   ACTION_SUBJECT_ID["TABLE_STICKY_HEADER"] = "tableStickyHeader";
   return ACTION_SUBJECT_ID;
 }({});

package/dist/es2019/monitoring/error.js

@@ -4,7 +4,7 @@ import { isFedRamp } from './environment';
 import { normaliseSentryBreadcrumbs, SERIALIZABLE_ATTRIBUTES } from './normalise-sentry-breadcrumbs';
 const SENTRY_DSN = 'https://0b10c8e02fb44d8796c047b102c9bee8@o55978.ingest.sentry.io/4505129224110080';
 const packageName = 'editor-common'; // Sentry doesn't accept '/' in its releases https://docs.sentry.io/platforms/javascript/configuration/releases/
-const packageVersion = "111.17.0";
+const packageVersion = "111.17.1";
 const sanitiseSentryEvents = (data, _hint) => {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/es2019/sync-block/ssr_error.js

@@ -0,0 +1,117 @@
+import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, EVENT_TYPE } from '../analytics';
+import { isSSR } from '../core-utils';
+/**
+ * Error codes for synced blocks preloading
+ * Used for tracking and monitoring errors during SSR preload phase
+ */
+export const SyncedBlocksSSRErrorCodeMap = {
+  /**
+   * Occurs when the fetch operation returns fewer results than requested.
+   * This indicates incomplete data retrieval or potential data loss.
+   * Included in error: list of missing block identifiers
+   */
+  FETCH_INCOMPLETE: 'SYNCED_BLOCKS_FETCH_INCOMPLETE',
+  /**
+   * Occurs when the batch fetch operation throws an error during execution.
+   * This indicates a network error, timeout, or API failure.
+   * Included in error: resource IDs that failed to fetch
+   */
+  BATCH_FETCH_FAILED: 'SYNCED_BLOCKS_BATCH_FETCH_FAILED',
+  /**
+   * Occurs when the fetch operation times out without returning results.
+   * This is specific to the bulk fetch operation with a configurable timeout.
+   */
+  FETCH_TIMEOUT: 'SYNCED_BLOCKS_FETCH_TIMEOUT'
+};
+
+/**
+ * This is the metadata structure for SSR errors stored in the window object.
+ */
+
+const isSyncedBlocksSSRErrorObj = maybeSSRErrorObj => {
+  if (!maybeSSRErrorObj || typeof maybeSSRErrorObj !== 'object') {
+    return false;
+  }
+  const errorWrapper = maybeSSRErrorObj;
+
+  // Check for meta object with valid code
+  const hasValidMeta = errorWrapper.meta && typeof errorWrapper.meta === 'object' && Object.values(SyncedBlocksSSRErrorCodeMap).includes(errorWrapper.meta.code);
+  return Boolean(hasValidMeta);
+};
+
+/**
+ * Get the first SSR error for synced blocks from the window.__SSR_ERROR__ array.
+ *
+ * Expected structure of error objects stored in confluence window.__SSR_ERROR__ for synced blocks SSR errors:
+ *
+ * @example
+ * {
+ *   error: {
+ *     message: "Synced blocks fetch operation timed out",
+ *     stack: "Error: Synced blocks fetch operation timed out\n    at /tmp/script.js:xxx:xxx"
+ *   },
+ *   meta: {
+ *     code: "SYNCED_BLOCKS_FETCH_TIMEOUT",
+ *     contentId: "XXXXXX",
+ *     cloudId: "XXXX-XXXX-XXXX-XXXX-XXXX",
+ *     isBlog: false,
+ *     identifiers: [
+ *       {
+ *         resourceId: "confluence-page/XXXXXX/XXXX-XXXX-XXXX-XXXX-XXXX",
+ *         blockInstanceId: "XXXX-XXXX-XXXX-XXXX-XXXX"
+ *       }
+ *     ]
+ *   }
+ * }
+ *
+ * @returns The first SSR error metadata, or undefined if no error found
+ */
+const getSyncedBlocksSSRError = () => {
+  if (isSSR()) {
+    return undefined;
+  }
+  const ssrErrors = window.__SSR_ERROR__;
+  if (Array.isArray(ssrErrors)) {
+    const syncedBlockErrors = ssrErrors.filter(isSyncedBlocksSSRErrorObj).map(errorWrapper => errorWrapper.meta);
+    return syncedBlockErrors.length > 0 ? syncedBlockErrors[0] : undefined;
+  }
+  return undefined;
+};
+
+/**
+ * Fire analytics event for the first unprocessed SSR error that occurred during page rendering.
+ * This function only runs ONCE per browser session to avoid duplicate analytics events.
+ *
+ * @param fireAnalyticsEvent - Function to fire analytics events
+ */
+export const handleSSRErrorsAnalytics = (() => {
+  let called = false;
+  // I want this fireAnalyticsEvent only takes in SyncedBlockSSRErrorAEP
+  return fireAnalyticsEvent => {
+    if (called) {
+      return;
+    }
+    called = true;
+    if (!fireAnalyticsEvent) {
+      return;
+    }
+    const error = getSyncedBlocksSSRError();
+    if (error) {
+      var _error$identifiers, _error$missingIdentif;
+      fireAnalyticsEvent({
+        action: ACTION.ERROR,
+        actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
+        actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_SSR_ERROR,
+        eventType: EVENT_TYPE.OPERATIONAL,
+        attributes: {
+          code: error.code,
+          isBlog: error.isBlog,
+          syncedBlocksCount: ((_error$identifiers = error.identifiers) === null || _error$identifiers === void 0 ? void 0 : _error$identifiers.length) || 0,
+          missingSyncedBlocksCount: ((_error$missingIdentif = error.missingIdentifiers) === null || _error$missingIdentif === void 0 ? void 0 : _error$missingIdentif.length) || 0,
+          errorMessage: error.errorMessage,
+          errorName: error.errorName
+        }
+      });
+    }
+  };
+})();

package/dist/es2019/sync-block.js

@@ -2,4 +2,5 @@
 /* eslint-disable @atlaskit/editor/no-re-export */
 
 export { BodiedSyncBlockSharedCssClassName, SyncBlockSharedCssClassName, SyncBlockLabelSharedCssClassName, SyncBlockStateCssClassName, SyncBlockRendererDataAttributeName } from './styles/shared/sync-block';
-export { SyncBlockActionsProvider, useSyncBlockActions } from './sync-block/SyncBlockActionsContext';
+export { SyncBlockActionsProvider, useSyncBlockActions } from './sync-block/SyncBlockActionsContext';
+export { handleSSRErrorsAnalytics, SyncedBlocksSSRErrorCodeMap } from './sync-block/ssr_error';

package/dist/es2019/ui/DropList/index.js

@@ -14,7 +14,7 @@ import withAnalyticsEvents from '@atlaskit/analytics-next/withAnalyticsEvents';
 import { fg } from '@atlaskit/platform-feature-flags';
 import Layer from '../Layer';
 const packageName = "@atlaskit/editor-common";
-const packageVersion = "111.17.0";
+const packageVersion = "111.17.1";
 const halfFocusRing = 1;
 const dropOffset = '0, 8';
 const fadeIn = keyframes({

package/dist/esm/analytics/types/enums.js

@@ -559,6 +559,7 @@ export var ACTION_SUBJECT_ID = /*#__PURE__*/function (ACTION_SUBJECT_ID) {
   ACTION_SUBJECT_ID["SYNCED_BLOCK_FETCH"] = "syncedBlockFetch";
   ACTION_SUBJECT_ID["SYNCED_BLOCK_FETCH_REFERENCES"] = "syncedBlockFetchReferences";
   ACTION_SUBJECT_ID["SYNCED_BLOCK_CLICK_SYNCED_LOCATION"] = "syncedBlockClickSyncedLocation";
+  ACTION_SUBJECT_ID["SYNCED_BLOCK_SSR_ERROR"] = "syncedBlockSSRError";
   ACTION_SUBJECT_ID["TABLE_STICKY_HEADER"] = "tableStickyHeader";
   return ACTION_SUBJECT_ID;
 }({});

package/dist/esm/monitoring/error.js

@@ -10,7 +10,7 @@ import { isFedRamp } from './environment';
 import { normaliseSentryBreadcrumbs, SERIALIZABLE_ATTRIBUTES } from './normalise-sentry-breadcrumbs';
 var SENTRY_DSN = 'https://0b10c8e02fb44d8796c047b102c9bee8@o55978.ingest.sentry.io/4505129224110080';
 var packageName = 'editor-common'; // Sentry doesn't accept '/' in its releases https://docs.sentry.io/platforms/javascript/configuration/releases/
-var packageVersion = "111.17.0";
+var packageVersion = "111.17.1";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

package/dist/esm/sync-block/ssr_error.js

@@ -0,0 +1,120 @@
+import _typeof from "@babel/runtime/helpers/typeof";
+import { ACTION, ACTION_SUBJECT, ACTION_SUBJECT_ID, EVENT_TYPE } from '../analytics';
+import { isSSR } from '../core-utils';
+/**
+ * Error codes for synced blocks preloading
+ * Used for tracking and monitoring errors during SSR preload phase
+ */
+export var SyncedBlocksSSRErrorCodeMap = {
+  /**
+   * Occurs when the fetch operation returns fewer results than requested.
+   * This indicates incomplete data retrieval or potential data loss.
+   * Included in error: list of missing block identifiers
+   */
+  FETCH_INCOMPLETE: 'SYNCED_BLOCKS_FETCH_INCOMPLETE',
+  /**
+   * Occurs when the batch fetch operation throws an error during execution.
+   * This indicates a network error, timeout, or API failure.
+   * Included in error: resource IDs that failed to fetch
+   */
+  BATCH_FETCH_FAILED: 'SYNCED_BLOCKS_BATCH_FETCH_FAILED',
+  /**
+   * Occurs when the fetch operation times out without returning results.
+   * This is specific to the bulk fetch operation with a configurable timeout.
+   */
+  FETCH_TIMEOUT: 'SYNCED_BLOCKS_FETCH_TIMEOUT'
+};
+
+/**
+ * This is the metadata structure for SSR errors stored in the window object.
+ */
+
+var isSyncedBlocksSSRErrorObj = function isSyncedBlocksSSRErrorObj(maybeSSRErrorObj) {
+  if (!maybeSSRErrorObj || _typeof(maybeSSRErrorObj) !== 'object') {
+    return false;
+  }
+  var errorWrapper = maybeSSRErrorObj;
+
+  // Check for meta object with valid code
+  var hasValidMeta = errorWrapper.meta && _typeof(errorWrapper.meta) === 'object' && Object.values(SyncedBlocksSSRErrorCodeMap).includes(errorWrapper.meta.code);
+  return Boolean(hasValidMeta);
+};
+
+/**
+ * Get the first SSR error for synced blocks from the window.__SSR_ERROR__ array.
+ *
+ * Expected structure of error objects stored in confluence window.__SSR_ERROR__ for synced blocks SSR errors:
+ *
+ * @example
+ * {
+ *   error: {
+ *     message: "Synced blocks fetch operation timed out",
+ *     stack: "Error: Synced blocks fetch operation timed out\n    at /tmp/script.js:xxx:xxx"
+ *   },
+ *   meta: {
+ *     code: "SYNCED_BLOCKS_FETCH_TIMEOUT",
+ *     contentId: "XXXXXX",
+ *     cloudId: "XXXX-XXXX-XXXX-XXXX-XXXX",
+ *     isBlog: false,
+ *     identifiers: [
+ *       {
+ *         resourceId: "confluence-page/XXXXXX/XXXX-XXXX-XXXX-XXXX-XXXX",
+ *         blockInstanceId: "XXXX-XXXX-XXXX-XXXX-XXXX"
+ *       }
+ *     ]
+ *   }
+ * }
+ *
+ * @returns The first SSR error metadata, or undefined if no error found
+ */
+var getSyncedBlocksSSRError = function getSyncedBlocksSSRError() {
+  if (isSSR()) {
+    return undefined;
+  }
+  var ssrErrors = window.__SSR_ERROR__;
+  if (Array.isArray(ssrErrors)) {
+    var syncedBlockErrors = ssrErrors.filter(isSyncedBlocksSSRErrorObj).map(function (errorWrapper) {
+      return errorWrapper.meta;
+    });
+    return syncedBlockErrors.length > 0 ? syncedBlockErrors[0] : undefined;
+  }
+  return undefined;
+};
+
+/**
+ * Fire analytics event for the first unprocessed SSR error that occurred during page rendering.
+ * This function only runs ONCE per browser session to avoid duplicate analytics events.
+ *
+ * @param fireAnalyticsEvent - Function to fire analytics events
+ */
+export var handleSSRErrorsAnalytics = function () {
+  var called = false;
+  // I want this fireAnalyticsEvent only takes in SyncedBlockSSRErrorAEP
+  return function (fireAnalyticsEvent) {
+    if (called) {
+      return;
+    }
+    called = true;
+    if (!fireAnalyticsEvent) {
+      return;
+    }
+    var error = getSyncedBlocksSSRError();
+    if (error) {
+      var _error$identifiers, _error$missingIdentif;
+      fireAnalyticsEvent({
+        action: ACTION.ERROR,
+        actionSubject: ACTION_SUBJECT.SYNCED_BLOCK,
+        actionSubjectId: ACTION_SUBJECT_ID.SYNCED_BLOCK_SSR_ERROR,
+        eventType: EVENT_TYPE.OPERATIONAL,
+        attributes: {
+          code: error.code,
+          isBlog: error.isBlog,
+          syncedBlocksCount: ((_error$identifiers = error.identifiers) === null || _error$identifiers === void 0 ? void 0 : _error$identifiers.length) || 0,
+          missingSyncedBlocksCount: ((_error$missingIdentif = error.missingIdentifiers) === null || _error$missingIdentif === void 0 ? void 0 : _error$missingIdentif.length) || 0,
+          errorMessage: error.errorMessage,
+          errorName: error.errorName
+        }
+      });
+    }
+  };
+}();

package/dist/esm/sync-block.js

@@ -2,4 +2,5 @@
 /* eslint-disable @atlaskit/editor/no-re-export */
 
 export { BodiedSyncBlockSharedCssClassName, SyncBlockSharedCssClassName, SyncBlockLabelSharedCssClassName, SyncBlockStateCssClassName, SyncBlockRendererDataAttributeName } from './styles/shared/sync-block';
-export { SyncBlockActionsProvider, useSyncBlockActions } from './sync-block/SyncBlockActionsContext';
+export { SyncBlockActionsProvider, useSyncBlockActions } from './sync-block/SyncBlockActionsContext';
+export { handleSSRErrorsAnalytics, SyncedBlocksSSRErrorCodeMap } from './sync-block/ssr_error';

package/dist/esm/ui/DropList/index.js

@@ -21,7 +21,7 @@ import withAnalyticsEvents from '@atlaskit/analytics-next/withAnalyticsEvents';
 import { fg } from '@atlaskit/platform-feature-flags';
 import Layer from '../Layer';
 var packageName = "@atlaskit/editor-common";
-var packageVersion = "111.17.0";
+var packageVersion = "111.17.1";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = keyframes({

package/dist/types/analytics/index.d.ts

@@ -53,4 +53,4 @@ export { type TelepointerClickPayload } from './types/telepointer-events';
 export { type NcsSessionStepEventAEP, type NcsSessionStepMetrics, } from './types/ncs-session-step-events';
 export type { BlockMenuEventPayload } from './types/block-menu-events';
 export type { BreakoutEventPayload, BreakoutSupportedNodes } from './types/breakout-events';
-export type { RendererSyncBlockEventPayload, SyncBlockEventPayload, } from './types/sync-block-events';
+export type { RendererSyncBlockEventPayload, SyncBlockEventPayload, SyncedBlockSSRErrorAEP, } from './types/sync-block-events';

package/dist/types/analytics/types/enums.d.ts

@@ -551,6 +551,7 @@ export declare enum ACTION_SUBJECT_ID {
     SYNCED_BLOCK_FETCH = "syncedBlockFetch",
     SYNCED_BLOCK_FETCH_REFERENCES = "syncedBlockFetchReferences",
     SYNCED_BLOCK_CLICK_SYNCED_LOCATION = "syncedBlockClickSyncedLocation",
+    SYNCED_BLOCK_SSR_ERROR = "syncedBlockSSRError",
     TABLE_STICKY_HEADER = "tableStickyHeader"
 }
 export declare enum FLOATING_CONTROLS_TITLE {

package/dist/types/analytics/types/sync-block-events.d.ts

@@ -38,6 +38,15 @@ export type SyncedBlockEditSourceAEP = OperationalAEP<ACTION.SYNCED_BLOCK_EDIT_S
 export type SyncedBlockCopyAEP = OperationalAEP<ACTION.COPIED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY, SyncedBlockCopySuccessAttributes>;
 export type SyncedBlockCopyErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY, SyncedBlockCopyErrorAttributes>;
 export type SyncedLocationClickAEP = OperationalAEP<ACTION.CLICKED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_CLICK_SYNCED_LOCATION, SyncedBlockSuccessAttributes>;
-export type SyncBlockEventPayload = SyncedBlockSourceURLErrorAEP | SyncedBlockUpdateCacheErrorAEP | SyncedBlockUpdateErrorAEP | SyncedBlockUpdateSuccessAEP | SyncedBlockCreateErrorAEP | SyncedBlockCreateSuccessAEP | SyncedBlockDeleteErrorAEP | SyncedBlockDeleteSuccessAEP | SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | SyncedBlockFetchReferencesErrorAEP | ExperienceEventPayload | ReferenceSyncedBlockCreateSuccessAEP | ReferenceSyncedBlockDeleteSuccessAEP | SyncedBlockEditSourceAEP | SyncedBlockCopyAEP | SyncedBlockCopyErrorAEP | SyncedLocationClickAEP | InsertSourceSyncedBlockPayload;
+type SyncedBlockSSRErrorAttributes = {
+    code: string;
+    errorMessage?: string;
+    errorName?: string;
+    isBlog?: boolean;
+    missingSyncedBlocksCount?: number;
+    syncedBlocksCount?: number;
+};
+export type SyncedBlockSSRErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_SSR_ERROR, SyncedBlockSSRErrorAttributes>;
+export type SyncBlockEventPayload = SyncedBlockSourceURLErrorAEP | SyncedBlockUpdateCacheErrorAEP | SyncedBlockUpdateErrorAEP | SyncedBlockUpdateSuccessAEP | SyncedBlockCreateErrorAEP | SyncedBlockCreateSuccessAEP | SyncedBlockDeleteErrorAEP | SyncedBlockDeleteSuccessAEP | SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | SyncedBlockFetchReferencesErrorAEP | ExperienceEventPayload | ReferenceSyncedBlockCreateSuccessAEP | ReferenceSyncedBlockDeleteSuccessAEP | SyncedBlockEditSourceAEP | SyncedBlockCopyAEP | SyncedBlockCopyErrorAEP | SyncedLocationClickAEP | SyncedBlockSSRErrorAEP | InsertSourceSyncedBlockPayload;
 export type RendererSyncBlockEventPayload = SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | ExperienceEventPayload;
 export {};

package/dist/types/sync-block/ssr_error.d.ts

@@ -0,0 +1,50 @@
+import type { SyncedBlockSSRErrorAEP } from '../analytics/types/sync-block-events';
+type BlockNodeIdentifiers = {
+    blockInstanceId: string;
+    resourceId: string;
+};
+/**
+ * Error codes for synced blocks preloading
+ * Used for tracking and monitoring errors during SSR preload phase
+ */
+export declare const SyncedBlocksSSRErrorCodeMap: {
+    /**
+     * Occurs when the fetch operation returns fewer results than requested.
+     * This indicates incomplete data retrieval or potential data loss.
+     * Included in error: list of missing block identifiers
+     */
+    readonly FETCH_INCOMPLETE: "SYNCED_BLOCKS_FETCH_INCOMPLETE";
+    /**
+     * Occurs when the batch fetch operation throws an error during execution.
+     * This indicates a network error, timeout, or API failure.
+     * Included in error: resource IDs that failed to fetch
+     */
+    readonly BATCH_FETCH_FAILED: "SYNCED_BLOCKS_BATCH_FETCH_FAILED";
+    /**
+     * Occurs when the fetch operation times out without returning results.
+     * This is specific to the bulk fetch operation with a configurable timeout.
+     */
+    readonly FETCH_TIMEOUT: "SYNCED_BLOCKS_FETCH_TIMEOUT";
+};
+export type SyncedBlocksSSRErrorCode = (typeof SyncedBlocksSSRErrorCodeMap)[keyof typeof SyncedBlocksSSRErrorCodeMap];
+/**
+ * This is the metadata structure for SSR errors stored in the window object.
+ */
+export type SyncedBlocksSSRErrorMetadata = {
+    cloudId?: string;
+    code: SyncedBlocksSSRErrorCode;
+    contentId?: string;
+    errorMessage?: string;
+    errorName?: string;
+    identifiers?: BlockNodeIdentifiers[];
+    isBlog?: boolean;
+    missingIdentifiers?: BlockNodeIdentifiers[];
+};
+/**
+ * Fire analytics event for the first unprocessed SSR error that occurred during page rendering.
+ * This function only runs ONCE per browser session to avoid duplicate analytics events.
+ *
+ * @param fireAnalyticsEvent - Function to fire analytics events
+ */
+export declare const handleSSRErrorsAnalytics: (fireAnalyticsEvent?: (event: SyncedBlockSSRErrorAEP) => void) => void;
+export {};

package/dist/types/sync-block/types.d.ts

@@ -0,0 +1,4 @@
+export type BlockNodeIdentifiers = {
+    blockInstanceId: string;
+    resourceId: string;
+};

package/dist/types/sync-block.d.ts

@@ -1,2 +1,4 @@
 export { BodiedSyncBlockSharedCssClassName, SyncBlockSharedCssClassName, SyncBlockLabelSharedCssClassName, SyncBlockStateCssClassName, SyncBlockRendererDataAttributeName, } from './styles/shared/sync-block';
 export { SyncBlockActionsProvider, useSyncBlockActions, } from './sync-block/SyncBlockActionsContext';
+export type { SyncedBlocksSSRErrorMetadata, SyncedBlocksSSRErrorCode, } from './sync-block/ssr_error';
+export { handleSSRErrorsAnalytics, SyncedBlocksSSRErrorCodeMap } from './sync-block/ssr_error';

package/dist/types-ts4.5/analytics/index.d.ts

@@ -53,4 +53,4 @@ export { type TelepointerClickPayload } from './types/telepointer-events';
 export { type NcsSessionStepEventAEP, type NcsSessionStepMetrics, } from './types/ncs-session-step-events';
 export type { BlockMenuEventPayload } from './types/block-menu-events';
 export type { BreakoutEventPayload, BreakoutSupportedNodes } from './types/breakout-events';
-export type { RendererSyncBlockEventPayload, SyncBlockEventPayload, } from './types/sync-block-events';
+export type { RendererSyncBlockEventPayload, SyncBlockEventPayload, SyncedBlockSSRErrorAEP, } from './types/sync-block-events';

package/dist/types-ts4.5/analytics/types/enums.d.ts

@@ -551,6 +551,7 @@ export declare enum ACTION_SUBJECT_ID {
     SYNCED_BLOCK_FETCH = "syncedBlockFetch",
     SYNCED_BLOCK_FETCH_REFERENCES = "syncedBlockFetchReferences",
     SYNCED_BLOCK_CLICK_SYNCED_LOCATION = "syncedBlockClickSyncedLocation",
+    SYNCED_BLOCK_SSR_ERROR = "syncedBlockSSRError",
     TABLE_STICKY_HEADER = "tableStickyHeader"
 }
 export declare enum FLOATING_CONTROLS_TITLE {

package/dist/types-ts4.5/analytics/types/sync-block-events.d.ts

@@ -38,6 +38,15 @@ export type SyncedBlockEditSourceAEP = OperationalAEP<ACTION.SYNCED_BLOCK_EDIT_S
 export type SyncedBlockCopyAEP = OperationalAEP<ACTION.COPIED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY, SyncedBlockCopySuccessAttributes>;
 export type SyncedBlockCopyErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_COPY, SyncedBlockCopyErrorAttributes>;
 export type SyncedLocationClickAEP = OperationalAEP<ACTION.CLICKED, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_CLICK_SYNCED_LOCATION, SyncedBlockSuccessAttributes>;
-export type SyncBlockEventPayload = SyncedBlockSourceURLErrorAEP | SyncedBlockUpdateCacheErrorAEP | SyncedBlockUpdateErrorAEP | SyncedBlockUpdateSuccessAEP | SyncedBlockCreateErrorAEP | SyncedBlockCreateSuccessAEP | SyncedBlockDeleteErrorAEP | SyncedBlockDeleteSuccessAEP | SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | SyncedBlockFetchReferencesErrorAEP | ExperienceEventPayload | ReferenceSyncedBlockCreateSuccessAEP | ReferenceSyncedBlockDeleteSuccessAEP | SyncedBlockEditSourceAEP | SyncedBlockCopyAEP | SyncedBlockCopyErrorAEP | SyncedLocationClickAEP | InsertSourceSyncedBlockPayload;
+type SyncedBlockSSRErrorAttributes = {
+    code: string;
+    errorMessage?: string;
+    errorName?: string;
+    isBlog?: boolean;
+    missingSyncedBlocksCount?: number;
+    syncedBlocksCount?: number;
+};
+export type SyncedBlockSSRErrorAEP = OperationalAEP<ACTION.ERROR, ACTION_SUBJECT.SYNCED_BLOCK, ACTION_SUBJECT_ID.SYNCED_BLOCK_SSR_ERROR, SyncedBlockSSRErrorAttributes>;
+export type SyncBlockEventPayload = SyncedBlockSourceURLErrorAEP | SyncedBlockUpdateCacheErrorAEP | SyncedBlockUpdateErrorAEP | SyncedBlockUpdateSuccessAEP | SyncedBlockCreateErrorAEP | SyncedBlockCreateSuccessAEP | SyncedBlockDeleteErrorAEP | SyncedBlockDeleteSuccessAEP | SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | SyncedBlockFetchReferencesErrorAEP | ExperienceEventPayload | ReferenceSyncedBlockCreateSuccessAEP | ReferenceSyncedBlockDeleteSuccessAEP | SyncedBlockEditSourceAEP | SyncedBlockCopyAEP | SyncedBlockCopyErrorAEP | SyncedLocationClickAEP | SyncedBlockSSRErrorAEP | InsertSourceSyncedBlockPayload;
 export type RendererSyncBlockEventPayload = SyncedBlockGetSourceInfoErrorAEP | SyncedBlockFetchErrorAEP | SyncedBlockFetchSuccessAEP | ReferenceSyncedBlockUpdateErrorAEP | ExperienceEventPayload;
 export {};

package/dist/types-ts4.5/sync-block/ssr_error.d.ts

@@ -0,0 +1,50 @@
+import type { SyncedBlockSSRErrorAEP } from '../analytics/types/sync-block-events';
+type BlockNodeIdentifiers = {
+    blockInstanceId: string;
+    resourceId: string;
+};
+/**
+ * Error codes for synced blocks preloading
+ * Used for tracking and monitoring errors during SSR preload phase
+ */
+export declare const SyncedBlocksSSRErrorCodeMap: {
+    /**
+     * Occurs when the fetch operation returns fewer results than requested.
+     * This indicates incomplete data retrieval or potential data loss.
+     * Included in error: list of missing block identifiers
+     */
+    readonly FETCH_INCOMPLETE: "SYNCED_BLOCKS_FETCH_INCOMPLETE";
+    /**
+     * Occurs when the batch fetch operation throws an error during execution.
+     * This indicates a network error, timeout, or API failure.
+     * Included in error: resource IDs that failed to fetch
+     */
+    readonly BATCH_FETCH_FAILED: "SYNCED_BLOCKS_BATCH_FETCH_FAILED";
+    /**
+     * Occurs when the fetch operation times out without returning results.
+     * This is specific to the bulk fetch operation with a configurable timeout.
+     */
+    readonly FETCH_TIMEOUT: "SYNCED_BLOCKS_FETCH_TIMEOUT";
+};
+export type SyncedBlocksSSRErrorCode = (typeof SyncedBlocksSSRErrorCodeMap)[keyof typeof SyncedBlocksSSRErrorCodeMap];
+/**
+ * This is the metadata structure for SSR errors stored in the window object.
+ */
+export type SyncedBlocksSSRErrorMetadata = {
+    cloudId?: string;
+    code: SyncedBlocksSSRErrorCode;
+    contentId?: string;
+    errorMessage?: string;
+    errorName?: string;
+    identifiers?: BlockNodeIdentifiers[];
+    isBlog?: boolean;
+    missingIdentifiers?: BlockNodeIdentifiers[];
+};
+/**
+ * Fire analytics event for the first unprocessed SSR error that occurred during page rendering.
+ * This function only runs ONCE per browser session to avoid duplicate analytics events.
+ *
+ * @param fireAnalyticsEvent - Function to fire analytics events
+ */
+export declare const handleSSRErrorsAnalytics: (fireAnalyticsEvent?: (event: SyncedBlockSSRErrorAEP) => void) => void;
+export {};

package/dist/types-ts4.5/sync-block/types.d.ts

@@ -0,0 +1,4 @@
+export type BlockNodeIdentifiers = {
+    blockInstanceId: string;
+    resourceId: string;
+};

package/dist/types-ts4.5/sync-block.d.ts

@@ -1,2 +1,4 @@
 export { BodiedSyncBlockSharedCssClassName, SyncBlockSharedCssClassName, SyncBlockLabelSharedCssClassName, SyncBlockStateCssClassName, SyncBlockRendererDataAttributeName, } from './styles/shared/sync-block';
 export { SyncBlockActionsProvider, useSyncBlockActions, } from './sync-block/SyncBlockActionsContext';
+export type { SyncedBlocksSSRErrorMetadata, SyncedBlocksSSRErrorCode, } from './sync-block/ssr_error';
+export { handleSSRErrorsAnalytics, SyncedBlocksSSRErrorCodeMap } from './sync-block/ssr_error';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-common",
-	"version": "111.17.1",
+	"version": "111.18.0",
 	"description": "A package that contains common classes and components for editor and renderer",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -63,7 +63,7 @@
 		"@atlaskit/media-picker": "^70.1.0",
 		"@atlaskit/media-ui": "^28.7.0",
 		"@atlaskit/media-viewer": "^52.8.0",
-		"@atlaskit/mention": "^24.4.0",
+		"@atlaskit/mention": "^24.5.0",
 		"@atlaskit/menu": "^8.4.0",
 		"@atlaskit/onboarding": "^14.5.0",
 		"@atlaskit/platform-feature-flags": "^1.1.0",