@atlaskit/editor-common 110.25.0 → 110.25.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @atlaskit/editor-common
 
+## 110.25.1
+
+### Patch Changes
+
+- [`bedd622f2826d`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/bedd622f2826d) -
+  Fix sentry error where currentUserIntent state is undefined
+- [`373dccb169d0b`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/373dccb169d0b) -
+  ED-29654 Editor experience custom tracking
+- Updated dependencies
+
 ## 110.25.0
 
 ### Minor Changes

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

@@ -62,6 +62,8 @@ var ACTION = exports.ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["ENTERED"] = "entered";
   ACTION["ERROR"] = "error";
   ACTION["ERRORED"] = "errored";
+  ACTION["EXPERIENCE_MEASURED"] = "experienceMeasured";
+  ACTION["EXPERIENCE_SAMPLED"] = "experienceSampled";
   ACTION["EXPOSED"] = "exposed";
   ACTION["FAILED_TO_UNMOUNT"] = "failedToUnmount";
   ACTION["FAILED_TO_INSERT"] = "failedToInsert";

package/dist/cjs/analytics/types/experience-events.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/cjs/experiences/Experience.js

@@ -5,52 +5,51 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.Experience = void 0;
-var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/classCallCheck"));
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
-var _ufo = require("@atlaskit/ufo");
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _analytics = require("../analytics");
+var _consts = require("./consts");
+var _experienceState = require("./experience-state");
 var _ExperienceCheckComposite = require("./ExperienceCheckComposite");
 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 PROGRESS_STATES = [_ufo.UFOExperienceState.STARTED.id, _ufo.UFOExperienceState.IN_PROGRESS.id];
 var Experience = exports.Experience = /*#__PURE__*/function () {
-  function Experience(id) {
-    var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  /**
+   * Indicates whether sampled tracking is enabled for this current experience session.
+   *
+   * Set to true | false upon transitioning to 'started' state.
+   * When true, on subsequent transitions we fire experienceSampled events.
+   * Ensures that every tracked start has corresponding abort/fail/success tracked.
+   */
+
+  function Experience(id, options) {
+    var _options$sampleRate;
     (0, _classCallCheck2.default)(this, Experience);
+    (0, _defineProperty2.default)(this, "currentState", 'pending');
+    (0, _defineProperty2.default)(this, "statesSeen", new Set());
     this.id = id;
-    this.options = options;
-    this.check = new _ExperienceCheckComposite.ExperienceCheckComposite(this.options.checks || []);
+    this.dispatchAnalyticsEvent = options.dispatchAnalyticsEvent;
+    this.sampleRate = (_options$sampleRate = options.sampleRate) !== null && _options$sampleRate !== void 0 ? _options$sampleRate : _consts.DEFAULT_EXPERIENCE_SAMPLE_RATE;
+    this.check = new _ExperienceCheckComposite.ExperienceCheckComposite(options.checks || []);
   }
   return (0, _createClass2.default)(Experience, [{
-    key: "ufoExperience",
-    get: function get() {
-      if (!this._ufoExperience) {
-        this._ufoExperience = new _ufo.UFOExperience(this.id, {
-          type: _ufo.ExperienceTypes.Experience,
-          performanceType: _ufo.ExperiencePerformanceTypes.InlineResult,
-          platform: {
-            component: 'editor'
-          }
-        });
-      }
-      return this._ufoExperience;
-    }
-  }, {
     key: "startCheck",
     value: function startCheck() {
       var _this = this;
       this.stopCheck();
-      this.check.start(function (result) {
-        var metadata = result.metadata;
-        if (result.status === 'success') {
+      this.check.start(function (_ref) {
+        var status = _ref.status,
+          metadata = _ref.metadata;
+        if (status === 'success') {
           _this.success({
             metadata: metadata
           });
-        } else if (result.status === 'abort') {
+        } else if (status === 'abort') {
           _this.abort({
             metadata: metadata
           });
-        } else if (result.status === 'failure') {
+        } else if (status === 'failure') {
           _this.failure({
             metadata: metadata
           });
@@ -62,11 +61,6 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
     value: function stopCheck() {
       this.check.stop();
     }
-  }, {
-    key: "isInProgress",
-    value: function isInProgress() {
-      return PROGRESS_STATES.includes(this.ufoExperience.state.id);
-    }
   }, {
     key: "getEndStateConfig",
     value: function getEndStateConfig(options) {
@@ -76,11 +70,72 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
       };
     }
 
+    /**
+     * Transitions to a new experience state and tracks analytics events.
+     *
+     * Upon transition to each state, two events are tracked:
+     * - experienceMeasured: tracked on every successful transition, used for data analysis
+     * - experienceSampled: tracked only on 1 out of every N transitions based on sample rate
+     *
+     * @param toState - The target state to transition to
+     * @param metadata - Optional metadata to attach to the analytics events
+     * @returns true if transition was successful, false if invalid transition
+     */
+  }, {
+    key: "transitionTo",
+    value: function transitionTo(toState, metadata) {
+      if (!(0, _experienceState.canTransition)(this.currentState, toState)) {
+        return false;
+      }
+      this.statesSeen.add(toState);
+      this.currentState = toState;
+      if (toState === 'started') {
+        this.isSampledTrackingEnabled = Math.random() < this.sampleRate;
+      }
+      this.trackTransition(toState, metadata);
+      return true;
+    }
+
+    /**
+     * Tracks analytics events for a state transition.
+     *
+     * Fires both experienceMeasured (always) and experienceSampled (sampled) events.
+     *
+     * @param toState - The state that was transitioned to
+     * @param metadata - Metadata to include in the event, including firstInSession flag
+     */
+  }, {
+    key: "trackTransition",
+    value: function trackTransition(toState, metadata) {
+      var attributes = _objectSpread({
+        experienceKey: this.id,
+        experienceStatus: toState,
+        firstInSession: !this.statesSeen.has(toState)
+      }, metadata);
+      var experienceMeasuredEvent = {
+        action: _analytics.ACTION.EXPERIENCE_MEASURED,
+        actionSubject: _analytics.ACTION_SUBJECT.EDITOR,
+        actionSubjectId: undefined,
+        eventType: _analytics.EVENT_TYPE.OPERATIONAL,
+        attributes: attributes
+      };
+      this.dispatchAnalyticsEvent(experienceMeasuredEvent);
+      if (this.isSampledTrackingEnabled) {
+        var experienceSampledEvent = {
+          action: _analytics.ACTION.EXPERIENCE_SAMPLED,
+          actionSubject: _analytics.ACTION_SUBJECT.EDITOR,
+          actionSubjectId: undefined,
+          eventType: _analytics.EVENT_TYPE.OPERATIONAL,
+          attributes: attributes
+        };
+        this.dispatchAnalyticsEvent(experienceSampledEvent);
+      }
+    }
+
     /**
      * Starts tracking the experience and all checks which monitor for completion.
      *
-     * If the experience is already in progress, this will restart the checks.
-     * Metadata from options will be merged with any end state metadata.
+     * Metadata from options will be merged with metadata provided in subsequent events.
      *
      * @param options - Configuration for starting the experience
      * @param options.metadata - Optional metadata attached to all subsequent events for this started experience
@@ -89,8 +144,7 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
     key: "start",
     value: function start(options) {
       this.startOptions = options;
-      this.ufoExperience.start();
-      if (this.isInProgress()) {
+      if (this.transitionTo('started', options === null || options === void 0 ? void 0 : options.metadata)) {
         this.startCheck();
       }
     }
@@ -98,17 +152,17 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
     /**
      * Marks the experience as successful and stops any ongoing checks.
      *
-     * Use this when the experience completes as expected.
-     *
      * @param options - Configuration for the success event
      * @param options.metadata - Optional metadata attached to the success event
      */
   }, {
     key: "success",
     value: function success(options) {
-      this.stopCheck();
-      this.ufoExperience.success(this.getEndStateConfig(options));
-      this.startOptions = undefined;
+      var mergedConfig = this.getEndStateConfig(options);
+      if (this.transitionTo('succeeded', mergedConfig.metadata)) {
+        this.stopCheck();
+        this.startOptions = undefined;
+      }
     }
 
     /**
@@ -129,9 +183,11 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
   }, {
     key: "abort",
     value: function abort(options) {
-      this.stopCheck();
-      this.ufoExperience.abort(this.getEndStateConfig(options));
-      this.startOptions = undefined;
+      var mergedConfig = this.getEndStateConfig(options);
+      if (this.transitionTo('aborted', mergedConfig.metadata)) {
+        this.stopCheck();
+        this.startOptions = undefined;
+      }
     }
 
     /**
@@ -145,9 +201,11 @@ var Experience = exports.Experience = /*#__PURE__*/function () {
   }, {
     key: "failure",
     value: function failure(options) {
-      this.stopCheck();
-      this.ufoExperience.failure(this.getEndStateConfig(options));
-      this.startOptions = undefined;
+      var mergedConfig = this.getEndStateConfig(options);
+      if (this.transitionTo('failed', mergedConfig.metadata)) {
+        this.stopCheck();
+        this.startOptions = undefined;
+      }
     }
   }]);
 }();

package/dist/cjs/experiences/consts.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.EXPERIENCE_FAILURE_REASON = void 0;
+exports.EXPERIENCE_FAILURE_REASON = exports.DEFAULT_EXPERIENCE_SAMPLE_RATE = void 0;
 /**
  * Built-in failure reasons for experience checks
  *
@@ -23,4 +23,15 @@ var EXPERIENCE_FAILURE_REASON = exports.EXPERIENCE_FAILURE_REASON = {
    * Error occurred during DOM mutation check execution
    */
   DOM_MUTATION_CHECK_ERROR: 'dom-mutation-check-error'
-};
+};
+
+/**
+ * Default sample rate for experienceSampled events.
+ * Set to 1 in 1000 (0.001) to balance data collection with event volume.
+ *
+ * Newly defined experiences should use this default unless they have data
+ * to justify a different rate. The expectation is that measurements will be
+ * gathered after initial instrumentation, then the sample rate can be tuned
+ * up to a safe threshold.
+ */
+var DEFAULT_EXPERIENCE_SAMPLE_RATE = exports.DEFAULT_EXPERIENCE_SAMPLE_RATE = 0.001;

package/dist/cjs/experiences/experience-state.js

@@ -0,0 +1,32 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.canTransition = exports.EXPERIENCE_STATE_TRANSITIONS = void 0;
+/**
+ * Represents the state of an experience throughout its lifecycle.
+ */
+
+/**
+ * State transition map defining valid state transitions.
+ */
+var EXPERIENCE_STATE_TRANSITIONS = exports.EXPERIENCE_STATE_TRANSITIONS = {
+  pending: ['started'],
+  started: ['aborted', 'failed', 'succeeded'],
+  aborted: ['started'],
+  failed: ['started'],
+  succeeded: ['started']
+};
+
+/**
+ * Validates whether a state transition is allowed.
+ *
+ * @param fromState - The current state
+ * @param toState - The target state to transition to
+ * @returns true if the transition is valid, false otherwise
+ */
+var canTransition = exports.canTransition = function canTransition(fromState, toState) {
+  var _EXPERIENCE_STATE_TRA, _EXPERIENCE_STATE_TRA2;
+  return (_EXPERIENCE_STATE_TRA = (_EXPERIENCE_STATE_TRA2 = EXPERIENCE_STATE_TRANSITIONS[fromState]) === null || _EXPERIENCE_STATE_TRA2 === void 0 ? void 0 : _EXPERIENCE_STATE_TRA2.includes(toState)) !== null && _EXPERIENCE_STATE_TRA !== void 0 ? _EXPERIENCE_STATE_TRA : false;
+};

package/dist/cjs/monitoring/error.js

@@ -16,7 +16,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 = "110.24.3";
+var packageVersion = "110.25.0";
 var sanitiseSentryEvents = function sanitiseSentryEvents(data, _hint) {
   // Remove URL as it has UGC
   // Ignored via go/ees007

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

package/dist/cjs/user-intent/UserIntentPopupWrapper.js

@@ -20,7 +20,7 @@ var UserIntentPopupWrapper = exports.UserIntentPopupWrapper = function UserInten
     api === null || api === void 0 || api.core.actions.execute(api === null || api === void 0 || (_api$userIntent = api.userIntent) === null || _api$userIntent === void 0 ? void 0 : _api$userIntent.commands.setCurrentUserIntent((0, _expValEqualsNoExposure.expValEqualsNoExposure)('platform_editor_lovability_user_intent', 'isEnabled', true) ? userIntent : 'popupOpen'));
     return function () {
       var _api$userIntent2;
-      if (userIntent === (api === null || api === void 0 || (_api$userIntent2 = api.userIntent) === null || _api$userIntent2 === void 0 ? void 0 : _api$userIntent2.sharedState.currentState().currentUserIntent) && (0, _expValEqualsNoExposure.expValEqualsNoExposure)('platform_editor_lovability_user_intent', 'isEnabled', true)) {
+      if (userIntent === (api === null || api === void 0 || (_api$userIntent2 = api.userIntent) === null || _api$userIntent2 === void 0 || (_api$userIntent2 = _api$userIntent2.sharedState.currentState()) === null || _api$userIntent2 === void 0 ? void 0 : _api$userIntent2.currentUserIntent) && (0, _expValEqualsNoExposure.expValEqualsNoExposure)('platform_editor_lovability_user_intent', 'isEnabled', true)) {
         var _api$userIntent3;
         api === null || api === void 0 || api.core.actions.execute(api === null || api === void 0 || (_api$userIntent3 = api.userIntent) === null || _api$userIntent3 === void 0 ? void 0 : _api$userIntent3.commands.setCurrentUserIntent('default'));
       }

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

@@ -56,6 +56,8 @@ export let ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["ENTERED"] = "entered";
   ACTION["ERROR"] = "error";
   ACTION["ERRORED"] = "errored";
+  ACTION["EXPERIENCE_MEASURED"] = "experienceMeasured";
+  ACTION["EXPERIENCE_SAMPLED"] = "experienceSampled";
   ACTION["EXPOSED"] = "exposed";
   ACTION["FAILED_TO_UNMOUNT"] = "failedToUnmount";
   ACTION["FAILED_TO_INSERT"] = "failedToInsert";

package/dist/es2019/analytics/types/experience-events.js

@@ -0,0 +1 @@
+export {};

package/dist/es2019/experiences/Experience.js

@@ -1,39 +1,41 @@
-import { ExperiencePerformanceTypes, ExperienceTypes, UFOExperience, UFOExperienceState } from '@atlaskit/ufo';
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import { ACTION, ACTION_SUBJECT, EVENT_TYPE } from '../analytics';
+import { DEFAULT_EXPERIENCE_SAMPLE_RATE } from './consts';
+import { canTransition } from './experience-state';
 import { ExperienceCheckComposite } from './ExperienceCheckComposite';
-const PROGRESS_STATES = [UFOExperienceState.STARTED.id, UFOExperienceState.IN_PROGRESS.id];
 export class Experience {
-  constructor(id, options = {}) {
+  /**
+   * Indicates whether sampled tracking is enabled for this current experience session.
+   *
+   * Set to true | false upon transitioning to 'started' state.
+   * When true, on subsequent transitions we fire experienceSampled events.
+   * Ensures that every tracked start has corresponding abort/fail/success tracked.
+   */
+
+  constructor(id, options) {
+    var _options$sampleRate;
+    _defineProperty(this, "currentState", 'pending');
+    _defineProperty(this, "statesSeen", new Set());
     this.id = id;
-    this.options = options;
-    this.check = new ExperienceCheckComposite(this.options.checks || []);
-  }
-  get ufoExperience() {
-    if (!this._ufoExperience) {
-      this._ufoExperience = new UFOExperience(this.id, {
-        type: ExperienceTypes.Experience,
-        performanceType: ExperiencePerformanceTypes.InlineResult,
-        platform: {
-          component: 'editor'
-        }
-      });
-    }
-    return this._ufoExperience;
+    this.dispatchAnalyticsEvent = options.dispatchAnalyticsEvent;
+    this.sampleRate = (_options$sampleRate = options.sampleRate) !== null && _options$sampleRate !== void 0 ? _options$sampleRate : DEFAULT_EXPERIENCE_SAMPLE_RATE;
+    this.check = new ExperienceCheckComposite(options.checks || []);
   }
   startCheck() {
     this.stopCheck();
-    this.check.start(result => {
-      const {
-        metadata
-      } = result;
-      if (result.status === 'success') {
+    this.check.start(({
+      status,
+      metadata
+    }) => {
+      if (status === 'success') {
         this.success({
           metadata
         });
-      } else if (result.status === 'abort') {
+      } else if (status === 'abort') {
         this.abort({
           metadata
         });
-      } else if (result.status === 'failure') {
+      } else if (status === 'failure') {
         this.failure({
           metadata
         });
@@ -43,9 +45,6 @@ export class Experience {
   stopCheck() {
     this.check.stop();
   }
-  isInProgress() {
-    return PROGRESS_STATES.includes(this.ufoExperience.state.id);
-  }
   getEndStateConfig(options) {
     var _this$startOptions, _this$startOptions2;
     return {
@@ -56,19 +55,76 @@ export class Experience {
     };
   }
 
+  /**
+   * Transitions to a new experience state and tracks analytics events.
+   *
+   * Upon transition to each state, two events are tracked:
+   * - experienceMeasured: tracked on every successful transition, used for data analysis
+   * - experienceSampled: tracked only on 1 out of every N transitions based on sample rate
+   *
+   * @param toState - The target state to transition to
+   * @param metadata - Optional metadata to attach to the analytics events
+   * @returns true if transition was successful, false if invalid transition
+   */
+  transitionTo(toState, metadata) {
+    if (!canTransition(this.currentState, toState)) {
+      return false;
+    }
+    this.statesSeen.add(toState);
+    this.currentState = toState;
+    if (toState === 'started') {
+      this.isSampledTrackingEnabled = Math.random() < this.sampleRate;
+    }
+    this.trackTransition(toState, metadata);
+    return true;
+  }
+
+  /**
+   * Tracks analytics events for a state transition.
+   *
+   * Fires both experienceMeasured (always) and experienceSampled (sampled) events.
+   *
+   * @param toState - The state that was transitioned to
+   * @param metadata - Metadata to include in the event, including firstInSession flag
+   */
+  trackTransition(toState, metadata) {
+    const attributes = {
+      experienceKey: this.id,
+      experienceStatus: toState,
+      firstInSession: !this.statesSeen.has(toState),
+      ...metadata
+    };
+    const experienceMeasuredEvent = {
+      action: ACTION.EXPERIENCE_MEASURED,
+      actionSubject: ACTION_SUBJECT.EDITOR,
+      actionSubjectId: undefined,
+      eventType: EVENT_TYPE.OPERATIONAL,
+      attributes
+    };
+    this.dispatchAnalyticsEvent(experienceMeasuredEvent);
+    if (this.isSampledTrackingEnabled) {
+      const experienceSampledEvent = {
+        action: ACTION.EXPERIENCE_SAMPLED,
+        actionSubject: ACTION_SUBJECT.EDITOR,
+        actionSubjectId: undefined,
+        eventType: EVENT_TYPE.OPERATIONAL,
+        attributes
+      };
+      this.dispatchAnalyticsEvent(experienceSampledEvent);
+    }
+  }
+
   /**
    * Starts tracking the experience and all checks which monitor for completion.
    *
-   * If the experience is already in progress, this will restart the checks.
-   * Metadata from options will be merged with any end state metadata.
+   * Metadata from options will be merged with metadata provided in subsequent events.
    *
    * @param options - Configuration for starting the experience
    * @param options.metadata - Optional metadata attached to all subsequent events for this started experience
    */
   start(options) {
     this.startOptions = options;
-    this.ufoExperience.start();
-    if (this.isInProgress()) {
+    if (this.transitionTo('started', options === null || options === void 0 ? void 0 : options.metadata)) {
       this.startCheck();
     }
   }
@@ -76,15 +132,15 @@ export class Experience {
   /**
    * Marks the experience as successful and stops any ongoing checks.
    *
-   * Use this when the experience completes as expected.
-   *
    * @param options - Configuration for the success event
    * @param options.metadata - Optional metadata attached to the success event
    */
   success(options) {
-    this.stopCheck();
-    this.ufoExperience.success(this.getEndStateConfig(options));
-    this.startOptions = undefined;
+    const mergedConfig = this.getEndStateConfig(options);
+    if (this.transitionTo('succeeded', mergedConfig.metadata)) {
+      this.stopCheck();
+      this.startOptions = undefined;
+    }
   }
 
   /**
@@ -103,9 +159,11 @@ export class Experience {
    * }, []);
    */
   abort(options) {
-    this.stopCheck();
-    this.ufoExperience.abort(this.getEndStateConfig(options));
-    this.startOptions = undefined;
+    const mergedConfig = this.getEndStateConfig(options);
+    if (this.transitionTo('aborted', mergedConfig.metadata)) {
+      this.stopCheck();
+      this.startOptions = undefined;
+    }
   }
 
   /**
@@ -117,8 +175,10 @@ export class Experience {
    * @param options.metadata - Optional metadata attached to the failure event
    */
   failure(options) {
-    this.stopCheck();
-    this.ufoExperience.failure(this.getEndStateConfig(options));
-    this.startOptions = undefined;
+    const mergedConfig = this.getEndStateConfig(options);
+    if (this.transitionTo('failed', mergedConfig.metadata)) {
+      this.stopCheck();
+      this.startOptions = undefined;
+    }
   }
 }

package/dist/es2019/experiences/consts.js

@@ -17,4 +17,15 @@ export const EXPERIENCE_FAILURE_REASON = {
    * Error occurred during DOM mutation check execution
    */
   DOM_MUTATION_CHECK_ERROR: 'dom-mutation-check-error'
-};
+};
+
+/**
+ * Default sample rate for experienceSampled events.
+ * Set to 1 in 1000 (0.001) to balance data collection with event volume.
+ *
+ * Newly defined experiences should use this default unless they have data
+ * to justify a different rate. The expectation is that measurements will be
+ * gathered after initial instrumentation, then the sample rate can be tuned
+ * up to a safe threshold.
+ */
+export const DEFAULT_EXPERIENCE_SAMPLE_RATE = 0.001;

package/dist/es2019/experiences/experience-state.js

@@ -0,0 +1,26 @@
+/**
+ * Represents the state of an experience throughout its lifecycle.
+ */
+
+/**
+ * State transition map defining valid state transitions.
+ */
+export const EXPERIENCE_STATE_TRANSITIONS = {
+  pending: ['started'],
+  started: ['aborted', 'failed', 'succeeded'],
+  aborted: ['started'],
+  failed: ['started'],
+  succeeded: ['started']
+};
+
+/**
+ * Validates whether a state transition is allowed.
+ *
+ * @param fromState - The current state
+ * @param toState - The target state to transition to
+ * @returns true if the transition is valid, false otherwise
+ */
+export const canTransition = (fromState, toState) => {
+  var _EXPERIENCE_STATE_TRA, _EXPERIENCE_STATE_TRA2;
+  return (_EXPERIENCE_STATE_TRA = (_EXPERIENCE_STATE_TRA2 = EXPERIENCE_STATE_TRANSITIONS[fromState]) === null || _EXPERIENCE_STATE_TRA2 === void 0 ? void 0 : _EXPERIENCE_STATE_TRA2.includes(toState)) !== null && _EXPERIENCE_STATE_TRA !== void 0 ? _EXPERIENCE_STATE_TRA : false;
+};

package/dist/es2019/monitoring/error.js

@@ -1,7 +1,7 @@
 import { isFedRamp } from './environment';
 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.24.3";
+const packageVersion = "110.25.0";
 const sanitiseSentryEvents = (data, _hint) => {
   // Remove URL as it has UGC
   // Ignored via go/ees007

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

package/dist/es2019/user-intent/UserIntentPopupWrapper.js

@@ -13,8 +13,8 @@ export const UserIntentPopupWrapper = ({
     var _api$userIntent;
     api === null || api === void 0 ? void 0 : api.core.actions.execute(api === null || api === void 0 ? void 0 : (_api$userIntent = api.userIntent) === null || _api$userIntent === void 0 ? void 0 : _api$userIntent.commands.setCurrentUserIntent(expValEqualsNoExposure('platform_editor_lovability_user_intent', 'isEnabled', true) ? userIntent : 'popupOpen'));
     return () => {
-      var _api$userIntent2;
-      if (userIntent === (api === null || api === void 0 ? void 0 : (_api$userIntent2 = api.userIntent) === null || _api$userIntent2 === void 0 ? void 0 : _api$userIntent2.sharedState.currentState().currentUserIntent) && expValEqualsNoExposure('platform_editor_lovability_user_intent', 'isEnabled', true)) {
+      var _api$userIntent2, _api$userIntent2$shar;
+      if (userIntent === (api === null || api === void 0 ? void 0 : (_api$userIntent2 = api.userIntent) === null || _api$userIntent2 === void 0 ? void 0 : (_api$userIntent2$shar = _api$userIntent2.sharedState.currentState()) === null || _api$userIntent2$shar === void 0 ? void 0 : _api$userIntent2$shar.currentUserIntent) && expValEqualsNoExposure('platform_editor_lovability_user_intent', 'isEnabled', true)) {
         var _api$userIntent3;
         api === null || api === void 0 ? void 0 : api.core.actions.execute(api === null || api === void 0 ? void 0 : (_api$userIntent3 = api.userIntent) === null || _api$userIntent3 === void 0 ? void 0 : _api$userIntent3.commands.setCurrentUserIntent('default'));
       }

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

@@ -56,6 +56,8 @@ export var ACTION = /*#__PURE__*/function (ACTION) {
   ACTION["ENTERED"] = "entered";
   ACTION["ERROR"] = "error";
   ACTION["ERRORED"] = "errored";
+  ACTION["EXPERIENCE_MEASURED"] = "experienceMeasured";
+  ACTION["EXPERIENCE_SAMPLED"] = "experienceSampled";
   ACTION["EXPOSED"] = "exposed";
   ACTION["FAILED_TO_UNMOUNT"] = "failedToUnmount";
   ACTION["FAILED_TO_INSERT"] = "failedToInsert";