@metamask-previews/analytics-controller 1.0.1-preview-4678f2f94 → 1.0.1-preview-784cc181c

package/CHANGELOG.md

@@ -9,8 +9,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Optional persisted event queue support in `AnalyticsController`, disabled by default. ([#8797](https://github.com/MetaMask/core/pull/8797))
-- Add optional analytics context on `trackEvent`, `identify`, and `trackView` to forward platform-specific context to `AnalyticsPlatformAdapter` implementations ([#8835](https://github.com/MetaMask/core/pull/8835))
 - Optional `skipUUIDv4Check` on `AnalyticsPlatformAdapter` to allow non-UUIDv4 `analyticsId` strings when constructing `AnalyticsController` ([#8543](https://github.com/MetaMask/core/pull/8543))
 
 ### Changed

package/README.md

@@ -20,7 +20,6 @@ The AnalyticsController provides a unified interface for tracking analytics even
 | ------------- | --------- | --------------------------------------------- | --------- |
 | `analyticsId` | `string`  | UUIDv4 identifier (client platform-generated) | Yes       |
 | `optedIn`     | `boolean` | User opt-in status                            | Yes       |
-| `eventQueue`  | `object`  | Optional persisted delivery queue             | Yes       |
 
 ### Client Platform Responsibilities
 
@@ -38,14 +37,6 @@ When `isAnonymousEventsFeatureEnabled` is enabled in the constructor, events wit
 
 This allows sensitive data to be tracked anonymously while maintaining user identification for regular properties. When disabled (default), all properties are tracked in a single event.
 
-## Persisted Event Queue
-
-When `isEventQueuePersistenceEnabled` is enabled in the constructor, each final platform adapter payload is persisted until the adapter reports successful delivery through its callback.
-
-This feature is disabled by default. Client platforms that already rely on SDK-level persistence, such as MetaMask Mobile through `@segment/analytics-react-native`'s `storePersistor` option, should leave it disabled.
-
-Platforms without SDK-level persistence, such as MetaMask Extension, can enable it to replay queued payloads after restart. The queue stores the final adapter calls, so anonymous event splitting persists the identified and anonymous payloads separately.
-
 ## Lifecycle Hooks
 
 ### `onSetupCompleted`

package/dist/AnalyticsController-method-action-types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsController-method-action-types.cjs","sourceRoot":"","sources":["../src/AnalyticsController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AnalyticsController } from './AnalyticsController';\n\n/**\n * Track an analytics event.\n *\n * Events are only tracked if analytics is enabled.\n *\n * @param event - Analytics event with properties and sensitive properties\n * @param context - Optional platform-specific context forwarded to the platform adapter.\n */\nexport type AnalyticsControllerTrackEventAction = {\n  type: `AnalyticsController:trackEvent`;\n  handler: AnalyticsController['trackEvent'];\n};\n\n/**\n * Identify a user for analytics.\n *\n * @param traits - User traits/properties\n * @param context - Optional platform-specific context forwarded to the platform adapter.\n */\nexport type AnalyticsControllerIdentifyAction = {\n  type: `AnalyticsController:identify`;\n  handler: AnalyticsController['identify'];\n};\n\n/**\n * Track a page or screen view.\n *\n * @param name - The identifier/name of the page or screen being viewed (e.g., \"home\", \"settings\", \"wallet\")\n * @param properties - Optional properties associated with the view\n * @param context - Optional platform-specific context forwarded to the platform adapter.\n */\nexport type AnalyticsControllerTrackViewAction = {\n  type: `AnalyticsController:trackView`;\n  handler: AnalyticsController['trackView'];\n};\n\n/**\n * Opt in to analytics.\n */\nexport type AnalyticsControllerOptInAction = {\n  type: `AnalyticsController:optIn`;\n  handler: AnalyticsController['optIn'];\n};\n\n/**\n * Opt out of analytics.\n */\nexport type AnalyticsControllerOptOutAction = {\n  type: `AnalyticsController:optOut`;\n  handler: AnalyticsController['optOut'];\n};\n\n/**\n * Union of all AnalyticsController action types.\n */\nexport type AnalyticsControllerMethodActions =\n  | AnalyticsControllerTrackEventAction\n  | AnalyticsControllerIdentifyAction\n  | AnalyticsControllerTrackViewAction\n  | AnalyticsControllerOptInAction\n  | AnalyticsControllerOptOutAction;\n"]}
+{"version":3,"file":"AnalyticsController-method-action-types.cjs","sourceRoot":"","sources":["../src/AnalyticsController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AnalyticsController } from './AnalyticsController';\n\n/**\n * Track an analytics event.\n *\n * Events are only tracked if analytics is enabled.\n *\n * @param event - Analytics event with properties and sensitive properties\n */\nexport type AnalyticsControllerTrackEventAction = {\n  type: `AnalyticsController:trackEvent`;\n  handler: AnalyticsController['trackEvent'];\n};\n\n/**\n * Identify a user for analytics.\n *\n * @param traits - User traits/properties\n */\nexport type AnalyticsControllerIdentifyAction = {\n  type: `AnalyticsController:identify`;\n  handler: AnalyticsController['identify'];\n};\n\n/**\n * Track a page or screen view.\n *\n * @param name - The identifier/name of the page or screen being viewed (e.g., \"home\", \"settings\", \"wallet\")\n * @param properties - Optional properties associated with the view\n */\nexport type AnalyticsControllerTrackViewAction = {\n  type: `AnalyticsController:trackView`;\n  handler: AnalyticsController['trackView'];\n};\n\n/**\n * Opt in to analytics.\n */\nexport type AnalyticsControllerOptInAction = {\n  type: `AnalyticsController:optIn`;\n  handler: AnalyticsController['optIn'];\n};\n\n/**\n * Opt out of analytics.\n */\nexport type AnalyticsControllerOptOutAction = {\n  type: `AnalyticsController:optOut`;\n  handler: AnalyticsController['optOut'];\n};\n\n/**\n * Union of all AnalyticsController action types.\n */\nexport type AnalyticsControllerMethodActions =\n  | AnalyticsControllerTrackEventAction\n  | AnalyticsControllerIdentifyAction\n  | AnalyticsControllerTrackViewAction\n  | AnalyticsControllerOptInAction\n  | AnalyticsControllerOptOutAction;\n"]}

package/dist/AnalyticsController-method-action-types.d.cts

@@ -9,7 +9,6 @@ import type { AnalyticsController } from "./AnalyticsController.cjs";
  * Events are only tracked if analytics is enabled.
  *
  * @param event - Analytics event with properties and sensitive properties
- * @param context - Optional platform-specific context forwarded to the platform adapter.
  */
 export type AnalyticsControllerTrackEventAction = {
     type: `AnalyticsController:trackEvent`;
@@ -19,7 +18,6 @@ export type AnalyticsControllerTrackEventAction = {
  * Identify a user for analytics.
  *
  * @param traits - User traits/properties
- * @param context - Optional platform-specific context forwarded to the platform adapter.
  */
 export type AnalyticsControllerIdentifyAction = {
     type: `AnalyticsController:identify`;
@@ -30,7 +28,6 @@ export type AnalyticsControllerIdentifyAction = {
  *
  * @param name - The identifier/name of the page or screen being viewed (e.g., "home", "settings", "wallet")
  * @param properties - Optional properties associated with the view
- * @param context - Optional platform-specific context forwarded to the platform adapter.
  */
 export type AnalyticsControllerTrackViewAction = {
     type: `AnalyticsController:trackView`;

package/dist/AnalyticsController-method-action-types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsController-method-action-types.d.cts","sourceRoot":"","sources":["../src/AnalyticsController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kCAA8B;AAEjE;;;;;;;GAOG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gCAAgC,GACxC,mCAAmC,GACnC,iCAAiC,GACjC,kCAAkC,GAClC,8BAA8B,GAC9B,+BAA+B,CAAC"}
+{"version":3,"file":"AnalyticsController-method-action-types.d.cts","sourceRoot":"","sources":["../src/AnalyticsController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kCAA8B;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gCAAgC,GACxC,mCAAmC,GACnC,iCAAiC,GACjC,kCAAkC,GAClC,8BAA8B,GAC9B,+BAA+B,CAAC"}

package/dist/AnalyticsController-method-action-types.d.mts

@@ -9,7 +9,6 @@ import type { AnalyticsController } from "./AnalyticsController.mjs";
  * Events are only tracked if analytics is enabled.
  *
  * @param event - Analytics event with properties and sensitive properties
- * @param context - Optional platform-specific context forwarded to the platform adapter.
  */
 export type AnalyticsControllerTrackEventAction = {
     type: `AnalyticsController:trackEvent`;
@@ -19,7 +18,6 @@ export type AnalyticsControllerTrackEventAction = {
  * Identify a user for analytics.
  *
  * @param traits - User traits/properties
- * @param context - Optional platform-specific context forwarded to the platform adapter.
  */
 export type AnalyticsControllerIdentifyAction = {
     type: `AnalyticsController:identify`;
@@ -30,7 +28,6 @@ export type AnalyticsControllerIdentifyAction = {
  *
  * @param name - The identifier/name of the page or screen being viewed (e.g., "home", "settings", "wallet")
  * @param properties - Optional properties associated with the view
- * @param context - Optional platform-specific context forwarded to the platform adapter.
  */
 export type AnalyticsControllerTrackViewAction = {
     type: `AnalyticsController:trackView`;

package/dist/AnalyticsController-method-action-types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsController-method-action-types.d.mts","sourceRoot":"","sources":["../src/AnalyticsController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kCAA8B;AAEjE;;;;;;;GAOG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gCAAgC,GACxC,mCAAmC,GACnC,iCAAiC,GACjC,kCAAkC,GAClC,8BAA8B,GAC9B,+BAA+B,CAAC"}
+{"version":3,"file":"AnalyticsController-method-action-types.d.mts","sourceRoot":"","sources":["../src/AnalyticsController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,kCAA8B;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gCAAgC,GACxC,mCAAmC,GACnC,iCAAiC,GACjC,kCAAkC,GAClC,8BAA8B,GAC9B,+BAA+B,CAAC"}

package/dist/AnalyticsController-method-action-types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsController-method-action-types.mjs","sourceRoot":"","sources":["../src/AnalyticsController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AnalyticsController } from './AnalyticsController';\n\n/**\n * Track an analytics event.\n *\n * Events are only tracked if analytics is enabled.\n *\n * @param event - Analytics event with properties and sensitive properties\n * @param context - Optional platform-specific context forwarded to the platform adapter.\n */\nexport type AnalyticsControllerTrackEventAction = {\n  type: `AnalyticsController:trackEvent`;\n  handler: AnalyticsController['trackEvent'];\n};\n\n/**\n * Identify a user for analytics.\n *\n * @param traits - User traits/properties\n * @param context - Optional platform-specific context forwarded to the platform adapter.\n */\nexport type AnalyticsControllerIdentifyAction = {\n  type: `AnalyticsController:identify`;\n  handler: AnalyticsController['identify'];\n};\n\n/**\n * Track a page or screen view.\n *\n * @param name - The identifier/name of the page or screen being viewed (e.g., \"home\", \"settings\", \"wallet\")\n * @param properties - Optional properties associated with the view\n * @param context - Optional platform-specific context forwarded to the platform adapter.\n */\nexport type AnalyticsControllerTrackViewAction = {\n  type: `AnalyticsController:trackView`;\n  handler: AnalyticsController['trackView'];\n};\n\n/**\n * Opt in to analytics.\n */\nexport type AnalyticsControllerOptInAction = {\n  type: `AnalyticsController:optIn`;\n  handler: AnalyticsController['optIn'];\n};\n\n/**\n * Opt out of analytics.\n */\nexport type AnalyticsControllerOptOutAction = {\n  type: `AnalyticsController:optOut`;\n  handler: AnalyticsController['optOut'];\n};\n\n/**\n * Union of all AnalyticsController action types.\n */\nexport type AnalyticsControllerMethodActions =\n  | AnalyticsControllerTrackEventAction\n  | AnalyticsControllerIdentifyAction\n  | AnalyticsControllerTrackViewAction\n  | AnalyticsControllerOptInAction\n  | AnalyticsControllerOptOutAction;\n"]}
+{"version":3,"file":"AnalyticsController-method-action-types.mjs","sourceRoot":"","sources":["../src/AnalyticsController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { AnalyticsController } from './AnalyticsController';\n\n/**\n * Track an analytics event.\n *\n * Events are only tracked if analytics is enabled.\n *\n * @param event - Analytics event with properties and sensitive properties\n */\nexport type AnalyticsControllerTrackEventAction = {\n  type: `AnalyticsController:trackEvent`;\n  handler: AnalyticsController['trackEvent'];\n};\n\n/**\n * Identify a user for analytics.\n *\n * @param traits - User traits/properties\n */\nexport type AnalyticsControllerIdentifyAction = {\n  type: `AnalyticsController:identify`;\n  handler: AnalyticsController['identify'];\n};\n\n/**\n * Track a page or screen view.\n *\n * @param name - The identifier/name of the page or screen being viewed (e.g., \"home\", \"settings\", \"wallet\")\n * @param properties - Optional properties associated with the view\n */\nexport type AnalyticsControllerTrackViewAction = {\n  type: `AnalyticsController:trackView`;\n  handler: AnalyticsController['trackView'];\n};\n\n/**\n * Opt in to analytics.\n */\nexport type AnalyticsControllerOptInAction = {\n  type: `AnalyticsController:optIn`;\n  handler: AnalyticsController['optIn'];\n};\n\n/**\n * Opt out of analytics.\n */\nexport type AnalyticsControllerOptOutAction = {\n  type: `AnalyticsController:optOut`;\n  handler: AnalyticsController['optOut'];\n};\n\n/**\n * Union of all AnalyticsController action types.\n */\nexport type AnalyticsControllerMethodActions =\n  | AnalyticsControllerTrackEventAction\n  | AnalyticsControllerIdentifyAction\n  | AnalyticsControllerTrackViewAction\n  | AnalyticsControllerOptInAction\n  | AnalyticsControllerOptOutAction;\n"]}

package/dist/AnalyticsController.cjs

@@ -10,12 +10,10 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _AnalyticsController_instances, _AnalyticsController_platformAdapter, _AnalyticsController_isAnonymousEventsFeatureEnabled, _AnalyticsController_isEventQueuePersistenceEnabled, _AnalyticsController_initialized, _AnalyticsController_sendOrQueueTrackEvent, _AnalyticsController_sendOrQueueIdentifyEvent, _AnalyticsController_sendOrQueueViewEvent, _AnalyticsController_enqueueEvent, _AnalyticsController_sendQueuedEvent, _AnalyticsController_replayQueuedEvents, _AnalyticsController_removeQueuedEvent, _AnalyticsController_clearQueuedEvents;
+var _AnalyticsController_platformAdapter, _AnalyticsController_isAnonymousEventsFeatureEnabled, _AnalyticsController_initialized;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AnalyticsController = exports.getDefaultAnalyticsControllerState = exports.controllerName = void 0;
 const base_controller_1 = require("@metamask/base-controller");
-const lodash_1 = require("lodash");
-const uuid_1 = require("uuid");
 const analyticsControllerStateValidator_1 = require("./analyticsControllerStateValidator.cjs");
 const AnalyticsLogger_1 = require("./AnalyticsLogger.cjs");
 const selectors_1 = require("./selectors.cjs");
@@ -59,12 +57,6 @@ const analyticsControllerMetadata = {
         includeInDebugSnapshot: true,
         usedInUi: false,
     },
-    eventQueue: {
-        includeInStateLogs: false,
-        persist: true,
-        includeInDebugSnapshot: false,
-        usedInUi: false,
-    },
 };
 // === MESSENGER ===
 const MESSENGER_EXPOSED_METHODS = [
@@ -74,46 +66,6 @@ const MESSENGER_EXPOSED_METHODS = [
     'optIn',
     'optOut',
 ];
-/**
- * Returns whether a value is a non-array object.
- *
- * @param value - The value to check.
- * @returns True if the value is a record.
- */
-function isRecord(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
-}
-/**
- * Returns whether a value is a valid persisted analytics event.
- *
- * @param value - The value to check.
- * @returns True if the value is a queued analytics event.
- */
-function isAnalyticsQueuedEvent(value) {
-    if (!isRecord(value)) {
-        return false;
-    }
-    if (typeof value.messageId !== 'string' ||
-        typeof value.timestamp !== 'string') {
-        return false;
-    }
-    if (value.type === 'track') {
-        return (typeof value.eventName === 'string' &&
-            (value.properties === undefined || isRecord(value.properties)) &&
-            (value.context === undefined || isRecord(value.context)));
-    }
-    if (value.type === 'identify') {
-        return (typeof value.userId === 'string' &&
-            (value.traits === undefined || isRecord(value.traits)) &&
-            (value.context === undefined || isRecord(value.context)));
-    }
-    if (value.type === 'view') {
-        return (typeof value.name === 'string' &&
-            (value.properties === undefined || isRecord(value.properties)) &&
-            (value.context === undefined || isRecord(value.context)));
-    }
-    return false;
-}
 /**
  * The AnalyticsController manages analytics tracking across platforms (Mobile/Extension).
  * It provides a unified interface for tracking events, identifying users, and managing
@@ -137,11 +89,10 @@ class AnalyticsController extends base_controller_1.BaseController {
      * @param options.messenger - Messenger used to communicate with BaseController
      * @param options.platformAdapter - Platform adapter implementation for tracking
      * @param options.isAnonymousEventsFeatureEnabled - Whether the anonymous events feature is enabled
-     * @param options.isEventQueuePersistenceEnabled - Whether analytics event queue persistence is enabled
      * @throws Error if state.analyticsId is missing or not a valid UUIDv4
      * @remarks After construction, call {@link AnalyticsController.init} to complete initialization.
      */
-    constructor({ state, messenger, platformAdapter, isAnonymousEventsFeatureEnabled = false, isEventQueuePersistenceEnabled = false, }) {
+    constructor({ state, messenger, platformAdapter, isAnonymousEventsFeatureEnabled = false, }) {
         const initialState = {
             ...getDefaultAnalyticsControllerState(),
             ...state,
@@ -153,13 +104,10 @@ class AnalyticsController extends base_controller_1.BaseController {
             state: initialState,
             messenger,
         });
-        _AnalyticsController_instances.add(this);
         _AnalyticsController_platformAdapter.set(this, void 0);
         _AnalyticsController_isAnonymousEventsFeatureEnabled.set(this, void 0);
-        _AnalyticsController_isEventQueuePersistenceEnabled.set(this, void 0);
         _AnalyticsController_initialized.set(this, void 0);
         __classPrivateFieldSet(this, _AnalyticsController_isAnonymousEventsFeatureEnabled, isAnonymousEventsFeatureEnabled, "f");
-        __classPrivateFieldSet(this, _AnalyticsController_isEventQueuePersistenceEnabled, isEventQueuePersistenceEnabled, "f");
         __classPrivateFieldSet(this, _AnalyticsController_platformAdapter, platformAdapter, "f");
         __classPrivateFieldSet(this, _AnalyticsController_initialized, false, "f");
         this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
@@ -167,7 +115,6 @@ class AnalyticsController extends base_controller_1.BaseController {
             enabled: selectors_1.analyticsControllerSelectors.selectEnabled(this.state),
             optedIn: this.state.optedIn,
             analyticsId: this.state.analyticsId,
-            eventQueuePersistenceEnabled: __classPrivateFieldGet(this, _AnalyticsController_isEventQueuePersistenceEnabled, "f"),
         });
     }
     /**
@@ -189,7 +136,6 @@ class AnalyticsController extends base_controller_1.BaseController {
             // Log error but don't throw - adapter setup failure shouldn't break controller
             (0, AnalyticsLogger_1.projectLogger)('Error calling platformAdapter.onSetupCompleted', error);
         }
-        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_replayQueuedEvents).call(this);
     }
     /**
      * Track an analytics event.
@@ -197,9 +143,8 @@ class AnalyticsController extends base_controller_1.BaseController {
      * Events are only tracked if analytics is enabled.
      *
      * @param event - Analytics event with properties and sensitive properties
-     * @param context - Optional platform-specific context forwarded to the platform adapter.
      */
-    trackEvent(event, context) {
+    trackEvent(event) {
         // Don't track if analytics is disabled
         if (!selectors_1.analyticsControllerSelectors.selectEnabled(this.state)) {
             return;
@@ -207,52 +152,50 @@ class AnalyticsController extends base_controller_1.BaseController {
         // if event does not have properties, send event without properties
         // and return to prevent any additional processing
         if (!event.hasProperties) {
-            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueTrackEvent).call(this, event.name, undefined, context);
+            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name);
             return;
         }
         // Track regular properties first if anonymous events feature is enabled
         if (__classPrivateFieldGet(this, _AnalyticsController_isAnonymousEventsFeatureEnabled, "f")) {
             // Note: Even if regular properties object is empty, we still send it to ensure
             // an event with user ID is tracked.
-            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueTrackEvent).call(this, event.name, {
+            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, {
                 ...event.properties,
-            }, context);
+            });
         }
         const hasSensitiveProperties = Object.keys(event.sensitiveProperties).length > 0;
         if (!__classPrivateFieldGet(this, _AnalyticsController_isAnonymousEventsFeatureEnabled, "f") || hasSensitiveProperties) {
-            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueTrackEvent).call(this, event.name, {
+            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, {
                 ...event.properties,
                 ...event.sensitiveProperties,
                 ...(hasSensitiveProperties && { anonymous: true }),
-            }, context);
+            });
         }
     }
     /**
      * Identify a user for analytics.
      *
      * @param traits - User traits/properties
-     * @param context - Optional platform-specific context forwarded to the platform adapter.
      */
-    identify(traits, context) {
+    identify(traits) {
         if (!selectors_1.analyticsControllerSelectors.selectEnabled(this.state)) {
             return;
         }
         // Delegate to platform adapter using the current analytics ID
-        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueIdentifyEvent).call(this, this.state.analyticsId, traits, context);
+        __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").identify(this.state.analyticsId, traits);
     }
     /**
      * Track a page or screen view.
      *
      * @param name - The identifier/name of the page or screen being viewed (e.g., "home", "settings", "wallet")
      * @param properties - Optional properties associated with the view
-     * @param context - Optional platform-specific context forwarded to the platform adapter.
      */
-    trackView(name, properties, context) {
+    trackView(name, properties) {
         if (!selectors_1.analyticsControllerSelectors.selectEnabled(this.state)) {
             return;
         }
         // Delegate to platform adapter
-        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueViewEvent).call(this, name, properties, context);
+        __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").view(name, properties);
     }
     /**
      * Opt in to analytics.
@@ -269,135 +212,8 @@ class AnalyticsController extends base_controller_1.BaseController {
         this.update((state) => {
             state.optedIn = false;
         });
-        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearQueuedEvents).call(this);
     }
 }
 exports.AnalyticsController = AnalyticsController;
-_AnalyticsController_platformAdapter = new WeakMap(), _AnalyticsController_isAnonymousEventsFeatureEnabled = new WeakMap(), _AnalyticsController_isEventQueuePersistenceEnabled = new WeakMap(), _AnalyticsController_initialized = new WeakMap(), _AnalyticsController_instances = new WeakSet(), _AnalyticsController_sendOrQueueTrackEvent = function _AnalyticsController_sendOrQueueTrackEvent(eventName, properties, context) {
-    if (!__classPrivateFieldGet(this, _AnalyticsController_isEventQueuePersistenceEnabled, "f")) {
-        __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(eventName, properties, context);
-        return;
-    }
-    const queuedEvent = {
-        type: 'track',
-        eventName,
-        messageId: (0, uuid_1.v4)(),
-        timestamp: new Date().toISOString(),
-        ...(properties === undefined ? {} : { properties }),
-        ...(context === undefined ? {} : { context }),
-    };
-    __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_enqueueEvent).call(this, queuedEvent);
-}, _AnalyticsController_sendOrQueueIdentifyEvent = function _AnalyticsController_sendOrQueueIdentifyEvent(userId, traits, context) {
-    if (!__classPrivateFieldGet(this, _AnalyticsController_isEventQueuePersistenceEnabled, "f")) {
-        __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").identify(userId, traits, context);
-        return;
-    }
-    const queuedEvent = {
-        type: 'identify',
-        userId,
-        messageId: (0, uuid_1.v4)(),
-        timestamp: new Date().toISOString(),
-        ...(traits === undefined ? {} : { traits }),
-        ...(context === undefined ? {} : { context }),
-    };
-    __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_enqueueEvent).call(this, queuedEvent);
-}, _AnalyticsController_sendOrQueueViewEvent = function _AnalyticsController_sendOrQueueViewEvent(name, properties, context) {
-    if (!__classPrivateFieldGet(this, _AnalyticsController_isEventQueuePersistenceEnabled, "f")) {
-        __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").view(name, properties, context);
-        return;
-    }
-    const queuedEvent = {
-        type: 'view',
-        name,
-        messageId: (0, uuid_1.v4)(),
-        timestamp: new Date().toISOString(),
-        ...(properties === undefined ? {} : { properties }),
-        ...(context === undefined ? {} : { context }),
-    };
-    __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_enqueueEvent).call(this, queuedEvent);
-}, _AnalyticsController_enqueueEvent = function _AnalyticsController_enqueueEvent(queuedEvent) {
-    const eventQueue = {
-        ...(this.state.eventQueue ?? {}),
-        [queuedEvent.messageId]: queuedEvent,
-    };
-    this.update((state) => {
-        state.eventQueue = eventQueue;
-    });
-    __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendQueuedEvent).call(this, queuedEvent);
-}, _AnalyticsController_sendQueuedEvent = function _AnalyticsController_sendQueuedEvent(queuedEvent) {
-    const timestamp = new Date(queuedEvent.timestamp);
-    if (Number.isNaN(timestamp.getTime())) {
-        (0, AnalyticsLogger_1.projectLogger)('Dropping queued analytics event with invalid timestamp', {
-            messageId: queuedEvent.messageId,
-        });
-        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_removeQueuedEvent).call(this, queuedEvent.messageId);
-        return;
-    }
-    const options = {
-        messageId: queuedEvent.messageId,
-        timestamp,
-        callback: (error) => {
-            if (error) {
-                (0, AnalyticsLogger_1.projectLogger)('Queued analytics event delivery failed', {
-                    messageId: queuedEvent.messageId,
-                    error,
-                });
-                return;
-            }
-            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_removeQueuedEvent).call(this, queuedEvent.messageId);
-        },
-    };
-    try {
-        if (queuedEvent.type === 'track') {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(queuedEvent.eventName, (0, lodash_1.cloneDeep)(queuedEvent.properties), (0, lodash_1.cloneDeep)(queuedEvent.context), options);
-        }
-        else if (queuedEvent.type === 'identify') {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").identify(queuedEvent.userId, (0, lodash_1.cloneDeep)(queuedEvent.traits), (0, lodash_1.cloneDeep)(queuedEvent.context), options);
-        }
-        else {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").view(queuedEvent.name, (0, lodash_1.cloneDeep)(queuedEvent.properties), (0, lodash_1.cloneDeep)(queuedEvent.context), options);
-        }
-    }
-    catch (error) {
-        (0, AnalyticsLogger_1.projectLogger)('Error sending queued analytics event', {
-            messageId: queuedEvent.messageId,
-            error,
-        });
-    }
-}, _AnalyticsController_replayQueuedEvents = function _AnalyticsController_replayQueuedEvents() {
-    if (!__classPrivateFieldGet(this, _AnalyticsController_isEventQueuePersistenceEnabled, "f") || !this.state.eventQueue) {
-        return;
-    }
-    if (!selectors_1.analyticsControllerSelectors.selectEnabled(this.state)) {
-        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearQueuedEvents).call(this);
-        return;
-    }
-    for (const [messageId, queuedEvent] of Object.entries(this.state.eventQueue)) {
-        if (!isAnalyticsQueuedEvent(queuedEvent) ||
-            queuedEvent.messageId !== messageId) {
-            (0, AnalyticsLogger_1.projectLogger)('Dropping invalid queued analytics event', { messageId });
-            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_removeQueuedEvent).call(this, messageId);
-            continue;
-        }
-        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendQueuedEvent).call(this, queuedEvent);
-    }
-}, _AnalyticsController_removeQueuedEvent = function _AnalyticsController_removeQueuedEvent(messageId) {
-    const currentEventQueue = this.state.eventQueue;
-    if (!currentEventQueue ||
-        !Object.prototype.hasOwnProperty.call(currentEventQueue, messageId)) {
-        return;
-    }
-    const { [messageId]: _deletedEvent, ...eventQueue } = currentEventQueue;
-    this.update((state) => {
-        state.eventQueue = eventQueue;
-    });
-}, _AnalyticsController_clearQueuedEvents = function _AnalyticsController_clearQueuedEvents() {
-    if (!this.state.eventQueue ||
-        Object.keys(this.state.eventQueue).length === 0) {
-        return;
-    }
-    this.update((state) => {
-        state.eventQueue = {};
-    });
-};
+_AnalyticsController_platformAdapter = new WeakMap(), _AnalyticsController_isAnonymousEventsFeatureEnabled = new WeakMap(), _AnalyticsController_initialized = new WeakMap();
 //# sourceMappingURL=AnalyticsController.cjs.map

package/dist/AnalyticsController.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsController.cjs","sourceRoot":"","sources":["../src/AnalyticsController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type { Json } from '@metamask/utils';\nimport { cloneDeep } from 'lodash';\nimport { v4 as uuid } from 'uuid';\n\nimport type { AnalyticsControllerMethodActions } from './AnalyticsController-method-action-types';\nimport { validateAnalyticsControllerState } from './analyticsControllerStateValidator';\nimport { projectLogger as log } from './AnalyticsLogger';\nimport type {\n  AnalyticsPlatformAdapter,\n  AnalyticsDeliveryOptions,\n  AnalyticsContext,\n  AnalyticsEventProperties,\n  AnalyticsUserTraits,\n  AnalyticsTrackingEvent,\n} from './AnalyticsPlatformAdapter.types';\nimport { analyticsControllerSelectors } from './selectors';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link AnalyticsController}, used to namespace the\n * controller's actions and events and to namespace the controller's state data\n * when composed with other controllers.\n */\nexport const controllerName = 'AnalyticsController';\n\n// === STATE ===\n\n/**\n * Describes the shape of the state object for {@link AnalyticsController}.\n */\nexport type AnalyticsControllerState = {\n  /**\n   * Whether the user has opted in to analytics.\n   */\n  optedIn: boolean;\n\n  /**\n   * User's UUIDv4 analytics identifier.\n   * This is an identity (unique per user), not a preference.\n   * Must be provided by the platform - the controller does not generate it.\n   */\n  analyticsId: string;\n\n  /**\n   * Persisted queue of analytics events waiting for delivery acknowledgement.\n   * This is only used when event queue persistence is enabled.\n   */\n  eventQueue?: Record<string, Json>;\n};\n\n/**\n * Event types supported by the persisted analytics event queue.\n */\nexport type AnalyticsQueuedEventType = 'track' | 'identify' | 'view';\n\n/**\n * Base persisted event queue entry.\n */\nexport type AnalyticsQueuedEventBase = {\n  /**\n   * Event type used to replay the payload with the platform adapter.\n   */\n  type: AnalyticsQueuedEventType;\n\n  /**\n   * Stable identifier for the analytics payload.\n   */\n  messageId: string;\n\n  /**\n   * Original payload timestamp serialized for persistence.\n   */\n  timestamp: string;\n};\n\n/**\n * Persisted track event queue entry.\n */\nexport type AnalyticsQueuedTrackEvent = AnalyticsQueuedEventBase & {\n  type: 'track';\n  eventName: string;\n  properties?: AnalyticsEventProperties;\n  context?: AnalyticsContext;\n};\n\n/**\n * Persisted identify event queue entry.\n */\nexport type AnalyticsQueuedIdentifyEvent = AnalyticsQueuedEventBase & {\n  type: 'identify';\n  userId: string;\n  traits?: AnalyticsUserTraits;\n  context?: AnalyticsContext;\n};\n\n/**\n * Persisted view event queue entry.\n */\nexport type AnalyticsQueuedViewEvent = AnalyticsQueuedEventBase & {\n  type: 'view';\n  name: string;\n  properties?: AnalyticsEventProperties;\n  context?: AnalyticsContext;\n};\n\n/**\n * Persisted analytics event queue entry.\n */\nexport type AnalyticsQueuedEvent =\n  | AnalyticsQueuedTrackEvent\n  | AnalyticsQueuedIdentifyEvent\n  | AnalyticsQueuedViewEvent;\n\n/**\n * Persisted analytics event queue keyed by message ID.\n */\nexport type AnalyticsEventQueue = Record<string, AnalyticsQueuedEvent>;\n\n/**\n * Returns default values for AnalyticsController state.\n *\n * Note: analyticsId is NOT included - it's an identity that must be\n * provided by the platform (generated once on first run, then persisted).\n *\n * @returns Default state without analyticsId\n */\nexport function getDefaultAnalyticsControllerState(): Omit<\n  AnalyticsControllerState,\n  'analyticsId'\n> {\n  return {\n    optedIn: false,\n  };\n}\n\n/**\n * The metadata for each property in {@link AnalyticsControllerState}.\n *\n * Both `optedIn` and `analyticsId` are persisted (`persist: true`).\n * The platform must supply a valid UUIDv4 `analyticsId` on first run.\n */\nconst analyticsControllerMetadata = {\n  optedIn: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  analyticsId: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n  eventQueue: {\n    includeInStateLogs: false,\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: false,\n  },\n} satisfies StateMetadata<AnalyticsControllerState>;\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'trackEvent',\n  'identify',\n  'trackView',\n  'optIn',\n  'optOut',\n] as const;\n\n/**\n * Returns the state of the {@link AnalyticsController}.\n */\nexport type AnalyticsControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AnalyticsControllerState\n>;\n\n/**\n * Actions that {@link AnalyticsControllerMessenger} exposes to other consumers.\n */\nexport type AnalyticsControllerActions =\n  | AnalyticsControllerGetStateAction\n  | AnalyticsControllerMethodActions;\n\n/**\n * Actions from other messengers that {@link AnalyticsControllerMessenger} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Event emitted when the state of the {@link AnalyticsController} changes.\n */\nexport type AnalyticsControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AnalyticsControllerState\n>;\n\n/**\n * Events that {@link AnalyticsControllerMessenger} exposes to other consumers.\n */\nexport type AnalyticsControllerEvents = AnalyticsControllerStateChangeEvent;\n\n/**\n * Events from other messengers that {@link AnalyticsControllerMessenger} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link AnalyticsController}.\n */\nexport type AnalyticsControllerMessenger = Messenger<\n  typeof controllerName,\n  AnalyticsControllerActions | AllowedActions,\n  AnalyticsControllerEvents | AllowedEvents\n>;\n\n// === CONTROLLER DEFINITION ===\n\n/**\n * The options that AnalyticsController takes.\n */\nexport type AnalyticsControllerOptions = {\n  /**\n   * Initial controller state. Must include a valid UUIDv4 `analyticsId`.\n   * The platform is responsible for generating the ID on first run.\n   * It is then persisted with controller state when using a persisted store.\n   */\n  state: AnalyticsControllerState;\n  /**\n   * Messenger used to communicate with BaseController and other controllers.\n   */\n  messenger: AnalyticsControllerMessenger;\n  /**\n   * Platform adapter implementation for tracking events.\n   */\n  platformAdapter: AnalyticsPlatformAdapter;\n\n  /**\n   * Whether the anonymous events feature is enabled.\n   *\n   * @default false\n   */\n  isAnonymousEventsFeatureEnabled?: boolean;\n\n  /**\n   * Whether analytics event queue persistence is enabled.\n   *\n   * When enabled, AnalyticsController persists each platform adapter payload\n   * until the adapter reports successful delivery.\n   *\n   * @default false\n   */\n  isEventQueuePersistenceEnabled?: boolean;\n};\n\n/**\n * Returns whether a value is a non-array object.\n *\n * @param value - The value to check.\n * @returns True if the value is a record.\n */\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\n/**\n * Returns whether a value is a valid persisted analytics event.\n *\n * @param value - The value to check.\n * @returns True if the value is a queued analytics event.\n */\nfunction isAnalyticsQueuedEvent(value: unknown): value is AnalyticsQueuedEvent {\n  if (!isRecord(value)) {\n    return false;\n  }\n\n  if (\n    typeof value.messageId !== 'string' ||\n    typeof value.timestamp !== 'string'\n  ) {\n    return false;\n  }\n\n  if (value.type === 'track') {\n    return (\n      typeof value.eventName === 'string' &&\n      (value.properties === undefined || isRecord(value.properties)) &&\n      (value.context === undefined || isRecord(value.context))\n    );\n  }\n\n  if (value.type === 'identify') {\n    return (\n      typeof value.userId === 'string' &&\n      (value.traits === undefined || isRecord(value.traits)) &&\n      (value.context === undefined || isRecord(value.context))\n    );\n  }\n\n  if (value.type === 'view') {\n    return (\n      typeof value.name === 'string' &&\n      (value.properties === undefined || isRecord(value.properties)) &&\n      (value.context === undefined || isRecord(value.context))\n    );\n  }\n\n  return false;\n}\n\n/**\n * The AnalyticsController manages analytics tracking across platforms (Mobile/Extension).\n * It provides a unified interface for tracking events, identifying users, and managing\n * analytics preferences while delegating platform-specific implementation to an\n * {@link AnalyticsPlatformAdapter}.\n *\n * This controller follows the MetaMask controller pattern and integrates with the\n * messenger system to allow other controllers and components to track analytics events.\n * It delegates platform-specific implementation to an {@link AnalyticsPlatformAdapter}.\n *\n * The controller persists `optedIn` and `analyticsId` when composed with a persisted\n * store. The platform must supply a valid `analyticsId` on first launch.\n */\nexport class AnalyticsController extends BaseController<\n  'AnalyticsController',\n  AnalyticsControllerState,\n  AnalyticsControllerMessenger\n> {\n  readonly #platformAdapter: AnalyticsPlatformAdapter;\n\n  readonly #isAnonymousEventsFeatureEnabled: boolean;\n\n  readonly #isEventQueuePersistenceEnabled: boolean;\n\n  #initialized: boolean;\n\n  /**\n   * Constructs an AnalyticsController instance.\n   *\n   * @param options - Controller options\n   * @param options.state - Initial controller state. Must include a valid UUIDv4 `analyticsId`.\n   * Use `getDefaultAnalyticsControllerState()` for default opt-in preferences.\n   * @param options.messenger - Messenger used to communicate with BaseController\n   * @param options.platformAdapter - Platform adapter implementation for tracking\n   * @param options.isAnonymousEventsFeatureEnabled - Whether the anonymous events feature is enabled\n   * @param options.isEventQueuePersistenceEnabled - Whether analytics event queue persistence is enabled\n   * @throws Error if state.analyticsId is missing or not a valid UUIDv4\n   * @remarks After construction, call {@link AnalyticsController.init} to complete initialization.\n   */\n  constructor({\n    state,\n    messenger,\n    platformAdapter,\n    isAnonymousEventsFeatureEnabled = false,\n    isEventQueuePersistenceEnabled = false,\n  }: AnalyticsControllerOptions) {\n    const initialState: AnalyticsControllerState = {\n      ...getDefaultAnalyticsControllerState(),\n      ...state,\n    };\n\n    validateAnalyticsControllerState(\n      initialState,\n      platformAdapter.skipUUIDv4Check === true,\n    );\n\n    super({\n      name: controllerName,\n      metadata: analyticsControllerMetadata,\n      state: initialState,\n      messenger,\n    });\n\n    this.#isAnonymousEventsFeatureEnabled = isAnonymousEventsFeatureEnabled;\n    this.#isEventQueuePersistenceEnabled = isEventQueuePersistenceEnabled;\n    this.#platformAdapter = platformAdapter;\n    this.#initialized = false;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    log('AnalyticsController initialized and ready', {\n      enabled: analyticsControllerSelectors.selectEnabled(this.state),\n      optedIn: this.state.optedIn,\n      analyticsId: this.state.analyticsId,\n      eventQueuePersistenceEnabled: this.#isEventQueuePersistenceEnabled,\n    });\n  }\n\n  /**\n   * Initialize the controller by calling the platform adapter's onSetupCompleted lifecycle hook.\n   * This method must be called after construction to complete the setup process.\n   */\n  init(): void {\n    if (this.#initialized) {\n      log('AnalyticsController already initialized.');\n      return;\n    }\n\n    this.#initialized = true;\n\n    // Call onSetupCompleted lifecycle hook after initialization\n    // State is already validated, so analyticsId is guaranteed to be a valid UUIDv4\n    try {\n      this.#platformAdapter.onSetupCompleted(this.state.analyticsId);\n    } catch (error) {\n      // Log error but don't throw - adapter setup failure shouldn't break controller\n      log('Error calling platformAdapter.onSetupCompleted', error);\n    }\n\n    this.#replayQueuedEvents();\n  }\n\n  /**\n   * Send final track payload through the platform adapter or queue it if persistence is enabled.\n   *\n   * @param eventName - The name of the event.\n   * @param properties - Optional event properties.\n   * @param context - Optional platform-specific context.\n   */\n  #sendOrQueueTrackEvent(\n    eventName: string,\n    properties?: AnalyticsEventProperties,\n    context?: AnalyticsContext,\n  ): void {\n    if (!this.#isEventQueuePersistenceEnabled) {\n      this.#platformAdapter.track(eventName, properties, context);\n      return;\n    }\n\n    const queuedEvent: AnalyticsQueuedTrackEvent = {\n      type: 'track',\n      eventName,\n      messageId: uuid(),\n      timestamp: new Date().toISOString(),\n      ...(properties === undefined ? {} : { properties }),\n      ...(context === undefined ? {} : { context }),\n    };\n\n    this.#enqueueEvent(queuedEvent);\n  }\n\n  /**\n   * Send final identify payload through the platform adapter or queue it if persistence is enabled.\n   *\n   * @param userId - The user ID.\n   * @param traits - Optional user traits.\n   * @param context - Optional platform-specific context.\n   */\n  #sendOrQueueIdentifyEvent(\n    userId: string,\n    traits?: AnalyticsUserTraits,\n    context?: AnalyticsContext,\n  ): void {\n    if (!this.#isEventQueuePersistenceEnabled) {\n      this.#platformAdapter.identify(userId, traits, context);\n      return;\n    }\n\n    const queuedEvent: AnalyticsQueuedIdentifyEvent = {\n      type: 'identify',\n      userId,\n      messageId: uuid(),\n      timestamp: new Date().toISOString(),\n      ...(traits === undefined ? {} : { traits }),\n      ...(context === undefined ? {} : { context }),\n    };\n\n    this.#enqueueEvent(queuedEvent);\n  }\n\n  /**\n   * Send final view payload through the platform adapter or queue it if persistence is enabled.\n   *\n   * @param name - The view name.\n   * @param properties - Optional view properties.\n   * @param context - Optional platform-specific context.\n   */\n  #sendOrQueueViewEvent(\n    name: string,\n    properties?: AnalyticsEventProperties,\n    context?: AnalyticsContext,\n  ): void {\n    if (!this.#isEventQueuePersistenceEnabled) {\n      this.#platformAdapter.view(name, properties, context);\n      return;\n    }\n\n    const queuedEvent: AnalyticsQueuedViewEvent = {\n      type: 'view',\n      name,\n      messageId: uuid(),\n      timestamp: new Date().toISOString(),\n      ...(properties === undefined ? {} : { properties }),\n      ...(context === undefined ? {} : { context }),\n    };\n\n    this.#enqueueEvent(queuedEvent);\n  }\n\n  /**\n   * Add an analytics event to the queue and send it.\n   *\n   * @param queuedEvent - The event to enqueue and deliver.\n   */\n  #enqueueEvent(queuedEvent: AnalyticsQueuedEvent): void {\n    const eventQueue: Record<string, Json> = {\n      ...(this.state.eventQueue ?? {}),\n      [queuedEvent.messageId]: queuedEvent as unknown as Json,\n    };\n\n    this.update((state) => {\n      state.eventQueue = eventQueue as never;\n    });\n\n    this.#sendQueuedEvent(queuedEvent);\n  }\n\n  /**\n   * Send a queued event through the platform adapter.\n   *\n   * @param queuedEvent - The queued event to deliver.\n   */\n  #sendQueuedEvent(queuedEvent: AnalyticsQueuedEvent): void {\n    const timestamp = new Date(queuedEvent.timestamp);\n\n    if (Number.isNaN(timestamp.getTime())) {\n      log('Dropping queued analytics event with invalid timestamp', {\n        messageId: queuedEvent.messageId,\n      });\n      this.#removeQueuedEvent(queuedEvent.messageId);\n      return;\n    }\n\n    const options: AnalyticsDeliveryOptions = {\n      messageId: queuedEvent.messageId,\n      timestamp,\n      callback: (error?: unknown) => {\n        if (error) {\n          log('Queued analytics event delivery failed', {\n            messageId: queuedEvent.messageId,\n            error,\n          });\n          return;\n        }\n\n        this.#removeQueuedEvent(queuedEvent.messageId);\n      },\n    };\n\n    try {\n      if (queuedEvent.type === 'track') {\n        this.#platformAdapter.track(\n          queuedEvent.eventName,\n          cloneDeep(queuedEvent.properties),\n          cloneDeep(queuedEvent.context),\n          options,\n        );\n      } else if (queuedEvent.type === 'identify') {\n        this.#platformAdapter.identify(\n          queuedEvent.userId,\n          cloneDeep(queuedEvent.traits),\n          cloneDeep(queuedEvent.context),\n          options,\n        );\n      } else {\n        this.#platformAdapter.view(\n          queuedEvent.name,\n          cloneDeep(queuedEvent.properties),\n          cloneDeep(queuedEvent.context),\n          options,\n        );\n      }\n    } catch (error) {\n      log('Error sending queued analytics event', {\n        messageId: queuedEvent.messageId,\n        error,\n      });\n    }\n  }\n\n  /**\n   * Replay persisted analytics events.\n   */\n  #replayQueuedEvents(): void {\n    if (!this.#isEventQueuePersistenceEnabled || !this.state.eventQueue) {\n      return;\n    }\n\n    if (!analyticsControllerSelectors.selectEnabled(this.state)) {\n      this.#clearQueuedEvents();\n      return;\n    }\n\n    for (const [messageId, queuedEvent] of Object.entries(\n      this.state.eventQueue,\n    )) {\n      if (\n        !isAnalyticsQueuedEvent(queuedEvent) ||\n        queuedEvent.messageId !== messageId\n      ) {\n        log('Dropping invalid queued analytics event', { messageId });\n        this.#removeQueuedEvent(messageId);\n        continue;\n      }\n\n      this.#sendQueuedEvent(queuedEvent);\n    }\n  }\n\n  /**\n   * Remove a queued analytics event.\n   *\n   * @param messageId - The queued event message ID.\n   */\n  #removeQueuedEvent(messageId: string): void {\n    const currentEventQueue = this.state.eventQueue;\n\n    if (\n      !currentEventQueue ||\n      !Object.prototype.hasOwnProperty.call(currentEventQueue, messageId)\n    ) {\n      return;\n    }\n\n    const { [messageId]: _deletedEvent, ...eventQueue } = currentEventQueue;\n\n    this.update((state) => {\n      state.eventQueue = eventQueue as never;\n    });\n  }\n\n  /**\n   * Clear all queued analytics events.\n   */\n  #clearQueuedEvents(): void {\n    if (\n      !this.state.eventQueue ||\n      Object.keys(this.state.eventQueue).length === 0\n    ) {\n      return;\n    }\n\n    this.update((state) => {\n      state.eventQueue = {} as never;\n    });\n  }\n\n  /**\n   * Track an analytics event.\n   *\n   * Events are only tracked if analytics is enabled.\n   *\n   * @param event - Analytics event with properties and sensitive properties\n   * @param context - Optional platform-specific context forwarded to the platform adapter.\n   */\n  trackEvent(event: AnalyticsTrackingEvent, context?: AnalyticsContext): void {\n    // Don't track if analytics is disabled\n    if (!analyticsControllerSelectors.selectEnabled(this.state)) {\n      return;\n    }\n\n    // if event does not have properties, send event without properties\n    // and return to prevent any additional processing\n    if (!event.hasProperties) {\n      this.#sendOrQueueTrackEvent(event.name, undefined, context);\n      return;\n    }\n\n    // Track regular properties first if anonymous events feature is enabled\n    if (this.#isAnonymousEventsFeatureEnabled) {\n      // Note: Even if regular properties object is empty, we still send it to ensure\n      // an event with user ID is tracked.\n      this.#sendOrQueueTrackEvent(\n        event.name,\n        {\n          ...event.properties,\n        },\n        context,\n      );\n    }\n\n    const hasSensitiveProperties =\n      Object.keys(event.sensitiveProperties).length > 0;\n\n    if (!this.#isAnonymousEventsFeatureEnabled || hasSensitiveProperties) {\n      this.#sendOrQueueTrackEvent(\n        event.name,\n        {\n          ...event.properties,\n          ...event.sensitiveProperties,\n          ...(hasSensitiveProperties && { anonymous: true }),\n        },\n        context,\n      );\n    }\n  }\n\n  /**\n   * Identify a user for analytics.\n   *\n   * @param traits - User traits/properties\n   * @param context - Optional platform-specific context forwarded to the platform adapter.\n   */\n  identify(traits?: AnalyticsUserTraits, context?: AnalyticsContext): void {\n    if (!analyticsControllerSelectors.selectEnabled(this.state)) {\n      return;\n    }\n\n    // Delegate to platform adapter using the current analytics ID\n    this.#sendOrQueueIdentifyEvent(this.state.analyticsId, traits, context);\n  }\n\n  /**\n   * Track a page or screen view.\n   *\n   * @param name - The identifier/name of the page or screen being viewed (e.g., \"home\", \"settings\", \"wallet\")\n   * @param properties - Optional properties associated with the view\n   * @param context - Optional platform-specific context forwarded to the platform adapter.\n   */\n  trackView(\n    name: string,\n    properties?: AnalyticsEventProperties,\n    context?: AnalyticsContext,\n  ): void {\n    if (!analyticsControllerSelectors.selectEnabled(this.state)) {\n      return;\n    }\n\n    // Delegate to platform adapter\n    this.#sendOrQueueViewEvent(name, properties, context);\n  }\n\n  /**\n   * Opt in to analytics.\n   */\n  optIn(): void {\n    this.update((state) => {\n      state.optedIn = true;\n    });\n  }\n\n  /**\n   * Opt out of analytics.\n   */\n  optOut(): void {\n    this.update((state) => {\n      state.optedIn = false;\n    });\n\n    this.#clearQueuedEvents();\n  }\n}\n"]}
+{"version":3,"file":"AnalyticsController.cjs","sourceRoot":"","sources":["../src/AnalyticsController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport type { AnalyticsControllerMethodActions } from './AnalyticsController-method-action-types';\nimport { validateAnalyticsControllerState } from './analyticsControllerStateValidator';\nimport { projectLogger as log } from './AnalyticsLogger';\nimport type {\n  AnalyticsPlatformAdapter,\n  AnalyticsEventProperties,\n  AnalyticsUserTraits,\n  AnalyticsTrackingEvent,\n} from './AnalyticsPlatformAdapter.types';\nimport { analyticsControllerSelectors } from './selectors';\n\n// === GENERAL ===\n\n/**\n * The name of the {@link AnalyticsController}, used to namespace the\n * controller's actions and events and to namespace the controller's state data\n * when composed with other controllers.\n */\nexport const controllerName = 'AnalyticsController';\n\n// === STATE ===\n\n/**\n * Describes the shape of the state object for {@link AnalyticsController}.\n */\nexport type AnalyticsControllerState = {\n  /**\n   * Whether the user has opted in to analytics.\n   */\n  optedIn: boolean;\n\n  /**\n   * User's UUIDv4 analytics identifier.\n   * This is an identity (unique per user), not a preference.\n   * Must be provided by the platform - the controller does not generate it.\n   */\n  analyticsId: string;\n};\n\n/**\n * Returns default values for AnalyticsController state.\n *\n * Note: analyticsId is NOT included - it's an identity that must be\n * provided by the platform (generated once on first run, then persisted).\n *\n * @returns Default state without analyticsId\n */\nexport function getDefaultAnalyticsControllerState(): Omit<\n  AnalyticsControllerState,\n  'analyticsId'\n> {\n  return {\n    optedIn: false,\n  };\n}\n\n/**\n * The metadata for each property in {@link AnalyticsControllerState}.\n *\n * Both `optedIn` and `analyticsId` are persisted (`persist: true`).\n * The platform must supply a valid UUIDv4 `analyticsId` on first run.\n */\nconst analyticsControllerMetadata = {\n  optedIn: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  analyticsId: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n} satisfies StateMetadata<AnalyticsControllerState>;\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'trackEvent',\n  'identify',\n  'trackView',\n  'optIn',\n  'optOut',\n] as const;\n\n/**\n * Returns the state of the {@link AnalyticsController}.\n */\nexport type AnalyticsControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  AnalyticsControllerState\n>;\n\n/**\n * Actions that {@link AnalyticsControllerMessenger} exposes to other consumers.\n */\nexport type AnalyticsControllerActions =\n  | AnalyticsControllerGetStateAction\n  | AnalyticsControllerMethodActions;\n\n/**\n * Actions from other messengers that {@link AnalyticsControllerMessenger} calls.\n */\ntype AllowedActions = never;\n\n/**\n * Event emitted when the state of the {@link AnalyticsController} changes.\n */\nexport type AnalyticsControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  AnalyticsControllerState\n>;\n\n/**\n * Events that {@link AnalyticsControllerMessenger} exposes to other consumers.\n */\nexport type AnalyticsControllerEvents = AnalyticsControllerStateChangeEvent;\n\n/**\n * Events from other messengers that {@link AnalyticsControllerMessenger} subscribes to.\n */\ntype AllowedEvents = never;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link AnalyticsController}.\n */\nexport type AnalyticsControllerMessenger = Messenger<\n  typeof controllerName,\n  AnalyticsControllerActions | AllowedActions,\n  AnalyticsControllerEvents | AllowedEvents\n>;\n\n// === CONTROLLER DEFINITION ===\n\n/**\n * The options that AnalyticsController takes.\n */\nexport type AnalyticsControllerOptions = {\n  /**\n   * Initial controller state. Must include a valid UUIDv4 `analyticsId`.\n   * The platform is responsible for generating the ID on first run.\n   * It is then persisted with controller state when using a persisted store.\n   */\n  state: AnalyticsControllerState;\n  /**\n   * Messenger used to communicate with BaseController and other controllers.\n   */\n  messenger: AnalyticsControllerMessenger;\n  /**\n   * Platform adapter implementation for tracking events.\n   */\n  platformAdapter: AnalyticsPlatformAdapter;\n\n  /**\n   * Whether the anonymous events feature is enabled.\n   *\n   * @default false\n   */\n  isAnonymousEventsFeatureEnabled?: boolean;\n};\n\n/**\n * The AnalyticsController manages analytics tracking across platforms (Mobile/Extension).\n * It provides a unified interface for tracking events, identifying users, and managing\n * analytics preferences while delegating platform-specific implementation to an\n * {@link AnalyticsPlatformAdapter}.\n *\n * This controller follows the MetaMask controller pattern and integrates with the\n * messenger system to allow other controllers and components to track analytics events.\n * It delegates platform-specific implementation to an {@link AnalyticsPlatformAdapter}.\n *\n * The controller persists `optedIn` and `analyticsId` when composed with a persisted\n * store. The platform must supply a valid `analyticsId` on first launch.\n */\nexport class AnalyticsController extends BaseController<\n  'AnalyticsController',\n  AnalyticsControllerState,\n  AnalyticsControllerMessenger\n> {\n  readonly #platformAdapter: AnalyticsPlatformAdapter;\n\n  readonly #isAnonymousEventsFeatureEnabled: boolean;\n\n  #initialized: boolean;\n\n  /**\n   * Constructs an AnalyticsController instance.\n   *\n   * @param options - Controller options\n   * @param options.state - Initial controller state. Must include a valid UUIDv4 `analyticsId`.\n   * Use `getDefaultAnalyticsControllerState()` for default opt-in preferences.\n   * @param options.messenger - Messenger used to communicate with BaseController\n   * @param options.platformAdapter - Platform adapter implementation for tracking\n   * @param options.isAnonymousEventsFeatureEnabled - Whether the anonymous events feature is enabled\n   * @throws Error if state.analyticsId is missing or not a valid UUIDv4\n   * @remarks After construction, call {@link AnalyticsController.init} to complete initialization.\n   */\n  constructor({\n    state,\n    messenger,\n    platformAdapter,\n    isAnonymousEventsFeatureEnabled = false,\n  }: AnalyticsControllerOptions) {\n    const initialState: AnalyticsControllerState = {\n      ...getDefaultAnalyticsControllerState(),\n      ...state,\n    };\n\n    validateAnalyticsControllerState(\n      initialState,\n      platformAdapter.skipUUIDv4Check === true,\n    );\n\n    super({\n      name: controllerName,\n      metadata: analyticsControllerMetadata,\n      state: initialState,\n      messenger,\n    });\n\n    this.#isAnonymousEventsFeatureEnabled = isAnonymousEventsFeatureEnabled;\n    this.#platformAdapter = platformAdapter;\n    this.#initialized = false;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    log('AnalyticsController initialized and ready', {\n      enabled: analyticsControllerSelectors.selectEnabled(this.state),\n      optedIn: this.state.optedIn,\n      analyticsId: this.state.analyticsId,\n    });\n  }\n\n  /**\n   * Initialize the controller by calling the platform adapter's onSetupCompleted lifecycle hook.\n   * This method must be called after construction to complete the setup process.\n   */\n  init(): void {\n    if (this.#initialized) {\n      log('AnalyticsController already initialized.');\n      return;\n    }\n\n    this.#initialized = true;\n\n    // Call onSetupCompleted lifecycle hook after initialization\n    // State is already validated, so analyticsId is guaranteed to be a valid UUIDv4\n    try {\n      this.#platformAdapter.onSetupCompleted(this.state.analyticsId);\n    } catch (error) {\n      // Log error but don't throw - adapter setup failure shouldn't break controller\n      log('Error calling platformAdapter.onSetupCompleted', error);\n    }\n  }\n\n  /**\n   * Track an analytics event.\n   *\n   * Events are only tracked if analytics is enabled.\n   *\n   * @param event - Analytics event with properties and sensitive properties\n   */\n  trackEvent(event: AnalyticsTrackingEvent): void {\n    // Don't track if analytics is disabled\n    if (!analyticsControllerSelectors.selectEnabled(this.state)) {\n      return;\n    }\n\n    // if event does not have properties, send event without properties\n    // and return to prevent any additional processing\n    if (!event.hasProperties) {\n      this.#platformAdapter.track(event.name);\n      return;\n    }\n\n    // Track regular properties first if anonymous events feature is enabled\n    if (this.#isAnonymousEventsFeatureEnabled) {\n      // Note: Even if regular properties object is empty, we still send it to ensure\n      // an event with user ID is tracked.\n      this.#platformAdapter.track(event.name, {\n        ...event.properties,\n      });\n    }\n\n    const hasSensitiveProperties =\n      Object.keys(event.sensitiveProperties).length > 0;\n\n    if (!this.#isAnonymousEventsFeatureEnabled || hasSensitiveProperties) {\n      this.#platformAdapter.track(event.name, {\n        ...event.properties,\n        ...event.sensitiveProperties,\n        ...(hasSensitiveProperties && { anonymous: true }),\n      });\n    }\n  }\n\n  /**\n   * Identify a user for analytics.\n   *\n   * @param traits - User traits/properties\n   */\n  identify(traits?: AnalyticsUserTraits): void {\n    if (!analyticsControllerSelectors.selectEnabled(this.state)) {\n      return;\n    }\n\n    // Delegate to platform adapter using the current analytics ID\n    this.#platformAdapter.identify(this.state.analyticsId, traits);\n  }\n\n  /**\n   * Track a page or screen view.\n   *\n   * @param name - The identifier/name of the page or screen being viewed (e.g., \"home\", \"settings\", \"wallet\")\n   * @param properties - Optional properties associated with the view\n   */\n  trackView(name: string, properties?: AnalyticsEventProperties): void {\n    if (!analyticsControllerSelectors.selectEnabled(this.state)) {\n      return;\n    }\n\n    // Delegate to platform adapter\n    this.#platformAdapter.view(name, properties);\n  }\n\n  /**\n   * Opt in to analytics.\n   */\n  optIn(): void {\n    this.update((state) => {\n      state.optedIn = true;\n    });\n  }\n\n  /**\n   * Opt out of analytics.\n   */\n  optOut(): void {\n    this.update((state) => {\n      state.optedIn = false;\n    });\n  }\n}\n"]}