@metamask-previews/analytics-controller 1.0.1-preview-8e8c4f6f5 → 1.1.0-preview-e43dfcb

package/dist/AnalyticsController.d.mts

@@ -1,6 +1,7 @@
 import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
 import { BaseController } from "@metamask/base-controller";
 import type { Messenger } from "@metamask/messenger";
+import type { Json } from "@metamask/utils";
 import type { AnalyticsControllerMethodActions } from "./AnalyticsController-method-action-types.mjs";
 import type { AnalyticsPlatformAdapter, AnalyticsContext, AnalyticsEventProperties, AnalyticsUserTraits, AnalyticsTrackingEvent } from "./AnalyticsPlatformAdapter.types.mjs";
 /**
@@ -23,7 +24,68 @@ export type AnalyticsControllerState = {
      * Must be provided by the platform - the controller does not generate it.
      */
     analyticsId: string;
+    /**
+     * Persisted queue of analytics events waiting for delivery acknowledgement.
+     * This is only used when event queue persistence is enabled.
+     */
+    eventQueue?: Record<string, Json>;
+};
+/**
+ * Event types supported by the persisted analytics event queue.
+ */
+export type AnalyticsQueuedEventType = 'track' | 'identify' | 'view';
+/**
+ * Base persisted event queue entry.
+ */
+export type AnalyticsQueuedEventBase = {
+    /**
+     * Event type used to replay the payload with the platform adapter.
+     */
+    type: AnalyticsQueuedEventType;
+    /**
+     * Stable identifier for the analytics payload.
+     */
+    messageId: string;
+    /**
+     * Original payload timestamp serialized for persistence.
+     */
+    timestamp: string;
+};
+/**
+ * Persisted track event queue entry.
+ */
+export type AnalyticsQueuedTrackEvent = AnalyticsQueuedEventBase & {
+    type: 'track';
+    eventName: string;
+    properties?: AnalyticsEventProperties;
+    context?: AnalyticsContext;
 };
+/**
+ * Persisted identify event queue entry.
+ */
+export type AnalyticsQueuedIdentifyEvent = AnalyticsQueuedEventBase & {
+    type: 'identify';
+    userId: string;
+    traits?: AnalyticsUserTraits;
+    context?: AnalyticsContext;
+};
+/**
+ * Persisted view event queue entry.
+ */
+export type AnalyticsQueuedViewEvent = AnalyticsQueuedEventBase & {
+    type: 'view';
+    name: string;
+    properties?: AnalyticsEventProperties;
+    context?: AnalyticsContext;
+};
+/**
+ * Persisted analytics event queue entry.
+ */
+export type AnalyticsQueuedEvent = AnalyticsQueuedTrackEvent | AnalyticsQueuedIdentifyEvent | AnalyticsQueuedViewEvent;
+/**
+ * Persisted analytics event queue keyed by message ID.
+ */
+export type AnalyticsEventQueue = Record<string, AnalyticsQueuedEvent>;
 /**
  * Returns default values for AnalyticsController state.
  *
@@ -86,6 +148,15 @@ export type AnalyticsControllerOptions = {
      * @default false
      */
     isAnonymousEventsFeatureEnabled?: boolean;
+    /**
+     * Whether analytics event queue persistence is enabled.
+     *
+     * When enabled, AnalyticsController persists each platform adapter payload
+     * until the adapter reports successful delivery.
+     *
+     * @default false
+     */
+    isEventQueuePersistenceEnabled?: boolean;
 };
 /**
  * The AnalyticsController manages analytics tracking across platforms (Mobile/Extension).
@@ -111,10 +182,11 @@ export declare class AnalyticsController extends BaseController<'AnalyticsContro
      * @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, }: AnalyticsControllerOptions);
+    constructor({ state, messenger, platformAdapter, isAnonymousEventsFeatureEnabled, isEventQueuePersistenceEnabled, }: AnalyticsControllerOptions);
     /**
      * Initialize the controller by calling the platform adapter's onSetupCompleted lifecycle hook.
      * This method must be called after construction to complete the setup process.

package/dist/AnalyticsController.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsController.d.mts","sourceRoot":"","sources":["../src/AnalyticsController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAE3B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AAErD,OAAO,KAAK,EAAE,gCAAgC,EAAE,sDAAkD;AAGlG,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACvB,6CAAyC;AAK1C;;;;GAIG;AACH,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAIpD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,IAAI,IAAI,CACxD,wBAAwB,EACxB,aAAa,CACd,CAIA;AAiCD;;GAEG;AACH,MAAM,MAAM,iCAAiC,GAAG,wBAAwB,CACtE,OAAO,cAAc,EACrB,wBAAwB,CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAClC,iCAAiC,GACjC,gCAAgC,CAAC;AAErC;;GAEG;AACH,KAAK,cAAc,GAAG,KAAK,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,mCAAmC,GAAG,0BAA0B,CAC1E,OAAO,cAAc,EACrB,wBAAwB,CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,mCAAmC,CAAC;AAE5E;;GAEG;AACH,KAAK,aAAa,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG,SAAS,CAClD,OAAO,cAAc,EACrB,0BAA0B,GAAG,cAAc,EAC3C,yBAAyB,GAAG,aAAa,CAC1C,CAAC;AAIF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,KAAK,EAAE,wBAAwB,CAAC;IAChC;;OAEG;IACH,SAAS,EAAE,4BAA4B,CAAC;IACxC;;OAEG;IACH,eAAe,EAAE,wBAAwB,CAAC;IAE1C;;;;OAIG;IACH,+BAA+B,CAAC,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,SAAQ,cAAc,CACrD,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,CAC7B;;IAOC;;;;;;;;;;;OAWG;gBACS,EACV,KAAK,EACL,SAAS,EACT,eAAe,EACf,+BAAuC,GACxC,EAAE,0BAA0B;IAkC7B;;;OAGG;IACH,IAAI,IAAI,IAAI;IAkBZ;;;;;;;OAOG;IACH,UAAU,CAAC,KAAK,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAgD3E;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAaxE;;;;;;OAMG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,wBAAwB,EACrC,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI;IAaP;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,MAAM,IAAI,IAAI;CAKf"}
+{"version":3,"file":"AnalyticsController.d.mts","sourceRoot":"","sources":["../src/AnalyticsController.ts"],"names":[],"mappings":"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"}

package/dist/AnalyticsController.mjs

@@ -9,8 +9,11 @@ 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_platformAdapter, _AnalyticsController_isAnonymousEventsFeatureEnabled, _AnalyticsController_initialized;
+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;
 import { BaseController } from "@metamask/base-controller";
+import $lodash from "lodash";
+const { cloneDeep } = $lodash;
+import { v4 as uuid } from "uuid";
 import { validateAnalyticsControllerState } from "./analyticsControllerStateValidator.mjs";
 import { projectLogger as log } from "./AnalyticsLogger.mjs";
 import { analyticsControllerSelectors } from "./selectors.mjs";
@@ -53,6 +56,12 @@ const analyticsControllerMetadata = {
         includeInDebugSnapshot: true,
         usedInUi: false,
     },
+    eventQueue: {
+        includeInStateLogs: false,
+        persist: true,
+        includeInDebugSnapshot: false,
+        usedInUi: false,
+    },
 };
 // === MESSENGER ===
 const MESSENGER_EXPOSED_METHODS = [
@@ -62,6 +71,46 @@ 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
@@ -85,10 +134,11 @@ export class AnalyticsController extends 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, }) {
+    constructor({ state, messenger, platformAdapter, isAnonymousEventsFeatureEnabled = false, isEventQueuePersistenceEnabled = false, }) {
         const initialState = {
             ...getDefaultAnalyticsControllerState(),
             ...state,
@@ -100,10 +150,13 @@ export class AnalyticsController extends 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);
@@ -111,6 +164,7 @@ export class AnalyticsController extends BaseController {
             enabled: analyticsControllerSelectors.selectEnabled(this.state),
             optedIn: this.state.optedIn,
             analyticsId: this.state.analyticsId,
+            eventQueuePersistenceEnabled: __classPrivateFieldGet(this, _AnalyticsController_isEventQueuePersistenceEnabled, "f"),
         });
     }
     /**
@@ -132,6 +186,7 @@ export class AnalyticsController extends BaseController {
             // Log error but don't throw - adapter setup failure shouldn't break controller
             log('Error calling platformAdapter.onSetupCompleted', error);
         }
+        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_replayQueuedEvents).call(this);
     }
     /**
      * Track an analytics event.
@@ -149,41 +204,24 @@ export class AnalyticsController extends BaseController {
         // if event does not have properties, send event without properties
         // and return to prevent any additional processing
         if (!event.hasProperties) {
-            if (context) {
-                __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, undefined, context);
-            }
-            else {
-                __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name);
-            }
+            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueTrackEvent).call(this, event.name, undefined, context);
             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.
-            const properties = {
+            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueTrackEvent).call(this, event.name, {
                 ...event.properties,
-            };
-            if (context) {
-                __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, properties, context);
-            }
-            else {
-                __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, properties);
-            }
+            }, context);
         }
         const hasSensitiveProperties = Object.keys(event.sensitiveProperties).length > 0;
         if (!__classPrivateFieldGet(this, _AnalyticsController_isAnonymousEventsFeatureEnabled, "f") || hasSensitiveProperties) {
-            const properties = {
+            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueTrackEvent).call(this, event.name, {
                 ...event.properties,
                 ...event.sensitiveProperties,
                 ...(hasSensitiveProperties && { anonymous: true }),
-            };
-            if (context) {
-                __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, properties, context);
-            }
-            else {
-                __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, properties);
-            }
+            }, context);
         }
     }
     /**
@@ -197,12 +235,7 @@ export class AnalyticsController extends BaseController {
             return;
         }
         // Delegate to platform adapter using the current analytics ID
-        if (context) {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").identify(this.state.analyticsId, traits, context);
-        }
-        else {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").identify(this.state.analyticsId, traits);
-        }
+        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueIdentifyEvent).call(this, this.state.analyticsId, traits, context);
     }
     /**
      * Track a page or screen view.
@@ -216,12 +249,7 @@ export class AnalyticsController extends BaseController {
             return;
         }
         // Delegate to platform adapter
-        if (context) {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").view(name, properties, context);
-        }
-        else {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").view(name, properties);
-        }
+        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueViewEvent).call(this, name, properties, context);
     }
     /**
      * Opt in to analytics.
@@ -238,7 +266,134 @@ export class AnalyticsController extends BaseController {
         this.update((state) => {
             state.optedIn = false;
         });
+        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearQueuedEvents).call(this);
     }
 }
-_AnalyticsController_platformAdapter = new WeakMap(), _AnalyticsController_isAnonymousEventsFeatureEnabled = new WeakMap(), _AnalyticsController_initialized = new WeakMap();
+_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: uuid(),
+        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: uuid(),
+        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: uuid(),
+        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())) {
+        log('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) {
+                log('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, cloneDeep(queuedEvent.properties), cloneDeep(queuedEvent.context), options);
+        }
+        else if (queuedEvent.type === 'identify') {
+            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").identify(queuedEvent.userId, cloneDeep(queuedEvent.traits), cloneDeep(queuedEvent.context), options);
+        }
+        else {
+            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").view(queuedEvent.name, cloneDeep(queuedEvent.properties), cloneDeep(queuedEvent.context), options);
+        }
+    }
+    catch (error) {
+        log('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 (!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) {
+            log('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 = {};
+    });
+};
 //# sourceMappingURL=AnalyticsController.mjs.map

package/dist/AnalyticsController.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsController.mjs","sourceRoot":"","sources":["../src/AnalyticsController.ts"],"names":[],"mappings":";;;;;;;;;;;;AAKA,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAI3D,OAAO,EAAE,gCAAgC,EAAE,gDAA4C;AACvF,OAAO,EAAE,aAAa,IAAI,GAAG,EAAE,8BAA0B;AAQzD,OAAO,EAAE,4BAA4B,EAAE,wBAAoB;AAE3D,kBAAkB;AAElB;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAqBpD;;;;;;;GAOG;AACH,MAAM,UAAU,kCAAkC;IAIhD,OAAO;QACL,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,2BAA2B,GAAG;IAClC,OAAO,EAAE;QACP,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,IAAI;KACf;IACD,WAAW,EAAE;QACX,kBAAkB,EAAE,IAAI;QACxB,OAAO,EAAE,IAAI;QACb,sBAAsB,EAAE,IAAI;QAC5B,QAAQ,EAAE,KAAK;KAChB;CACgD,CAAC;AAEpD,oBAAoB;AAEpB,MAAM,yBAAyB,GAAG;IAChC,YAAY;IACZ,UAAU;IACV,WAAW;IACX,OAAO;IACP,QAAQ;CACA,CAAC;AA+EX;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAoB,SAAQ,cAIxC;IAOC;;;;;;;;;;;OAWG;IACH,YAAY,EACV,KAAK,EACL,SAAS,EACT,eAAe,EACf,+BAA+B,GAAG,KAAK,GACZ;QAC3B,MAAM,YAAY,GAA6B;YAC7C,GAAG,kCAAkC,EAAE;YACvC,GAAG,KAAK;SACT,CAAC;QAEF,gCAAgC,CAC9B,YAAY,EACZ,eAAe,CAAC,eAAe,KAAK,IAAI,CACzC,CAAC;QAEF,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,2BAA2B;YACrC,KAAK,EAAE,YAAY;YACnB,SAAS;SACV,CAAC,CAAC;QAvCI,uDAA2C;QAE3C,uEAA0C;QAEnD,mDAAsB;QAqCpB,uBAAA,IAAI,wDAAoC,+BAA+B,MAAA,CAAC;QACxE,uBAAA,IAAI,wCAAoB,eAAe,MAAA,CAAC;QACxC,uBAAA,IAAI,oCAAgB,KAAK,MAAA,CAAC;QAE1B,IAAI,CAAC,SAAS,CAAC,4BAA4B,CACzC,IAAI,EACJ,yBAAyB,CAC1B,CAAC;QAEF,GAAG,CAAC,2CAA2C,EAAE;YAC/C,OAAO,EAAE,4BAA4B,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;YAC/D,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;YAC3B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,uBAAA,IAAI,wCAAa,EAAE,CAAC;YACtB,GAAG,CAAC,0CAA0C,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,uBAAA,IAAI,oCAAgB,IAAI,MAAA,CAAC;QAEzB,4DAA4D;QAC5D,gFAAgF;QAChF,IAAI,CAAC;YACH,uBAAA,IAAI,4CAAiB,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+EAA+E;YAC/E,GAAG,CAAC,gDAAgD,EAAE,KAAK,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,KAA6B,EAAE,OAA0B;QAClE,uCAAuC;QACvC,IAAI,CAAC,4BAA4B,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,mEAAmE;QACnE,kDAAkD;QAClD,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YACzB,IAAI,OAAO,EAAE,CAAC;gBACZ,uBAAA,IAAI,4CAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,uBAAA,IAAI,4CAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO;QACT,CAAC;QAED,wEAAwE;QACxE,IAAI,uBAAA,IAAI,4DAAiC,EAAE,CAAC;YAC1C,+EAA+E;YAC/E,oCAAoC;YACpC,MAAM,UAAU,GAAG;gBACjB,GAAG,KAAK,CAAC,UAAU;aACpB,CAAC;YACF,IAAI,OAAO,EAAE,CAAC;gBACZ,uBAAA,IAAI,4CAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,uBAAA,IAAI,4CAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,MAAM,sBAAsB,GAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAEpD,IAAI,CAAC,uBAAA,IAAI,4DAAiC,IAAI,sBAAsB,EAAE,CAAC;YACrE,MAAM,UAAU,GAAG;gBACjB,GAAG,KAAK,CAAC,UAAU;gBACnB,GAAG,KAAK,CAAC,mBAAmB;gBAC5B,GAAG,CAAC,sBAAsB,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;aACnD,CAAC;YACF,IAAI,OAAO,EAAE,CAAC;gBACZ,uBAAA,IAAI,4CAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,uBAAA,IAAI,4CAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,MAA4B,EAAE,OAA0B;QAC/D,IAAI,CAAC,4BAA4B,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,8DAA8D;QAC9D,IAAI,OAAO,EAAE,CAAC;YACZ,uBAAA,IAAI,4CAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,uBAAA,IAAI,4CAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CACP,IAAY,EACZ,UAAqC,EACrC,OAA0B;QAE1B,IAAI,CAAC,4BAA4B,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,IAAI,OAAO,EAAE,CAAC;YACZ,uBAAA,IAAI,4CAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,uBAAA,IAAI,4CAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACpB,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF","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  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/**\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   * @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      if (context) {\n        this.#platformAdapter.track(event.name, undefined, context);\n      } else {\n        this.#platformAdapter.track(event.name);\n      }\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      const properties = {\n        ...event.properties,\n      };\n      if (context) {\n        this.#platformAdapter.track(event.name, properties, context);\n      } else {\n        this.#platformAdapter.track(event.name, properties);\n      }\n    }\n\n    const hasSensitiveProperties =\n      Object.keys(event.sensitiveProperties).length > 0;\n\n    if (!this.#isAnonymousEventsFeatureEnabled || hasSensitiveProperties) {\n      const properties = {\n        ...event.properties,\n        ...event.sensitiveProperties,\n        ...(hasSensitiveProperties && { anonymous: true }),\n      };\n      if (context) {\n        this.#platformAdapter.track(event.name, properties, context);\n      } else {\n        this.#platformAdapter.track(event.name, properties);\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    if (context) {\n      this.#platformAdapter.identify(this.state.analyticsId, traits, context);\n    } else {\n      this.#platformAdapter.identify(this.state.analyticsId, traits);\n    }\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    if (context) {\n      this.#platformAdapter.view(name, properties, context);\n    } else {\n      this.#platformAdapter.view(name, properties);\n    }\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"]}
+{"version":3,"file":"AnalyticsController.mjs","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"]}

package/dist/AnalyticsPlatformAdapter.types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsPlatformAdapter.types.cjs","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapter.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/utils';\n\n/**\n * Analytics event properties\n */\nexport type AnalyticsEventProperties = Record<string, Json>;\n\n/**\n * User traits/properties for analytics identification\n */\nexport type AnalyticsUserTraits = Record<string, Json>;\n\n/**\n * Event properties structure with two distinct properties lists for regular and sensitive data.\n * Similar to ITrackingEvent from legacy analytics but decoupled for platform agnosticism.\n * Sensitivity is derived from the presence of sensitiveProperties (if sensitiveProperties has keys, the event is sensitive).\n */\nexport type AnalyticsTrackingEvent = {\n  readonly name: string;\n  properties: AnalyticsEventProperties;\n  sensitiveProperties: AnalyticsEventProperties;\n  /**\n   * Legacy property handled by the mobile app.\n   * This property is ignored by the analytics controller and will be removed from the type in the future.\n   * The mobile app will use the future analytics privacy controller to handle this functionality.\n   */\n  saveDataRecording: boolean;\n  readonly hasProperties: boolean;\n};\n\n/**\n * Optional analytics context payload (for example Segment-style context).\n */\nexport type AnalyticsContext = Record<string, Json>;\n\n/**\n * Platform adapter interface for analytics tracking\n * Implementations should handle platform-specific details (Segment SDK, etc.)\n */\nexport type AnalyticsPlatformAdapter = {\n  /**\n   * When `true`, the controller accepts any non-empty `analyticsId` string\n   * instead of requiring UUIDv4 format. Defaults to validation against UUIDv4 when omitted or `false`.\n   */\n  skipUUIDv4Check?: boolean;\n\n  /**\n   * Track an analytics event.\n   *\n   * This is the same as trackEvent in the old analytics system\n   *\n   * @param eventName - The name of the event\n   * @param properties - Event properties. If not provided, the event has no properties.\n   * The privacy plugin should check for `isSensitive === true` to determine if an event contains sensitive data.\n   * @param context - Optional platform-specific context attached to the invocation.\n   */\n  track(\n    eventName: string,\n    properties?: AnalyticsEventProperties,\n    context?: AnalyticsContext,\n  ): void;\n\n  /**\n   * Identify a user with traits.\n   *\n   * @param userId - The user identifier (e.g., metametrics ID)\n   * @param traits - User traits/properties\n   * @param context - Optional platform-specific context attached to the invocation.\n   */\n  identify(\n    userId: string,\n    traits?: AnalyticsUserTraits,\n    context?: AnalyticsContext,\n  ): void;\n\n  /**\n   * Track a UI unit (page or screen) view depending on the platform\n   *\n   * This method delegates to platform-specific Segment SDK methods:\n   * - Web adapters should call `analytics.page(name, properties)`\n   * - Mobile adapters should call `analytics.screen(name, properties)`\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 attached to the invocation.\n   */\n  view(\n    name: string,\n    properties?: AnalyticsEventProperties,\n    context?: AnalyticsContext,\n  ): void;\n\n  /**\n   * Lifecycle hook called after the AnalyticsController is fully initialized.\n   *\n   * This hook allows platform-specific adapters to perform setup that requires\n   * access to the controller's state (e.g., analyticsId).\n   *\n   * The controller calls this method once after initialization, passing the\n   * analyticsId from controller state. The analyticsId is guaranteed to be set\n   * when this method is called - this is the definition of \"completed\" setup.\n   *\n   * @param analyticsId - The analytics ID from controller state. Always set (never empty).\n   * @throws {AnalyticsPlatformAdapterSetupError} May throw errors during setup (e.g., configuration errors, network failures).\n   * Errors thrown by this method are caught and logged by the controller, but do not prevent\n   * controller initialization from completing successfully.\n   *\n   * @example\n   * ```typescript\n   * onSetupCompleted(analyticsId: string): void {\n   *   // Add platform-specific plugins that require analyticsId\n   *   client.add({\n   *     plugin: new PrivacyPlugin(analyticsId),\n   *   });\n   * }\n   * ```\n   */\n  onSetupCompleted(analyticsId: string): void;\n};\n"]}
+{"version":3,"file":"AnalyticsPlatformAdapter.types.cjs","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapter.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/utils';\n\n/**\n * Analytics event properties\n */\nexport type AnalyticsEventProperties = Record<string, Json>;\n\n/**\n * User traits/properties for analytics identification\n */\nexport type AnalyticsUserTraits = Record<string, Json>;\n\n/**\n * Callback invoked by the platform adapter after an analytics payload is\n * delivered or fails.\n */\nexport type AnalyticsInvocationCallback = (error?: unknown) => void;\n\n/**\n * Internal delivery metadata used by AnalyticsController when event queue\n * persistence is enabled.\n */\nexport type AnalyticsDeliveryOptions = {\n  /**\n   * Stable identifier for the analytics payload.\n   */\n  messageId?: string;\n\n  /**\n   * Original timestamp for the analytics payload.\n   */\n  timestamp?: Date;\n\n  /**\n   * Callback for delivery acknowledgement.\n   */\n  callback?: AnalyticsInvocationCallback;\n};\n\n/**\n * Event properties structure with two distinct properties lists for regular and sensitive data.\n * Similar to ITrackingEvent from legacy analytics but decoupled for platform agnosticism.\n * Sensitivity is derived from the presence of sensitiveProperties (if sensitiveProperties has keys, the event is sensitive).\n */\nexport type AnalyticsTrackingEvent = {\n  readonly name: string;\n  properties: AnalyticsEventProperties;\n  sensitiveProperties: AnalyticsEventProperties;\n  /**\n   * Legacy property handled by the mobile app.\n   * This property is ignored by the analytics controller and will be removed from the type in the future.\n   * The mobile app will use the future analytics privacy controller to handle this functionality.\n   */\n  saveDataRecording: boolean;\n  readonly hasProperties: boolean;\n};\n\n/**\n * Optional analytics context payload (for example Segment-style context).\n */\nexport type AnalyticsContext = Record<string, Json>;\n\n/**\n * Platform adapter interface for analytics tracking\n * Implementations should handle platform-specific details (Segment SDK, etc.)\n */\nexport type AnalyticsPlatformAdapter = {\n  /**\n   * When `true`, the controller accepts any non-empty `analyticsId` string\n   * instead of requiring UUIDv4 format. Defaults to validation against UUIDv4 when omitted or `false`.\n   */\n  skipUUIDv4Check?: boolean;\n\n  /**\n   * Track an analytics event.\n   *\n   * This is the same as trackEvent in the old analytics system\n   *\n   * @param eventName - The name of the event\n   * @param properties - Event properties. If not provided, the event has no properties.\n   * The privacy plugin should check for `isSensitive === true` to determine if an event contains sensitive data.\n   * @param context - Optional platform-specific context attached to the invocation.\n   * @param options - Optional delivery metadata for platform adapters.\n   */\n  track(\n    eventName: string,\n    properties?: AnalyticsEventProperties,\n    context?: AnalyticsContext,\n    options?: AnalyticsDeliveryOptions,\n  ): void;\n\n  /**\n   * Identify a user with traits.\n   *\n   * @param userId - The user identifier (e.g., metametrics ID)\n   * @param traits - User traits/properties\n   * @param context - Optional platform-specific context attached to the invocation.\n   * @param options - Optional delivery metadata for platform adapters.\n   */\n  identify(\n    userId: string,\n    traits?: AnalyticsUserTraits,\n    context?: AnalyticsContext,\n    options?: AnalyticsDeliveryOptions,\n  ): void;\n\n  /**\n   * Track a UI unit (page or screen) view depending on the platform\n   *\n   * This method delegates to platform-specific Segment SDK methods:\n   * - Web adapters should call `analytics.page(name, properties)`\n   * - Mobile adapters should call `analytics.screen(name, properties)`\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 attached to the invocation.\n   * @param options - Optional delivery metadata for platform adapters.\n   */\n  view(\n    name: string,\n    properties?: AnalyticsEventProperties,\n    context?: AnalyticsContext,\n    options?: AnalyticsDeliveryOptions,\n  ): void;\n\n  /**\n   * Lifecycle hook called after the AnalyticsController is fully initialized.\n   *\n   * This hook allows platform-specific adapters to perform setup that requires\n   * access to the controller's state (e.g., analyticsId).\n   *\n   * The controller calls this method once after initialization, passing the\n   * analyticsId from controller state. The analyticsId is guaranteed to be set\n   * when this method is called - this is the definition of \"completed\" setup.\n   *\n   * @param analyticsId - The analytics ID from controller state. Always set (never empty).\n   * @throws {AnalyticsPlatformAdapterSetupError} May throw errors during setup (e.g., configuration errors, network failures).\n   * Errors thrown by this method are caught and logged by the controller, but do not prevent\n   * controller initialization from completing successfully.\n   *\n   * @example\n   * ```typescript\n   * onSetupCompleted(analyticsId: string): void {\n   *   // Add platform-specific plugins that require analyticsId\n   *   client.add({\n   *     plugin: new PrivacyPlugin(analyticsId),\n   *   });\n   * }\n   * ```\n   */\n  onSetupCompleted(analyticsId: string): void;\n};\n"]}