@magicpixel/rn-mp-client-sdk 1.13.21 → 1.13.23

package/README.md

@@ -14,16 +14,55 @@ npm install @magicpixel/rn-mp-client-sdk
 npm install react-native @react-native-async-storage/async-storage
 ```
 
-### For Bare React Native (Optional)
+### For Bare React Native
 
-For enhanced device info detection:
+Bare React Native apps require additional setup:
 
+#### 1. Install Required Dependencies
+
+```sh
+npm install react-native-get-random-values react-native-device-info
+```
+
+#### 2. Link Native Modules (Required)
+
+**iOS:**
 ```sh
-npm install react-native-device-info
-npx pod-install
+cd ios && pod install && cd ..
+```
+
+**Android:** Native modules are auto-linked via Gradle.
+
+> ⚠️ **Important:** After running `pod install`, you must fully restart the app:
+> 1. Kill the app in the simulator/device
+> 2. Stop Metro bundler (`Ctrl+C`)
+> 3. Restart Metro (`npx react-native start`)
+> 4. Rebuild and launch the app
+>
+> Simply reloading Metro is not sufficient - the native binary must be rebuilt.
+
+#### 3. Add Polyfill Import (Required)
+
+Add this import at the very top of your app's entry file (`index.js`), **before any other imports**:
+
+```javascript
+import 'react-native-get-random-values'; // Must be first import!
+
+import {AppRegistry} from 'react-native';
+import App from './App';
+import {name as appName} from './app.json';
+
+AppRegistry.registerComponent(appName, () => App);
 ```
 
-> **Note**: For Expo apps, device info is automatically detected using Expo modules. No additional setup required.
+> ⚠️ **Without this setup, you will see the error:**
+> ```
+> MagicPixel SDK initialization failed: Invariant Violation: TurboModuleRegistry.getEnforcing(...): 'RNGetRandomValues' could not be found.
+> ```
+
+The SDK uses ULID for generating unique identifiers, which requires `crypto.getRandomValues()`. This polyfill must be loaded before any other code runs.
+
+> **Note**: For Expo managed apps, no additional setup is required - the polyfill is handled automatically.
 
 ## Quick Start
 

package/lib/commonjs/common/device-info-helper.js

@@ -12,40 +12,55 @@ function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e =
 /**
  * Helper class to automatically detect device and app information
  * Supports both Expo and bare React Native:
- * 1. Tries Expo modules first (works in Expo Go)
- * 2. Falls back to react-native-device-info (for bare RN)
+ * 1. Tries react-native-device-info first (works in bare RN and Expo custom builds)
+ * 2. Falls back to Expo modules (for Expo Go where native modules don't work)
  * 3. Returns safe defaults if neither is available
  */
 class DeviceInfoHelper {
   /**
-   * Try to load Expo modules and react-native-device-info
-   * This uses dynamic imports to avoid errors when modules aren't available
+   * Try to load react-native-device-info first, then Expo modules
+   * Uses console.log during init to avoid Logger dependency issues if module loading fails
    */
   static async initialize() {
     if (this.initialized) return;
 
-    // Try to load Expo modules first (works in Expo Go)
+    // FIRST: Try react-native-device-info (preferred - works in bare RN and Expo custom builds)
+    // This is a direct dependency of the SDK, so it should always be available except in Expo Go
     try {
       // eslint-disable-next-line @typescript-eslint/no-var-requires
-      this.expoApplication = require('expo-application');
-      // eslint-disable-next-line @typescript-eslint/no-var-requires
-      this.expoDevice = require('expo-device');
-      // eslint-disable-next-line @typescript-eslint/no-var-requires
-      this.expoConstants = require('expo-constants').default;
-      _logger.Logger.logDbg('Using Expo modules for device info');
+      const rnDeviceInfo = require('react-native-device-info');
+      // Validate the module is actually loaded and functional
+      if (rnDeviceInfo && typeof (rnDeviceInfo.default || rnDeviceInfo).getVersion === 'function') {
+        this.deviceInfo = rnDeviceInfo.default || rnDeviceInfo;
+        this.initialized = true;
+        // Use console.log to avoid any Logger issues during early init
+        console.log('[MagicPixel DeviceInfoHelper] Using react-native-device-info');
+        return;
+      }
     } catch (error) {
-      _logger.Logger.logDbg('Expo modules not available, will try react-native-device-info');
+      // react-native-device-info not available (likely Expo Go)
+      console.log('[MagicPixel DeviceInfoHelper] react-native-device-info not available, trying Expo modules');
     }
 
-    // Fall back to react-native-device-info (for bare RN)
-    if (!this.expoApplication) {
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        this.deviceInfo = require('react-native-device-info').default;
-        _logger.Logger.logDbg('Using react-native-device-info for device info');
-      } catch (error) {
-        _logger.Logger.logError('Neither Expo modules nor react-native-device-info available:', error);
+    // SECOND: Fall back to Expo modules (for Expo Go where native modules don't work)
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const expoApp = require('expo-application');
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const expoDevice = require('expo-device');
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const expoConst = require('expo-constants');
+
+      // Validate modules are actually loaded (not undefined placeholders from Metro)
+      if (expoApp && expoDevice && expoConst && typeof expoApp.nativeApplicationVersion !== 'undefined') {
+        this.expoApplication = expoApp;
+        this.expoDevice = expoDevice;
+        this.expoConstants = expoConst.default || expoConst;
+        console.log('[MagicPixel DeviceInfoHelper] Using Expo modules');
       }
+    } catch (error) {
+      // Expo modules not available
+      console.log('[MagicPixel DeviceInfoHelper] Expo modules not available, using safe defaults');
     }
     this.initialized = true;
   }
@@ -57,20 +72,21 @@ class DeviceInfoHelper {
   static async getAppInfo() {
     await this.initialize();
     try {
-      // Try Expo modules first
-      if (this.expoApplication && this.expoDevice) {
-        return await this.getAppInfoFromExpo();
-      }
-
-      // Fall back to react-native-device-info
+      // Use react-native-device-info if available (preferred)
       if (this.deviceInfo) {
         return await this.getAppInfoFromDeviceInfo();
       }
 
+      // Fall back to Expo modules (for Expo Go)
+      if (this.expoApplication && this.expoDevice) {
+        return await this.getAppInfoFromExpo();
+      }
+
       // Return safe fallback values
       return this.getSafeDefaults();
     } catch (error) {
-      _logger.Logger.logError('Error getting device info:', error);
+      // Use console.log here as well to be safe
+      console.error('[MagicPixel DeviceInfoHelper] Error getting device info:', error);
       return this.getSafeDefaults();
     }
   }

package/lib/commonjs/common/device-info-helper.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_logger","_defineProperty","e","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","DeviceInfoHelper","initialize","initialized","expoApplication","expoDevice","expoConstants","default","Logger","logDbg","error","deviceInfo","logError","getAppInfo","getAppInfoFromExpo","getAppInfoFromDeviceInfo","getSafeDefaults","_Platform$Version","version","nativeApplicationVersion","buildNumber","nativeBuildVersion","packageName","applicationId","app_version","build_number","package_name","device_model_name","modelName","device_manufacturer","manufacturer","device_id","sessionId","os_name","Platform","OS","os_version","osVersion","Version","toString","is_tablet","deviceType","is_emulator","isDevice","uniqueId","bundleId","Promise","all","getVersion","getBuildNumber","getUniqueId","getBundleId","getModel","getManufacturerSync","getSystemVersion","isTablet","isEmulator","_Platform$Version2","getFormattedAppVersion","info","exports"],"sources":["device-info-helper.ts"],"sourcesContent":["import { Platform } from 'react-native';\nimport { Logger } from './logger';\n\ninterface DeviceAppInfo {\n  app_version: string;\n  build_number: string;\n  package_name: string;\n  device_model_name: string;\n  device_manufacturer: string;\n  device_id: string;\n  os_name: string;\n  os_version: string;\n  is_tablet: boolean;\n  is_emulator: boolean;\n}\n\n/**\n * Helper class to automatically detect device and app information\n * Supports both Expo and bare React Native:\n * 1. Tries Expo modules first (works in Expo Go)\n * 2. Falls back to react-native-device-info (for bare RN)\n * 3. Returns safe defaults if neither is available\n */\nexport class DeviceInfoHelper {\n  private static expoApplication: any = null;\n  private static expoDevice: any = null;\n  private static expoConstants: any = null;\n  private static deviceInfo: any = null;\n  private static initialized = false;\n\n  /**\n   * Try to load Expo modules and react-native-device-info\n   * This uses dynamic imports to avoid errors when modules aren't available\n   */\n  private static async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    // Try to load Expo modules first (works in Expo Go)\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      this.expoApplication = require('expo-application');\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      this.expoDevice = require('expo-device');\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      this.expoConstants = require('expo-constants').default;\n      Logger.logDbg('Using Expo modules for device info');\n    } catch (error) {\n      Logger.logDbg(\n        'Expo modules not available, will try react-native-device-info'\n      );\n    }\n\n    // Fall back to react-native-device-info (for bare RN)\n    if (!this.expoApplication) {\n      try {\n        // eslint-disable-next-line @typescript-eslint/no-var-requires\n        this.deviceInfo = require('react-native-device-info').default;\n        Logger.logDbg('Using react-native-device-info for device info');\n      } catch (error) {\n        Logger.logError(\n          'Neither Expo modules nor react-native-device-info available:',\n          error\n        );\n      }\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Get comprehensive app and device information\n   * All methods are async-safe and handle errors gracefully\n   */\n  static async getAppInfo(): Promise<DeviceAppInfo> {\n    await this.initialize();\n\n    try {\n      // Try Expo modules first\n      if (this.expoApplication && this.expoDevice) {\n        return await this.getAppInfoFromExpo();\n      }\n\n      // Fall back to react-native-device-info\n      if (this.deviceInfo) {\n        return await this.getAppInfoFromDeviceInfo();\n      }\n\n      // Return safe fallback values\n      return this.getSafeDefaults();\n    } catch (error) {\n      Logger.logError('Error getting device info:', error);\n      return this.getSafeDefaults();\n    }\n  }\n\n  /**\n   * Get device info using Expo modules (works in Expo Go)\n   */\n  private static async getAppInfoFromExpo(): Promise<DeviceAppInfo> {\n    const version = this.expoApplication.nativeApplicationVersion || 'unknown';\n    const buildNumber = this.expoApplication.nativeBuildVersion || 'unknown';\n    const packageName = this.expoApplication.applicationId || 'unknown';\n\n    return {\n      // App information\n      app_version: version,\n      build_number: buildNumber,\n      package_name: packageName,\n\n      // Device information\n      device_model_name: this.expoDevice.modelName || 'unknown',\n      device_manufacturer: this.expoDevice.manufacturer || 'unknown',\n      device_id: this.expoConstants.sessionId || 'unknown',\n\n      // OS information\n      os_name: Platform.OS,\n      os_version:\n        this.expoDevice.osVersion || Platform.Version?.toString() || 'unknown',\n\n      // Additional useful info\n      // DeviceType enum: UNKNOWN=0, PHONE=1, TABLET=2, DESKTOP=3, TV=4\n      is_tablet: this.expoDevice.deviceType === 2, // DeviceType.TABLET = 2\n      is_emulator: !this.expoDevice.isDevice,\n    };\n  }\n\n  /**\n   * Get device info using react-native-device-info (for bare RN)\n   */\n  private static async getAppInfoFromDeviceInfo(): Promise<DeviceAppInfo> {\n    const [version, buildNumber, uniqueId, bundleId] = await Promise.all([\n      this.deviceInfo.getVersion(),\n      this.deviceInfo.getBuildNumber(),\n      this.deviceInfo.getUniqueId(),\n      this.deviceInfo.getBundleId(),\n    ]);\n\n    return {\n      // App information\n      app_version: version,\n      build_number: buildNumber,\n      package_name: bundleId,\n\n      // Device information\n      device_model_name: this.deviceInfo.getModel(),\n      device_manufacturer: this.deviceInfo.getManufacturerSync(),\n      device_id: uniqueId,\n\n      // OS information\n      os_name: Platform.OS,\n      os_version: this.deviceInfo.getSystemVersion(),\n\n      // Additional useful info\n      is_tablet: this.deviceInfo.isTablet(),\n      is_emulator: await this.deviceInfo.isEmulator(),\n    };\n  }\n\n  /**\n   * Safe default values when no device info library is available\n   */\n  private static getSafeDefaults(): DeviceAppInfo {\n    return {\n      app_version: 'unknown',\n      build_number: 'unknown',\n      package_name: 'unknown',\n      device_model_name: 'unknown',\n      device_manufacturer: 'unknown',\n      device_id: 'unknown',\n      os_name: Platform.OS,\n      os_version: Platform.Version?.toString() || 'unknown',\n      is_tablet: false,\n      is_emulator: false,\n    };\n  }\n\n  /**\n   * Get app version in format: \"1.0.0 (123)\"\n   * Combines version and build number for better tracking\n   */\n  static async getFormattedAppVersion(): Promise<string> {\n    try {\n      const info = await this.getAppInfo();\n      return `${info.app_version} (${info.build_number})`;\n    } catch (error) {\n      Logger.logError('Error getting formatted app version:', error);\n      return 'unknown';\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_logger","_defineProperty","e","r","t","_toPropertyKey","Object","defineProperty","value","enumerable","configurable","writable","i","_toPrimitive","Symbol","toPrimitive","call","TypeError","String","Number","DeviceInfoHelper","initialize","initialized","rnDeviceInfo","default","getVersion","deviceInfo","console","log","error","expoApp","expoDevice","expoConst","nativeApplicationVersion","expoApplication","expoConstants","getAppInfo","getAppInfoFromDeviceInfo","getAppInfoFromExpo","getSafeDefaults","_Platform$Version","version","buildNumber","nativeBuildVersion","packageName","applicationId","app_version","build_number","package_name","device_model_name","modelName","device_manufacturer","manufacturer","device_id","sessionId","os_name","Platform","OS","os_version","osVersion","Version","toString","is_tablet","deviceType","is_emulator","isDevice","uniqueId","bundleId","Promise","all","getBuildNumber","getUniqueId","getBundleId","getModel","getManufacturerSync","getSystemVersion","isTablet","isEmulator","_Platform$Version2","getFormattedAppVersion","info","Logger","logError","exports"],"sources":["device-info-helper.ts"],"sourcesContent":["import { Platform } from 'react-native';\nimport { Logger } from './logger';\n\ninterface DeviceAppInfo {\n  app_version: string;\n  build_number: string;\n  package_name: string;\n  device_model_name: string;\n  device_manufacturer: string;\n  device_id: string;\n  os_name: string;\n  os_version: string;\n  is_tablet: boolean;\n  is_emulator: boolean;\n}\n\n/**\n * Helper class to automatically detect device and app information\n * Supports both Expo and bare React Native:\n * 1. Tries react-native-device-info first (works in bare RN and Expo custom builds)\n * 2. Falls back to Expo modules (for Expo Go where native modules don't work)\n * 3. Returns safe defaults if neither is available\n */\nexport class DeviceInfoHelper {\n  private static expoApplication: any = null;\n  private static expoDevice: any = null;\n  private static expoConstants: any = null;\n  private static deviceInfo: any = null;\n  private static initialized = false;\n\n  /**\n   * Try to load react-native-device-info first, then Expo modules\n   * Uses console.log during init to avoid Logger dependency issues if module loading fails\n   */\n  private static async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    // FIRST: Try react-native-device-info (preferred - works in bare RN and Expo custom builds)\n    // This is a direct dependency of the SDK, so it should always be available except in Expo Go\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const rnDeviceInfo = require('react-native-device-info');\n      // Validate the module is actually loaded and functional\n      if (\n        rnDeviceInfo &&\n        typeof (rnDeviceInfo.default || rnDeviceInfo).getVersion === 'function'\n      ) {\n        this.deviceInfo = rnDeviceInfo.default || rnDeviceInfo;\n        this.initialized = true;\n        // Use console.log to avoid any Logger issues during early init\n        console.log(\n          '[MagicPixel DeviceInfoHelper] Using react-native-device-info'\n        );\n        return;\n      }\n    } catch (error) {\n      // react-native-device-info not available (likely Expo Go)\n      console.log(\n        '[MagicPixel DeviceInfoHelper] react-native-device-info not available, trying Expo modules'\n      );\n    }\n\n    // SECOND: Fall back to Expo modules (for Expo Go where native modules don't work)\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const expoApp = require('expo-application');\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const expoDevice = require('expo-device');\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const expoConst = require('expo-constants');\n\n      // Validate modules are actually loaded (not undefined placeholders from Metro)\n      if (\n        expoApp &&\n        expoDevice &&\n        expoConst &&\n        typeof expoApp.nativeApplicationVersion !== 'undefined'\n      ) {\n        this.expoApplication = expoApp;\n        this.expoDevice = expoDevice;\n        this.expoConstants = expoConst.default || expoConst;\n        console.log('[MagicPixel DeviceInfoHelper] Using Expo modules');\n      }\n    } catch (error) {\n      // Expo modules not available\n      console.log(\n        '[MagicPixel DeviceInfoHelper] Expo modules not available, using safe defaults'\n      );\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Get comprehensive app and device information\n   * All methods are async-safe and handle errors gracefully\n   */\n  static async getAppInfo(): Promise<DeviceAppInfo> {\n    await this.initialize();\n\n    try {\n      // Use react-native-device-info if available (preferred)\n      if (this.deviceInfo) {\n        return await this.getAppInfoFromDeviceInfo();\n      }\n\n      // Fall back to Expo modules (for Expo Go)\n      if (this.expoApplication && this.expoDevice) {\n        return await this.getAppInfoFromExpo();\n      }\n\n      // Return safe fallback values\n      return this.getSafeDefaults();\n    } catch (error) {\n      // Use console.log here as well to be safe\n      console.error('[MagicPixel DeviceInfoHelper] Error getting device info:', error);\n      return this.getSafeDefaults();\n    }\n  }\n\n  /**\n   * Get device info using Expo modules (works in Expo Go)\n   */\n  private static async getAppInfoFromExpo(): Promise<DeviceAppInfo> {\n    const version = this.expoApplication.nativeApplicationVersion || 'unknown';\n    const buildNumber = this.expoApplication.nativeBuildVersion || 'unknown';\n    const packageName = this.expoApplication.applicationId || 'unknown';\n\n    return {\n      // App information\n      app_version: version,\n      build_number: buildNumber,\n      package_name: packageName,\n\n      // Device information\n      device_model_name: this.expoDevice.modelName || 'unknown',\n      device_manufacturer: this.expoDevice.manufacturer || 'unknown',\n      device_id: this.expoConstants.sessionId || 'unknown',\n\n      // OS information\n      os_name: Platform.OS,\n      os_version:\n        this.expoDevice.osVersion || Platform.Version?.toString() || 'unknown',\n\n      // Additional useful info\n      // DeviceType enum: UNKNOWN=0, PHONE=1, TABLET=2, DESKTOP=3, TV=4\n      is_tablet: this.expoDevice.deviceType === 2, // DeviceType.TABLET = 2\n      is_emulator: !this.expoDevice.isDevice,\n    };\n  }\n\n  /**\n   * Get device info using react-native-device-info (for bare RN)\n   */\n  private static async getAppInfoFromDeviceInfo(): Promise<DeviceAppInfo> {\n    const [version, buildNumber, uniqueId, bundleId] = await Promise.all([\n      this.deviceInfo.getVersion(),\n      this.deviceInfo.getBuildNumber(),\n      this.deviceInfo.getUniqueId(),\n      this.deviceInfo.getBundleId(),\n    ]);\n\n    return {\n      // App information\n      app_version: version,\n      build_number: buildNumber,\n      package_name: bundleId,\n\n      // Device information\n      device_model_name: this.deviceInfo.getModel(),\n      device_manufacturer: this.deviceInfo.getManufacturerSync(),\n      device_id: uniqueId,\n\n      // OS information\n      os_name: Platform.OS,\n      os_version: this.deviceInfo.getSystemVersion(),\n\n      // Additional useful info\n      is_tablet: this.deviceInfo.isTablet(),\n      is_emulator: await this.deviceInfo.isEmulator(),\n    };\n  }\n\n  /**\n   * Safe default values when no device info library is available\n   */\n  private static getSafeDefaults(): DeviceAppInfo {\n    return {\n      app_version: 'unknown',\n      build_number: 'unknown',\n      package_name: 'unknown',\n      device_model_name: 'unknown',\n      device_manufacturer: 'unknown',\n      device_id: 'unknown',\n      os_name: Platform.OS,\n      os_version: Platform.Version?.toString() || 'unknown',\n      is_tablet: false,\n      is_emulator: false,\n    };\n  }\n\n  /**\n   * Get app version in format: \"1.0.0 (123)\"\n   * Combines version and build number for better tracking\n   */\n  static async getFormattedAppVersion(): Promise<string> {\n    try {\n      const info = await this.getAppInfo();\n      return `${info.app_version} (${info.build_number})`;\n    } catch (error) {\n      Logger.logError('Error getting formatted app version:', error);\n      return 'unknown';\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/types/sdk.d.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=sdk.d.js.map

package/lib/commonjs/types/sdk.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["sdk.d.ts"],"sourcesContent":["declare module '@magicpixel/rn-mp-client-sdk' {\n  interface InitConfig {\n    orgId: string;\n    env: 'staging' | 'production';\n    projectId: string;\n    baseUrl: string;\n    logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'none';\n    eventDeduplicationWindowMs?: number;\n    onInitFailure?: (error: Error) => void;\n  }\n\n  interface UserInfo {\n    pid?: string;\n    email?: string;\n    phone?: string;\n    country?: string;\n    city?: string;\n    state?: string;\n    fName?: string;\n    lName?: string;\n    zip?: string;\n  }\n\n  interface PageLoadData {\n    page_name: string;\n    [key: string]: any;\n  }\n\n  class MagicPixelImpl {\n    init(config: InitConfig): void;\n    shutdown(): void;\n    recordEvent(eventName: string, payload?: Record<string, any>): void;\n    recordPageLoad(data: PageLoadData): void;\n    setUserInfo(userInfo: UserInfo): void;\n    setCustomerInfo(customerInfo: Record<string, any>): void;\n    setDeviceInfo(customFields?: Record<string, any>): void;\n    setDeepLinkUrl(url: string): void;\n    setFirebaseAppInstanceId(id: string): void;\n    getDebugId(): Promise<string | null>;\n    setDataLayer(data: Record<string, any>): void;\n    persistData(key: string, value: any): void;\n    clearPersistedData(keys: string[]): void;\n    getDataLayer(): Record<string, any>;\n    getEventState(): Record<string, any>;\n    hasEventHappened(eventName: string): boolean;\n    registerEventProcessor(\n      eventType: string,\n      callback: (event: any) => void\n    ): void;\n  }\n\n  export const MagicPixel: MagicPixelImpl;\n  export const MagicPixelEventBus: any;\n}\n"],"mappings":"","ignoreList":[]}

package/lib/module/common/device-info-helper.js

@@ -6,40 +6,55 @@ import { Logger } from './logger';
 /**
  * Helper class to automatically detect device and app information
  * Supports both Expo and bare React Native:
- * 1. Tries Expo modules first (works in Expo Go)
- * 2. Falls back to react-native-device-info (for bare RN)
+ * 1. Tries react-native-device-info first (works in bare RN and Expo custom builds)
+ * 2. Falls back to Expo modules (for Expo Go where native modules don't work)
  * 3. Returns safe defaults if neither is available
  */
 export class DeviceInfoHelper {
   /**
-   * Try to load Expo modules and react-native-device-info
-   * This uses dynamic imports to avoid errors when modules aren't available
+   * Try to load react-native-device-info first, then Expo modules
+   * Uses console.log during init to avoid Logger dependency issues if module loading fails
    */
   static async initialize() {
     if (this.initialized) return;
 
-    // Try to load Expo modules first (works in Expo Go)
+    // FIRST: Try react-native-device-info (preferred - works in bare RN and Expo custom builds)
+    // This is a direct dependency of the SDK, so it should always be available except in Expo Go
     try {
       // eslint-disable-next-line @typescript-eslint/no-var-requires
-      this.expoApplication = require('expo-application');
-      // eslint-disable-next-line @typescript-eslint/no-var-requires
-      this.expoDevice = require('expo-device');
-      // eslint-disable-next-line @typescript-eslint/no-var-requires
-      this.expoConstants = require('expo-constants').default;
-      Logger.logDbg('Using Expo modules for device info');
+      const rnDeviceInfo = require('react-native-device-info');
+      // Validate the module is actually loaded and functional
+      if (rnDeviceInfo && typeof (rnDeviceInfo.default || rnDeviceInfo).getVersion === 'function') {
+        this.deviceInfo = rnDeviceInfo.default || rnDeviceInfo;
+        this.initialized = true;
+        // Use console.log to avoid any Logger issues during early init
+        console.log('[MagicPixel DeviceInfoHelper] Using react-native-device-info');
+        return;
+      }
     } catch (error) {
-      Logger.logDbg('Expo modules not available, will try react-native-device-info');
+      // react-native-device-info not available (likely Expo Go)
+      console.log('[MagicPixel DeviceInfoHelper] react-native-device-info not available, trying Expo modules');
     }
 
-    // Fall back to react-native-device-info (for bare RN)
-    if (!this.expoApplication) {
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        this.deviceInfo = require('react-native-device-info').default;
-        Logger.logDbg('Using react-native-device-info for device info');
-      } catch (error) {
-        Logger.logError('Neither Expo modules nor react-native-device-info available:', error);
+    // SECOND: Fall back to Expo modules (for Expo Go where native modules don't work)
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const expoApp = require('expo-application');
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const expoDevice = require('expo-device');
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const expoConst = require('expo-constants');
+
+      // Validate modules are actually loaded (not undefined placeholders from Metro)
+      if (expoApp && expoDevice && expoConst && typeof expoApp.nativeApplicationVersion !== 'undefined') {
+        this.expoApplication = expoApp;
+        this.expoDevice = expoDevice;
+        this.expoConstants = expoConst.default || expoConst;
+        console.log('[MagicPixel DeviceInfoHelper] Using Expo modules');
       }
+    } catch (error) {
+      // Expo modules not available
+      console.log('[MagicPixel DeviceInfoHelper] Expo modules not available, using safe defaults');
     }
     this.initialized = true;
   }
@@ -51,20 +66,21 @@ export class DeviceInfoHelper {
   static async getAppInfo() {
     await this.initialize();
     try {
-      // Try Expo modules first
-      if (this.expoApplication && this.expoDevice) {
-        return await this.getAppInfoFromExpo();
-      }
-
-      // Fall back to react-native-device-info
+      // Use react-native-device-info if available (preferred)
       if (this.deviceInfo) {
         return await this.getAppInfoFromDeviceInfo();
       }
 
+      // Fall back to Expo modules (for Expo Go)
+      if (this.expoApplication && this.expoDevice) {
+        return await this.getAppInfoFromExpo();
+      }
+
       // Return safe fallback values
       return this.getSafeDefaults();
     } catch (error) {
-      Logger.logError('Error getting device info:', error);
+      // Use console.log here as well to be safe
+      console.error('[MagicPixel DeviceInfoHelper] Error getting device info:', error);
       return this.getSafeDefaults();
     }
   }

package/lib/module/common/device-info-helper.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","Logger","DeviceInfoHelper","initialize","initialized","expoApplication","require","expoDevice","expoConstants","default","logDbg","error","deviceInfo","logError","getAppInfo","getAppInfoFromExpo","getAppInfoFromDeviceInfo","getSafeDefaults","_Platform$Version","version","nativeApplicationVersion","buildNumber","nativeBuildVersion","packageName","applicationId","app_version","build_number","package_name","device_model_name","modelName","device_manufacturer","manufacturer","device_id","sessionId","os_name","OS","os_version","osVersion","Version","toString","is_tablet","deviceType","is_emulator","isDevice","uniqueId","bundleId","Promise","all","getVersion","getBuildNumber","getUniqueId","getBundleId","getModel","getManufacturerSync","getSystemVersion","isTablet","isEmulator","_Platform$Version2","getFormattedAppVersion","info","_defineProperty"],"sources":["device-info-helper.ts"],"sourcesContent":["import { Platform } from 'react-native';\nimport { Logger } from './logger';\n\ninterface DeviceAppInfo {\n  app_version: string;\n  build_number: string;\n  package_name: string;\n  device_model_name: string;\n  device_manufacturer: string;\n  device_id: string;\n  os_name: string;\n  os_version: string;\n  is_tablet: boolean;\n  is_emulator: boolean;\n}\n\n/**\n * Helper class to automatically detect device and app information\n * Supports both Expo and bare React Native:\n * 1. Tries Expo modules first (works in Expo Go)\n * 2. Falls back to react-native-device-info (for bare RN)\n * 3. Returns safe defaults if neither is available\n */\nexport class DeviceInfoHelper {\n  private static expoApplication: any = null;\n  private static expoDevice: any = null;\n  private static expoConstants: any = null;\n  private static deviceInfo: any = null;\n  private static initialized = false;\n\n  /**\n   * Try to load Expo modules and react-native-device-info\n   * This uses dynamic imports to avoid errors when modules aren't available\n   */\n  private static async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    // Try to load Expo modules first (works in Expo Go)\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      this.expoApplication = require('expo-application');\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      this.expoDevice = require('expo-device');\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      this.expoConstants = require('expo-constants').default;\n      Logger.logDbg('Using Expo modules for device info');\n    } catch (error) {\n      Logger.logDbg(\n        'Expo modules not available, will try react-native-device-info'\n      );\n    }\n\n    // Fall back to react-native-device-info (for bare RN)\n    if (!this.expoApplication) {\n      try {\n        // eslint-disable-next-line @typescript-eslint/no-var-requires\n        this.deviceInfo = require('react-native-device-info').default;\n        Logger.logDbg('Using react-native-device-info for device info');\n      } catch (error) {\n        Logger.logError(\n          'Neither Expo modules nor react-native-device-info available:',\n          error\n        );\n      }\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Get comprehensive app and device information\n   * All methods are async-safe and handle errors gracefully\n   */\n  static async getAppInfo(): Promise<DeviceAppInfo> {\n    await this.initialize();\n\n    try {\n      // Try Expo modules first\n      if (this.expoApplication && this.expoDevice) {\n        return await this.getAppInfoFromExpo();\n      }\n\n      // Fall back to react-native-device-info\n      if (this.deviceInfo) {\n        return await this.getAppInfoFromDeviceInfo();\n      }\n\n      // Return safe fallback values\n      return this.getSafeDefaults();\n    } catch (error) {\n      Logger.logError('Error getting device info:', error);\n      return this.getSafeDefaults();\n    }\n  }\n\n  /**\n   * Get device info using Expo modules (works in Expo Go)\n   */\n  private static async getAppInfoFromExpo(): Promise<DeviceAppInfo> {\n    const version = this.expoApplication.nativeApplicationVersion || 'unknown';\n    const buildNumber = this.expoApplication.nativeBuildVersion || 'unknown';\n    const packageName = this.expoApplication.applicationId || 'unknown';\n\n    return {\n      // App information\n      app_version: version,\n      build_number: buildNumber,\n      package_name: packageName,\n\n      // Device information\n      device_model_name: this.expoDevice.modelName || 'unknown',\n      device_manufacturer: this.expoDevice.manufacturer || 'unknown',\n      device_id: this.expoConstants.sessionId || 'unknown',\n\n      // OS information\n      os_name: Platform.OS,\n      os_version:\n        this.expoDevice.osVersion || Platform.Version?.toString() || 'unknown',\n\n      // Additional useful info\n      // DeviceType enum: UNKNOWN=0, PHONE=1, TABLET=2, DESKTOP=3, TV=4\n      is_tablet: this.expoDevice.deviceType === 2, // DeviceType.TABLET = 2\n      is_emulator: !this.expoDevice.isDevice,\n    };\n  }\n\n  /**\n   * Get device info using react-native-device-info (for bare RN)\n   */\n  private static async getAppInfoFromDeviceInfo(): Promise<DeviceAppInfo> {\n    const [version, buildNumber, uniqueId, bundleId] = await Promise.all([\n      this.deviceInfo.getVersion(),\n      this.deviceInfo.getBuildNumber(),\n      this.deviceInfo.getUniqueId(),\n      this.deviceInfo.getBundleId(),\n    ]);\n\n    return {\n      // App information\n      app_version: version,\n      build_number: buildNumber,\n      package_name: bundleId,\n\n      // Device information\n      device_model_name: this.deviceInfo.getModel(),\n      device_manufacturer: this.deviceInfo.getManufacturerSync(),\n      device_id: uniqueId,\n\n      // OS information\n      os_name: Platform.OS,\n      os_version: this.deviceInfo.getSystemVersion(),\n\n      // Additional useful info\n      is_tablet: this.deviceInfo.isTablet(),\n      is_emulator: await this.deviceInfo.isEmulator(),\n    };\n  }\n\n  /**\n   * Safe default values when no device info library is available\n   */\n  private static getSafeDefaults(): DeviceAppInfo {\n    return {\n      app_version: 'unknown',\n      build_number: 'unknown',\n      package_name: 'unknown',\n      device_model_name: 'unknown',\n      device_manufacturer: 'unknown',\n      device_id: 'unknown',\n      os_name: Platform.OS,\n      os_version: Platform.Version?.toString() || 'unknown',\n      is_tablet: false,\n      is_emulator: false,\n    };\n  }\n\n  /**\n   * Get app version in format: \"1.0.0 (123)\"\n   * Combines version and build number for better tracking\n   */\n  static async getFormattedAppVersion(): Promise<string> {\n    try {\n      const info = await this.getAppInfo();\n      return `${info.app_version} (${info.build_number})`;\n    } catch (error) {\n      Logger.logError('Error getting formatted app version:', error);\n      return 'unknown';\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["Platform","Logger","DeviceInfoHelper","initialize","initialized","rnDeviceInfo","require","default","getVersion","deviceInfo","console","log","error","expoApp","expoDevice","expoConst","nativeApplicationVersion","expoApplication","expoConstants","getAppInfo","getAppInfoFromDeviceInfo","getAppInfoFromExpo","getSafeDefaults","_Platform$Version","version","buildNumber","nativeBuildVersion","packageName","applicationId","app_version","build_number","package_name","device_model_name","modelName","device_manufacturer","manufacturer","device_id","sessionId","os_name","OS","os_version","osVersion","Version","toString","is_tablet","deviceType","is_emulator","isDevice","uniqueId","bundleId","Promise","all","getBuildNumber","getUniqueId","getBundleId","getModel","getManufacturerSync","getSystemVersion","isTablet","isEmulator","_Platform$Version2","getFormattedAppVersion","info","logError","_defineProperty"],"sources":["device-info-helper.ts"],"sourcesContent":["import { Platform } from 'react-native';\nimport { Logger } from './logger';\n\ninterface DeviceAppInfo {\n  app_version: string;\n  build_number: string;\n  package_name: string;\n  device_model_name: string;\n  device_manufacturer: string;\n  device_id: string;\n  os_name: string;\n  os_version: string;\n  is_tablet: boolean;\n  is_emulator: boolean;\n}\n\n/**\n * Helper class to automatically detect device and app information\n * Supports both Expo and bare React Native:\n * 1. Tries react-native-device-info first (works in bare RN and Expo custom builds)\n * 2. Falls back to Expo modules (for Expo Go where native modules don't work)\n * 3. Returns safe defaults if neither is available\n */\nexport class DeviceInfoHelper {\n  private static expoApplication: any = null;\n  private static expoDevice: any = null;\n  private static expoConstants: any = null;\n  private static deviceInfo: any = null;\n  private static initialized = false;\n\n  /**\n   * Try to load react-native-device-info first, then Expo modules\n   * Uses console.log during init to avoid Logger dependency issues if module loading fails\n   */\n  private static async initialize(): Promise<void> {\n    if (this.initialized) return;\n\n    // FIRST: Try react-native-device-info (preferred - works in bare RN and Expo custom builds)\n    // This is a direct dependency of the SDK, so it should always be available except in Expo Go\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const rnDeviceInfo = require('react-native-device-info');\n      // Validate the module is actually loaded and functional\n      if (\n        rnDeviceInfo &&\n        typeof (rnDeviceInfo.default || rnDeviceInfo).getVersion === 'function'\n      ) {\n        this.deviceInfo = rnDeviceInfo.default || rnDeviceInfo;\n        this.initialized = true;\n        // Use console.log to avoid any Logger issues during early init\n        console.log(\n          '[MagicPixel DeviceInfoHelper] Using react-native-device-info'\n        );\n        return;\n      }\n    } catch (error) {\n      // react-native-device-info not available (likely Expo Go)\n      console.log(\n        '[MagicPixel DeviceInfoHelper] react-native-device-info not available, trying Expo modules'\n      );\n    }\n\n    // SECOND: Fall back to Expo modules (for Expo Go where native modules don't work)\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const expoApp = require('expo-application');\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const expoDevice = require('expo-device');\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const expoConst = require('expo-constants');\n\n      // Validate modules are actually loaded (not undefined placeholders from Metro)\n      if (\n        expoApp &&\n        expoDevice &&\n        expoConst &&\n        typeof expoApp.nativeApplicationVersion !== 'undefined'\n      ) {\n        this.expoApplication = expoApp;\n        this.expoDevice = expoDevice;\n        this.expoConstants = expoConst.default || expoConst;\n        console.log('[MagicPixel DeviceInfoHelper] Using Expo modules');\n      }\n    } catch (error) {\n      // Expo modules not available\n      console.log(\n        '[MagicPixel DeviceInfoHelper] Expo modules not available, using safe defaults'\n      );\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Get comprehensive app and device information\n   * All methods are async-safe and handle errors gracefully\n   */\n  static async getAppInfo(): Promise<DeviceAppInfo> {\n    await this.initialize();\n\n    try {\n      // Use react-native-device-info if available (preferred)\n      if (this.deviceInfo) {\n        return await this.getAppInfoFromDeviceInfo();\n      }\n\n      // Fall back to Expo modules (for Expo Go)\n      if (this.expoApplication && this.expoDevice) {\n        return await this.getAppInfoFromExpo();\n      }\n\n      // Return safe fallback values\n      return this.getSafeDefaults();\n    } catch (error) {\n      // Use console.log here as well to be safe\n      console.error('[MagicPixel DeviceInfoHelper] Error getting device info:', error);\n      return this.getSafeDefaults();\n    }\n  }\n\n  /**\n   * Get device info using Expo modules (works in Expo Go)\n   */\n  private static async getAppInfoFromExpo(): Promise<DeviceAppInfo> {\n    const version = this.expoApplication.nativeApplicationVersion || 'unknown';\n    const buildNumber = this.expoApplication.nativeBuildVersion || 'unknown';\n    const packageName = this.expoApplication.applicationId || 'unknown';\n\n    return {\n      // App information\n      app_version: version,\n      build_number: buildNumber,\n      package_name: packageName,\n\n      // Device information\n      device_model_name: this.expoDevice.modelName || 'unknown',\n      device_manufacturer: this.expoDevice.manufacturer || 'unknown',\n      device_id: this.expoConstants.sessionId || 'unknown',\n\n      // OS information\n      os_name: Platform.OS,\n      os_version:\n        this.expoDevice.osVersion || Platform.Version?.toString() || 'unknown',\n\n      // Additional useful info\n      // DeviceType enum: UNKNOWN=0, PHONE=1, TABLET=2, DESKTOP=3, TV=4\n      is_tablet: this.expoDevice.deviceType === 2, // DeviceType.TABLET = 2\n      is_emulator: !this.expoDevice.isDevice,\n    };\n  }\n\n  /**\n   * Get device info using react-native-device-info (for bare RN)\n   */\n  private static async getAppInfoFromDeviceInfo(): Promise<DeviceAppInfo> {\n    const [version, buildNumber, uniqueId, bundleId] = await Promise.all([\n      this.deviceInfo.getVersion(),\n      this.deviceInfo.getBuildNumber(),\n      this.deviceInfo.getUniqueId(),\n      this.deviceInfo.getBundleId(),\n    ]);\n\n    return {\n      // App information\n      app_version: version,\n      build_number: buildNumber,\n      package_name: bundleId,\n\n      // Device information\n      device_model_name: this.deviceInfo.getModel(),\n      device_manufacturer: this.deviceInfo.getManufacturerSync(),\n      device_id: uniqueId,\n\n      // OS information\n      os_name: Platform.OS,\n      os_version: this.deviceInfo.getSystemVersion(),\n\n      // Additional useful info\n      is_tablet: this.deviceInfo.isTablet(),\n      is_emulator: await this.deviceInfo.isEmulator(),\n    };\n  }\n\n  /**\n   * Safe default values when no device info library is available\n   */\n  private static getSafeDefaults(): DeviceAppInfo {\n    return {\n      app_version: 'unknown',\n      build_number: 'unknown',\n      package_name: 'unknown',\n      device_model_name: 'unknown',\n      device_manufacturer: 'unknown',\n      device_id: 'unknown',\n      os_name: Platform.OS,\n      os_version: Platform.Version?.toString() || 'unknown',\n      is_tablet: false,\n      is_emulator: false,\n    };\n  }\n\n  /**\n   * Get app version in format: \"1.0.0 (123)\"\n   * Combines version and build number for better tracking\n   */\n  static async getFormattedAppVersion(): Promise<string> {\n    try {\n      const info = await this.getAppInfo();\n      return `${info.app_version} (${info.build_number})`;\n    } catch (error) {\n      Logger.logError('Error getting formatted app version:', error);\n      return 'unknown';\n    }\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/module/types/sdk.d.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=sdk.d.js.map

package/lib/module/types/sdk.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["sdk.d.ts"],"sourcesContent":["declare module '@magicpixel/rn-mp-client-sdk' {\n  interface InitConfig {\n    orgId: string;\n    env: 'staging' | 'production';\n    projectId: string;\n    baseUrl: string;\n    logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'none';\n    eventDeduplicationWindowMs?: number;\n    onInitFailure?: (error: Error) => void;\n  }\n\n  interface UserInfo {\n    pid?: string;\n    email?: string;\n    phone?: string;\n    country?: string;\n    city?: string;\n    state?: string;\n    fName?: string;\n    lName?: string;\n    zip?: string;\n  }\n\n  interface PageLoadData {\n    page_name: string;\n    [key: string]: any;\n  }\n\n  class MagicPixelImpl {\n    init(config: InitConfig): void;\n    shutdown(): void;\n    recordEvent(eventName: string, payload?: Record<string, any>): void;\n    recordPageLoad(data: PageLoadData): void;\n    setUserInfo(userInfo: UserInfo): void;\n    setCustomerInfo(customerInfo: Record<string, any>): void;\n    setDeviceInfo(customFields?: Record<string, any>): void;\n    setDeepLinkUrl(url: string): void;\n    setFirebaseAppInstanceId(id: string): void;\n    getDebugId(): Promise<string | null>;\n    setDataLayer(data: Record<string, any>): void;\n    persistData(key: string, value: any): void;\n    clearPersistedData(keys: string[]): void;\n    getDataLayer(): Record<string, any>;\n    getEventState(): Record<string, any>;\n    hasEventHappened(eventName: string): boolean;\n    registerEventProcessor(\n      eventType: string,\n      callback: (event: any) => void\n    ): void;\n  }\n\n  export const MagicPixel: MagicPixelImpl;\n  export const MagicPixelEventBus: any;\n}\n"],"mappings":"","ignoreList":[]}

package/lib/typescript/src/common/device-info-helper.d.ts

@@ -13,8 +13,8 @@ interface DeviceAppInfo {
 /**
  * Helper class to automatically detect device and app information
  * Supports both Expo and bare React Native:
- * 1. Tries Expo modules first (works in Expo Go)
- * 2. Falls back to react-native-device-info (for bare RN)
+ * 1. Tries react-native-device-info first (works in bare RN and Expo custom builds)
+ * 2. Falls back to Expo modules (for Expo Go where native modules don't work)
  * 3. Returns safe defaults if neither is available
  */
 export declare class DeviceInfoHelper {
@@ -24,8 +24,8 @@ export declare class DeviceInfoHelper {
     private static deviceInfo;
     private static initialized;
     /**
-     * Try to load Expo modules and react-native-device-info
-     * This uses dynamic imports to avoid errors when modules aren't available
+     * Try to load react-native-device-info first, then Expo modules
+     * Uses console.log during init to avoid Logger dependency issues if module loading fails
      */
     private static initialize;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicpixel/rn-mp-client-sdk",
-  "version": "1.13.21",
+  "version": "1.13.23",
   "description": "React Native SDK for MagicPixel analytics and tag management",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "lib",
+    "scripts",
     "!lib/typescript/example",
     "!**/__tests__",
     "!**/__fixtures__",
@@ -20,6 +21,7 @@
     "typescript": "tsc --noEmit",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
     "prepare": "bob build",
+    "postinstall": "node scripts/postinstall.js",
     "release": "release-it",
     "example": "yarn --cwd example",
     "bootstrap": "yarn example && yarn && yarn example pods",
@@ -91,7 +93,13 @@
   },
   "peerDependencies": {
     "react": "*",
-    "react-native": "*"
+    "react-native": "*",
+    "react-native-get-random-values": ">=1.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-get-random-values": {
+      "optional": true
+    }
   },
   "commitlint": {
     "extends": [

package/scripts/bootstrap.js

@@ -0,0 +1,29 @@
+const os = require('os');
+const path = require('path');
+const child_process = require('child_process');
+
+const root = path.resolve(__dirname, '..');
+const args = process.argv.slice(2);
+const options = {
+  cwd: process.cwd(),
+  env: process.env,
+  stdio: 'inherit',
+  encoding: 'utf-8',
+};
+
+if (os.type() === 'Windows_NT') {
+  options.shell = true;
+}
+
+let result;
+
+if (process.cwd() !== root || args.length) {
+  // We're not in the root of the project, or additional arguments were passed
+  // In this case, forward the command to `yarn`
+  result = child_process.spawnSync('yarn', args, options);
+} else {
+  // If `yarn` is run without arguments, perform bootstrap
+  result = child_process.spawnSync('yarn', ['bootstrap'], options);
+}
+
+process.exitCode = result.status;

package/scripts/postinstall.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+
+/**
+ * MagicPixel SDK Postinstall Script
+ * Detects bare React Native projects and displays setup instructions
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// ANSI color codes
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  white: '\x1b[37m',
+  bgMagenta: '\x1b[45m',
+  bgBlue: '\x1b[44m',
+};
+
+function getAppRoot() {
+  // Navigate up from node_modules/@magicpixel/rn-mp-client-sdk/scripts
+  // Structure: <app>/node_modules/@magicpixel/rn-mp-client-sdk/scripts/postinstall.js
+  // Or with yalc: <app>/.yalc/@magicpixel/rn-mp-client-sdk/scripts/postinstall.js
+  let current = __dirname;
+
+  for (let i = 0; i < 10; i++) {
+    current = path.dirname(current);
+    const packageJsonPath = path.join(current, 'package.json');
+
+    if (fs.existsSync(packageJsonPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        // Skip our own package.json
+        if (pkg.name === '@magicpixel/rn-mp-client-sdk') {
+          continue;
+        }
+        // Found the host app
+        return current;
+      } catch (e) {
+        // Continue searching
+      }
+    }
+  }
+  return null;
+}
+
+function detectProjectType(appRoot) {
+  if (!appRoot) return 'unknown';
+
+  const hasIosFolder = fs.existsSync(path.join(appRoot, 'ios'));
+  const hasAndroidFolder = fs.existsSync(path.join(appRoot, 'android'));
+  const hasPodfile = fs.existsSync(path.join(appRoot, 'ios', 'Podfile'));
+
+  // Check for Expo
+  let hasExpo = false;
+  try {
+    const packageJsonPath = path.join(appRoot, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+      const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+      hasExpo = !!(
+        pkg.dependencies?.expo ||
+        pkg.devDependencies?.expo ||
+        pkg.dependencies?.['expo-modules-core']
+      );
+    }
+  } catch (e) {
+    // Ignore errors
+  }
+
+  if (hasExpo && !hasIosFolder && !hasAndroidFolder) {
+    return 'expo-managed';
+  }
+  if (hasExpo && (hasIosFolder || hasAndroidFolder)) {
+    return 'expo-bare';
+  }
+  if (!hasExpo && (hasIosFolder || hasAndroidFolder)) {
+    return 'bare-rn';
+  }
+  return 'unknown';
+}
+
+function printBareRNMessage() {
+  const c = colors;
+  // Use stderr for better visibility (npm sometimes hides stdout from postinstall)
+  const log = (msg) => process.stderr.write(msg + '\n');
+
+  log('');
+  log(`${c.bgMagenta}${c.white}${c.bright}                                                                      ${c.reset}`);
+  log(`${c.bgMagenta}${c.white}${c.bright}   ╔═══════════════════════════════════════════════════════════════╗  ${c.reset}`);
+  log(`${c.bgMagenta}${c.white}${c.bright}   ║                                                               ║  ${c.reset}`);
+  log(`${c.bgMagenta}${c.white}${c.bright}   ║   🔮 MAGICPIXEL SDK - BARE REACT NATIVE SETUP REQUIRED 🔮     ║  ${c.reset}`);
+  log(`${c.bgMagenta}${c.white}${c.bright}   ║                                                               ║  ${c.reset}`);
+  log(`${c.bgMagenta}${c.white}${c.bright}   ╚═══════════════════════════════════════════════════════════════╝  ${c.reset}`);
+  log(`${c.bgMagenta}${c.white}${c.bright}                                                                      ${c.reset}`);
+  log('');
+  log(`${c.cyan}${c.bright}   Complete these steps to finish SDK installation:${c.reset}`);
+  log('');
+  log(`${c.yellow}${c.bright}   STEP 1:${c.reset} Link native modules (iOS)`);
+  log(`${c.dim}   ─────────────────────────────────────${c.reset}`);
+  log(`   ${c.white}cd ios && pod install && cd ..${c.reset}`);
+  log('');
+  log(`${c.yellow}${c.bright}   STEP 2:${c.reset} Add polyfill to index.js ${c.dim}(MUST be first import!)${c.reset}`);
+  log(`${c.dim}   ─────────────────────────────────────${c.reset}`);
+  log(`   ${c.white}import 'react-native-get-random-values';${c.reset}`);
+  log('');
+  log(`${c.yellow}${c.bright}   STEP 3:${c.reset} Rebuild your app ${c.dim}(required after pod install)${c.reset}`);
+  log(`${c.dim}   ─────────────────────────────────────${c.reset}`);
+  log(`   ${c.white}• Kill the app in simulator/device${c.reset}`);
+  log(`   ${c.white}• Stop Metro (Ctrl+C)${c.reset}`);
+  log(`   ${c.white}• Run: npx react-native run-ios${c.reset}`);
+  log('');
+  log(`${c.dim}   ⚠️  Without these steps, you'll see:${c.reset}`);
+  log(`${c.dim}   TurboModuleRegistry.getEnforcing(...): 'RNGetRandomValues' not found${c.reset}`);
+  log('');
+  log(`${c.dim}   📖 Full docs: https://github.com/digital-madtech/mp-rn-client-sdk#readme${c.reset}`);
+  log('');
+}
+
+function main() {
+  try {
+    const appRoot = getAppRoot();
+    const projectType = detectProjectType(appRoot);
+
+    if (projectType === 'bare-rn' || projectType === 'expo-bare') {
+      printBareRNMessage();
+    }
+    // For expo-managed, no message needed - it handles native modules automatically
+  } catch (error) {
+    // Silently fail - don't break npm install
+  }
+}
+
+main();

package/src/common/device-info-helper.ts

@@ -17,8 +17,8 @@ interface DeviceAppInfo {
 /**
  * Helper class to automatically detect device and app information
  * Supports both Expo and bare React Native:
- * 1. Tries Expo modules first (works in Expo Go)
- * 2. Falls back to react-native-device-info (for bare RN)
+ * 1. Tries react-native-device-info first (works in bare RN and Expo custom builds)
+ * 2. Falls back to Expo modules (for Expo Go where native modules don't work)
  * 3. Returns safe defaults if neither is available
  */
 export class DeviceInfoHelper {
@@ -29,39 +29,63 @@ export class DeviceInfoHelper {
   private static initialized = false;
 
   /**
-   * Try to load Expo modules and react-native-device-info
-   * This uses dynamic imports to avoid errors when modules aren't available
+   * Try to load react-native-device-info first, then Expo modules
+   * Uses console.log during init to avoid Logger dependency issues if module loading fails
    */
   private static async initialize(): Promise<void> {
     if (this.initialized) return;
 
-    // Try to load Expo modules first (works in Expo Go)
+    // FIRST: Try react-native-device-info (preferred - works in bare RN and Expo custom builds)
+    // This is a direct dependency of the SDK, so it should always be available except in Expo Go
     try {
       // eslint-disable-next-line @typescript-eslint/no-var-requires
-      this.expoApplication = require('expo-application');
-      // eslint-disable-next-line @typescript-eslint/no-var-requires
-      this.expoDevice = require('expo-device');
-      // eslint-disable-next-line @typescript-eslint/no-var-requires
-      this.expoConstants = require('expo-constants').default;
-      Logger.logDbg('Using Expo modules for device info');
+      const rnDeviceInfo = require('react-native-device-info');
+      // Validate the module is actually loaded and functional
+      if (
+        rnDeviceInfo &&
+        typeof (rnDeviceInfo.default || rnDeviceInfo).getVersion === 'function'
+      ) {
+        this.deviceInfo = rnDeviceInfo.default || rnDeviceInfo;
+        this.initialized = true;
+        // Use console.log to avoid any Logger issues during early init
+        console.log(
+          '[MagicPixel DeviceInfoHelper] Using react-native-device-info'
+        );
+        return;
+      }
     } catch (error) {
-      Logger.logDbg(
-        'Expo modules not available, will try react-native-device-info'
+      // react-native-device-info not available (likely Expo Go)
+      console.log(
+        '[MagicPixel DeviceInfoHelper] react-native-device-info not available, trying Expo modules'
       );
     }
 
-    // Fall back to react-native-device-info (for bare RN)
-    if (!this.expoApplication) {
-      try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        this.deviceInfo = require('react-native-device-info').default;
-        Logger.logDbg('Using react-native-device-info for device info');
-      } catch (error) {
-        Logger.logError(
-          'Neither Expo modules nor react-native-device-info available:',
-          error
-        );
+    // SECOND: Fall back to Expo modules (for Expo Go where native modules don't work)
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const expoApp = require('expo-application');
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const expoDevice = require('expo-device');
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const expoConst = require('expo-constants');
+
+      // Validate modules are actually loaded (not undefined placeholders from Metro)
+      if (
+        expoApp &&
+        expoDevice &&
+        expoConst &&
+        typeof expoApp.nativeApplicationVersion !== 'undefined'
+      ) {
+        this.expoApplication = expoApp;
+        this.expoDevice = expoDevice;
+        this.expoConstants = expoConst.default || expoConst;
+        console.log('[MagicPixel DeviceInfoHelper] Using Expo modules');
       }
+    } catch (error) {
+      // Expo modules not available
+      console.log(
+        '[MagicPixel DeviceInfoHelper] Expo modules not available, using safe defaults'
+      );
     }
 
     this.initialized = true;
@@ -75,20 +99,21 @@ export class DeviceInfoHelper {
     await this.initialize();
 
     try {
-      // Try Expo modules first
-      if (this.expoApplication && this.expoDevice) {
-        return await this.getAppInfoFromExpo();
-      }
-
-      // Fall back to react-native-device-info
+      // Use react-native-device-info if available (preferred)
       if (this.deviceInfo) {
         return await this.getAppInfoFromDeviceInfo();
       }
 
+      // Fall back to Expo modules (for Expo Go)
+      if (this.expoApplication && this.expoDevice) {
+        return await this.getAppInfoFromExpo();
+      }
+
       // Return safe fallback values
       return this.getSafeDefaults();
     } catch (error) {
-      Logger.logError('Error getting device info:', error);
+      // Use console.log here as well to be safe
+      console.error('[MagicPixel DeviceInfoHelper] Error getting device info:', error);
       return this.getSafeDefaults();
     }
   }

package/src/types/sdk.d.ts

@@ -0,0 +1,54 @@
+declare module '@magicpixel/rn-mp-client-sdk' {
+  interface InitConfig {
+    orgId: string;
+    env: 'staging' | 'production';
+    projectId: string;
+    baseUrl: string;
+    logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'none';
+    eventDeduplicationWindowMs?: number;
+    onInitFailure?: (error: Error) => void;
+  }
+
+  interface UserInfo {
+    pid?: string;
+    email?: string;
+    phone?: string;
+    country?: string;
+    city?: string;
+    state?: string;
+    fName?: string;
+    lName?: string;
+    zip?: string;
+  }
+
+  interface PageLoadData {
+    page_name: string;
+    [key: string]: any;
+  }
+
+  class MagicPixelImpl {
+    init(config: InitConfig): void;
+    shutdown(): void;
+    recordEvent(eventName: string, payload?: Record<string, any>): void;
+    recordPageLoad(data: PageLoadData): void;
+    setUserInfo(userInfo: UserInfo): void;
+    setCustomerInfo(customerInfo: Record<string, any>): void;
+    setDeviceInfo(customFields?: Record<string, any>): void;
+    setDeepLinkUrl(url: string): void;
+    setFirebaseAppInstanceId(id: string): void;
+    getDebugId(): Promise<string | null>;
+    setDataLayer(data: Record<string, any>): void;
+    persistData(key: string, value: any): void;
+    clearPersistedData(keys: string[]): void;
+    getDataLayer(): Record<string, any>;
+    getEventState(): Record<string, any>;
+    hasEventHappened(eventName: string): boolean;
+    registerEventProcessor(
+      eventType: string,
+      callback: (event: any) => void
+    ): void;
+  }
+
+  export const MagicPixel: MagicPixelImpl;
+  export const MagicPixelEventBus: any;
+}