@metamask-previews/analytics-controller 0.0.0-preview-8647bc1c → 0.0.0-preview-704ae19a

package/dist/AnalyticsController.mjs

@@ -11,8 +11,9 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 };
 var _AnalyticsController_platformAdapter;
 import { BaseController } from "@metamask/base-controller";
-import { v4 as uuidv4 } from "uuid";
+import { v4 as uuidv4, validate as uuidValidate, version as uuidVersion } from "uuid";
 import { projectLogger } from "./AnalyticsLogger.mjs";
+import { computeEnabledState } from "./analyticsStateComputer.mjs";
 // === GENERAL ===
 /**
  * The name of the {@link AnalyticsController}, used to namespace the
@@ -24,19 +25,19 @@ export const controllerName = 'AnalyticsController';
  * The metadata for each property in {@link AnalyticsControllerState}.
  */
 const analyticsControllerMetadata = {
-    enabled: {
+    user_optedIn: {
         includeInStateLogs: true,
         persist: true,
         includeInDebugSnapshot: true,
         usedInUi: true,
     },
-    optedIn: {
+    user_socialOptedIn: {
         includeInStateLogs: true,
         persist: true,
         includeInDebugSnapshot: true,
         usedInUi: true,
     },
-    analyticsId: {
+    user_analyticsId: {
         includeInStateLogs: true,
         persist: true,
         includeInDebugSnapshot: true,
@@ -53,20 +54,24 @@ const analyticsControllerMetadata = {
  */
 export function getDefaultAnalyticsControllerState() {
     return {
-        enabled: true,
-        optedIn: false,
-        analyticsId: uuidv4(),
+        user_optedIn: false,
+        user_socialOptedIn: false,
+        user_analyticsId: uuidv4(),
     };
 }
 // === MESSENGER ===
 const MESSENGER_EXPOSED_METHODS = [
     'trackEvent',
     'identify',
-    'trackPage',
-    'enable',
-    'disable',
+    'trackView',
     'optIn',
     'optOut',
+    'socialOptIn',
+    'socialOptOut',
+    'getAnalyticsId',
+    'isEnabled',
+    'isOptedIn',
+    'isSocialOptedIn',
 ];
 /**
  * The AnalyticsController manages analytics tracking across platforms (Mobile/Extension).
@@ -83,111 +88,179 @@ export class AnalyticsController extends BaseController {
      * Constructs an AnalyticsController instance.
      *
      * @param options - Controller options
-     * @param options.state - Initial controller state (defaults from getDefaultAnalyticsControllerState)
+     * @param options.state - Initial controller state (defaults from getDefaultAnalyticsControllerState).
+     * For migration from a previous system, pass the existing analytics ID via state.user_analyticsId.
      * @param options.messenger - Messenger used to communicate with BaseController
      * @param options.platformAdapter - Platform adapter implementation for tracking
      */
     constructor({ state = {}, messenger, platformAdapter, }) {
+        const initialState = {
+            ...getDefaultAnalyticsControllerState(),
+            ...state,
+        };
         super({
             name: controllerName,
             metadata: analyticsControllerMetadata,
-            state: {
-                ...getDefaultAnalyticsControllerState(),
-                ...state,
-            },
+            state: initialState,
             messenger,
         });
         _AnalyticsController_platformAdapter.set(this, void 0);
         __classPrivateFieldSet(this, _AnalyticsController_platformAdapter, platformAdapter, "f");
         this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
         projectLogger('AnalyticsController initialized and ready', {
-            enabled: this.state.enabled,
-            optedIn: this.state.optedIn,
-            analyticsId: this.state.analyticsId,
+            enabled: computeEnabledState(this.state),
+            optedIn: this.state.user_optedIn,
+            socialOptedIn: this.state.user_socialOptedIn,
+            analyticsId: this.state.user_analyticsId,
         });
+        // Call onSetupCompleted lifecycle hook after initialization
+        // Only call if analyticsId is set and is a valid UUIDv4 (this is the definition of "completed" setup)
+        if (this.state.user_analyticsId &&
+            uuidValidate(this.state.user_analyticsId) &&
+            uuidVersion(this.state.user_analyticsId) === 4) {
+            try {
+                __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").onSetupCompleted(this.state.user_analyticsId);
+            }
+            catch (error) {
+                // Log error but don't throw - adapter setup failure shouldn't break controller
+                projectLogger('Error calling platformAdapter.onSetupCompleted', error);
+            }
+        }
+        else {
+            // analyticsId is undefined, null, empty string, or not a valid UUIDv4
+            throw new Error(`Invalid analyticsId: expected a valid UUIDv4, but got ${JSON.stringify(this.state.user_analyticsId)}`);
+        }
     }
     /**
      * Track an analytics event.
      *
      * Events are only tracked if analytics is enabled.
      *
-     * @param eventName - The name of the event
-     * @param properties - Event properties
+     * @param event - Analytics event with properties and sensitive properties
      */
-    trackEvent(eventName, properties = {}) {
+    trackEvent(event) {
         // Don't track if analytics is disabled
-        if (!this.state.enabled) {
+        if (!computeEnabledState(this.state)) {
             return;
         }
-        // Delegate to platform adapter
-        __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").trackEvent(eventName, properties);
+        // if event does not have properties, only send the non-anonymous empty event
+        // and return to prevent any additional processing
+        if (!event.hasProperties) {
+            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, {
+                anonymous: false,
+            });
+            return;
+        }
+        // Log all non-anonymous properties, or an empty event if there's no non-anon props.
+        __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, {
+            anonymous: false,
+            ...event.properties,
+        });
+        // Track all sensitive properties in an anonymous event
+        if (event.isAnonymous) {
+            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").track(event.name, {
+                anonymous: true,
+                ...event.properties,
+                ...event.sensitiveProperties,
+            });
+        }
     }
     /**
      * Identify a user for analytics.
      *
-     * @param userId - The user identifier (e.g., metametrics ID)
      * @param traits - User traits/properties
      */
-    identify(userId, traits) {
-        if (!this.state.enabled) {
+    identify(traits) {
+        if (!computeEnabledState(this.state)) {
             return;
         }
-        // Update state with analytics ID
-        this.update((state) => {
-            state.analyticsId = userId;
-        });
-        // Delegate to platform adapter if supported
+        // Delegate to platform adapter if supported, using the current analytics ID
         if (__classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").identify) {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").identify(userId, traits);
+            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").identify(this.state.user_analyticsId, traits);
         }
     }
     /**
      * Track a page view.
      *
-     * @param pageName - The name of the page
-     * @param properties - Page properties
+     * @param name - The name of the UI item being viewed (pages for web, screen for mobile)
+     * @param properties - UI item properties
      */
-    trackPage(pageName, properties) {
-        if (!this.state.enabled) {
+    trackView(name, properties) {
+        if (!computeEnabledState(this.state)) {
             return;
         }
-        // Delegate to platform adapter if supported
-        if (__classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").trackPage) {
-            __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").trackPage(pageName, properties);
-        }
+        // Delegate to platform adapter
+        __classPrivateFieldGet(this, _AnalyticsController_platformAdapter, "f").view(name, properties);
     }
     /**
-     * Enable analytics tracking.
+     * Opt in to analytics.
+     * This updates the user's opt-in status.
      */
-    enable() {
+    optIn() {
         this.update((state) => {
-            state.enabled = true;
+            state.user_optedIn = true;
         });
     }
     /**
-     * Disable analytics tracking.
+     * Opt out of analytics.
+     * This updates the user's opt-in status.
      */
-    disable() {
+    optOut() {
         this.update((state) => {
-            state.enabled = false;
+            state.user_optedIn = false;
         });
     }
     /**
-     * Opt in to analytics.
+     * Opt in to analytics through social account.
+     * This updates the user's social opt-in status.
      */
-    optIn() {
+    socialOptIn() {
         this.update((state) => {
-            state.optedIn = true;
+            state.user_socialOptedIn = true;
         });
     }
     /**
-     * Opt out of analytics.
+     * Opt out of analytics through social account.
+     * This updates the user's social opt-in status.
      */
-    optOut() {
+    socialOptOut() {
         this.update((state) => {
-            state.optedIn = false;
+            state.user_socialOptedIn = false;
         });
     }
+    /**
+     * Get the analytics ID from the controller state.
+     *
+     * @returns The current analytics ID.
+     */
+    getAnalyticsId() {
+        return this.state.user_analyticsId;
+    }
+    /**
+     * Get the enabled status from the controller state.
+     * This is computed from user state via the state machine.
+     *
+     * @returns The current enabled status.
+     */
+    isEnabled() {
+        return computeEnabledState(this.state);
+    }
+    /**
+     * Get the opted in status from the controller state.
+     *
+     * @returns The current opted in status.
+     */
+    isOptedIn() {
+        return this.state.user_optedIn;
+    }
+    /**
+     * Get the social opted in status from the controller state.
+     *
+     * @returns The current social opted in status.
+     */
+    isSocialOptedIn() {
+        return this.state.user_socialOptedIn;
+    }
 }
 _AnalyticsController_platformAdapter = new WeakMap();
 //# sourceMappingURL=AnalyticsController.mjs.map

package/dist/AnalyticsController.mjs.map

@@ -1 +1 @@
-{"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 { v4 as uuidv4 } from 'uuid';\n\nimport type { AnalyticsControllerMethodActions } from './AnalyticsController-method-action-types';\nimport { projectLogger } from './AnalyticsLogger';\nimport type {\n  AnalyticsPlatformAdapter,\n  AnalyticsEventProperties,\n} from './AnalyticsPlatformAdapter.types';\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 analytics tracking is enabled\n   */\n  enabled: boolean;\n\n  /**\n   * Whether the user has opted in to analytics\n   */\n  optedIn: boolean;\n\n  /**\n   * User's UUIDv4 analytics identifier\n   */\n  analyticsId: string;\n};\n\n/**\n * The metadata for each property in {@link AnalyticsControllerState}.\n */\nconst analyticsControllerMetadata = {\n  enabled: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\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/**\n * Constructs the default {@link AnalyticsController} state. This allows\n * consumers to provide a partial state object when initializing the controller\n * and also helps in constructing complete state objects for this controller in\n * tests.\n *\n * @returns The default {@link AnalyticsController} state.\n */\nexport function getDefaultAnalyticsControllerState(): AnalyticsControllerState {\n  return {\n    enabled: true,\n    optedIn: false,\n    analyticsId: uuidv4(),\n  };\n}\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'trackEvent',\n  'identify',\n  'trackPage',\n  'enable',\n  'disable',\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  state?: Partial<AnalyticsControllerState>;\n  messenger: AnalyticsControllerMessenger;\n  /**\n   * Platform adapter implementation for tracking events\n   */\n  platformAdapter: AnalyticsPlatformAdapter;\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 */\nexport class AnalyticsController extends BaseController<\n  'AnalyticsController',\n  AnalyticsControllerState,\n  AnalyticsControllerMessenger\n> {\n  readonly #platformAdapter: AnalyticsPlatformAdapter;\n\n  /**\n   * Constructs an AnalyticsController instance.\n   *\n   * @param options - Controller options\n   * @param options.state - Initial controller state (defaults from getDefaultAnalyticsControllerState)\n   * @param options.messenger - Messenger used to communicate with BaseController\n   * @param options.platformAdapter - Platform adapter implementation for tracking\n   */\n  constructor({\n    state = {},\n    messenger,\n    platformAdapter,\n  }: AnalyticsControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: analyticsControllerMetadata,\n      state: {\n        ...getDefaultAnalyticsControllerState(),\n        ...state,\n      },\n      messenger,\n    });\n\n    this.#platformAdapter = platformAdapter;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    projectLogger('AnalyticsController initialized and ready', {\n      enabled: this.state.enabled,\n      optedIn: this.state.optedIn,\n      analyticsId: this.state.analyticsId,\n    });\n  }\n\n  /**\n   * Track an analytics event.\n   *\n   * Events are only tracked if analytics is enabled.\n   *\n   * @param eventName - The name of the event\n   * @param properties - Event properties\n   */\n  trackEvent(\n    eventName: string,\n    properties: AnalyticsEventProperties = {},\n  ): void {\n    // Don't track if analytics is disabled\n    if (!this.state.enabled) {\n      return;\n    }\n\n    // Delegate to platform adapter\n    this.#platformAdapter.trackEvent(eventName, properties);\n  }\n\n  /**\n   * Identify a user for analytics.\n   *\n   * @param userId - The user identifier (e.g., metametrics ID)\n   * @param traits - User traits/properties\n   */\n  identify(userId: string, traits?: AnalyticsEventProperties): void {\n    if (!this.state.enabled) {\n      return;\n    }\n\n    // Update state with analytics ID\n    this.update((state) => {\n      state.analyticsId = userId;\n    });\n\n    // Delegate to platform adapter if supported\n    if (this.#platformAdapter.identify) {\n      this.#platformAdapter.identify(userId, traits);\n    }\n  }\n\n  /**\n   * Track a page view.\n   *\n   * @param pageName - The name of the page\n   * @param properties - Page properties\n   */\n  trackPage(pageName: string, properties?: AnalyticsEventProperties): void {\n    if (!this.state.enabled) {\n      return;\n    }\n\n    // Delegate to platform adapter if supported\n    if (this.#platformAdapter.trackPage) {\n      this.#platformAdapter.trackPage(pageName, properties);\n    }\n  }\n\n  /**\n   * Enable analytics tracking.\n   */\n  enable(): void {\n    this.update((state) => {\n      state.enabled = true;\n    });\n  }\n\n  /**\n   * Disable analytics tracking.\n   */\n  disable(): void {\n    this.update((state) => {\n      state.enabled = false;\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 {\n  v4 as uuidv4,\n  validate as uuidValidate,\n  version as uuidVersion,\n} from 'uuid';\n\nimport type { AnalyticsControllerMethodActions } from './AnalyticsController-method-action-types';\nimport { projectLogger } from './AnalyticsLogger';\nimport type {\n  AnalyticsPlatformAdapter,\n  AnalyticsEventProperties,\n  AnalyticsUserTraits,\n  AnalyticsTrackingEvent,\n} from './AnalyticsPlatformAdapter.types';\nimport { computeEnabledState } from './analyticsStateComputer';\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   * User domain: Whether the user has opted in to analytics.\n   */\n  user_optedIn: boolean;\n\n  /**\n   * User domain: Whether the user has opted in to analytics through social account.\n   */\n  user_socialOptedIn: boolean;\n\n  /**\n   * User domain: User's UUIDv4 analytics identifier.\n   */\n  user_analyticsId: string;\n};\n\n/**\n * The metadata for each property in {@link AnalyticsControllerState}.\n */\nconst analyticsControllerMetadata = {\n  user_optedIn: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  user_socialOptedIn: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: true,\n  },\n  user_analyticsId: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: true,\n    usedInUi: false,\n  },\n} satisfies StateMetadata<AnalyticsControllerState>;\n\n/**\n * Constructs the default {@link AnalyticsController} state. This allows\n * consumers to provide a partial state object when initializing the controller\n * and also helps in constructing complete state objects for this controller in\n * tests.\n *\n * @returns The default {@link AnalyticsController} state.\n */\nexport function getDefaultAnalyticsControllerState(): AnalyticsControllerState {\n  return {\n    user_optedIn: false,\n    user_socialOptedIn: false,\n    user_analyticsId: uuidv4(),\n  };\n}\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'trackEvent',\n  'identify',\n  'trackView',\n  'optIn',\n  'optOut',\n  'socialOptIn',\n  'socialOptOut',\n  'getAnalyticsId',\n  'isEnabled',\n  'isOptedIn',\n  'isSocialOptedIn',\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  state?: Partial<AnalyticsControllerState>;\n  messenger: AnalyticsControllerMessenger;\n  /**\n   * Platform adapter implementation for tracking events\n   */\n  platformAdapter: AnalyticsPlatformAdapter;\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 */\nexport class AnalyticsController extends BaseController<\n  'AnalyticsController',\n  AnalyticsControllerState,\n  AnalyticsControllerMessenger\n> {\n  readonly #platformAdapter: AnalyticsPlatformAdapter;\n\n  /**\n   * Constructs an AnalyticsController instance.\n   *\n   * @param options - Controller options\n   * @param options.state - Initial controller state (defaults from getDefaultAnalyticsControllerState).\n   * For migration from a previous system, pass the existing analytics ID via state.user_analyticsId.\n   * @param options.messenger - Messenger used to communicate with BaseController\n   * @param options.platformAdapter - Platform adapter implementation for tracking\n   */\n  constructor({\n    state = {},\n    messenger,\n    platformAdapter,\n  }: AnalyticsControllerOptions) {\n    const initialState = {\n      ...getDefaultAnalyticsControllerState(),\n      ...state,\n    };\n\n    super({\n      name: controllerName,\n      metadata: analyticsControllerMetadata,\n      state: initialState,\n      messenger,\n    });\n\n    this.#platformAdapter = platformAdapter;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    projectLogger('AnalyticsController initialized and ready', {\n      enabled: computeEnabledState(this.state),\n      optedIn: this.state.user_optedIn,\n      socialOptedIn: this.state.user_socialOptedIn,\n      analyticsId: this.state.user_analyticsId,\n    });\n\n    // Call onSetupCompleted lifecycle hook after initialization\n    // Only call if analyticsId is set and is a valid UUIDv4 (this is the definition of \"completed\" setup)\n    if (\n      this.state.user_analyticsId &&\n      uuidValidate(this.state.user_analyticsId) &&\n      uuidVersion(this.state.user_analyticsId) === 4\n    ) {\n      try {\n        this.#platformAdapter.onSetupCompleted(this.state.user_analyticsId);\n      } catch (error) {\n        // Log error but don't throw - adapter setup failure shouldn't break controller\n        projectLogger('Error calling platformAdapter.onSetupCompleted', error);\n      }\n    } else {\n      // analyticsId is undefined, null, empty string, or not a valid UUIDv4\n      throw new Error(\n        `Invalid analyticsId: expected a valid UUIDv4, but got ${JSON.stringify(this.state.user_analyticsId)}`,\n      );\n    }\n  }\n\n  /**\n   * Track an analytics event.\n   *\n   * Events are only tracked if analytics is enabled.\n   *\n   * @param event - Analytics event with properties and sensitive properties\n   */\n  trackEvent(event: AnalyticsTrackingEvent): void {\n    // Don't track if analytics is disabled\n    if (!computeEnabledState(this.state)) {\n      return;\n    }\n\n    // if event does not have properties, only send the non-anonymous empty event\n    // and return to prevent any additional processing\n    if (!event.hasProperties) {\n      this.#platformAdapter.track(event.name, {\n        anonymous: false,\n      } as AnalyticsEventProperties);\n\n      return;\n    }\n\n    // Log all non-anonymous properties, or an empty event if there's no non-anon props.\n    this.#platformAdapter.track(event.name, {\n      anonymous: false,\n      ...event.properties,\n    } as AnalyticsEventProperties);\n\n    // Track all sensitive properties in an anonymous event\n    if (event.isAnonymous) {\n      this.#platformAdapter.track(event.name, {\n        anonymous: true,\n        ...event.properties,\n        ...event.sensitiveProperties,\n      } as AnalyticsEventProperties);\n    }\n  }\n\n  /**\n   * Identify a user for analytics.\n   *\n   * @param traits - User traits/properties\n   */\n  identify(traits?: AnalyticsUserTraits): void {\n    if (!computeEnabledState(this.state)) {\n      return;\n    }\n\n    // Delegate to platform adapter if supported, using the current analytics ID\n    if (this.#platformAdapter.identify) {\n      this.#platformAdapter.identify(this.state.user_analyticsId, traits);\n    }\n  }\n\n  /**\n   * Track a page view.\n   *\n   * @param name - The name of the UI item being viewed (pages for web, screen for mobile)\n   * @param properties - UI item properties\n   */\n  trackView(name: string, properties?: AnalyticsEventProperties): void {\n    if (!computeEnabledState(this.state)) {\n      return;\n    }\n\n    // Delegate to platform adapter\n    this.#platformAdapter.view(name, properties);\n  }\n\n  /**\n   * Opt in to analytics.\n   * This updates the user's opt-in status.\n   */\n  optIn(): void {\n    this.update((state) => {\n      state.user_optedIn = true;\n    });\n  }\n\n  /**\n   * Opt out of analytics.\n   * This updates the user's opt-in status.\n   */\n  optOut(): void {\n    this.update((state) => {\n      state.user_optedIn = false;\n    });\n  }\n\n  /**\n   * Opt in to analytics through social account.\n   * This updates the user's social opt-in status.\n   */\n  socialOptIn(): void {\n    this.update((state) => {\n      state.user_socialOptedIn = true;\n    });\n  }\n\n  /**\n   * Opt out of analytics through social account.\n   * This updates the user's social opt-in status.\n   */\n  socialOptOut(): void {\n    this.update((state) => {\n      state.user_socialOptedIn = false;\n    });\n  }\n\n  /**\n   * Get the analytics ID from the controller state.\n   *\n   * @returns The current analytics ID.\n   */\n  getAnalyticsId(): string {\n    return this.state.user_analyticsId;\n  }\n\n  /**\n   * Get the enabled status from the controller state.\n   * This is computed from user state via the state machine.\n   *\n   * @returns The current enabled status.\n   */\n  isEnabled(): boolean {\n    return computeEnabledState(this.state);\n  }\n\n  /**\n   * Get the opted in status from the controller state.\n   *\n   * @returns The current opted in status.\n   */\n  isOptedIn(): boolean {\n    return this.state.user_optedIn;\n  }\n\n  /**\n   * Get the social opted in status from the controller state.\n   *\n   * @returns The current social opted in status.\n   */\n  isSocialOptedIn(): boolean {\n    return this.state.user_socialOptedIn;\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 * Platform adapter interface for analytics tracking\n * Implementations should handle platform-specific details (Segment SDK, etc.)\n *\n * @todo This type is work in progress and will be updated as we\n * integrate with the new analytics system on mobile.\n * We have this draft type to help us iterate on the implementation.\n * It will be updated with proper types as we create the mobile adapter\n * And the controller package will be released only when this is completed.\n */\nexport type AnalyticsPlatformAdapter = {\n  /**\n   * Track an analytics event\n   *\n   * @param eventName - The name of the event\n   * @param properties - Event properties\n   */\n  trackEvent(eventName: string, properties: AnalyticsEventProperties): void;\n\n  /**\n   * Identify a user\n   *\n   * @param userId - The user identifier (e.g., metametrics ID)\n   * @param traits - User traits/properties\n   */\n  identify?(userId: string, traits?: AnalyticsEventProperties): void;\n\n  /**\n   * Track a page view\n   *\n   * @param pageName - The name of the page\n   * @param properties - Page properties\n   */\n  trackPage?(pageName: string, properties?: AnalyticsEventProperties): 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 * Represents values that can be passed as properties to the event tracking function.\n * Similar to JsonValue from Segment SDK but decoupled for platform agnosticism.\n */\ntype AnalyticsJsonValue =\n  | boolean\n  | number\n  | string\n  | null\n  | AnalyticsJsonValue[]\n  | AnalyticsJsonMap\n  | undefined;\n\n/**\n * Represents the map object used to pass properties to the event tracking function.\n * Similar to JsonMap from Segment SDK but decoupled for platform agnosticism.\n */\ntype AnalyticsJsonMap = {\n  [key: string]: AnalyticsJsonValue;\n  [index: number]: AnalyticsJsonValue;\n};\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 anonymous and non-anonymous data.\n * Similar to ITrackingEvent from legacy analytics but decoupled for platform agnosticism.\n */\nexport type AnalyticsTrackingEvent = {\n  readonly name: string;\n  properties: AnalyticsJsonMap;\n  sensitiveProperties: AnalyticsJsonMap;\n  saveDataRecording: boolean;\n  readonly isAnonymous: boolean;\n  readonly hasProperties: boolean;\n};\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   * 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\n   */\n  track(eventName: string, properties: AnalyticsEventProperties): 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   */\n  identify(userId: string, traits?: AnalyticsUserTraits): void;\n\n  /**\n   * Track a UI unit (page or screen) view depending on the platform\n   *\n   * This is the same as page in Segment web SDK and screen in Segment mobile SDK.\n   * Each platform adapter should implement this method to track UI views\n   * using the appropriate method for the platform: \"pages\" for web, \"screen\" for mobile.\n   *\n   * @param name - The name of the UI item being viewed (pages for web, screen for mobile)\n   * @param properties - Page properties\n   */\n  view(name: string, properties?: AnalyticsEventProperties): 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"]}

package/dist/AnalyticsPlatformAdapter.types.d.cts

@@ -1,39 +1,95 @@
 import type { Json } from "@metamask/utils";
+/**
+ * Represents values that can be passed as properties to the event tracking function.
+ * Similar to JsonValue from Segment SDK but decoupled for platform agnosticism.
+ */
+type AnalyticsJsonValue = boolean | number | string | null | AnalyticsJsonValue[] | AnalyticsJsonMap | undefined;
+/**
+ * Represents the map object used to pass properties to the event tracking function.
+ * Similar to JsonMap from Segment SDK but decoupled for platform agnosticism.
+ */
+type AnalyticsJsonMap = {
+    [key: string]: AnalyticsJsonValue;
+    [index: number]: AnalyticsJsonValue;
+};
 /**
  * Analytics event properties
  */
 export type AnalyticsEventProperties = Record<string, Json>;
+/**
+ * User traits/properties for analytics identification
+ */
+export type AnalyticsUserTraits = Record<string, Json>;
+/**
+ * Event properties structure with two distinct properties lists for anonymous and non-anonymous data.
+ * Similar to ITrackingEvent from legacy analytics but decoupled for platform agnosticism.
+ */
+export type AnalyticsTrackingEvent = {
+    readonly name: string;
+    properties: AnalyticsJsonMap;
+    sensitiveProperties: AnalyticsJsonMap;
+    saveDataRecording: boolean;
+    readonly isAnonymous: boolean;
+    readonly hasProperties: boolean;
+};
 /**
  * Platform adapter interface for analytics tracking
  * Implementations should handle platform-specific details (Segment SDK, etc.)
- *
- * @todo This type is work in progress and will be updated as we
- * integrate with the new analytics system on mobile.
- * We have this draft type to help us iterate on the implementation.
- * It will be updated with proper types as we create the mobile adapter
- * And the controller package will be released only when this is completed.
  */
 export type AnalyticsPlatformAdapter = {
     /**
-     * Track an analytics event
+     * Track an analytics event.
+     *
+     * This is the same as trackEvent in the old analytics system
      *
      * @param eventName - The name of the event
      * @param properties - Event properties
      */
-    trackEvent(eventName: string, properties: AnalyticsEventProperties): void;
+    track(eventName: string, properties: AnalyticsEventProperties): void;
     /**
-     * Identify a user
+     * Identify a user with traits.
      *
      * @param userId - The user identifier (e.g., metametrics ID)
      * @param traits - User traits/properties
      */
-    identify?(userId: string, traits?: AnalyticsEventProperties): void;
+    identify(userId: string, traits?: AnalyticsUserTraits): void;
     /**
-     * Track a page view
+     * Track a UI unit (page or screen) view depending on the platform
+     *
+     * This is the same as page in Segment web SDK and screen in Segment mobile SDK.
+     * Each platform adapter should implement this method to track UI views
+     * using the appropriate method for the platform: "pages" for web, "screen" for mobile.
      *
-     * @param pageName - The name of the page
+     * @param name - The name of the UI item being viewed (pages for web, screen for mobile)
      * @param properties - Page properties
      */
-    trackPage?(pageName: string, properties?: AnalyticsEventProperties): void;
+    view(name: string, properties?: AnalyticsEventProperties): void;
+    /**
+     * Lifecycle hook called after the AnalyticsController is fully initialized.
+     *
+     * This hook allows platform-specific adapters to perform setup that requires
+     * access to the controller's state (e.g., analyticsId).
+     *
+     * The controller calls this method once after initialization, passing the
+     * analyticsId from controller state. The analyticsId is guaranteed to be set
+     * when this method is called - this is the definition of "completed" setup.
+     *
+     * @param analyticsId - The analytics ID from controller state. Always set (never empty).
+     * @throws {AnalyticsPlatformAdapterSetupError} May throw errors during setup (e.g., configuration errors, network failures).
+     * Errors thrown by this method are caught and logged by the controller, but do not prevent
+     * controller initialization from completing successfully.
+     *
+     * @example
+     * ```typescript
+     * onSetupCompleted(analyticsId: string): void {
+     *   // Add platform-specific plugins that require analyticsId
+     *   client.add({
+     *     plugin: new PrivacyPlugin(analyticsId),
+     *   });
+     * }
+     * ```
+     */
+    onSetupCompleted(analyticsId: string): void;
 };
+export {};
 //# sourceMappingURL=AnalyticsPlatformAdapter.types.d.cts.map

package/dist/AnalyticsPlatformAdapter.types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsPlatformAdapter.types.d.cts","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapter.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAE1E;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAEnE;;;;;OAKG;IACH,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC3E,CAAC"}
+{"version":3,"file":"AnalyticsPlatformAdapter.types.d.cts","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapter.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C;;;GAGG;AACH,KAAK,kBAAkB,GACnB,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,GACJ,kBAAkB,EAAE,GACpB,gBAAgB,GAChB,SAAS,CAAC;AAEd;;;GAGG;AACH,KAAK,gBAAgB,GAAG;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAClC,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,mBAAmB,EAAE,gBAAgB,CAAC;IACtC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAErE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE7D;;;;;;;;;OASG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAEhE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C,CAAC"}

package/dist/AnalyticsPlatformAdapter.types.d.mts

@@ -1,39 +1,95 @@
 import type { Json } from "@metamask/utils";
+/**
+ * Represents values that can be passed as properties to the event tracking function.
+ * Similar to JsonValue from Segment SDK but decoupled for platform agnosticism.
+ */
+type AnalyticsJsonValue = boolean | number | string | null | AnalyticsJsonValue[] | AnalyticsJsonMap | undefined;
+/**
+ * Represents the map object used to pass properties to the event tracking function.
+ * Similar to JsonMap from Segment SDK but decoupled for platform agnosticism.
+ */
+type AnalyticsJsonMap = {
+    [key: string]: AnalyticsJsonValue;
+    [index: number]: AnalyticsJsonValue;
+};
 /**
  * Analytics event properties
  */
 export type AnalyticsEventProperties = Record<string, Json>;
+/**
+ * User traits/properties for analytics identification
+ */
+export type AnalyticsUserTraits = Record<string, Json>;
+/**
+ * Event properties structure with two distinct properties lists for anonymous and non-anonymous data.
+ * Similar to ITrackingEvent from legacy analytics but decoupled for platform agnosticism.
+ */
+export type AnalyticsTrackingEvent = {
+    readonly name: string;
+    properties: AnalyticsJsonMap;
+    sensitiveProperties: AnalyticsJsonMap;
+    saveDataRecording: boolean;
+    readonly isAnonymous: boolean;
+    readonly hasProperties: boolean;
+};
 /**
  * Platform adapter interface for analytics tracking
  * Implementations should handle platform-specific details (Segment SDK, etc.)
- *
- * @todo This type is work in progress and will be updated as we
- * integrate with the new analytics system on mobile.
- * We have this draft type to help us iterate on the implementation.
- * It will be updated with proper types as we create the mobile adapter
- * And the controller package will be released only when this is completed.
  */
 export type AnalyticsPlatformAdapter = {
     /**
-     * Track an analytics event
+     * Track an analytics event.
+     *
+     * This is the same as trackEvent in the old analytics system
      *
      * @param eventName - The name of the event
      * @param properties - Event properties
      */
-    trackEvent(eventName: string, properties: AnalyticsEventProperties): void;
+    track(eventName: string, properties: AnalyticsEventProperties): void;
     /**
-     * Identify a user
+     * Identify a user with traits.
      *
      * @param userId - The user identifier (e.g., metametrics ID)
      * @param traits - User traits/properties
      */
-    identify?(userId: string, traits?: AnalyticsEventProperties): void;
+    identify(userId: string, traits?: AnalyticsUserTraits): void;
     /**
-     * Track a page view
+     * Track a UI unit (page or screen) view depending on the platform
+     *
+     * This is the same as page in Segment web SDK and screen in Segment mobile SDK.
+     * Each platform adapter should implement this method to track UI views
+     * using the appropriate method for the platform: "pages" for web, "screen" for mobile.
      *
-     * @param pageName - The name of the page
+     * @param name - The name of the UI item being viewed (pages for web, screen for mobile)
      * @param properties - Page properties
      */
-    trackPage?(pageName: string, properties?: AnalyticsEventProperties): void;
+    view(name: string, properties?: AnalyticsEventProperties): void;
+    /**
+     * Lifecycle hook called after the AnalyticsController is fully initialized.
+     *
+     * This hook allows platform-specific adapters to perform setup that requires
+     * access to the controller's state (e.g., analyticsId).
+     *
+     * The controller calls this method once after initialization, passing the
+     * analyticsId from controller state. The analyticsId is guaranteed to be set
+     * when this method is called - this is the definition of "completed" setup.
+     *
+     * @param analyticsId - The analytics ID from controller state. Always set (never empty).
+     * @throws {AnalyticsPlatformAdapterSetupError} May throw errors during setup (e.g., configuration errors, network failures).
+     * Errors thrown by this method are caught and logged by the controller, but do not prevent
+     * controller initialization from completing successfully.
+     *
+     * @example
+     * ```typescript
+     * onSetupCompleted(analyticsId: string): void {
+     *   // Add platform-specific plugins that require analyticsId
+     *   client.add({
+     *     plugin: new PrivacyPlugin(analyticsId),
+     *   });
+     * }
+     * ```
+     */
+    onSetupCompleted(analyticsId: string): void;
 };
+export {};
 //# sourceMappingURL=AnalyticsPlatformAdapter.types.d.mts.map

package/dist/AnalyticsPlatformAdapter.types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsPlatformAdapter.types.d.mts","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapter.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAE1E;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAEnE;;;;;OAKG;IACH,SAAS,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC3E,CAAC"}
+{"version":3,"file":"AnalyticsPlatformAdapter.types.d.mts","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapter.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAE5C;;;GAGG;AACH,KAAK,kBAAkB,GACnB,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,GACJ,kBAAkB,EAAE,GACpB,gBAAgB,GAChB,SAAS,CAAC;AAEd;;;GAGG;AACH,KAAK,gBAAgB,GAAG;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAClC,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,mBAAmB,EAAE,gBAAgB,CAAC;IACtC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAErE;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAE7D;;;;;;;;;OASG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAEhE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C,CAAC"}

package/dist/AnalyticsPlatformAdapter.types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"AnalyticsPlatformAdapter.types.mjs","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 * Platform adapter interface for analytics tracking\n * Implementations should handle platform-specific details (Segment SDK, etc.)\n *\n * @todo This type is work in progress and will be updated as we\n * integrate with the new analytics system on mobile.\n * We have this draft type to help us iterate on the implementation.\n * It will be updated with proper types as we create the mobile adapter\n * And the controller package will be released only when this is completed.\n */\nexport type AnalyticsPlatformAdapter = {\n  /**\n   * Track an analytics event\n   *\n   * @param eventName - The name of the event\n   * @param properties - Event properties\n   */\n  trackEvent(eventName: string, properties: AnalyticsEventProperties): void;\n\n  /**\n   * Identify a user\n   *\n   * @param userId - The user identifier (e.g., metametrics ID)\n   * @param traits - User traits/properties\n   */\n  identify?(userId: string, traits?: AnalyticsEventProperties): void;\n\n  /**\n   * Track a page view\n   *\n   * @param pageName - The name of the page\n   * @param properties - Page properties\n   */\n  trackPage?(pageName: string, properties?: AnalyticsEventProperties): void;\n};\n"]}
+{"version":3,"file":"AnalyticsPlatformAdapter.types.mjs","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapter.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Json } from '@metamask/utils';\n\n/**\n * Represents values that can be passed as properties to the event tracking function.\n * Similar to JsonValue from Segment SDK but decoupled for platform agnosticism.\n */\ntype AnalyticsJsonValue =\n  | boolean\n  | number\n  | string\n  | null\n  | AnalyticsJsonValue[]\n  | AnalyticsJsonMap\n  | undefined;\n\n/**\n * Represents the map object used to pass properties to the event tracking function.\n * Similar to JsonMap from Segment SDK but decoupled for platform agnosticism.\n */\ntype AnalyticsJsonMap = {\n  [key: string]: AnalyticsJsonValue;\n  [index: number]: AnalyticsJsonValue;\n};\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 anonymous and non-anonymous data.\n * Similar to ITrackingEvent from legacy analytics but decoupled for platform agnosticism.\n */\nexport type AnalyticsTrackingEvent = {\n  readonly name: string;\n  properties: AnalyticsJsonMap;\n  sensitiveProperties: AnalyticsJsonMap;\n  saveDataRecording: boolean;\n  readonly isAnonymous: boolean;\n  readonly hasProperties: boolean;\n};\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   * 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\n   */\n  track(eventName: string, properties: AnalyticsEventProperties): 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   */\n  identify(userId: string, traits?: AnalyticsUserTraits): void;\n\n  /**\n   * Track a UI unit (page or screen) view depending on the platform\n   *\n   * This is the same as page in Segment web SDK and screen in Segment mobile SDK.\n   * Each platform adapter should implement this method to track UI views\n   * using the appropriate method for the platform: \"pages\" for web, \"screen\" for mobile.\n   *\n   * @param name - The name of the UI item being viewed (pages for web, screen for mobile)\n   * @param properties - Page properties\n   */\n  view(name: string, properties?: AnalyticsEventProperties): 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"]}

package/dist/AnalyticsPlatformAdapterSetupError.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalyticsPlatformAdapterSetupError = void 0;
+/**
+ * Error thrown when platform adapter setup fails during the onSetupCompleted lifecycle hook.
+ */
+class AnalyticsPlatformAdapterSetupError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = this.constructor.name;
+        if (cause) {
+            this.cause = cause;
+        }
+    }
+}
+exports.AnalyticsPlatformAdapterSetupError = AnalyticsPlatformAdapterSetupError;
+//# sourceMappingURL=AnalyticsPlatformAdapterSetupError.cjs.map

package/dist/AnalyticsPlatformAdapterSetupError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPlatformAdapterSetupError.cjs","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapterSetupError.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,kCAAmC,SAAQ,KAAK;IAG3D,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;CACF;AAVD,gFAUC","sourcesContent":["/**\n * Error thrown when platform adapter setup fails during the onSetupCompleted lifecycle hook.\n */\nexport class AnalyticsPlatformAdapterSetupError extends Error {\n  cause?: Error;\n\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = this.constructor.name;\n    if (cause) {\n      this.cause = cause;\n    }\n  }\n}\n"]}