@atlaskit/editor-common 110.34.3 → 110.34.5

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @atlaskit/editor-common
 
+## 110.34.5
+
+### Patch Changes
+
+- [`cfa9f26687992`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/cfa9f26687992) -
+  Enable breadcrumbs in Sentry for Editor
+- [`34ebbcd3440c2`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/34ebbcd3440c2) -
+  NO-ISSUE Split by action subject id for experience tracking
+
+## 110.34.4
+
+### Patch Changes
+
+- [`4d676bbdb3ce6`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/4d676bbdb3ce6) -
+  ts-ignore added temporarily to unblock local consumption for help-center, will be removed once
+  project refs are setup
+- Updated dependencies
+
 ## 110.34.3
 
 ### Patch Changes

package/dist/cjs/card/utils.js

@@ -28,6 +28,7 @@ function addLinkMetadata(initialSelection, tr, metadata) {
   return tr;
 }
 function getLinkMetadataFromTransaction(tr) {
+  // @ts-ignore - Workaround for help-center local consumption
   return tr.steps.reduce(function (metadata, step) {
     if (!(step instanceof _steps.LinkMetaStep)) {
       return metadata;

package/dist/cjs/experiences/Experience.js

@@ -38,13 +38,14 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
   /**
    * Creates a new Experience instance for tracking user experiences.
    *
-   * @param id - Unique identifier for the experience
+   * @param id - Unique identifier for the experience e.g. 'toolbar-open' 'menu-action'
    * @param options - Configuration options for the experience
    * @param options.checks - Experience checks to monitor for completion
    * @param options.dispatchAnalyticsEvent - Function to dispatch analytics events
    * @param options.sampleRate - Sample rate for experienceSampled events
    * @param options.metadata - Global metadata to attach to all events
-   * @param options.action - Optional sub identifier for the specific experience action
+   * @param options.action - Optional sub identifier for the specific experience action e.g. 'bold' 'insert-table'
+   * @param options.actionSubjectId - Optional sub identifier for the experience action subject e.g. 'selection-toolbar' 'quick-insert'
    */
   function Experience(id, options) {
     var _options$sampleRate;
@@ -57,6 +58,7 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
      */
     (0, _defineProperty2.default)(this, "statesSeen", new Set());
     this.id = id;
+    this.actionSubjectId = options.actionSubjectId;
     this.dispatchAnalyticsEvent = options.dispatchAnalyticsEvent;
     this.sampleRate = (_options$sampleRate = options.sampleRate) !== null && _options$sampleRate !== void 0 ? _options$sampleRate : _consts.DEFAULT_EXPERIENCE_SAMPLE_RATE;
     this.globalMetadata = _objectSpread(_objectSpread({}, options.metadata), {}, {
@@ -161,7 +163,7 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
       var experienceMeasuredEvent = {
         action: _analytics.ACTION.EXPERIENCE_MEASURED,
         actionSubject: _analytics.ACTION_SUBJECT.EDITOR,
-        actionSubjectId: undefined,
+        actionSubjectId: this.actionSubjectId,
         eventType: _analytics.EVENT_TYPE.OPERATIONAL,
         attributes: attributes
       };
@@ -170,7 +172,7 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
         var experienceSampledEvent = {
           action: _analytics.ACTION.EXPERIENCE_SAMPLED,
           actionSubject: _analytics.ACTION_SUBJECT.EDITOR,
-          actionSubjectId: undefined,
+          actionSubjectId: this.actionSubjectId,
           eventType: _analytics.EVENT_TYPE.OPERATIONAL,
           attributes: attributes
         };

package/dist/cjs/hooks/usePluginStateEffect.js

@@ -95,6 +95,8 @@ function usePluginStateEffect(injectionApi, plugins, effect) {
       return _objectSpread(_objectSpread({}, acc), {}, (0, _defineProperty2.default)({}, "".concat(String(pluginName), "State"), injectionApi === null || injectionApi === void 0 ? void 0 : injectionApi[pluginName]));
     }, {});
   }, [injectionApi, pluginNames]);
+
+  // @ts-ignore - Workaround for help-center local consumption
   usePluginStateEffectInternal(namedExternalPlugins, effect, options);
 }
 function usePluginStateEffectInternal(externalPlugins, effect) {

package/dist/cjs/keymaps/keymap.js

@@ -19,6 +19,7 @@ var _safePlugin = require("../safe-plugin");
 function keymap(bindings) {
   return new _safePlugin.SafePlugin({
     props: {
+      // @ts-ignore - Workaround for help-center local consumption
       handleKeyDown: function handleKeyDown(view, event) {
         var name = (0, _w3cKeyname.keyName)(event);
         var keyboardEvent = event;

package/dist/cjs/link/LinkSearch/index.js

@@ -327,4 +327,6 @@ var RecentLink = /*#__PURE__*/function (_React$Component) {
 (0, _defineProperty2.default)(RecentLink, "defaultProps", {
   limit: DEFAULT_ITEMS_LIMIT
 });
-var _default = exports.default = (0, _withActivityProvider.default)((0, _reactIntlNext.injectIntl)(RecentLink));
+var _default = exports.default = (0, _withActivityProvider.default)(
+// @ts-ignore - Workaround for help-center local consumption (prop type incompatibility)
+(0, _reactIntlNext.injectIntl)(RecentLink));

package/dist/cjs/monitoring/error.js

@@ -10,13 +10,16 @@ var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"))
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _browser = require("@sentry/browser");
+var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _environment = require("./environment");
+var _normaliseSentryBreadcrumbs = require("./normalise-sentry-breadcrumbs");
 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; }
 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 = "110.34.2";
+var packageVersion = "110.34.4";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007
@@ -29,7 +32,7 @@ var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
 };
 var logException = exports.logException = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(error, tags) {
-    var _process$env$CLOUD_EN, _yield$import, BrowserClient, defaultIntegrations, getCurrentHub, _yield$import2, ExtraErrorData, sentryOptions, client, hub;
+    var _process$env$CLOUD_EN, _yield$import, BrowserClient, defaultIntegrations, getCurrentHub, _yield$import2, ExtraErrorData, breadcrumbsIntegration, sentryOptions, client, hub;
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
@@ -56,10 +59,23 @@ var logException = exports.logException = /*#__PURE__*/function () {
         case 11:
           _yield$import2 = _context.sent;
           ExtraErrorData = _yield$import2.ExtraErrorData;
+          breadcrumbsIntegration = (0, _platformFeatureFlags.fg)('platform_editor_sentry_breadcrumbs') ? new _browser.Integrations.Breadcrumbs({
+            // only enable breadcrumbs for dom (UI clicks and inputs)
+            // include 'data-test-id', 'data-testid' in the breadcrumbs if they are found
+            dom: {
+              serializeAttribute: _normaliseSentryBreadcrumbs.SERIALIZABLE_ATTRIBUTES
+            },
+            fetch: false,
+            xhr: false,
+            console: false,
+            history: false,
+            sentry: false
+          }) : undefined;
           sentryOptions = {
             dsn: (0, _environment.isFedRamp)() ? undefined : SENTRY_DSN,
             release: "".concat(packageName, "@").concat(packageVersion),
             environment: (_process$env$CLOUD_EN = process.env.CLOUD_ENV) !== null && _process$env$CLOUD_EN !== void 0 ? _process$env$CLOUD_EN : 'unknown',
+            beforeBreadcrumb: (0, _platformFeatureFlags.fg)('platform_editor_sentry_breadcrumbs') ? _normaliseSentryBreadcrumbs.normaliseSentryBreadcrumbs : undefined,
             ignoreErrors: [
             // Network issues
             // Ignored via go/ees005
@@ -78,7 +94,7 @@ var logException = exports.logException = /*#__PURE__*/function () {
               return [].concat((0, _toConsumableArray2.default)(defaultIntegrations.filter(function (_ref2) {
                 var name = _ref2.name;
                 return name !== 'Breadcrumbs';
-              })), [
+              })), (0, _toConsumableArray2.default)(breadcrumbsIntegration ? [breadcrumbsIntegration] : []), [
               // Extracts all non-native attributes from the error object and attaches them to the event as the extra data
               // https://docs.sentry.io/platforms/javascript/configuration/integrations/plugin/?original_referrer=https%3A%2F%2Fduckduckgo.com%2F#extraerrordata
               new ExtraErrorData()]);
@@ -113,14 +129,14 @@ var logException = exports.logException = /*#__PURE__*/function () {
 
           // @ts-ignore - TypeScript 5.9.2 upgrade
           return _context.abrupt("return", client.close());
-        case 21:
-          _context.prev = 21;
+        case 22:
+          _context.prev = 22;
           _context.t0 = _context["catch"](0);
-        case 23:
+        case 24:
         case "end":
           return _context.stop();
       }
-    }, _callee, null, [[0, 21]]);
+    }, _callee, null, [[0, 22]]);
   }));
   return function logException(_x, _x2) {
     return _ref.apply(this, arguments);

package/dist/cjs/monitoring/normalise-sentry-breadcrumbs.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.normaliseSentryBreadcrumbs = exports.SERIALIZABLE_ATTRIBUTES = void 0;
+var SERIALIZABLE_ATTRIBUTES = exports.SERIALIZABLE_ATTRIBUTES = ['data-test-id', 'data-testid'];
+var WHITELISTED_ATTRIBNUTES = ['type', 'name'].concat(SERIALIZABLE_ATTRIBUTES);
+var REG_MATCH_NOTALLOWED_ATTRIBUTES = new RegExp("\\[(?!".concat(WHITELISTED_ATTRIBNUTES.join('|'), ").*?\\]"), 'gmu');
+
+// attributes may contain UGC that we need to strip out
+// only allow type and name attributes
+var sanitiseUiBreadcrumbMessage = function sanitiseUiBreadcrumbMessage(message) {
+  return message.replace(REG_MATCH_NOTALLOWED_ATTRIBUTES, '');
+};
+/**
+ * Sanitizes messages within UI category breadcrumbs to ensure user-generated content is
+ * appropriately cleaned before being logged by Sentry. This helps in maintaining
+ * privacy and security by preventing sensitive data exposure.
+ */
+var normaliseSentryBreadcrumbs = exports.normaliseSentryBreadcrumbs = function normaliseSentryBreadcrumbs(breadcrumb) {
+  var _ref = breadcrumb || {},
+    category = _ref.category;
+
+  // allow "ui*"" category breadcrumbs, that include clicks and inputs on DOM elements
+  // they may contain UGC that needs to be stripped out
+  if (category !== null && category !== void 0 && category.startsWith('ui')) {
+    // sentry can include the element attributes in the data
+    // which may contain UGC that we need to strip out
+    var sanitisedBreadCrumb = breadcrumb;
+    var message = sanitisedBreadCrumb.message;
+    if (message !== null && message !== undefined) {
+      sanitisedBreadCrumb.message = sanitiseUiBreadcrumbMessage(message);
+    }
+    return breadcrumb;
+  }
+  return breadcrumb;
+};

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 = "110.34.2";
+var packageVersion = "110.34.4";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = (0, _react2.keyframes)({

package/dist/cjs/utils/document.js

@@ -20,7 +20,10 @@ var _editorCoreUtils = require("./editor-core-utils");
 var getStepRange = exports.getStepRange = function getStepRange(transaction) {
   var from = -1;
   var to = -1;
+
+  // @ts-ignore - Workaround for help-center local consumption
   transaction.mapping.maps.forEach(function (stepMap, index) {
+    // @ts-ignore - Workaround for help-center local consumption
     stepMap.forEach(function (oldStart, oldEnd) {
       var newStart = transaction.mapping.slice(index).map(oldStart, -1);
       var newEnd = transaction.mapping.slice(index).map(oldEnd);

package/dist/cjs/utils/plugin-state-factory.js

@@ -64,9 +64,13 @@ function pluginFactory(pluginKey, reducer) {
   return {
     createPluginState: function createPluginState(dispatch, initialState) {
       return {
+        // @ts-ignore - Workaround for help-center local consumption
+
         init: function init(_, state) {
           return isFunction(initialState) ? initialState(state) : initialState;
         },
+        // @ts-ignore - Workaround for help-center local consumption
+
         apply: function apply(tr, _pluginState, _oldEditorState, newEditorState) {
           var oldPluginState = mapping ? mapping(tr, _pluginState, newEditorState) : _pluginState;
           var newPluginState = oldPluginState;

package/dist/es2019/card/utils.js

@@ -18,6 +18,7 @@ export function addLinkMetadata(initialSelection, tr, metadata) {
   return tr;
 }
 export function getLinkMetadataFromTransaction(tr) {
+  // @ts-ignore - Workaround for help-center local consumption
   return tr.steps.reduce((metadata, step) => {
     if (!(step instanceof LinkMetaStep)) {
       return metadata;

package/dist/es2019/experiences/Experience.js

@@ -27,13 +27,14 @@ export class Experience {
   /**
    * Creates a new Experience instance for tracking user experiences.
    *
-   * @param id - Unique identifier for the experience
+   * @param id - Unique identifier for the experience e.g. 'toolbar-open' 'menu-action'
    * @param options - Configuration options for the experience
    * @param options.checks - Experience checks to monitor for completion
    * @param options.dispatchAnalyticsEvent - Function to dispatch analytics events
    * @param options.sampleRate - Sample rate for experienceSampled events
    * @param options.metadata - Global metadata to attach to all events
-   * @param options.action - Optional sub identifier for the specific experience action
+   * @param options.action - Optional sub identifier for the specific experience action e.g. 'bold' 'insert-table'
+   * @param options.actionSubjectId - Optional sub identifier for the experience action subject e.g. 'selection-toolbar' 'quick-insert'
    */
   constructor(id, options) {
     var _options$sampleRate;
@@ -45,6 +46,7 @@ export class Experience {
      */
     _defineProperty(this, "statesSeen", new Set());
     this.id = id;
+    this.actionSubjectId = options.actionSubjectId;
     this.dispatchAnalyticsEvent = options.dispatchAnalyticsEvent;
     this.sampleRate = (_options$sampleRate = options.sampleRate) !== null && _options$sampleRate !== void 0 ? _options$sampleRate : DEFAULT_EXPERIENCE_SAMPLE_RATE;
     this.globalMetadata = {
@@ -145,7 +147,7 @@ export class Experience {
     const experienceMeasuredEvent = {
       action: ACTION.EXPERIENCE_MEASURED,
       actionSubject: ACTION_SUBJECT.EDITOR,
-      actionSubjectId: undefined,
+      actionSubjectId: this.actionSubjectId,
       eventType: EVENT_TYPE.OPERATIONAL,
       attributes
     };
@@ -154,7 +156,7 @@ export class Experience {
       const experienceSampledEvent = {
         action: ACTION.EXPERIENCE_SAMPLED,
         actionSubject: ACTION_SUBJECT.EDITOR,
-        actionSubjectId: undefined,
+        actionSubjectId: this.actionSubjectId,
         eventType: EVENT_TYPE.OPERATIONAL,
         attributes
       };

package/dist/es2019/hooks/usePluginStateEffect.js

@@ -79,6 +79,8 @@ export function usePluginStateEffect(injectionApi, plugins, effect, options = {}
     ...acc,
     [`${String(pluginName)}State`]: injectionApi === null || injectionApi === void 0 ? void 0 : injectionApi[pluginName]
   }), {}), [injectionApi, pluginNames]);
+
+  // @ts-ignore - Workaround for help-center local consumption
   usePluginStateEffectInternal(namedExternalPlugins, effect, options);
 }
 function usePluginStateEffectInternal(externalPlugins, effect, options = {}) {

package/dist/es2019/keymaps/keymap.js

@@ -14,6 +14,7 @@ import { SafePlugin } from '../safe-plugin';
 export function keymap(bindings) {
   return new SafePlugin({
     props: {
+      // @ts-ignore - Workaround for help-center local consumption
       handleKeyDown(view, event) {
         const name = keyName(event);
         let keyboardEvent = event;

package/dist/es2019/link/LinkSearch/index.js

@@ -220,4 +220,6 @@ class RecentLink extends React.Component {
 _defineProperty(RecentLink, "defaultProps", {
   limit: DEFAULT_ITEMS_LIMIT
 });
-export default withActivityProvider(injectIntl(RecentLink));
+export default withActivityProvider(
+// @ts-ignore - Workaround for help-center local consumption (prop type incompatibility)
+injectIntl(RecentLink));

package/dist/es2019/monitoring/error.js

@@ -1,7 +1,10 @@
+import { Integrations } from '@sentry/browser';
+import { fg } from '@atlaskit/platform-feature-flags';
 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 = "110.34.2";
+const packageVersion = "110.34.4";
 const sanitiseSentryEvents = (data, _hint) => {
   // Remove URL as it has UGC
   // Ignored via go/ees007
@@ -27,10 +30,23 @@ export const logException = async (error, tags) => {
     const {
       ExtraErrorData
     } = await import( /* webpackChunkName: "@atlaskit-internal_editor-sentryintegrations" */'@sentry/integrations');
+    const breadcrumbsIntegration = fg('platform_editor_sentry_breadcrumbs') ? new Integrations.Breadcrumbs({
+      // only enable breadcrumbs for dom (UI clicks and inputs)
+      // include 'data-test-id', 'data-testid' in the breadcrumbs if they are found
+      dom: {
+        serializeAttribute: SERIALIZABLE_ATTRIBUTES
+      },
+      fetch: false,
+      xhr: false,
+      console: false,
+      history: false,
+      sentry: false
+    }) : undefined;
     const sentryOptions = {
       dsn: isFedRamp() ? undefined : SENTRY_DSN,
       release: `${packageName}@${packageVersion}`,
       environment: (_process$env$CLOUD_EN = process.env.CLOUD_ENV) !== null && _process$env$CLOUD_EN !== void 0 ? _process$env$CLOUD_EN : 'unknown',
+      beforeBreadcrumb: fg('platform_editor_sentry_breadcrumbs') ? normaliseSentryBreadcrumbs : undefined,
       ignoreErrors: [
       // Network issues
       // Ignored via go/ees005
@@ -50,7 +66,7 @@ export const logException = async (error, tags) => {
       // https://docs.sentry.io/platforms/javascript/configuration/integrations/default/
       ...defaultIntegrations.filter(({
         name
-      }) => name !== 'Breadcrumbs'),
+      }) => name !== 'Breadcrumbs'), ...(breadcrumbsIntegration ? [breadcrumbsIntegration] : []),
       // Extracts all non-native attributes from the error object and attaches them to the event as the extra data
       // https://docs.sentry.io/platforms/javascript/configuration/integrations/plugin/?original_referrer=https%3A%2F%2Fduckduckgo.com%2F#extraerrordata
       new ExtraErrorData()],

package/dist/es2019/monitoring/normalise-sentry-breadcrumbs.js

@@ -0,0 +1,33 @@
+export const SERIALIZABLE_ATTRIBUTES = ['data-test-id', 'data-testid'];
+const WHITELISTED_ATTRIBNUTES = ['type', 'name', ...SERIALIZABLE_ATTRIBUTES];
+const REG_MATCH_NOTALLOWED_ATTRIBUTES = new RegExp(`\\[(?!${WHITELISTED_ATTRIBNUTES.join('|')}).*?\\]`, 'gmu');
+
+// attributes may contain UGC that we need to strip out
+// only allow type and name attributes
+const sanitiseUiBreadcrumbMessage = message => message.replace(REG_MATCH_NOTALLOWED_ATTRIBUTES, '');
+/**
+ * Sanitizes messages within UI category breadcrumbs to ensure user-generated content is
+ * appropriately cleaned before being logged by Sentry. This helps in maintaining
+ * privacy and security by preventing sensitive data exposure.
+ */
+export const normaliseSentryBreadcrumbs = breadcrumb => {
+  const {
+    category
+  } = breadcrumb || {};
+
+  // allow "ui*"" category breadcrumbs, that include clicks and inputs on DOM elements
+  // they may contain UGC that needs to be stripped out
+  if (category !== null && category !== void 0 && category.startsWith('ui')) {
+    // sentry can include the element attributes in the data
+    // which may contain UGC that we need to strip out
+    const sanitisedBreadCrumb = breadcrumb;
+    const {
+      message
+    } = sanitisedBreadCrumb;
+    if (message !== null && message !== undefined) {
+      sanitisedBreadCrumb.message = sanitiseUiBreadcrumbMessage(message);
+    }
+    return breadcrumb;
+  }
+  return breadcrumb;
+};

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 = "110.34.2";
+const packageVersion = "110.34.4";
 const halfFocusRing = 1;
 const dropOffset = '0, 8';
 const fadeIn = keyframes({

package/dist/es2019/utils/document.js

@@ -5,7 +5,10 @@ import { isEmptyParagraph } from './editor-core-utils';
 export const getStepRange = transaction => {
   let from = -1;
   let to = -1;
+
+  // @ts-ignore - Workaround for help-center local consumption
   transaction.mapping.maps.forEach((stepMap, index) => {
+    // @ts-ignore - Workaround for help-center local consumption
     stepMap.forEach((oldStart, oldEnd) => {
       const newStart = transaction.mapping.slice(index).map(oldStart, -1);
       const newEnd = transaction.mapping.slice(index).map(oldEnd);

package/dist/es2019/utils/plugin-state-factory.js

@@ -59,7 +59,11 @@ export function pluginFactory(pluginKey, reducer, options = {}) {
   return {
     createPluginState(dispatch, initialState) {
       return {
+        // @ts-ignore - Workaround for help-center local consumption
+
         init: (_, state) => isFunction(initialState) ? initialState(state) : initialState,
+        // @ts-ignore - Workaround for help-center local consumption
+
         apply: (tr, _pluginState, _oldEditorState, newEditorState) => {
           const oldPluginState = mapping ? mapping(tr, _pluginState, newEditorState) : _pluginState;
           let newPluginState = oldPluginState;

package/dist/esm/card/utils.js

@@ -19,6 +19,7 @@ export function addLinkMetadata(initialSelection, tr, metadata) {
   return tr;
 }
 export function getLinkMetadataFromTransaction(tr) {
+  // @ts-ignore - Workaround for help-center local consumption
   return tr.steps.reduce(function (metadata, step) {
     if (!(step instanceof LinkMetaStep)) {
       return metadata;

package/dist/esm/experiences/Experience.js

@@ -31,13 +31,14 @@ export var Experience = /*#__PURE__*/function () {
   /**
    * Creates a new Experience instance for tracking user experiences.
    *
-   * @param id - Unique identifier for the experience
+   * @param id - Unique identifier for the experience e.g. 'toolbar-open' 'menu-action'
    * @param options - Configuration options for the experience
    * @param options.checks - Experience checks to monitor for completion
    * @param options.dispatchAnalyticsEvent - Function to dispatch analytics events
    * @param options.sampleRate - Sample rate for experienceSampled events
    * @param options.metadata - Global metadata to attach to all events
-   * @param options.action - Optional sub identifier for the specific experience action
+   * @param options.action - Optional sub identifier for the specific experience action e.g. 'bold' 'insert-table'
+   * @param options.actionSubjectId - Optional sub identifier for the experience action subject e.g. 'selection-toolbar' 'quick-insert'
    */
   function Experience(id, options) {
     var _options$sampleRate;
@@ -50,6 +51,7 @@ export var Experience = /*#__PURE__*/function () {
      */
     _defineProperty(this, "statesSeen", new Set());
     this.id = id;
+    this.actionSubjectId = options.actionSubjectId;
     this.dispatchAnalyticsEvent = options.dispatchAnalyticsEvent;
     this.sampleRate = (_options$sampleRate = options.sampleRate) !== null && _options$sampleRate !== void 0 ? _options$sampleRate : DEFAULT_EXPERIENCE_SAMPLE_RATE;
     this.globalMetadata = _objectSpread(_objectSpread({}, options.metadata), {}, {
@@ -154,7 +156,7 @@ export var Experience = /*#__PURE__*/function () {
       var experienceMeasuredEvent = {
         action: ACTION.EXPERIENCE_MEASURED,
         actionSubject: ACTION_SUBJECT.EDITOR,
-        actionSubjectId: undefined,
+        actionSubjectId: this.actionSubjectId,
         eventType: EVENT_TYPE.OPERATIONAL,
         attributes: attributes
       };
@@ -163,7 +165,7 @@ export var Experience = /*#__PURE__*/function () {
         var experienceSampledEvent = {
           action: ACTION.EXPERIENCE_SAMPLED,
           actionSubject: ACTION_SUBJECT.EDITOR,
-          actionSubjectId: undefined,
+          actionSubjectId: this.actionSubjectId,
           eventType: EVENT_TYPE.OPERATIONAL,
           attributes: attributes
         };

package/dist/esm/hooks/usePluginStateEffect.js

@@ -89,6 +89,8 @@ export function usePluginStateEffect(injectionApi, plugins, effect) {
       return _objectSpread(_objectSpread({}, acc), {}, _defineProperty({}, "".concat(String(pluginName), "State"), injectionApi === null || injectionApi === void 0 ? void 0 : injectionApi[pluginName]));
     }, {});
   }, [injectionApi, pluginNames]);
+
+  // @ts-ignore - Workaround for help-center local consumption
   usePluginStateEffectInternal(namedExternalPlugins, effect, options);
 }
 function usePluginStateEffectInternal(externalPlugins, effect) {

package/dist/esm/keymaps/keymap.js

@@ -14,6 +14,7 @@ import { SafePlugin } from '../safe-plugin';
 export function keymap(bindings) {
   return new SafePlugin({
     props: {
+      // @ts-ignore - Workaround for help-center local consumption
       handleKeyDown: function handleKeyDown(view, event) {
         var name = keyName(event);
         var keyboardEvent = event;

package/dist/esm/link/LinkSearch/index.js

@@ -320,4 +320,6 @@ var RecentLink = /*#__PURE__*/function (_React$Component) {
 _defineProperty(RecentLink, "defaultProps", {
   limit: DEFAULT_ITEMS_LIMIT
 });
-export default withActivityProvider(injectIntl(RecentLink));
+export default withActivityProvider(
+// @ts-ignore - Workaround for help-center local consumption (prop type incompatibility)
+injectIntl(RecentLink));

package/dist/esm/monitoring/error.js

@@ -4,10 +4,13 @@ import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+import { Integrations } from '@sentry/browser';
+import { fg } from '@atlaskit/platform-feature-flags';
 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 = "110.34.2";
+var packageVersion = "110.34.4";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007
@@ -20,7 +23,7 @@ var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
 };
 export var logException = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(error, tags) {
-    var _process$env$CLOUD_EN, _yield$import, BrowserClient, defaultIntegrations, getCurrentHub, _yield$import2, ExtraErrorData, sentryOptions, client, hub;
+    var _process$env$CLOUD_EN, _yield$import, BrowserClient, defaultIntegrations, getCurrentHub, _yield$import2, ExtraErrorData, breadcrumbsIntegration, sentryOptions, client, hub;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
@@ -43,10 +46,23 @@ export var logException = /*#__PURE__*/function () {
         case 11:
           _yield$import2 = _context.sent;
           ExtraErrorData = _yield$import2.ExtraErrorData;
+          breadcrumbsIntegration = fg('platform_editor_sentry_breadcrumbs') ? new Integrations.Breadcrumbs({
+            // only enable breadcrumbs for dom (UI clicks and inputs)
+            // include 'data-test-id', 'data-testid' in the breadcrumbs if they are found
+            dom: {
+              serializeAttribute: SERIALIZABLE_ATTRIBUTES
+            },
+            fetch: false,
+            xhr: false,
+            console: false,
+            history: false,
+            sentry: false
+          }) : undefined;
           sentryOptions = {
             dsn: isFedRamp() ? undefined : SENTRY_DSN,
             release: "".concat(packageName, "@").concat(packageVersion),
             environment: (_process$env$CLOUD_EN = process.env.CLOUD_ENV) !== null && _process$env$CLOUD_EN !== void 0 ? _process$env$CLOUD_EN : 'unknown',
+            beforeBreadcrumb: fg('platform_editor_sentry_breadcrumbs') ? normaliseSentryBreadcrumbs : undefined,
             ignoreErrors: [
             // Network issues
             // Ignored via go/ees005
@@ -65,7 +81,7 @@ export var logException = /*#__PURE__*/function () {
               return [].concat(_toConsumableArray(defaultIntegrations.filter(function (_ref2) {
                 var name = _ref2.name;
                 return name !== 'Breadcrumbs';
-              })), [
+              })), _toConsumableArray(breadcrumbsIntegration ? [breadcrumbsIntegration] : []), [
               // Extracts all non-native attributes from the error object and attaches them to the event as the extra data
               // https://docs.sentry.io/platforms/javascript/configuration/integrations/plugin/?original_referrer=https%3A%2F%2Fduckduckgo.com%2F#extraerrordata
               new ExtraErrorData()]);
@@ -100,14 +116,14 @@ export var logException = /*#__PURE__*/function () {
 
           // @ts-ignore - TypeScript 5.9.2 upgrade
           return _context.abrupt("return", client.close());
-        case 21:
-          _context.prev = 21;
+        case 22:
+          _context.prev = 22;
           _context.t0 = _context["catch"](0);
-        case 23:
+        case 24:
         case "end":
           return _context.stop();
       }
-    }, _callee, null, [[0, 21]]);
+    }, _callee, null, [[0, 22]]);
   }));
   return function logException(_x, _x2) {
     return _ref.apply(this, arguments);

package/dist/esm/monitoring/normalise-sentry-breadcrumbs.js

@@ -0,0 +1,32 @@
+export var SERIALIZABLE_ATTRIBUTES = ['data-test-id', 'data-testid'];
+var WHITELISTED_ATTRIBNUTES = ['type', 'name'].concat(SERIALIZABLE_ATTRIBUTES);
+var REG_MATCH_NOTALLOWED_ATTRIBUTES = new RegExp("\\[(?!".concat(WHITELISTED_ATTRIBNUTES.join('|'), ").*?\\]"), 'gmu');
+
+// attributes may contain UGC that we need to strip out
+// only allow type and name attributes
+var sanitiseUiBreadcrumbMessage = function sanitiseUiBreadcrumbMessage(message) {
+  return message.replace(REG_MATCH_NOTALLOWED_ATTRIBUTES, '');
+};
+/**
+ * Sanitizes messages within UI category breadcrumbs to ensure user-generated content is
+ * appropriately cleaned before being logged by Sentry. This helps in maintaining
+ * privacy and security by preventing sensitive data exposure.
+ */
+export var normaliseSentryBreadcrumbs = function normaliseSentryBreadcrumbs(breadcrumb) {
+  var _ref = breadcrumb || {},
+    category = _ref.category;
+
+  // allow "ui*"" category breadcrumbs, that include clicks and inputs on DOM elements
+  // they may contain UGC that needs to be stripped out
+  if (category !== null && category !== void 0 && category.startsWith('ui')) {
+    // sentry can include the element attributes in the data
+    // which may contain UGC that we need to strip out
+    var sanitisedBreadCrumb = breadcrumb;
+    var message = sanitisedBreadCrumb.message;
+    if (message !== null && message !== undefined) {
+      sanitisedBreadCrumb.message = sanitiseUiBreadcrumbMessage(message);
+    }
+    return breadcrumb;
+  }
+  return breadcrumb;
+};

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 = "110.34.2";
+var packageVersion = "110.34.4";
 var halfFocusRing = 1;
 var dropOffset = '0, 8';
 var fadeIn = keyframes({

package/dist/esm/utils/document.js

@@ -5,7 +5,10 @@ import { isEmptyParagraph } from './editor-core-utils';
 export var getStepRange = function getStepRange(transaction) {
   var from = -1;
   var to = -1;
+
+  // @ts-ignore - Workaround for help-center local consumption
   transaction.mapping.maps.forEach(function (stepMap, index) {
+    // @ts-ignore - Workaround for help-center local consumption
     stepMap.forEach(function (oldStart, oldEnd) {
       var newStart = transaction.mapping.slice(index).map(oldStart, -1);
       var newEnd = transaction.mapping.slice(index).map(oldEnd);

package/dist/esm/utils/plugin-state-factory.js

@@ -58,9 +58,13 @@ export function pluginFactory(pluginKey, reducer) {
   return {
     createPluginState: function createPluginState(dispatch, initialState) {
       return {
+        // @ts-ignore - Workaround for help-center local consumption
+
         init: function init(_, state) {
           return isFunction(initialState) ? initialState(state) : initialState;
         },
+        // @ts-ignore - Workaround for help-center local consumption
+
         apply: function apply(tr, _pluginState, _oldEditorState, newEditorState) {
           var oldPluginState = mapping ? mapping(tr, _pluginState, newEditorState) : _pluginState;
           var newPluginState = oldPluginState;

package/dist/types/analytics/types/experience-events.d.ts

@@ -6,52 +6,52 @@ import type { OperationalAEP } from './utils';
  */
 export type ExperienceEventAttributes = CustomExperienceMetadata & {
     /**
-     * The unique key identifying the experience being tracked.
-     */
-    experienceKey: string;
-    /**
-     * The state the experience transitioned to.
-     */
-    experienceStatus: ExperienceState;
-    /**
-     * Whether this is the first transition to this status for this experience
-     * in the current editor session.
-     */
-    experienceStatusFirstSeen: boolean;
-    /**
-     * Timestamp when the experience started.
-     *
-     * Milliseconds since epoch.
+     * Optional action that triggered the experience, if applicable.
      */
-    experienceStartTime: number;
+    experienceAction?: string;
     /**
      * Duration from experience start to current status transition.
      *
      * Measured in milliseconds.
      */
     experienceDuration: number;
+    /**
+     * Optional reason for experience end, e.g., abort or failure reason.
+     */
+    experienceEndReason?: string;
+    /**
+     * The unique key identifying the experience being tracked.
+     */
+    experienceKey: string;
     /**
      * Optional method for experience start, e.g., how the experience was initiated.
      */
     experienceStartMethod?: string;
     /**
-     * Optional reason for experience end, e.g., abort or failure reason.
+     * Timestamp when the experience started.
+     *
+     * Milliseconds since epoch.
      */
-    experienceEndReason?: string;
+    experienceStartTime: number;
     /**
-     * Optional action that triggered the experience, if applicable.
+     * The state the experience transitioned to.
      */
-    experienceAction?: string;
+    experienceStatus: ExperienceState;
+    /**
+     * Whether this is the first transition to this status for this experience
+     * in the current editor session.
+     */
+    experienceStatusFirstSeen: boolean;
 };
 /**
  * Event fired on every successful experience state transition.
  * Used for data analysis in Databricks.
  */
-type ExperienceMeasuredAEP = OperationalAEP<ACTION.EXPERIENCE_MEASURED, ACTION_SUBJECT.EDITOR, undefined, ExperienceEventAttributes>;
+type ExperienceMeasuredAEP = OperationalAEP<ACTION.EXPERIENCE_MEASURED, ACTION_SUBJECT.EDITOR, string, ExperienceEventAttributes>;
 /**
  * Event fired on sampled experience state transitions (e.g., 1 in 1000).
  * Can be forwarded to Signal FX, Statsig, etc. for use in SLOs and defining experiment metrics.
  */
-type ExperienceSampledAEP = OperationalAEP<ACTION.EXPERIENCE_SAMPLED, ACTION_SUBJECT.EDITOR, undefined, ExperienceEventAttributes>;
+type ExperienceSampledAEP = OperationalAEP<ACTION.EXPERIENCE_SAMPLED, ACTION_SUBJECT.EDITOR, string, ExperienceEventAttributes>;
 export type ExperienceEventPayload = ExperienceMeasuredAEP | ExperienceSampledAEP;
 export {};

package/dist/types/experiences/Experience.d.ts

@@ -2,6 +2,18 @@ import type { DispatchAnalyticsEvent } from '../analytics';
 import type { ExperienceCheck } from './ExperienceCheck';
 import type { CustomExperienceMetadata } from './types';
 type ExperienceOptions = {
+    /**
+     * An optional sub identifier to further classify the specific experience action taken
+     *
+     * e.g. 'bold' 'bullet' 'insert-table'
+     */
+    action?: string;
+    /**
+     * An optional sub identifier to further classify the specific experience action subject
+     *
+     * e.g. 'selection-toolbar' 'quick-insert'
+     */
+    actionSubjectId?: string;
     /**
      * Checks used to control experience transition to various states.
      * Once the experience is in progress, these checks can automatically trigger
@@ -13,6 +25,12 @@ type ExperienceOptions = {
      * Required for tracking experienceMeasured and experienceSampled events.
      */
     dispatchAnalyticsEvent: DispatchAnalyticsEvent;
+    /**
+     * Optional global metadata to attach to all analytics events for this experience.
+     *
+     * Can be overridden by metadata provided in individual start/abort/fail/success calls.
+     */
+    metadata?: CustomExperienceMetadata;
     /**
      * Sample rate for experienceSampled events.
      * Determines how frequently we should track events for the experience based on
@@ -25,30 +43,19 @@ type ExperienceOptions = {
      * instrumentation, then the sample rate can be tuned up to a safe threshold.
      */
     sampleRate?: number;
-    /**
-     * Optional global metadata to attach to all analytics events for this experience.
-     *
-     * Can be overridden by metadata provided in individual start/abort/fail/success calls.
-     */
-    metadata?: CustomExperienceMetadata;
-    /**
-     * An optional sub identifier to further classify the specific experience action taken
-     *
-     * e.g. 'bold' 'bullet' 'insert-table'
-     */
-    action?: string;
 };
 type ExperienceStartOptions = {
+    forceRestart?: boolean;
     metadata?: CustomExperienceMetadata;
     method?: string;
-    forceRestart?: boolean;
 };
 type ExperienceEndOptions = {
-    reason?: string;
     metadata?: CustomExperienceMetadata;
+    reason?: string;
 };
 export declare class Experience {
     private readonly id;
+    private readonly actionSubjectId;
     private readonly dispatchAnalyticsEvent;
     private readonly sampleRate;
     private readonly globalMetadata;
@@ -83,13 +90,14 @@ export declare class Experience {
     /**
      * Creates a new Experience instance for tracking user experiences.
      *
-     * @param id - Unique identifier for the experience
+     * @param id - Unique identifier for the experience e.g. 'toolbar-open' 'menu-action'
      * @param options - Configuration options for the experience
      * @param options.checks - Experience checks to monitor for completion
      * @param options.dispatchAnalyticsEvent - Function to dispatch analytics events
      * @param options.sampleRate - Sample rate for experienceSampled events
      * @param options.metadata - Global metadata to attach to all events
-     * @param options.action - Optional sub identifier for the specific experience action
+     * @param options.action - Optional sub identifier for the specific experience action e.g. 'bold' 'insert-table'
+     * @param options.actionSubjectId - Optional sub identifier for the experience action subject e.g. 'selection-toolbar' 'quick-insert'
      */
     constructor(id: string, options: ExperienceOptions);
     private startCheck;

package/dist/types/monitoring/normalise-sentry-breadcrumbs.d.ts

@@ -0,0 +1,8 @@
+import type { Breadcrumb } from '@sentry/types';
+export declare const SERIALIZABLE_ATTRIBUTES: string[];
+/**
+ * Sanitizes messages within UI category breadcrumbs to ensure user-generated content is
+ * appropriately cleaned before being logged by Sentry. This helps in maintaining
+ * privacy and security by preventing sensitive data exposure.
+ */
+export declare const normaliseSentryBreadcrumbs: (breadcrumb: Breadcrumb) => Breadcrumb;

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

@@ -6,52 +6,52 @@ import type { OperationalAEP } from './utils';
  */
 export type ExperienceEventAttributes = CustomExperienceMetadata & {
     /**
-     * The unique key identifying the experience being tracked.
-     */
-    experienceKey: string;
-    /**
-     * The state the experience transitioned to.
-     */
-    experienceStatus: ExperienceState;
-    /**
-     * Whether this is the first transition to this status for this experience
-     * in the current editor session.
-     */
-    experienceStatusFirstSeen: boolean;
-    /**
-     * Timestamp when the experience started.
-     *
-     * Milliseconds since epoch.
+     * Optional action that triggered the experience, if applicable.
      */
-    experienceStartTime: number;
+    experienceAction?: string;
     /**
      * Duration from experience start to current status transition.
      *
      * Measured in milliseconds.
      */
     experienceDuration: number;
+    /**
+     * Optional reason for experience end, e.g., abort or failure reason.
+     */
+    experienceEndReason?: string;
+    /**
+     * The unique key identifying the experience being tracked.
+     */
+    experienceKey: string;
     /**
      * Optional method for experience start, e.g., how the experience was initiated.
      */
     experienceStartMethod?: string;
     /**
-     * Optional reason for experience end, e.g., abort or failure reason.
+     * Timestamp when the experience started.
+     *
+     * Milliseconds since epoch.
      */
-    experienceEndReason?: string;
+    experienceStartTime: number;
     /**
-     * Optional action that triggered the experience, if applicable.
+     * The state the experience transitioned to.
      */
-    experienceAction?: string;
+    experienceStatus: ExperienceState;
+    /**
+     * Whether this is the first transition to this status for this experience
+     * in the current editor session.
+     */
+    experienceStatusFirstSeen: boolean;
 };
 /**
  * Event fired on every successful experience state transition.
  * Used for data analysis in Databricks.
  */
-type ExperienceMeasuredAEP = OperationalAEP<ACTION.EXPERIENCE_MEASURED, ACTION_SUBJECT.EDITOR, undefined, ExperienceEventAttributes>;
+type ExperienceMeasuredAEP = OperationalAEP<ACTION.EXPERIENCE_MEASURED, ACTION_SUBJECT.EDITOR, string, ExperienceEventAttributes>;
 /**
  * Event fired on sampled experience state transitions (e.g., 1 in 1000).
  * Can be forwarded to Signal FX, Statsig, etc. for use in SLOs and defining experiment metrics.
  */
-type ExperienceSampledAEP = OperationalAEP<ACTION.EXPERIENCE_SAMPLED, ACTION_SUBJECT.EDITOR, undefined, ExperienceEventAttributes>;
+type ExperienceSampledAEP = OperationalAEP<ACTION.EXPERIENCE_SAMPLED, ACTION_SUBJECT.EDITOR, string, ExperienceEventAttributes>;
 export type ExperienceEventPayload = ExperienceMeasuredAEP | ExperienceSampledAEP;
 export {};

package/dist/types-ts4.5/experiences/Experience.d.ts

@@ -2,6 +2,18 @@ import type { DispatchAnalyticsEvent } from '../analytics';
 import type { ExperienceCheck } from './ExperienceCheck';
 import type { CustomExperienceMetadata } from './types';
 type ExperienceOptions = {
+    /**
+     * An optional sub identifier to further classify the specific experience action taken
+     *
+     * e.g. 'bold' 'bullet' 'insert-table'
+     */
+    action?: string;
+    /**
+     * An optional sub identifier to further classify the specific experience action subject
+     *
+     * e.g. 'selection-toolbar' 'quick-insert'
+     */
+    actionSubjectId?: string;
     /**
      * Checks used to control experience transition to various states.
      * Once the experience is in progress, these checks can automatically trigger
@@ -13,6 +25,12 @@ type ExperienceOptions = {
      * Required for tracking experienceMeasured and experienceSampled events.
      */
     dispatchAnalyticsEvent: DispatchAnalyticsEvent;
+    /**
+     * Optional global metadata to attach to all analytics events for this experience.
+     *
+     * Can be overridden by metadata provided in individual start/abort/fail/success calls.
+     */
+    metadata?: CustomExperienceMetadata;
     /**
      * Sample rate for experienceSampled events.
      * Determines how frequently we should track events for the experience based on
@@ -25,30 +43,19 @@ type ExperienceOptions = {
      * instrumentation, then the sample rate can be tuned up to a safe threshold.
      */
     sampleRate?: number;
-    /**
-     * Optional global metadata to attach to all analytics events for this experience.
-     *
-     * Can be overridden by metadata provided in individual start/abort/fail/success calls.
-     */
-    metadata?: CustomExperienceMetadata;
-    /**
-     * An optional sub identifier to further classify the specific experience action taken
-     *
-     * e.g. 'bold' 'bullet' 'insert-table'
-     */
-    action?: string;
 };
 type ExperienceStartOptions = {
+    forceRestart?: boolean;
     metadata?: CustomExperienceMetadata;
     method?: string;
-    forceRestart?: boolean;
 };
 type ExperienceEndOptions = {
-    reason?: string;
     metadata?: CustomExperienceMetadata;
+    reason?: string;
 };
 export declare class Experience {
     private readonly id;
+    private readonly actionSubjectId;
     private readonly dispatchAnalyticsEvent;
     private readonly sampleRate;
     private readonly globalMetadata;
@@ -83,13 +90,14 @@ export declare class Experience {
     /**
      * Creates a new Experience instance for tracking user experiences.
      *
-     * @param id - Unique identifier for the experience
+     * @param id - Unique identifier for the experience e.g. 'toolbar-open' 'menu-action'
      * @param options - Configuration options for the experience
      * @param options.checks - Experience checks to monitor for completion
      * @param options.dispatchAnalyticsEvent - Function to dispatch analytics events
      * @param options.sampleRate - Sample rate for experienceSampled events
      * @param options.metadata - Global metadata to attach to all events
-     * @param options.action - Optional sub identifier for the specific experience action
+     * @param options.action - Optional sub identifier for the specific experience action e.g. 'bold' 'insert-table'
+     * @param options.actionSubjectId - Optional sub identifier for the experience action subject e.g. 'selection-toolbar' 'quick-insert'
      */
     constructor(id: string, options: ExperienceOptions);
     private startCheck;

package/dist/types-ts4.5/monitoring/normalise-sentry-breadcrumbs.d.ts

@@ -0,0 +1,8 @@
+import type { Breadcrumb } from '@sentry/types';
+export declare const SERIALIZABLE_ATTRIBUTES: string[];
+/**
+ * Sanitizes messages within UI category breadcrumbs to ensure user-generated content is
+ * appropriately cleaned before being logged by Sentry. This helps in maintaining
+ * privacy and security by preventing sensitive data exposure.
+ */
+export declare const normaliseSentryBreadcrumbs: (breadcrumb: Breadcrumb) => Breadcrumb;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/editor-common",
-	"version": "110.34.3",
+	"version": "110.34.5",
 	"description": "A package that contains common classes and components for editor and renderer",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -263,6 +263,9 @@
 		},
 		"platform_editor_transform_invalid_media_width": {
 			"type": "boolean"
+		},
+		"platform_editor_sentry_breadcrumbs": {
+			"type": "boolean"
 		}
 	}
 }