@metamask-previews/analytics-controller 1.0.1-preview-9fb8d00e7 → 1.1.0-preview-e43dfcb

package/dist/AnalyticsController.d.cts

@@ -1,8 +1,9 @@
 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.cjs";
-import type { AnalyticsPlatformAdapter, AnalyticsEventProperties, AnalyticsUserTraits, AnalyticsTrackingEvent } from "./AnalyticsPlatformAdapter.types.cjs";
+import type { AnalyticsPlatformAdapter, AnalyticsContext, AnalyticsEventProperties, AnalyticsUserTraits, AnalyticsTrackingEvent } from "./AnalyticsPlatformAdapter.types.cjs";
 /**
  * The name of the {@link AnalyticsController}, used to namespace the
  * controller's actions and events and to namespace the controller's state data
@@ -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.
@@ -126,21 +198,24 @@ export declare class AnalyticsController extends BaseController<'AnalyticsContro
      * 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: AnalyticsTrackingEvent): void;
+    trackEvent(event: AnalyticsTrackingEvent, context?: AnalyticsContext): void;
     /**
      * Identify a user for analytics.
      *
      * @param traits - User traits/properties
+     * @param context - Optional platform-specific context forwarded to the platform adapter.
      */
-    identify(traits?: AnalyticsUserTraits): void;
+    identify(traits?: AnalyticsUserTraits, context?: AnalyticsContext): void;
     /**
      * 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: string, properties?: AnalyticsEventProperties): void;
+    trackView(name: string, properties?: AnalyticsEventProperties, context?: AnalyticsContext): void;
     /**
      * Opt in to analytics.
      */

package/dist/AnalyticsController.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsController.d.cts","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,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;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAkC/C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAS5C;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,wBAAwB,GAAG,IAAI;IASpE;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,MAAM,IAAI,IAAI;CAKf"}
+{"version":3,"file":"AnalyticsController.d.cts","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;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAI5C,OAAO,KAAK,EAAE,gCAAgC,EAAE,sDAAkD;AAGlG,OAAO,KAAK,EACV,wBAAwB,EAExB,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;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CACnC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,IAAI,EAAE,wBAAwB,CAAC;IAE/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,wBAAwB,GAAG;IACjE,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,wBAAwB,CAAC;IACtC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG,wBAAwB,GAAG;IACpE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,GAAG;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,wBAAwB,CAAC;IACtC,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,yBAAyB,GACzB,4BAA4B,GAC5B,wBAAwB,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAEvE;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,IAAI,IAAI,CACxD,wBAAwB,EACxB,aAAa,CACd,CAIA;AAuCD;;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;IAE1C;;;;;;;OAOG;IACH,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C,CAAC;AAyDF;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,SAAQ,cAAc,CACrD,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,CAC7B;;IASC;;;;;;;;;;;;OAYG;gBACS,EACV,KAAK,EACL,SAAS,EACT,eAAe,EACf,+BAAuC,EACvC,8BAAsC,GACvC,EAAE,0BAA0B;IAoC7B;;;OAGG;IACH,IAAI,IAAI,IAAI;IA+PZ;;;;;;;OAOG;IACH,UAAU,CAAC,KAAK,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI;IA0C3E;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI;IASxE;;;;;;OAMG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,wBAAwB,EACrC,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI;IASP;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,MAAM,IAAI,IAAI;CAOf"}

package/dist/AnalyticsController.d.mts

@@ -1,8 +1,9 @@
 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, AnalyticsEventProperties, AnalyticsUserTraits, AnalyticsTrackingEvent } from "./AnalyticsPlatformAdapter.types.mjs";
+import type { AnalyticsPlatformAdapter, AnalyticsContext, AnalyticsEventProperties, AnalyticsUserTraits, AnalyticsTrackingEvent } from "./AnalyticsPlatformAdapter.types.mjs";
 /**
  * The name of the {@link AnalyticsController}, used to namespace the
  * controller's actions and events and to namespace the controller's state data
@@ -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.
@@ -126,21 +198,24 @@ export declare class AnalyticsController extends BaseController<'AnalyticsContro
      * 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: AnalyticsTrackingEvent): void;
+    trackEvent(event: AnalyticsTrackingEvent, context?: AnalyticsContext): void;
     /**
      * Identify a user for analytics.
      *
      * @param traits - User traits/properties
+     * @param context - Optional platform-specific context forwarded to the platform adapter.
      */
-    identify(traits?: AnalyticsUserTraits): void;
+    identify(traits?: AnalyticsUserTraits, context?: AnalyticsContext): void;
     /**
      * 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: string, properties?: AnalyticsEventProperties): void;
+    trackView(name: string, properties?: AnalyticsEventProperties, context?: AnalyticsContext): void;
     /**
      * Opt in to analytics.
      */

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,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;;;;;;OAMG;IACH,UAAU,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAkC/C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAS5C;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,wBAAwB,GAAG,IAAI;IASpE;;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.
@@ -139,8 +194,9 @@ export class AnalyticsController extends 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) {
+    trackEvent(event, context) {
         // Don't track if analytics is disabled
         if (!analyticsControllerSelectors.selectEnabled(this.state)) {
             return;
@@ -148,50 +204,52 @@ 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) {
-            __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.
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, {
+            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueTrackEvent).call(this, event.name, {
                 ...event.properties,
-            });
+            }, context);
         }
         const hasSensitiveProperties = Object.keys(event.sensitiveProperties).length > 0;
         if (!__classPrivateFieldGet(this, _AnalyticsController_isAnonymousEventsFeatureEnabled, "f") || hasSensitiveProperties) {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, {
+            __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueTrackEvent).call(this, 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) {
+    identify(traits, context) {
         if (!analyticsControllerSelectors.selectEnabled(this.state)) {
             return;
         }
         // Delegate to platform adapter using the current analytics ID
-        __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.
      *
      * @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) {
+    trackView(name, properties, context) {
         if (!analyticsControllerSelectors.selectEnabled(this.state)) {
             return;
         }
         // Delegate to platform adapter
-        __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").view(name, properties);
+        __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueViewEvent).call(this, name, properties, context);
     }
     /**
      * Opt in to analytics.
@@ -208,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