@rejourneyco/react-native 1.0.0

package/lib/module/index.js

@@ -0,0 +1,1284 @@
+/**
+ * Rejourney - Session Recording and Replay SDK for React Native
+ * 
+ * Captures user interactions, gestures, and screen states for replay and analysis.
+ * 
+ * Just call initRejourney() - everything else is automatic!
+ * 
+ * Copyright (c) 2026 Rejourney
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See LICENSE-APACHE for full terms.
+ * 
+ * @example
+ * ```typescript
+ * import { initRejourney } from 'rejourney';
+ * 
+ * // Initialize the SDK with your public key - that's it!
+ * initRejourney('pk_live_xxxxxxxxxxxx');
+ * 
+ * // Or with options:
+ * initRejourney('pk_live_xxxxxxxxxxxx', { debug: true });
+ * ```
+ */
+
+// =============================================================================
+// CRITICAL: Safe Module Loading for React Native 0.81+
+// =============================================================================
+// 
+// On React Native 0.81+ with New Architecture (Bridgeless), importing from 
+// 'react-native' at module load time can fail with "PlatformConstants could 
+// not be found" because the TurboModule runtime may not be fully initialized.
+//
+// This wrapper ensures that all react-native imports happen after the runtime
+// is ready, by catching any initialization errors and deferring actual SDK 
+// operations until initRejourney() is called.
+// =============================================================================
+
+// Module load confirmation - this runs when the module is first imported
+
+// SDK disabled flag - set to true if we detect runtime issues
+let _sdkDisabled = false;
+
+// Type-only imports are safe - they're erased at compile time
+
+// SDK version is safe - no react-native imports
+import { SDK_VERSION } from './sdk/constants';
+
+// =============================================================================
+// Lazy Module Loading
+// =============================================================================
+// All modules that import from 'react-native' are loaded lazily to avoid
+// accessing TurboModuleRegistry before it's ready.
+
+let _reactNativeLoaded = false;
+let _RN = null;
+function getReactNative() {
+  if (_sdkDisabled) return null;
+  if (_reactNativeLoaded) return _RN;
+  try {
+    _RN = require('react-native');
+    _reactNativeLoaded = true;
+    return _RN;
+  } catch (error) {
+    getLogger().warn('Failed to load react-native:', error?.message || error);
+    _sdkDisabled = true;
+    return null;
+  }
+}
+
+// Lazy-loaded logger
+let _logger = null;
+function getLogger() {
+  if (_logger) return _logger;
+  if (_sdkDisabled) {
+    // Return a no-op logger if SDK is disabled
+    return {
+      debug: () => {},
+      info: console.log.bind(console, '[Rejourney]'),
+      warn: console.warn.bind(console, '[Rejourney]'),
+      error: console.error.bind(console, '[Rejourney]'),
+      logSessionStart: () => {},
+      logSessionEnd: () => {},
+      logInitSuccess: () => {},
+      logInitFailure: () => {},
+      setLogLevel: () => {},
+      setDebugMode: () => {},
+      logObservabilityStart: () => {},
+      logRecordingStart: () => {},
+      logRecordingRemoteDisabled: () => {},
+      logInvalidProjectKey: () => {},
+      logPackageMismatch: () => {}
+    };
+  }
+  try {
+    const utils = require('./sdk/utils');
+    _logger = utils.logger;
+    return _logger;
+  } catch (error) {
+    console.warn('[Rejourney] Failed to load logger:', error?.message || error);
+    // Return fallback logger with working info
+    return {
+      debug: () => {},
+      info: console.log.bind(console, '[Rejourney]'),
+      warn: console.warn.bind(console, '[Rejourney]'),
+      error: console.error.bind(console, '[Rejourney]'),
+      logSessionStart: () => {},
+      logSessionEnd: () => {},
+      logInitSuccess: () => {},
+      logInitFailure: () => {},
+      setLogLevel: () => {},
+      setDebugMode: () => {},
+      logObservabilityStart: () => {},
+      logRecordingStart: () => {},
+      logRecordingRemoteDisabled: () => {},
+      logInvalidProjectKey: () => {},
+      logPackageMismatch: () => {}
+    };
+  }
+}
+
+// Lazy-loaded network interceptor
+let _networkInterceptor = null;
+function getNetworkInterceptor() {
+  if (_sdkDisabled) return {
+    initNetworkInterceptor: () => {},
+    disableNetworkInterceptor: () => {}
+  };
+  if (_networkInterceptor) return _networkInterceptor;
+  try {
+    _networkInterceptor = require('./sdk/networkInterceptor');
+    return _networkInterceptor;
+  } catch (error) {
+    getLogger().warn('Failed to load network interceptor:', error?.message || error);
+    return {
+      initNetworkInterceptor: () => {},
+      disableNetworkInterceptor: () => {}
+    };
+  }
+}
+
+// Lazy-loaded auto tracking module
+let _autoTracking = null;
+
+// No-op auto tracking for when SDK is disabled
+const noopAutoTracking = {
+  initAutoTracking: () => {},
+  cleanupAutoTracking: () => {},
+  trackScroll: () => {},
+  trackScreen: () => {},
+  trackAPIRequest: () => {},
+  notifyStateChange: () => {},
+  getSessionMetrics: () => ({}),
+  resetMetrics: () => {},
+  collectDeviceInfo: () => ({}),
+  ensurePersistentAnonymousId: async () => 'anonymous'
+};
+function getAutoTracking() {
+  if (_sdkDisabled) return noopAutoTracking;
+  if (_autoTracking) return _autoTracking;
+  try {
+    _autoTracking = require('./sdk/autoTracking');
+    return _autoTracking;
+  } catch (error) {
+    getLogger().warn('Failed to load auto tracking:', error?.message || error);
+    return noopAutoTracking;
+  }
+}
+
+// State
+const USER_IDENTITY_KEY = '@rejourney_user_identity';
+let _isInitialized = false;
+let _isRecording = false;
+let _initializationFailed = false;
+let _appStateSubscription = null;
+let _authErrorSubscription = null;
+let _currentAppState = 'active'; // Default to active, will be updated on init
+let _userIdentity = null;
+
+// Scroll throttling - reduce native bridge calls from 60fps to at most 10/sec
+let _lastScrollTime = 0;
+let _lastScrollOffset = 0;
+const SCROLL_THROTTLE_MS = 100;
+
+// Helper to save/load user identity
+async function persistUserIdentity(identity) {
+  try {
+    const AsyncStorage = require('@react-native-async-storage/async-storage').default;
+    if (identity) {
+      await AsyncStorage.setItem(USER_IDENTITY_KEY, identity);
+    } else {
+      await AsyncStorage.removeItem(USER_IDENTITY_KEY);
+    }
+  } catch (e) {
+    // Ignore storage errors
+  }
+}
+async function loadPersistedUserIdentity() {
+  try {
+    const AsyncStorage = require('@react-native-async-storage/async-storage').default;
+    return await AsyncStorage.getItem(USER_IDENTITY_KEY);
+  } catch (e) {
+    return null;
+  }
+}
+let _storedConfig = null;
+
+// Lazy-loaded native module reference
+// We don't access TurboModuleRegistry at module load time to avoid
+// "PlatformConstants could not be found" errors on RN 0.81+
+let _rejourneyNative = undefined;
+let _nativeModuleLogged = false;
+let _runtimeReady = false;
+
+/**
+ * Check if the React Native runtime is ready for native module access.
+ * This prevents crashes on RN 0.81+ where accessing modules too early fails.
+ */
+function isRuntimeReady() {
+  if (_runtimeReady) return true;
+  try {
+    // Try to access a core module to verify runtime is ready
+    const RN = require('react-native');
+    // If we can access NativeModules without error, runtime is ready
+    if (RN.NativeModules) {
+      _runtimeReady = true;
+      return true;
+    }
+  } catch {
+    // Runtime not ready yet
+  }
+  return false;
+}
+
+/**
+ * Get the native Rejourney module lazily.
+ * 
+ * This function defers access to TurboModuleRegistry/NativeModules until
+ * the first time it's actually needed. This is critical for React Native 0.81+
+ * where accessing TurboModuleRegistry at module load time can fail because
+ * PlatformConstants and other core modules aren't yet initialized.
+ * 
+ * The function caches the result after the first call.
+ */
+function getRejourneyNative() {
+  // Return cached result if already resolved
+  if (_rejourneyNative !== undefined) {
+    return _rejourneyNative;
+  }
+
+  // Check if runtime is ready before attempting to access native modules
+  if (!isRuntimeReady()) {
+    getLogger().debug('Rejourney: Runtime not ready, deferring native module access');
+    return null;
+  }
+  try {
+    const RN = require('react-native');
+    const {
+      NativeModules,
+      TurboModuleRegistry
+    } = RN;
+
+    // Track how the module was loaded
+    let loadedVia = 'none';
+    let nativeModule = null;
+
+    // Try TurboModuleRegistry first (New Architecture)
+    if (TurboModuleRegistry && typeof TurboModuleRegistry.get === 'function') {
+      try {
+        nativeModule = TurboModuleRegistry.get('Rejourney');
+        if (nativeModule) {
+          loadedVia = 'TurboModules';
+        }
+      } catch (turboError) {
+        // TurboModuleRegistry.get failed, will try NativeModules
+        getLogger().debug('TurboModuleRegistry.get failed:', turboError);
+      }
+    }
+
+    // Fall back to NativeModules (Old Architecture / Interop Layer)
+    if (!nativeModule && NativeModules) {
+      nativeModule = NativeModules.Rejourney ?? null;
+      if (nativeModule) {
+        loadedVia = 'NativeModules';
+      }
+    }
+    _rejourneyNative = nativeModule;
+
+    // Log which method was used to load the module
+    if (_rejourneyNative && !_nativeModuleLogged) {
+      _nativeModuleLogged = true;
+
+      // More accurate detection based on actual load method
+      if (loadedVia === 'TurboModules') {
+        getLogger().debug('Using New Architecture (TurboModules/JSI)');
+      } else if (loadedVia === 'NativeModules') {
+        // Check if we're in interop mode (New Arch with bridge fallback)
+        const hasTurboProxy = !!global.__turboModuleProxy;
+        if (hasTurboProxy) {
+          getLogger().debug('Using New Architecture (Interop Layer)');
+        } else {
+          getLogger().debug('Using Old Architecture (Bridge)');
+        }
+      }
+    }
+  } catch (error) {
+    // If any access fails, log and return null
+    getLogger().warn('Rejourney: Failed to access native modules:', error);
+    _rejourneyNative = null;
+  }
+
+  // Ensure we never return undefined - convert to null
+  if (_rejourneyNative === undefined) {
+    _rejourneyNative = null;
+  }
+  return _rejourneyNative;
+}
+
+/**
+ * Safely call a native method with error handling
+ * Never throws - logs errors and returns gracefully
+ */
+async function safeNativeCall(methodName, fn, defaultValue) {
+  const nativeModule = getRejourneyNative();
+  if (!nativeModule || _initializationFailed) {
+    return defaultValue;
+  }
+  try {
+    return await fn();
+  } catch (error) {
+    getLogger().error(`Rejourney.${methodName} failed:`, error);
+    return defaultValue;
+  }
+}
+
+/**
+ * Safely call a synchronous native method with error handling
+ * Never throws - logs errors and returns gracefully
+ */
+function safeNativeCallSync(methodName, fn, defaultValue) {
+  const nativeModule = getRejourneyNative();
+  if (!nativeModule || _initializationFailed) {
+    return defaultValue;
+  }
+  try {
+    return fn();
+  } catch (error) {
+    getLogger().error(`Rejourney.${methodName} failed:`, error);
+    return defaultValue;
+  }
+}
+
+/**
+ * Main Rejourney API (Internal)
+ */
+const Rejourney = {
+  /**
+   * SDK Version
+   */
+  version: SDK_VERSION,
+  /**
+   * Internal method to start recording session
+   * Called by startRejourney() after user consent
+   */
+  async _startSession() {
+    getLogger().debug('_startSession() entered');
+    if (!_storedConfig) {
+      throw new Error('SDK not initialized. Call initRejourney() first.');
+    }
+    const nativeModule = getRejourneyNative();
+    if (!nativeModule) {
+      // Common causes:
+      // - startRejourney() called too early (RN runtime not ready yet)
+      // - native module not linked (pods/gradle/autolinking issue)
+      getLogger().warn('Native module not available - cannot start recording');
+      return false;
+    }
+    getLogger().debug('Native module found, checking if already recording...');
+    if (_isRecording) {
+      getLogger().warn('Recording already started');
+      return false;
+    }
+    try {
+      const apiUrl = _storedConfig.apiUrl || 'https://api.rejourney.co';
+      const publicKey = _storedConfig.publicRouteKey || '';
+      getLogger().debug(`Calling native startSession (apiUrl=${apiUrl})`);
+
+      // Use user identity if set, otherwise use anonymous device ID
+      const deviceId = await getAutoTracking().ensurePersistentAnonymousId();
+
+      // Try to load persisted user identity if not already set in memory
+      if (!_userIdentity) {
+        _userIdentity = await loadPersistedUserIdentity();
+      }
+      const userId = _userIdentity || deviceId;
+      getLogger().debug(`userId=${userId.substring(0, 8)}...`);
+
+      // Start native session
+      const result = await nativeModule.startSession(userId, apiUrl, publicKey);
+      getLogger().debug('Native startSession returned:', JSON.stringify(result));
+      if (!result?.success) {
+        const reason = result?.error || 'Native startSession returned success=false';
+        if (/disabled|blocked|not enabled/i.test(reason)) {
+          getLogger().logRecordingRemoteDisabled();
+        }
+        getLogger().error('Native startSession failed:', reason);
+        return false;
+      }
+      _isRecording = true;
+      getLogger().debug(`✅ Session started: ${result.sessionId}`);
+      // Use lifecycle log for session start - only shown in dev builds
+      getLogger().logSessionStart(result.sessionId);
+
+      // Initialize auto tracking features
+      getAutoTracking().initAutoTracking({
+        rageTapThreshold: _storedConfig?.rageTapThreshold ?? 3,
+        rageTapTimeWindow: _storedConfig?.rageTapTimeWindow ?? 500,
+        rageTapRadius: 50,
+        trackJSErrors: true,
+        trackPromiseRejections: true,
+        trackReactNativeErrors: true,
+        collectDeviceInfo: _storedConfig?.collectDeviceInfo !== false
+      }, {
+        // Rage tap callback - log as frustration event
+        onRageTap: (count, x, y) => {
+          this.logEvent('frustration', {
+            frustrationKind: 'rage_tap',
+            tapCount: count,
+            x,
+            y
+          });
+          // logger.debug(`Rage tap detected: ${count} taps at (${x}, ${y})`);
+        },
+        // Error callback - log as error event
+        onError: error => {
+          this.logEvent('error', {
+            message: error.message,
+            stack: error.stack,
+            name: error.name
+          });
+          // logger.debug(`Error captured: ${error.message}`);
+        },
+        // Screen change callback - log screen change
+        onScreen: (_screenName, _previousScreen) => {
+          // Native module already handles screen changes
+          // This is just for metrics tracking
+          // logger.debug(`Screen changed: ${previousScreen} -> ${screenName}`);
+        }
+      });
+
+      // Collect and log device info
+      if (_storedConfig?.collectDeviceInfo !== false) {
+        try {
+          const deviceInfo = getAutoTracking().collectDeviceInfo();
+          this.logEvent('device_info', deviceInfo);
+        } catch (deviceError) {
+          getLogger().warn('Failed to collect device info:', deviceError);
+        }
+      }
+
+      // Setup automatic network interception
+      if (_storedConfig?.autoTrackNetwork !== false) {
+        try {
+          const ignoreUrls = [apiUrl, '/api/ingest/presign', '/api/ingest/batch/complete', '/api/ingest/session/end', ...(_storedConfig?.networkIgnoreUrls || [])];
+          getNetworkInterceptor().initNetworkInterceptor(request => {
+            this.logNetworkRequest(request);
+            getAutoTracking().trackAPIRequest(request.success || false, request.statusCode, request.duration || 0, request.responseBodySize || 0);
+          }, {
+            ignoreUrls,
+            captureSizes: _storedConfig?.networkCaptureSizes !== false
+          });
+
+          // logger.debug('Network interception enabled');
+        } catch (networkError) {
+          getLogger().warn('Failed to setup network interception:', networkError);
+        }
+      }
+
+      // logger.debug('Auto tracking enabled');
+
+      return true;
+    } catch (error) {
+      getLogger().error('Failed to start recording:', error);
+      _isRecording = false;
+      return false;
+    }
+  },
+  /**
+   * Stop the current recording session
+   */
+  async _stopSession() {
+    if (!_isRecording) {
+      getLogger().warn('No active recording to stop');
+      return;
+    }
+    try {
+      // Get session metrics before stopping
+      const metrics = getAutoTracking().getSessionMetrics();
+      this.logEvent('session_metrics', metrics);
+
+      // Cleanup
+      getNetworkInterceptor().disableNetworkInterceptor();
+      getAutoTracking().cleanupAutoTracking();
+      getAutoTracking().resetMetrics();
+      await safeNativeCall('stopSession', () => getRejourneyNative().stopSession(), undefined);
+      _isRecording = false;
+      // Use lifecycle log for session end - only shown in dev builds
+      getLogger().logSessionEnd('current');
+    } catch (error) {
+      getLogger().error('Failed to stop recording:', error);
+    }
+  },
+  /**
+   * Log a custom event
+   * 
+   * @param name - Event name
+   * @param properties - Optional event properties
+   * @example
+   * Rejourney.logEvent('button_click', { buttonId: 'submit' });
+   */
+  logEvent(name, properties) {
+    safeNativeCallSync('logEvent', () => {
+      // Fire and forget - don't await
+      getRejourneyNative().logEvent(name, properties || {}).catch(() => {});
+    }, undefined);
+  },
+  /**
+   * Set user identity for session correlation
+   * Associates current and future sessions with a user ID
+   * 
+   * @param userId - User identifier (e.g., email, username, or internal ID)
+   * @example
+   * Rejourney.setUserIdentity('user_12345');
+   * Rejourney.setUserIdentity('john@example.com');
+   */
+  setUserIdentity(userId) {
+    _userIdentity = userId;
+    persistUserIdentity(userId).catch(() => {});
+    // logger.debug(`User identity set: ${userId}`);
+
+    // If recording is active, update the native module immediately
+    if (_isRecording && getRejourneyNative()) {
+      safeNativeCallSync('setUserIdentity', () => {
+        getRejourneyNative().setUserIdentity(userId).catch(() => {});
+      }, undefined);
+    }
+  },
+  /**
+   * Clear user identity
+   * Removes user association from future sessions
+   */
+  clearUserIdentity() {
+    _userIdentity = null;
+    persistUserIdentity(null).catch(() => {});
+    // logger.debug('User identity cleared');
+
+    // If recording is active, update the native module immediately  
+    if (_isRecording && getRejourneyNative()) {
+      safeNativeCallSync('setUserIdentity', () => {
+        getRejourneyNative().setUserIdentity('anonymous').catch(() => {});
+      }, undefined);
+    }
+  },
+  /**
+   * Tag the current screen
+   * 
+   * @param screenName - Screen name
+   * @param params - Optional screen parameters
+   */
+  tagScreen(screenName, _params) {
+    // Track screen for metrics and funnel tracking
+    getAutoTracking().trackScreen(screenName);
+
+    // Notify state change (kept for API compatibility)
+    getAutoTracking().notifyStateChange();
+    safeNativeCallSync('tagScreen', () => {
+      getRejourneyNative().screenChanged(screenName).catch(() => {});
+    }, undefined);
+  },
+  /**
+   * Mark a view as sensitive (will be occluded in recordings)
+   * 
+   * @param viewRef - React ref to the view
+   * @param occluded - Whether to occlude (default: true)
+   */
+  setOccluded(_viewRef, _occluded = true) {
+    // No-op - occlusion handled automatically by native module
+  },
+  /**
+   * Add a tag to the current session
+   * 
+   * @param tag - Tag string
+   */
+  addSessionTag(tag) {
+    this.logEvent('session_tag', {
+      tag
+    });
+  },
+  /**
+   * Get all recorded sessions
+   * 
+   * @returns Array of session summaries (always empty - sessions on dashboard server)
+   */
+  async getSessions() {
+    return [];
+  },
+  /**
+   * Get session data for replay
+   * 
+   * @param sessionId - Session ID
+   * @returns Session data (not implemented - use dashboard server)
+   */
+  async getSessionData(_sessionId) {
+    // Return empty session data - actual data should be fetched from dashboard server
+    getLogger().warn('getSessionData not implemented - fetch from dashboard server');
+    return {
+      metadata: {
+        sessionId: _sessionId,
+        startTime: 0,
+        endTime: 0,
+        duration: 0,
+        deviceInfo: {
+          model: '',
+          os: 'ios',
+          osVersion: '',
+          screenWidth: 0,
+          screenHeight: 0,
+          pixelRatio: 1
+        },
+        eventCount: 0,
+        videoSegmentCount: 0,
+        storageSize: 0,
+        sdkVersion: '1.0.0',
+        isComplete: false
+      },
+      events: []
+    };
+  },
+  /**
+   * Delete a session
+   * 
+   * @param sessionId - Session ID
+   */
+  async deleteSession(_sessionId) {
+    // No-op - session deletion handled by dashboard server
+  },
+  /**
+   * Delete all sessions
+   */
+  async deleteAllSessions() {
+    // No-op - session deletion handled by dashboard server
+  },
+  /**
+   * Export session for sharing
+   * 
+   * @param sessionId - Session ID
+   * @returns Path to export file (not implemented)
+   */
+  async exportSession(_sessionId) {
+    // Return empty string - actual export should be done from dashboard server
+    getLogger().warn('exportSession not implemented - export from dashboard server');
+    return '';
+  },
+  /**
+   * Check if currently recording
+   * 
+   * @returns Whether recording is active
+   */
+  async isRecording() {
+    return _isRecording;
+  },
+  /**
+   * Get storage usage
+   * 
+   * @returns Storage usage info (always 0 - storage on dashboard server)
+   */
+  async getStorageUsage() {
+    return {
+      used: 0,
+      max: 0
+    };
+  },
+  /**
+  * Get ingest auth headers.
+  * Authentication now handled by device registration flow.
+  */
+  getIngestAuthHeaders() {
+    return null;
+  },
+  /**
+   * Mark a visual change that should be captured
+   * 
+   * Use this when your app changes in a visually significant way that should be captured,
+   * like showing a success message, updating a cart badge, or displaying an error.
+   * 
+   * @param reason - Description of what changed (e.g., 'cart_updated', 'error_shown')
+   * @param importance - How important is this change? 'low', 'medium', 'high', or 'critical'
+   * 
+   * @example
+   * ```typescript
+   * // Mark that an error was shown (high importance)
+   * await Rejourney.markVisualChange('checkout_error', 'high');
+   * 
+   * // Mark that a cart badge updated (medium importance)
+   * await Rejourney.markVisualChange('cart_badge_update', 'medium');
+   * ```
+   */
+  async markVisualChange(reason, importance = 'medium') {
+    return safeNativeCall('markVisualChange', async () => {
+      await getRejourneyNative().markVisualChange(reason, importance);
+      return true;
+    }, false);
+  },
+  /**
+   * Report a scroll event for video capture timing
+   * 
+   * Call this from your ScrollView's onScroll handler to improve scroll capture.
+   * The SDK captures video at 2 FPS continuously, but this helps log scroll events
+   * for timeline correlation during replay.
+   * 
+   * @param scrollOffset - Current scroll offset (vertical or horizontal)
+   * 
+   * @example
+   * ```typescript
+   * <ScrollView
+   *   onScroll={(e) => {
+   *     Rejourney.onScroll(e.nativeEvent.contentOffset.y);
+   *   }}
+   *   scrollEventThrottle={16}
+   * >
+   *   {content}
+   * </ScrollView>
+   * ```
+   */
+  async onScroll(scrollOffset) {
+    // Throttle scroll events to reduce native bridge traffic
+    // Scroll events can fire at 60fps, but we only need ~10/sec for smooth replay
+    const now = Date.now();
+    const offsetDelta = Math.abs(scrollOffset - _lastScrollOffset);
+
+    // Only forward to native if enough time passed OR significant scroll distance
+    if (now - _lastScrollTime < SCROLL_THROTTLE_MS && offsetDelta < 50) {
+      return;
+    }
+    _lastScrollTime = now;
+    _lastScrollOffset = scrollOffset;
+
+    // Track scroll for metrics
+    getAutoTracking().trackScroll();
+    await safeNativeCall('onScroll', () => getRejourneyNative().onScroll(scrollOffset), undefined);
+  },
+  // ========================================================================
+  // OAuth / External URL Tracking
+  // ========================================================================
+
+  /**
+   * Notify the SDK that an OAuth flow is starting
+   * 
+   * Call this before opening an OAuth URL (e.g., before opening Safari for Google/Apple sign-in).
+   * This captures the current screen and marks the session as entering an OAuth flow.
+   * 
+   * @param provider - The OAuth provider name (e.g., 'google', 'apple', 'facebook')
+   * 
+   * @example
+   * ```typescript
+   * // Before opening OAuth URL
+   * await Rejourney.onOAuthStarted('google');
+   * await WebBrowser.openAuthSessionAsync(authUrl);
+   * ```
+   */
+  async onOAuthStarted(provider) {
+    return safeNativeCall('onOAuthStarted', async () => {
+      await getRejourneyNative().onOAuthStarted(provider);
+      return true;
+    }, false);
+  },
+  /**
+   * Notify the SDK that an OAuth flow has completed
+   * 
+   * Call this after the user returns from an OAuth flow (successful or not).
+   * This captures the result screen and logs the OAuth outcome.
+   * 
+   * @param provider - The OAuth provider name (e.g., 'google', 'apple', 'facebook')
+   * @param success - Whether the OAuth flow was successful
+   * 
+   * @example
+   * ```typescript
+   * // After OAuth returns
+   * const result = await WebBrowser.openAuthSessionAsync(authUrl);
+   * await Rejourney.onOAuthCompleted('google', result.type === 'success');
+   * ```
+   */
+  async onOAuthCompleted(provider, success) {
+    return safeNativeCall('onOAuthCompleted', async () => {
+      await getRejourneyNative().onOAuthCompleted(provider, success);
+      return true;
+    }, false);
+  },
+  /**
+   * Notify the SDK that an external URL is being opened
+   * 
+   * Call this when your app opens an external URL (browser, maps, phone, etc.).
+   * This is automatically detected for app lifecycle events, but you can use this
+   * for more granular tracking.
+   * 
+   * @param urlScheme - The URL scheme being opened (e.g., 'https', 'tel', 'maps')
+   * 
+   * @example
+   * ```typescript
+   * // Before opening external URL
+   * await Rejourney.onExternalURLOpened('https');
+   * Linking.openURL('https://example.com');
+   * ```
+   */
+  async onExternalURLOpened(urlScheme) {
+    return safeNativeCall('onExternalURLOpened', async () => {
+      await getRejourneyNative().onExternalURLOpened(urlScheme);
+      return true;
+    }, false);
+  },
+  /**
+   * Log a network request for API call timeline tracking
+   * 
+   * This is a low-priority, efficient way to track API calls during session replay.
+   * Network requests are stored separately and displayed in a collapsible timeline
+   * in the dashboard for easy correlation with user actions.
+   * 
+   * @param request - Network request parameters
+   * 
+   * @example
+   * ```typescript
+   * // After a fetch completes
+   * const startTime = Date.now();
+   * const response = await fetch('https://api.example.com/users', {
+   *   method: 'POST',
+   *   body: JSON.stringify(userData),
+   * });
+   * 
+   * Rejourney.logNetworkRequest({
+   *   method: 'POST',
+   *   url: 'https://api.example.com/users',
+   *   statusCode: response.status,
+   *   duration: Date.now() - startTime,
+   *   requestBodySize: JSON.stringify(userData).length,
+   *   responseBodySize: (await response.text()).length,
+   * });
+   * ```
+   */
+  logNetworkRequest(request) {
+    safeNativeCallSync('logNetworkRequest', () => {
+      // Parse URL for efficient storage and grouping
+      let urlPath = request.url;
+      let urlHost = '';
+      try {
+        const parsedUrl = new URL(request.url);
+        urlHost = parsedUrl.host;
+        urlPath = parsedUrl.pathname + parsedUrl.search;
+      } catch {
+        // If URL parsing fails, use the full URL as path
+      }
+      const endTimestamp = request.endTimestamp || Date.now();
+      const startTimestamp = request.startTimestamp || endTimestamp - request.duration;
+      const success = request.statusCode >= 200 && request.statusCode < 400;
+
+      // Create the network request event
+      const networkEvent = {
+        type: 'network_request',
+        requestId: request.requestId || `req_${startTimestamp}_${Math.random().toString(36).substr(2, 9)}`,
+        timestamp: startTimestamp,
+        method: request.method,
+        url: request.url.length > 500 ? request.url.substring(0, 500) : request.url,
+        // Truncate long URLs
+        urlPath,
+        urlHost,
+        statusCode: request.statusCode,
+        duration: request.duration,
+        endTimestamp,
+        success,
+        requestBodySize: request.requestBodySize,
+        responseBodySize: request.responseBodySize,
+        requestContentType: request.requestContentType,
+        responseContentType: request.responseContentType,
+        errorMessage: request.errorMessage,
+        cached: request.cached
+      };
+
+      // Fire and forget - don't await, this is low priority
+      getRejourneyNative().logEvent('network_request', networkEvent).catch(() => {});
+    }, undefined);
+  },
+  // ========================================================================
+  // SDK Telemetry / Observability
+  // ========================================================================
+
+  /**
+   * Get SDK telemetry metrics for observability
+   * 
+   * Returns metrics about SDK health including upload success rates,
+   * retry attempts, circuit breaker events, and memory pressure.
+   * 
+   * @returns SDK telemetry metrics
+   * 
+   * @example
+   * ```typescript
+   * const metrics = await Rejourney.getSDKMetrics();
+   * console.log(`Upload success rate: ${(metrics.uploadSuccessRate * 100).toFixed(1)}%`);
+   * console.log(`Circuit breaker opens: ${metrics.circuitBreakerOpenCount}`);
+   * ```
+   */
+  async getSDKMetrics() {
+    return safeNativeCall('getSDKMetrics', () => getRejourneyNative().getSDKMetrics(), {
+      uploadSuccessCount: 0,
+      uploadFailureCount: 0,
+      retryAttemptCount: 0,
+      circuitBreakerOpenCount: 0,
+      memoryEvictionCount: 0,
+      offlinePersistCount: 0,
+      sessionStartCount: 0,
+      crashCount: 0,
+      uploadSuccessRate: 1.0,
+      avgUploadDurationMs: 0,
+      currentQueueDepth: 0,
+      lastUploadTime: null,
+      lastRetryTime: null,
+      totalBytesUploaded: 0,
+      totalBytesEvicted: 0
+    });
+  },
+  /**
+   * Trigger a debug ANR (Dev only)
+   * Blocks the main thread for the specified duration
+   */
+  debugTriggerANR(durationMs) {
+    if (__DEV__) {
+      safeNativeCallSync('debugTriggerANR', () => {
+        getRejourneyNative().debugTriggerANR(durationMs);
+      }, undefined);
+    } else {
+      getLogger().warn('debugTriggerANR is only available in development mode');
+    }
+  },
+  // ========================================================================
+  // Privacy / View Masking
+  // ========================================================================
+
+  /**
+   * Mask a view by its nativeID prop (will be occluded in recordings)
+   * 
+   * Use this to mask any sensitive content that isn't a text input.
+   * The view must have a `nativeID` prop set.
+   * 
+   * @param nativeID - The nativeID prop of the view to mask
+   * @example
+   * ```tsx
+   * // In your component
+   * <View nativeID="sensitiveCard">...</View>
+   * 
+   * // To mask it
+   * Rejourney.maskView('sensitiveCard');
+   * ```
+   */
+  maskView(nativeID) {
+    safeNativeCallSync('maskView', () => {
+      getRejourneyNative().maskViewByNativeID(nativeID).catch(() => {});
+    }, undefined);
+  },
+  /**
+   * Unmask a view by its nativeID prop
+   * 
+   * Removes the mask from a view that was previously masked with maskView().
+   * 
+   * @param nativeID - The nativeID prop of the view to unmask
+   */
+  unmaskView(nativeID) {
+    safeNativeCallSync('unmaskView', () => {
+      getRejourneyNative().unmaskViewByNativeID(nativeID).catch(() => {});
+    }, undefined);
+  }
+};
+
+// =============================================================================
+// Automatic Lifecycle Management
+// =============================================================================
+
+/**
+ * Handle app state changes for automatic session management
+ * - Pauses recording when app goes to background
+ * - Resumes recording when app comes back to foreground
+ * - Cleans up properly when app is terminated
+ */
+function handleAppStateChange(nextAppState) {
+  if (!_isInitialized || _initializationFailed) return;
+  try {
+    if (_currentAppState.match(/active/) && nextAppState === 'background') {
+      // App going to background - native module handles this automatically
+      getLogger().debug('App moving to background');
+    } else if (_currentAppState.match(/inactive|background/) && nextAppState === 'active') {
+      // App coming back to foreground
+      getLogger().debug('App returning to foreground');
+    }
+    _currentAppState = nextAppState;
+  } catch (error) {
+    getLogger().warn('Error handling app state change:', error);
+  }
+}
+
+/**
+ * Setup automatic lifecycle management
+ * Handles cleanup when the app unmounts or goes to background
+ */
+function setupLifecycleManagement() {
+  if (_sdkDisabled) return;
+  const RN = getReactNative();
+  if (!RN) return;
+
+  // Remove any existing subscription
+  if (_appStateSubscription) {
+    _appStateSubscription.remove();
+    _appStateSubscription = null;
+  }
+  try {
+    // Get current app state
+    _currentAppState = RN.AppState.currentState || 'active';
+
+    // Subscribe to app state changes
+    _appStateSubscription = RN.AppState.addEventListener('change', handleAppStateChange);
+
+    // Setup auth error listener from native module
+    setupAuthErrorListener();
+    getLogger().debug('Lifecycle management enabled');
+  } catch (error) {
+    getLogger().warn('Failed to setup lifecycle management:', error);
+  }
+}
+
+/**
+ * Setup listener for authentication errors from native module
+ * This handles security errors like bundle ID mismatch
+ */
+function setupAuthErrorListener() {
+  if (_sdkDisabled) return;
+  const RN = getReactNative();
+  if (!RN) return;
+  if (_authErrorSubscription) {
+    _authErrorSubscription.remove();
+    _authErrorSubscription = null;
+  }
+  try {
+    const nativeModule = getRejourneyNative();
+    if (nativeModule) {
+      // RN warns if a non-null module is passed without addListener/removeListeners.
+      // Our native module may not implement these no-op methods yet, so only pass
+      // the module when those hooks exist; otherwise use the global emitter.
+      const maybeAny = nativeModule;
+      const hasEventEmitterHooks = typeof maybeAny?.addListener === 'function' && typeof maybeAny?.removeListeners === 'function';
+      const eventEmitter = hasEventEmitterHooks ? new RN.NativeEventEmitter(maybeAny) : new RN.NativeEventEmitter();
+      _authErrorSubscription = eventEmitter.addListener('rejourneyAuthError', error => {
+        getLogger().error('Authentication error from native:', error);
+        if (error?.code === 403) {
+          getLogger().logPackageMismatch();
+        } else if (error?.code === 404) {
+          getLogger().logInvalidProjectKey();
+        }
+
+        // Update SDK state - recording has been stopped by native
+        _isRecording = false;
+
+        // Call user's error handler if provided
+        if (_storedConfig?.onAuthError) {
+          try {
+            _storedConfig.onAuthError(error);
+          } catch (callbackError) {
+            getLogger().warn('Error in onAuthError callback:', callbackError);
+          }
+        }
+      });
+    }
+  } catch (error) {
+    // Event emitter not available on this platform - that's OK
+    getLogger().debug('Auth error listener not available:', error);
+  }
+}
+
+/**
+ * Cleanup lifecycle management
+ */
+function cleanupLifecycleManagement() {
+  if (_appStateSubscription) {
+    _appStateSubscription.remove();
+    _appStateSubscription = null;
+  }
+  if (_authErrorSubscription) {
+    _authErrorSubscription.remove();
+    _authErrorSubscription = null;
+  }
+}
+
+// =============================================================================
+// Simple Initialization API
+// =============================================================================
+
+/**
+ * Initialize Rejourney SDK - STEP 1 of 3
+ * 
+ * This sets up the SDK, handles attestation, and prepares for recording,
+ * but does NOT start recording automatically. Call startRejourney() after
+ * obtaining user consent to begin recording.
+ * 
+ * @param publicRouteKey - Your public route key from the Rejourney dashboard
+ * @param options - Optional configuration options
+ * 
+ * @example
+ * ```typescript
+ * import { initRejourney, startRejourney } from 'rejourney';
+ * 
+ * // Step 1: Initialize SDK (safe to call on app start)
+ * initRejourney('pk_live_xxxxxxxxxxxx');
+ * 
+ * // Step 2: After obtaining user consent
+ * startRejourney();
+ * 
+ * // With options
+ * initRejourney('pk_live_xxxxxxxxxxxx', {
+ *   debug: true,
+ *   apiUrl: 'https://api.yourdomain.com',
+ *   projectId: 'your-project-id',
+ * });
+ * ```
+ */
+export function initRejourney(publicRouteKey, options) {
+  // Validate public route key
+  if (!publicRouteKey || typeof publicRouteKey !== 'string') {
+    getLogger().warn('Rejourney: Invalid public route key provided. SDK will be disabled.');
+    _initializationFailed = true;
+    return;
+  }
+
+  // Store config for later use
+  _storedConfig = {
+    ...options,
+    publicRouteKey
+  };
+  if (options?.debug) {
+    getLogger().setDebugMode(true);
+    const nativeModule = getRejourneyNative();
+    if (nativeModule) {
+      nativeModule.setDebugMode(true).catch(() => {});
+    }
+  }
+  _isInitialized = true;
+  (async () => {
+    try {
+      setupLifecycleManagement();
+      getLogger().logObservabilityStart();
+      getLogger().logInitSuccess(SDK_VERSION);
+    } catch (error) {
+      const reason = error instanceof Error ? error.message : String(error);
+      getLogger().logInitFailure(reason);
+      _initializationFailed = true;
+      _isInitialized = false;
+    }
+  })();
+}
+
+/**
+ * Start recording - STEP 2 of 3 (call after user consent)
+ * 
+ * Begins session recording. Call this after obtaining user consent for recording.
+ * 
+ * @example
+ * ```typescript
+ * import { initRejourney, startRejourney } from 'rejourney';
+ * 
+ * initRejourney('pk_live_xxxxxxxxxxxx');
+ * 
+ * // After user accepts consent dialog
+ * startRejourney();
+ * ```
+ */
+export function startRejourney() {
+  getLogger().debug('startRejourney() called');
+  if (!_isInitialized) {
+    getLogger().warn('Not initialized - call initRejourney() first');
+    return;
+  }
+  if (_initializationFailed) {
+    getLogger().warn('Initialization failed - cannot start recording');
+    return;
+  }
+  getLogger().logRecordingStart();
+  getLogger().debug('Starting session...');
+
+  // Fire and forget - don't block the caller
+  (async () => {
+    try {
+      const started = await Rejourney._startSession();
+      if (started) {
+        getLogger().debug('✅ Recording started successfully');
+      } else {
+        getLogger().warn('Recording not started (native module unavailable or already recording)');
+      }
+    } catch (error) {
+      getLogger().error('Failed to start recording:', error);
+    }
+  })();
+}
+
+/**
+ * Stop recording and cleanup all resources.
+ * 
+ * Note: This is usually not needed as the SDK handles cleanup automatically.
+ * Only call this if you want to explicitly stop recording.
+ */
+export function stopRejourney() {
+  try {
+    cleanupLifecycleManagement();
+    Rejourney._stopSession();
+    _isRecording = false;
+    getLogger().debug('Rejourney stopped');
+  } catch (error) {
+    getLogger().warn('Error stopping Rejourney:', error);
+  }
+}
+export default Rejourney;
+
+// Export types
+export * from './types';
+
+// Export auto tracking utilities for advanced usage
+// These are used internally but can be called manually if needed
+export { trackTap, trackScroll, trackGesture, trackInput, trackScreen, captureError, getSessionMetrics } from './sdk/autoTracking';
+
+// Navigation
+export { trackNavigationState, useNavigationTracking } from './sdk/autoTracking';
+
+// Re-export LogLevel enum from utils
+// Note: This is safe because the enum itself doesn't trigger react-native imports
+export { LogLevel } from './sdk/utils';
+
+/**
+ * Configure SDK log verbosity.
+ * 
+ * By default, the SDK logs minimally to avoid polluting your app's console:
+ * - Production/Release: SILENT (no logs at all)
+ * - Development/Debug: Only critical errors shown
+ * 
+ * Essential lifecycle events (init success, session start/end) are automatically
+ * logged in debug builds only - you don't need to configure anything.
+ * 
+ * Use this function only if you need to troubleshoot SDK behavior.
+ * 
+ * @param level - Minimum log level to display
+ * 
+ * @example
+ * ```typescript
+ * import { setLogLevel, LogLevel } from 'rejourney';
+ * 
+ * // Enable verbose logging for SDK debugging (not recommended for regular use)
+ * setLogLevel(LogLevel.DEBUG);
+ * 
+ * // Show warnings and errors (for troubleshooting)
+ * setLogLevel(LogLevel.WARNING);
+ * 
+ * // Silence all logs (default behavior in production)
+ * setLogLevel(LogLevel.SILENT);
+ * ```
+ */
+export function setLogLevel(level) {
+  getLogger().setLogLevel(level);
+}
+
+// Note: Components and hooks removed in new engine
+// Session replay now handled by dashboard web UI
+// export { RejourneyReplay } from './components/replay/RejourneyReplay';
+// export { GestureTracker } from './components/GestureTracker';
+// export { SessionList } from './components/SessionList';
+// export { useRejourney } from './hooks/useRejourney';
+// export { useReplay } from './hooks/useReplay';
+
+// Note: SDK managers removed in new engine - all functionality handled by native module
+
+// Export Mask component
+export { Mask } from './components/Mask';
+//# sourceMappingURL=index.js.map