@metamask-previews/analytics-controller 0.0.0-preview-d21b3dc → 0.0.0-preview-a5935709

package/dist/AnalyticsPlatformAdapter.types.d.mts

@@ -3,37 +3,85 @@ import type { Json } from "@metamask/utils";
  * 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 regular and sensitive data.
+ * Similar to ITrackingEvent from legacy analytics but decoupled for platform agnosticism.
+ * Sensitivity is derived from the presence of sensitiveProperties (if sensitiveProperties has keys, the event is sensitive).
+ */
+export type AnalyticsTrackingEvent = {
+    readonly name: string;
+    properties: AnalyticsEventProperties;
+    sensitiveProperties: AnalyticsEventProperties;
+    /**
+     * Legacy property handled by the mobile app.
+     * This property is ignored by the analytics controller and will be removed from the type in the future.
+     * The mobile app will use the future analytics privacy controller to handle this functionality.
+     */
+    saveDataRecording: 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
+     * @param properties - Event properties. If not provided, the event has no properties.
+     * The privacy plugin should check for `isSensitive === true` to determine if an event contains sensitive data.
      */
-    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 method delegates to platform-specific Segment SDK methods:
+     * - Web adapters should call `analytics.page(name, properties)`
+     * - Mobile adapters should call `analytics.screen(name, properties)`
+     *
+     * @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
+     */
+    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.
      *
-     * @param pageName - The name of the page
-     * @param properties - Page properties
+     * @example
+     * ```typescript
+     * async onSetupCompleted(analyticsId: string): Promise<void> {
+     *   // Add platform-specific plugins that require analyticsId
+     *   client.add({
+     *     plugin: new PrivacyPlugin(analyticsId),
+     *   });
+     * }
+     * ```
      */
-    trackPage?(pageName: string, properties?: AnalyticsEventProperties): void;
+    onSetupCompleted(analyticsId: string): Promise<void>;
 };
 //# 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;;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;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,wBAAwB,CAAC;IACrC,mBAAmB,EAAE,wBAAwB,CAAC;IAC9C;;;;OAIG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;;;;;OAQG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAEtE;;;;;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,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD,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 * Analytics event properties\n */\nexport type AnalyticsEventProperties = Record<string, Json>;\n\n/**\n * User traits/properties for analytics identification\n */\nexport type AnalyticsUserTraits = Record<string, Json>;\n\n/**\n * Event properties structure with two distinct properties lists for regular and sensitive data.\n * Similar to ITrackingEvent from legacy analytics but decoupled for platform agnosticism.\n * Sensitivity is derived from the presence of sensitiveProperties (if sensitiveProperties has keys, the event is sensitive).\n */\nexport type AnalyticsTrackingEvent = {\n  readonly name: string;\n  properties: AnalyticsEventProperties;\n  sensitiveProperties: AnalyticsEventProperties;\n  /**\n   * Legacy property handled by the mobile app.\n   * This property is ignored by the analytics controller and will be removed from the type in the future.\n   * The mobile app will use the future analytics privacy controller to handle this functionality.\n   */\n  saveDataRecording: boolean;\n  readonly hasProperties: boolean;\n};\n\n/**\n * 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. If not provided, the event has no properties.\n   * The privacy plugin should check for `isSensitive === true` to determine if an event contains sensitive data.\n   */\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 method delegates to platform-specific Segment SDK methods:\n   * - Web adapters should call `analytics.page(name, properties)`\n   * - Mobile adapters should call `analytics.screen(name, properties)`\n   *\n   * @param name - The identifier/name of the page or screen being viewed (e.g., \"home\", \"settings\", \"wallet\")\n   * @param properties - Optional properties associated with the view\n   */\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   * async onSetupCompleted(analyticsId: string): Promise<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): Promise<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"]}

package/dist/AnalyticsPlatformAdapterSetupError.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Error thrown when platform adapter setup fails during the onSetupCompleted lifecycle hook.
+ */
+export declare class AnalyticsPlatformAdapterSetupError extends Error {
+    cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=AnalyticsPlatformAdapterSetupError.d.cts.map

package/dist/AnalyticsPlatformAdapterSetupError.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPlatformAdapterSetupError.d.cts","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapterSetupError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,kCAAmC,SAAQ,KAAK;IAC3D,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEF,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAO3C"}

package/dist/AnalyticsPlatformAdapterSetupError.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Error thrown when platform adapter setup fails during the onSetupCompleted lifecycle hook.
+ */
+export declare class AnalyticsPlatformAdapterSetupError extends Error {
+    cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=AnalyticsPlatformAdapterSetupError.d.mts.map

package/dist/AnalyticsPlatformAdapterSetupError.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPlatformAdapterSetupError.d.mts","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapterSetupError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,kCAAmC,SAAQ,KAAK;IAC3D,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEF,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAO3C"}

package/dist/AnalyticsPlatformAdapterSetupError.mjs

@@ -0,0 +1,13 @@
+/**
+ * Error thrown when platform adapter setup fails during the onSetupCompleted lifecycle hook.
+ */
+export class AnalyticsPlatformAdapterSetupError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = this.constructor.name;
+        if (cause) {
+            this.cause = cause;
+        }
+    }
+}
+//# sourceMappingURL=AnalyticsPlatformAdapterSetupError.mjs.map

package/dist/AnalyticsPlatformAdapterSetupError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPlatformAdapterSetupError.mjs","sourceRoot":"","sources":["../src/AnalyticsPlatformAdapterSetupError.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,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","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"]}

package/dist/analyticsControllerStateValidator.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAnalyticsControllerState = exports.isValidUUIDv4 = void 0;
+/**
+ * UUIDv4 format regex pattern.
+ * Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ * - x is any hexadecimal digit [0-9a-f]
+ * - 4 indicates UUID version 4
+ * - y is the variant indicator [89ab]
+ */
+const UUID_V4_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+/**
+ * Validates that a string is a valid UUIDv4 format.
+ *
+ * @param value - The string to validate
+ * @returns True if the string matches UUIDv4 format
+ */
+function isValidUUIDv4(value) {
+    return typeof value === 'string' && UUID_V4_REGEX.test(value);
+}
+exports.isValidUUIDv4 = isValidUUIDv4;
+/**
+ * Validates that the analytics state has a valid UUIDv4 analyticsId.
+ *
+ * @param state - The analytics controller state to validate
+ * @throws Error if analyticsId is missing or not a valid UUIDv4
+ */
+function validateAnalyticsControllerState(state) {
+    if (!state.analyticsId || !isValidUUIDv4(state.analyticsId)) {
+        throw new Error(`Invalid analyticsId: expected a valid UUIDv4, but got ${JSON.stringify(state.analyticsId)}`);
+    }
+}
+exports.validateAnalyticsControllerState = validateAnalyticsControllerState;
+//# sourceMappingURL=analyticsControllerStateValidator.cjs.map

package/dist/analyticsControllerStateValidator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyticsControllerStateValidator.cjs","sourceRoot":"","sources":["../src/analyticsControllerStateValidator.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,MAAM,aAAa,GACjB,yEAAyE,CAAC;AAE5E;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,KAAa;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAFD,sCAEC;AAED;;;;;GAKG;AACH,SAAgB,gCAAgC,CAC9C,KAA+B;IAE/B,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,yDAAyD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AARD,4EAQC","sourcesContent":["import type { AnalyticsControllerState } from './AnalyticsController';\n\n/**\n * UUIDv4 format regex pattern.\n * Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\n * - x is any hexadecimal digit [0-9a-f]\n * - 4 indicates UUID version 4\n * - y is the variant indicator [89ab]\n */\nconst UUID_V4_REGEX =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;\n\n/**\n * Validates that a string is a valid UUIDv4 format.\n *\n * @param value - The string to validate\n * @returns True if the string matches UUIDv4 format\n */\nexport function isValidUUIDv4(value: string): boolean {\n  return typeof value === 'string' && UUID_V4_REGEX.test(value);\n}\n\n/**\n * Validates that the analytics state has a valid UUIDv4 analyticsId.\n *\n * @param state - The analytics controller state to validate\n * @throws Error if analyticsId is missing or not a valid UUIDv4\n */\nexport function validateAnalyticsControllerState(\n  state: AnalyticsControllerState,\n): void {\n  if (!state.analyticsId || !isValidUUIDv4(state.analyticsId)) {\n    throw new Error(\n      `Invalid analyticsId: expected a valid UUIDv4, but got ${JSON.stringify(state.analyticsId)}`,\n    );\n  }\n}\n"]}

package/dist/analyticsControllerStateValidator.d.cts

@@ -0,0 +1,16 @@
+import type { AnalyticsControllerState } from "./AnalyticsController.cjs";
+/**
+ * Validates that a string is a valid UUIDv4 format.
+ *
+ * @param value - The string to validate
+ * @returns True if the string matches UUIDv4 format
+ */
+export declare function isValidUUIDv4(value: string): boolean;
+/**
+ * Validates that the analytics state has a valid UUIDv4 analyticsId.
+ *
+ * @param state - The analytics controller state to validate
+ * @throws Error if analyticsId is missing or not a valid UUIDv4
+ */
+export declare function validateAnalyticsControllerState(state: AnalyticsControllerState): void;
+//# sourceMappingURL=analyticsControllerStateValidator.d.cts.map

package/dist/analyticsControllerStateValidator.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyticsControllerStateValidator.d.cts","sourceRoot":"","sources":["../src/analyticsControllerStateValidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kCAA8B;AAYtE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,wBAAwB,GAC9B,IAAI,CAMN"}

package/dist/analyticsControllerStateValidator.d.mts

@@ -0,0 +1,16 @@
+import type { AnalyticsControllerState } from "./AnalyticsController.mjs";
+/**
+ * Validates that a string is a valid UUIDv4 format.
+ *
+ * @param value - The string to validate
+ * @returns True if the string matches UUIDv4 format
+ */
+export declare function isValidUUIDv4(value: string): boolean;
+/**
+ * Validates that the analytics state has a valid UUIDv4 analyticsId.
+ *
+ * @param state - The analytics controller state to validate
+ * @throws Error if analyticsId is missing or not a valid UUIDv4
+ */
+export declare function validateAnalyticsControllerState(state: AnalyticsControllerState): void;
+//# sourceMappingURL=analyticsControllerStateValidator.d.mts.map

package/dist/analyticsControllerStateValidator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyticsControllerStateValidator.d.mts","sourceRoot":"","sources":["../src/analyticsControllerStateValidator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kCAA8B;AAYtE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,wBAAwB,GAC9B,IAAI,CAMN"}

package/dist/analyticsControllerStateValidator.mjs

@@ -0,0 +1,29 @@
+/**
+ * UUIDv4 format regex pattern.
+ * Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ * - x is any hexadecimal digit [0-9a-f]
+ * - 4 indicates UUID version 4
+ * - y is the variant indicator [89ab]
+ */
+const UUID_V4_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+/**
+ * Validates that a string is a valid UUIDv4 format.
+ *
+ * @param value - The string to validate
+ * @returns True if the string matches UUIDv4 format
+ */
+export function isValidUUIDv4(value) {
+    return typeof value === 'string' && UUID_V4_REGEX.test(value);
+}
+/**
+ * Validates that the analytics state has a valid UUIDv4 analyticsId.
+ *
+ * @param state - The analytics controller state to validate
+ * @throws Error if analyticsId is missing or not a valid UUIDv4
+ */
+export function validateAnalyticsControllerState(state) {
+    if (!state.analyticsId || !isValidUUIDv4(state.analyticsId)) {
+        throw new Error(`Invalid analyticsId: expected a valid UUIDv4, but got ${JSON.stringify(state.analyticsId)}`);
+    }
+}
+//# sourceMappingURL=analyticsControllerStateValidator.mjs.map

package/dist/analyticsControllerStateValidator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyticsControllerStateValidator.mjs","sourceRoot":"","sources":["../src/analyticsControllerStateValidator.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,aAAa,GACjB,yEAAyE,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAC9C,KAA+B;IAE/B,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CACb,yDAAyD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import type { AnalyticsControllerState } from './AnalyticsController';\n\n/**\n * UUIDv4 format regex pattern.\n * Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\n * - x is any hexadecimal digit [0-9a-f]\n * - 4 indicates UUID version 4\n * - y is the variant indicator [89ab]\n */\nconst UUID_V4_REGEX =\n  /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;\n\n/**\n * Validates that a string is a valid UUIDv4 format.\n *\n * @param value - The string to validate\n * @returns True if the string matches UUIDv4 format\n */\nexport function isValidUUIDv4(value: string): boolean {\n  return typeof value === 'string' && UUID_V4_REGEX.test(value);\n}\n\n/**\n * Validates that the analytics state has a valid UUIDv4 analyticsId.\n *\n * @param state - The analytics controller state to validate\n * @throws Error if analyticsId is missing or not a valid UUIDv4\n */\nexport function validateAnalyticsControllerState(\n  state: AnalyticsControllerState,\n): void {\n  if (!state.analyticsId || !isValidUUIDv4(state.analyticsId)) {\n    throw new Error(\n      `Invalid analyticsId: expected a valid UUIDv4, but got ${JSON.stringify(state.analyticsId)}`,\n    );\n  }\n}\n"]}

package/dist/index.cjs

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDefaultAnalyticsControllerState = exports.AnalyticsController = void 0;
-// Export controller class
+exports.analyticsControllerSelectors = exports.AnalyticsPlatformAdapterSetupError = exports.getDefaultAnalyticsControllerState = exports.AnalyticsController = void 0;
+// Export controller class and state utilities
 var AnalyticsController_1 = require("./AnalyticsController.cjs");
 Object.defineProperty(exports, "AnalyticsController", { enumerable: true, get: function () { return AnalyticsController_1.AnalyticsController; } });
-var AnalyticsController_2 = require("./AnalyticsController.cjs");
-Object.defineProperty(exports, "getDefaultAnalyticsControllerState", { enumerable: true, get: function () { return AnalyticsController_2.getDefaultAnalyticsControllerState; } });
+Object.defineProperty(exports, "getDefaultAnalyticsControllerState", { enumerable: true, get: function () { return AnalyticsController_1.getDefaultAnalyticsControllerState; } });
+// Export errors
+var AnalyticsPlatformAdapterSetupError_1 = require("./AnalyticsPlatformAdapterSetupError.cjs");
+Object.defineProperty(exports, "AnalyticsPlatformAdapterSetupError", { enumerable: true, get: function () { return AnalyticsPlatformAdapterSetupError_1.AnalyticsPlatformAdapterSetupError; } });
+// Export selectors
+var selectors_1 = require("./selectors.cjs");
+Object.defineProperty(exports, "analyticsControllerSelectors", { enumerable: true, get: function () { return selectors_1.analyticsControllerSelectors; } });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,0BAA0B;AAC1B,iEAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAW5B,iEAA2E;AAAlE,yIAAA,kCAAkC,OAAA","sourcesContent":["// Export controller class\nexport { AnalyticsController } from './AnalyticsController';\nexport type { AnalyticsControllerOptions } from './AnalyticsController';\n\n// Export types\nexport type {\n  AnalyticsEventProperties,\n  AnalyticsPlatformAdapter,\n} from './AnalyticsPlatformAdapter.types';\n\n// Export state types and utilities\nexport type { AnalyticsControllerState } from './AnalyticsController';\nexport { getDefaultAnalyticsControllerState } from './AnalyticsController';\n\n// Export messenger types\nexport type { AnalyticsControllerMessenger } from './AnalyticsController';\n\n// Export action and event types\nexport type {\n  AnalyticsControllerActions,\n  AnalyticsControllerEvents,\n  AnalyticsControllerGetStateAction,\n  AnalyticsControllerStateChangeEvent,\n  controllerName,\n} from './AnalyticsController';\nexport type {\n  AnalyticsControllerTrackEventAction,\n  AnalyticsControllerIdentifyAction,\n  AnalyticsControllerTrackPageAction,\n  AnalyticsControllerEnableAction,\n  AnalyticsControllerDisableAction,\n  AnalyticsControllerOptInAction,\n  AnalyticsControllerOptOutAction,\n  AnalyticsControllerMethodActions,\n} from './AnalyticsController-method-action-types';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,8CAA8C;AAC9C,iEAG+B;AAF7B,0HAAA,mBAAmB,OAAA;AACnB,yIAAA,kCAAkC,OAAA;AAIpC,gBAAgB;AAChB,+FAA0F;AAAjF,wJAAA,kCAAkC,OAAA;AAa3C,mBAAmB;AACnB,6CAA2D;AAAlD,yHAAA,4BAA4B,OAAA","sourcesContent":["// Export controller class and state utilities\nexport {\n  AnalyticsController,\n  getDefaultAnalyticsControllerState,\n} from './AnalyticsController';\nexport type { AnalyticsControllerOptions } from './AnalyticsController';\n\n// Export errors\nexport { AnalyticsPlatformAdapterSetupError } from './AnalyticsPlatformAdapterSetupError';\n\n// Export types\nexport type {\n  AnalyticsEventProperties,\n  AnalyticsUserTraits,\n  AnalyticsPlatformAdapter,\n  AnalyticsTrackingEvent,\n} from './AnalyticsPlatformAdapter.types';\n\n// Export state types\nexport type { AnalyticsControllerState } from './AnalyticsController';\n\n// Export selectors\nexport { analyticsControllerSelectors } from './selectors';\n\n// Export messenger types\nexport type { AnalyticsControllerMessenger } from './AnalyticsController';\n\n// Export action and event types\nexport type {\n  AnalyticsControllerActions,\n  AnalyticsControllerEvents,\n  AnalyticsControllerGetStateAction,\n  AnalyticsControllerStateChangeEvent,\n  controllerName,\n} from './AnalyticsController';\nexport type {\n  AnalyticsControllerTrackEventAction,\n  AnalyticsControllerIdentifyAction,\n  AnalyticsControllerTrackViewAction,\n  AnalyticsControllerOptInForRegularAccountAction,\n  AnalyticsControllerOptOutForRegularAccountAction,\n  AnalyticsControllerOptInForSocialAccountAction,\n  AnalyticsControllerOptOutForSocialAccountAction,\n  AnalyticsControllerMethodActions,\n} from './AnalyticsController-method-action-types';\n"]}

package/dist/index.d.cts

@@ -1,9 +1,10 @@
-export { AnalyticsController } from "./AnalyticsController.cjs";
+export { AnalyticsController, getDefaultAnalyticsControllerState, } from "./AnalyticsController.cjs";
 export type { AnalyticsControllerOptions } from "./AnalyticsController.cjs";
-export type { AnalyticsEventProperties, AnalyticsPlatformAdapter, } from "./AnalyticsPlatformAdapter.types.cjs";
+export { AnalyticsPlatformAdapterSetupError } from "./AnalyticsPlatformAdapterSetupError.cjs";
+export type { AnalyticsEventProperties, AnalyticsUserTraits, AnalyticsPlatformAdapter, AnalyticsTrackingEvent, } from "./AnalyticsPlatformAdapter.types.cjs";
 export type { AnalyticsControllerState } from "./AnalyticsController.cjs";
-export { getDefaultAnalyticsControllerState } from "./AnalyticsController.cjs";
+export { analyticsControllerSelectors } from "./selectors.cjs";
 export type { AnalyticsControllerMessenger } from "./AnalyticsController.cjs";
 export type { AnalyticsControllerActions, AnalyticsControllerEvents, AnalyticsControllerGetStateAction, AnalyticsControllerStateChangeEvent, controllerName, } from "./AnalyticsController.cjs";
-export type { AnalyticsControllerTrackEventAction, AnalyticsControllerIdentifyAction, AnalyticsControllerTrackPageAction, AnalyticsControllerEnableAction, AnalyticsControllerDisableAction, AnalyticsControllerOptInAction, AnalyticsControllerOptOutAction, AnalyticsControllerMethodActions, } from "./AnalyticsController-method-action-types.cjs";
+export type { AnalyticsControllerTrackEventAction, AnalyticsControllerIdentifyAction, AnalyticsControllerTrackViewAction, AnalyticsControllerOptInForRegularAccountAction, AnalyticsControllerOptOutForRegularAccountAction, AnalyticsControllerOptInForSocialAccountAction, AnalyticsControllerOptOutForSocialAccountAction, AnalyticsControllerMethodActions, } from "./AnalyticsController-method-action-types.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,kCAA8B;AAC5D,YAAY,EAAE,0BAA0B,EAAE,kCAA8B;AAGxE,YAAY,EACV,wBAAwB,EACxB,wBAAwB,GACzB,6CAAyC;AAG1C,YAAY,EAAE,wBAAwB,EAAE,kCAA8B;AACtE,OAAO,EAAE,kCAAkC,EAAE,kCAA8B;AAG3E,YAAY,EAAE,4BAA4B,EAAE,kCAA8B;AAG1E,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,iCAAiC,EACjC,mCAAmC,EACnC,cAAc,GACf,kCAA8B;AAC/B,YAAY,EACV,mCAAmC,EACnC,iCAAiC,EACjC,kCAAkC,EAClC,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,GACjC,sDAAkD"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,kCAAkC,GACnC,kCAA8B;AAC/B,YAAY,EAAE,0BAA0B,EAAE,kCAA8B;AAGxE,OAAO,EAAE,kCAAkC,EAAE,iDAA6C;AAG1F,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,GACvB,6CAAyC;AAG1C,YAAY,EAAE,wBAAwB,EAAE,kCAA8B;AAGtE,OAAO,EAAE,4BAA4B,EAAE,wBAAoB;AAG3D,YAAY,EAAE,4BAA4B,EAAE,kCAA8B;AAG1E,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,iCAAiC,EACjC,mCAAmC,EACnC,cAAc,GACf,kCAA8B;AAC/B,YAAY,EACV,mCAAmC,EACnC,iCAAiC,EACjC,kCAAkC,EAClC,+CAA+C,EAC/C,gDAAgD,EAChD,8CAA8C,EAC9C,+CAA+C,EAC/C,gCAAgC,GACjC,sDAAkD"}

package/dist/index.d.mts

@@ -1,9 +1,10 @@
-export { AnalyticsController } from "./AnalyticsController.mjs";
+export { AnalyticsController, getDefaultAnalyticsControllerState, } from "./AnalyticsController.mjs";
 export type { AnalyticsControllerOptions } from "./AnalyticsController.mjs";
-export type { AnalyticsEventProperties, AnalyticsPlatformAdapter, } from "./AnalyticsPlatformAdapter.types.mjs";
+export { AnalyticsPlatformAdapterSetupError } from "./AnalyticsPlatformAdapterSetupError.mjs";
+export type { AnalyticsEventProperties, AnalyticsUserTraits, AnalyticsPlatformAdapter, AnalyticsTrackingEvent, } from "./AnalyticsPlatformAdapter.types.mjs";
 export type { AnalyticsControllerState } from "./AnalyticsController.mjs";
-export { getDefaultAnalyticsControllerState } from "./AnalyticsController.mjs";
+export { analyticsControllerSelectors } from "./selectors.mjs";
 export type { AnalyticsControllerMessenger } from "./AnalyticsController.mjs";
 export type { AnalyticsControllerActions, AnalyticsControllerEvents, AnalyticsControllerGetStateAction, AnalyticsControllerStateChangeEvent, controllerName, } from "./AnalyticsController.mjs";
-export type { AnalyticsControllerTrackEventAction, AnalyticsControllerIdentifyAction, AnalyticsControllerTrackPageAction, AnalyticsControllerEnableAction, AnalyticsControllerDisableAction, AnalyticsControllerOptInAction, AnalyticsControllerOptOutAction, AnalyticsControllerMethodActions, } from "./AnalyticsController-method-action-types.mjs";
+export type { AnalyticsControllerTrackEventAction, AnalyticsControllerIdentifyAction, AnalyticsControllerTrackViewAction, AnalyticsControllerOptInForRegularAccountAction, AnalyticsControllerOptOutForRegularAccountAction, AnalyticsControllerOptInForSocialAccountAction, AnalyticsControllerOptOutForSocialAccountAction, AnalyticsControllerMethodActions, } from "./AnalyticsController-method-action-types.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,kCAA8B;AAC5D,YAAY,EAAE,0BAA0B,EAAE,kCAA8B;AAGxE,YAAY,EACV,wBAAwB,EACxB,wBAAwB,GACzB,6CAAyC;AAG1C,YAAY,EAAE,wBAAwB,EAAE,kCAA8B;AACtE,OAAO,EAAE,kCAAkC,EAAE,kCAA8B;AAG3E,YAAY,EAAE,4BAA4B,EAAE,kCAA8B;AAG1E,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,iCAAiC,EACjC,mCAAmC,EACnC,cAAc,GACf,kCAA8B;AAC/B,YAAY,EACV,mCAAmC,EACnC,iCAAiC,EACjC,kCAAkC,EAClC,+BAA+B,EAC/B,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,GACjC,sDAAkD"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,kCAAkC,GACnC,kCAA8B;AAC/B,YAAY,EAAE,0BAA0B,EAAE,kCAA8B;AAGxE,OAAO,EAAE,kCAAkC,EAAE,iDAA6C;AAG1F,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,GACvB,6CAAyC;AAG1C,YAAY,EAAE,wBAAwB,EAAE,kCAA8B;AAGtE,OAAO,EAAE,4BAA4B,EAAE,wBAAoB;AAG3D,YAAY,EAAE,4BAA4B,EAAE,kCAA8B;AAG1E,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,iCAAiC,EACjC,mCAAmC,EACnC,cAAc,GACf,kCAA8B;AAC/B,YAAY,EACV,mCAAmC,EACnC,iCAAiC,EACjC,kCAAkC,EAClC,+CAA+C,EAC/C,gDAAgD,EAChD,8CAA8C,EAC9C,+CAA+C,EAC/C,gCAAgC,GACjC,sDAAkD"}

package/dist/index.mjs

@@ -1,4 +1,7 @@
-// Export controller class
-export { AnalyticsController } from "./AnalyticsController.mjs";
-export { getDefaultAnalyticsControllerState } from "./AnalyticsController.mjs";
+// Export controller class and state utilities
+export { AnalyticsController, getDefaultAnalyticsControllerState } from "./AnalyticsController.mjs";
+// Export errors
+export { AnalyticsPlatformAdapterSetupError } from "./AnalyticsPlatformAdapterSetupError.mjs";
+// Export selectors
+export { analyticsControllerSelectors } from "./selectors.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAE,mBAAmB,EAAE,kCAA8B;AAW5D,OAAO,EAAE,kCAAkC,EAAE,kCAA8B","sourcesContent":["// Export controller class\nexport { AnalyticsController } from './AnalyticsController';\nexport type { AnalyticsControllerOptions } from './AnalyticsController';\n\n// Export types\nexport type {\n  AnalyticsEventProperties,\n  AnalyticsPlatformAdapter,\n} from './AnalyticsPlatformAdapter.types';\n\n// Export state types and utilities\nexport type { AnalyticsControllerState } from './AnalyticsController';\nexport { getDefaultAnalyticsControllerState } from './AnalyticsController';\n\n// Export messenger types\nexport type { AnalyticsControllerMessenger } from './AnalyticsController';\n\n// Export action and event types\nexport type {\n  AnalyticsControllerActions,\n  AnalyticsControllerEvents,\n  AnalyticsControllerGetStateAction,\n  AnalyticsControllerStateChangeEvent,\n  controllerName,\n} from './AnalyticsController';\nexport type {\n  AnalyticsControllerTrackEventAction,\n  AnalyticsControllerIdentifyAction,\n  AnalyticsControllerTrackPageAction,\n  AnalyticsControllerEnableAction,\n  AnalyticsControllerDisableAction,\n  AnalyticsControllerOptInAction,\n  AnalyticsControllerOptOutAction,\n  AnalyticsControllerMethodActions,\n} from './AnalyticsController-method-action-types';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,OAAO,EACL,mBAAmB,EACnB,kCAAkC,EACnC,kCAA8B;AAG/B,gBAAgB;AAChB,OAAO,EAAE,kCAAkC,EAAE,iDAA6C;AAa1F,mBAAmB;AACnB,OAAO,EAAE,4BAA4B,EAAE,wBAAoB","sourcesContent":["// Export controller class and state utilities\nexport {\n  AnalyticsController,\n  getDefaultAnalyticsControllerState,\n} from './AnalyticsController';\nexport type { AnalyticsControllerOptions } from './AnalyticsController';\n\n// Export errors\nexport { AnalyticsPlatformAdapterSetupError } from './AnalyticsPlatformAdapterSetupError';\n\n// Export types\nexport type {\n  AnalyticsEventProperties,\n  AnalyticsUserTraits,\n  AnalyticsPlatformAdapter,\n  AnalyticsTrackingEvent,\n} from './AnalyticsPlatformAdapter.types';\n\n// Export state types\nexport type { AnalyticsControllerState } from './AnalyticsController';\n\n// Export selectors\nexport { analyticsControllerSelectors } from './selectors';\n\n// Export messenger types\nexport type { AnalyticsControllerMessenger } from './AnalyticsController';\n\n// Export action and event types\nexport type {\n  AnalyticsControllerActions,\n  AnalyticsControllerEvents,\n  AnalyticsControllerGetStateAction,\n  AnalyticsControllerStateChangeEvent,\n  controllerName,\n} from './AnalyticsController';\nexport type {\n  AnalyticsControllerTrackEventAction,\n  AnalyticsControllerIdentifyAction,\n  AnalyticsControllerTrackViewAction,\n  AnalyticsControllerOptInForRegularAccountAction,\n  AnalyticsControllerOptOutForRegularAccountAction,\n  AnalyticsControllerOptInForSocialAccountAction,\n  AnalyticsControllerOptOutForSocialAccountAction,\n  AnalyticsControllerMethodActions,\n} from './AnalyticsController-method-action-types';\n"]}

package/dist/selectors.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyticsControllerSelectors = void 0;
+/**
+ * Selects the analytics ID from the controller state.
+ *
+ * @param state - The controller state
+ * @returns The analytics ID
+ */
+const selectAnalyticsId = (state) => state.analyticsId;
+/**
+ * Selects the opted-in status for regular account from the controller state.
+ *
+ * @param state - The controller state
+ * @returns Whether the user has opted in for regular account
+ */
+const selectOptedInForRegularAccount = (state) => state.optedInForRegularAccount;
+/**
+ * Selects the opted-in status for social account from the controller state.
+ *
+ * @param state - The controller state
+ * @returns Whether the user has opted in for social account
+ */
+const selectOptedInForSocialAccount = (state) => state.optedInForSocialAccount;
+/**
+ * Selects the enabled status from the controller state.
+ * Analytics is enabled if the user has opted in for regular account OR social account.
+ *
+ * @param state - The controller state
+ * @returns Whether analytics tracking is enabled
+ */
+const selectEnabled = (state) => state.optedInForRegularAccount || state.optedInForSocialAccount;
+/**
+ * Selectors for the AnalyticsController state.
+ * These can be used with Redux or directly with controller state.
+ */
+exports.analyticsControllerSelectors = {
+    selectAnalyticsId,
+    selectOptedInForRegularAccount,
+    selectOptedInForSocialAccount,
+    selectEnabled,
+};
+//# sourceMappingURL=selectors.cjs.map

package/dist/selectors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.cjs","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,CAAC,KAA+B,EAAU,EAAE,CACpE,KAAK,CAAC,WAAW,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,8BAA8B,GAAG,CACrC,KAA+B,EACtB,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,6BAA6B,GAAG,CACpC,KAA+B,EACtB,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,CAAC,KAA+B,EAAW,EAAE,CACjE,KAAK,CAAC,wBAAwB,IAAI,KAAK,CAAC,uBAAuB,CAAC;AAElE;;;GAGG;AACU,QAAA,4BAA4B,GAAG;IAC1C,iBAAiB;IACjB,8BAA8B;IAC9B,6BAA6B;IAC7B,aAAa;CACd,CAAC","sourcesContent":["import type { AnalyticsControllerState } from './AnalyticsController';\n\n/**\n * Selects the analytics ID from the controller state.\n *\n * @param state - The controller state\n * @returns The analytics ID\n */\nconst selectAnalyticsId = (state: AnalyticsControllerState): string =>\n  state.analyticsId;\n\n/**\n * Selects the opted-in status for regular account from the controller state.\n *\n * @param state - The controller state\n * @returns Whether the user has opted in for regular account\n */\nconst selectOptedInForRegularAccount = (\n  state: AnalyticsControllerState,\n): boolean => state.optedInForRegularAccount;\n\n/**\n * Selects the opted-in status for social account from the controller state.\n *\n * @param state - The controller state\n * @returns Whether the user has opted in for social account\n */\nconst selectOptedInForSocialAccount = (\n  state: AnalyticsControllerState,\n): boolean => state.optedInForSocialAccount;\n\n/**\n * Selects the enabled status from the controller state.\n * Analytics is enabled if the user has opted in for regular account OR social account.\n *\n * @param state - The controller state\n * @returns Whether analytics tracking is enabled\n */\nconst selectEnabled = (state: AnalyticsControllerState): boolean =>\n  state.optedInForRegularAccount || state.optedInForSocialAccount;\n\n/**\n * Selectors for the AnalyticsController state.\n * These can be used with Redux or directly with controller state.\n */\nexport const analyticsControllerSelectors = {\n  selectAnalyticsId,\n  selectOptedInForRegularAccount,\n  selectOptedInForSocialAccount,\n  selectEnabled,\n};\n"]}

package/dist/selectors.d.cts

@@ -0,0 +1,12 @@
+import type { AnalyticsControllerState } from "./AnalyticsController.cjs";
+/**
+ * Selectors for the AnalyticsController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export declare const analyticsControllerSelectors: {
+    selectAnalyticsId: (state: AnalyticsControllerState) => string;
+    selectOptedInForRegularAccount: (state: AnalyticsControllerState) => boolean;
+    selectOptedInForSocialAccount: (state: AnalyticsControllerState) => boolean;
+    selectEnabled: (state: AnalyticsControllerState) => boolean;
+};
+//# sourceMappingURL=selectors.d.cts.map

package/dist/selectors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.cts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kCAA8B;AAyCtE;;;GAGG;AACH,eAAO,MAAM,4BAA4B;+BArCP,wBAAwB,KAAG,MAAM;4CAU1D,wBAAwB,KAC9B,OAAO;2CASD,wBAAwB,KAC9B,OAAO;2BASoB,wBAAwB,KAAG,OAAO;CAY/D,CAAC"}

package/dist/selectors.d.mts

@@ -0,0 +1,12 @@
+import type { AnalyticsControllerState } from "./AnalyticsController.mjs";
+/**
+ * Selectors for the AnalyticsController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export declare const analyticsControllerSelectors: {
+    selectAnalyticsId: (state: AnalyticsControllerState) => string;
+    selectOptedInForRegularAccount: (state: AnalyticsControllerState) => boolean;
+    selectOptedInForSocialAccount: (state: AnalyticsControllerState) => boolean;
+    selectEnabled: (state: AnalyticsControllerState) => boolean;
+};
+//# sourceMappingURL=selectors.d.mts.map

package/dist/selectors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.mts","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kCAA8B;AAyCtE;;;GAGG;AACH,eAAO,MAAM,4BAA4B;+BArCP,wBAAwB,KAAG,MAAM;4CAU1D,wBAAwB,KAC9B,OAAO;2CASD,wBAAwB,KAC9B,OAAO;2BASoB,wBAAwB,KAAG,OAAO;CAY/D,CAAC"}

package/dist/selectors.mjs

@@ -0,0 +1,40 @@
+/**
+ * Selects the analytics ID from the controller state.
+ *
+ * @param state - The controller state
+ * @returns The analytics ID
+ */
+const selectAnalyticsId = (state) => state.analyticsId;
+/**
+ * Selects the opted-in status for regular account from the controller state.
+ *
+ * @param state - The controller state
+ * @returns Whether the user has opted in for regular account
+ */
+const selectOptedInForRegularAccount = (state) => state.optedInForRegularAccount;
+/**
+ * Selects the opted-in status for social account from the controller state.
+ *
+ * @param state - The controller state
+ * @returns Whether the user has opted in for social account
+ */
+const selectOptedInForSocialAccount = (state) => state.optedInForSocialAccount;
+/**
+ * Selects the enabled status from the controller state.
+ * Analytics is enabled if the user has opted in for regular account OR social account.
+ *
+ * @param state - The controller state
+ * @returns Whether analytics tracking is enabled
+ */
+const selectEnabled = (state) => state.optedInForRegularAccount || state.optedInForSocialAccount;
+/**
+ * Selectors for the AnalyticsController state.
+ * These can be used with Redux or directly with controller state.
+ */
+export const analyticsControllerSelectors = {
+    selectAnalyticsId,
+    selectOptedInForRegularAccount,
+    selectOptedInForSocialAccount,
+    selectEnabled,
+};
+//# sourceMappingURL=selectors.mjs.map

package/dist/selectors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.mjs","sourceRoot":"","sources":["../src/selectors.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,CAAC,KAA+B,EAAU,EAAE,CACpE,KAAK,CAAC,WAAW,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,8BAA8B,GAAG,CACrC,KAA+B,EACtB,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,6BAA6B,GAAG,CACpC,KAA+B,EACtB,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,CAAC,KAA+B,EAAW,EAAE,CACjE,KAAK,CAAC,wBAAwB,IAAI,KAAK,CAAC,uBAAuB,CAAC;AAElE;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,iBAAiB;IACjB,8BAA8B;IAC9B,6BAA6B;IAC7B,aAAa;CACd,CAAC","sourcesContent":["import type { AnalyticsControllerState } from './AnalyticsController';\n\n/**\n * Selects the analytics ID from the controller state.\n *\n * @param state - The controller state\n * @returns The analytics ID\n */\nconst selectAnalyticsId = (state: AnalyticsControllerState): string =>\n  state.analyticsId;\n\n/**\n * Selects the opted-in status for regular account from the controller state.\n *\n * @param state - The controller state\n * @returns Whether the user has opted in for regular account\n */\nconst selectOptedInForRegularAccount = (\n  state: AnalyticsControllerState,\n): boolean => state.optedInForRegularAccount;\n\n/**\n * Selects the opted-in status for social account from the controller state.\n *\n * @param state - The controller state\n * @returns Whether the user has opted in for social account\n */\nconst selectOptedInForSocialAccount = (\n  state: AnalyticsControllerState,\n): boolean => state.optedInForSocialAccount;\n\n/**\n * Selects the enabled status from the controller state.\n * Analytics is enabled if the user has opted in for regular account OR social account.\n *\n * @param state - The controller state\n * @returns Whether analytics tracking is enabled\n */\nconst selectEnabled = (state: AnalyticsControllerState): boolean =>\n  state.optedInForRegularAccount || state.optedInForSocialAccount;\n\n/**\n * Selectors for the AnalyticsController state.\n * These can be used with Redux or directly with controller state.\n */\nexport const analyticsControllerSelectors = {\n  selectAnalyticsId,\n  selectOptedInForRegularAccount,\n  selectOptedInForSocialAccount,\n  selectEnabled,\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/analytics-controller",
-  "version": "0.0.0-preview-d21b3dc",
+  "version": "0.0.0-preview-a5935709",
   "description": "Common Analytics controller for event tracking",
   "keywords": [
     "MetaMask",
@@ -50,8 +50,7 @@
   "dependencies": {
     "@metamask/base-controller": "^9.0.0",
     "@metamask/messenger": "^0.3.0",
-    "@metamask/utils": "^11.8.1",
-    "uuid": "^8.3.2"
+    "@metamask/utils": "^11.8.1"
   },
   "devDependencies": {
     "@metamask/auto-changelog": "^3.4.4",