@rejourneyco/react-native 1.0.8 → 1.0.10

package/lib/commonjs/sdk/autoTracking.js

@@ -13,11 +13,13 @@ exports.getRemainingSessionDurationMs = getRemainingSessionDurationMs;
 exports.getSessionMetrics = getSessionMetrics;
 exports.hasExceededMaxSessionDuration = hasExceededMaxSessionDuration;
 exports.initAutoTracking = initAutoTracking;
+exports.isExpoRouterTrackingEnabled = isExpoRouterTrackingEnabled;
 exports.loadAnonymousId = loadAnonymousId;
 exports.markTapHandled = markTapHandled;
 exports.notifyStateChange = notifyStateChange;
 exports.resetMetrics = resetMetrics;
 exports.setAnonymousId = setAnonymousId;
+exports.setExpoRouterPollingInterval = setExpoRouterPollingInterval;
 exports.setMaxSessionDurationMinutes = setMaxSessionDurationMinutes;
 exports.trackAPIRequest = trackAPIRequest;
 exports.trackGesture = trackGesture;
@@ -130,6 +132,7 @@ let originalOnError = null;
 let originalOnUnhandledRejection = null;
 let originalConsoleError = null;
 let _promiseRejectionTrackingDisable = null;
+const FATAL_ERROR_FLUSH_DELAY_MS = 1200;
 
 /**
  * Initialize auto tracking features
@@ -144,7 +147,9 @@ function initAutoTracking(trackingConfig, callbacks = {}) {
     trackJSErrors: true,
     trackPromiseRejections: true,
     trackReactNativeErrors: true,
+    trackConsoleLogs: true,
     collectDeviceInfo: true,
+    autoTrackExpoRouter: true,
     maxSessionDurationMs: trackingConfig.maxSessionDurationMs,
     ...trackingConfig
   };
@@ -154,6 +159,9 @@ function initAutoTracking(trackingConfig, callbacks = {}) {
   onErrorCaptured = callbacks.onError || null;
   onScreenChange = callbacks.onScreen || null;
   setupErrorTracking();
+  if (config.trackConsoleLogs) {
+    setupConsoleTracking();
+  }
   setupNavigationTracking();
   loadAnonymousId().then(id => {
     anonymousId = id;
@@ -167,11 +175,13 @@ function initAutoTracking(trackingConfig, callbacks = {}) {
 function cleanupAutoTracking() {
   if (!isInitialized) return;
   restoreErrorHandlers();
+  restoreConsoleHandlers();
   cleanupNavigationTracking();
 
   // Reset state
   tapHead = 0;
   tapCount = 0;
+  consoleLogCount = 0;
   metrics = createEmptyMetrics();
   screensVisited = [];
   currentScreen = '';
@@ -285,7 +295,7 @@ function setupErrorTracking() {
 /**
  * Setup React Native ErrorUtils handler
  *
- * CRITICAL FIX: For fatal errors, we delay calling the original handler by 500ms
+ * CRITICAL FIX: For fatal errors, we delay calling the original handler briefly
  * to give the React Native bridge time to flush the logEvent('error') call to the
  * native TelemetryPipeline. Without this delay, the error event is queued on the
  * JS→native bridge but the app crashes (via originalErrorHandler) before the bridge
@@ -309,10 +319,10 @@ function setupReactNativeErrorHandler() {
         if (isFatal) {
           // For fatal errors, delay the original handler so the native bridge
           // has time to deliver the error event to TelemetryPipeline before
-          // the app terminates. 500ms is enough for the bridge to flush.
+          // the app terminates.
           setTimeout(() => {
             originalErrorHandler(error, isFatal);
-          }, 500);
+          }, FATAL_ERROR_FLUSH_DELAY_MS);
         } else {
           originalErrorHandler(error, isFatal);
         }
@@ -367,7 +377,6 @@ function setupPromiseRejectionHandler() {
 
   // Strategy 1: RN-specific promise rejection tracking polyfill
   try {
-    // eslint-disable-next-line @typescript-eslint/no-var-requires
     const tracking = require('promise/setimmediate/rejection-tracking');
     if (tracking && typeof tracking.enable === 'function') {
       tracking.enable({
@@ -476,8 +485,27 @@ function restoreErrorHandlers() {
 function trackError(error) {
   metrics.errorCount++;
   metrics.totalEvents++;
+  forwardErrorToNative(error);
   if (onErrorCaptured) {
-    onErrorCaptured(error);
+    try {
+      onErrorCaptured(error);
+    } catch {
+      // Ignore callback exceptions so SDK error forwarding keeps working.
+    }
+  }
+}
+function forwardErrorToNative(error) {
+  try {
+    const nativeModule = getRejourneyNativeModule();
+    if (!nativeModule || typeof nativeModule.logEvent !== 'function') return;
+    nativeModule.logEvent('error', {
+      message: error.message,
+      stack: error.stack,
+      name: error.name || 'Error',
+      timestamp: error.timestamp
+    }).catch(() => {});
+  } catch {
+    // Ignore native forwarding failures; SDK should never crash app code.
   }
 }
 
@@ -493,11 +521,104 @@ function captureError(message, stack, name) {
     name: name || 'Error'
   });
 }
+let originalConsoleLog = null;
+let originalConsoleInfo = null;
+let originalConsoleWarn = null;
+
+// Cap console logs to prevent flooding the event pipeline
+const MAX_CONSOLE_LOGS_PER_SESSION = 1000;
+let consoleLogCount = 0;
+
+/**
+ * Setup console tracking to capture log statements
+ */
+function setupConsoleTracking() {
+  if (typeof console === 'undefined') return;
+  if (!originalConsoleLog) originalConsoleLog = console.log;
+  if (!originalConsoleInfo) originalConsoleInfo = console.info;
+  if (!originalConsoleWarn) originalConsoleWarn = console.warn;
+  const createConsoleInterceptor = (level, originalFn) => {
+    return (...args) => {
+      try {
+        const message = args.map(arg => {
+          if (typeof arg === 'string') return arg;
+          if (arg instanceof Error) return `${arg.name}: ${arg.message}${arg.stack ? `\n...` : ''}`;
+          try {
+            return JSON.stringify(arg);
+          } catch {
+            return String(arg);
+          }
+        }).join(' ');
+
+        // Enforce per-session cap and skip React Native unhandled-rejection noise.
+        if (consoleLogCount < MAX_CONSOLE_LOGS_PER_SESSION && !message.includes('Possible Unhandled Promise Rejection')) {
+          consoleLogCount++;
+          const nativeModule = getRejourneyNativeModule();
+          if (nativeModule) {
+            const logEvent = {
+              type: 'log',
+              timestamp: Date.now(),
+              level,
+              message: message.length > 2000 ? message.substring(0, 2000) + '...' : message
+            };
+            nativeModule.logEvent('log', logEvent).catch(() => {});
+          }
+        }
+      } catch {
+        // Ignore any errors during interception
+      }
+      if (originalFn) {
+        originalFn.apply(console, args);
+      }
+    };
+  };
+  console.log = createConsoleInterceptor('log', originalConsoleLog);
+  console.info = createConsoleInterceptor('info', originalConsoleInfo);
+  console.warn = createConsoleInterceptor('warn', originalConsoleWarn);
+  const currentConsoleError = console.error;
+  if (!originalConsoleError) originalConsoleError = currentConsoleError;
+  console.error = createConsoleInterceptor('error', currentConsoleError);
+}
+
+/**
+ * Restore console standard functions
+ */
+function restoreConsoleHandlers() {
+  if (originalConsoleLog) {
+    console.log = originalConsoleLog;
+    originalConsoleLog = null;
+  }
+  if (originalConsoleInfo) {
+    console.info = originalConsoleInfo;
+    originalConsoleInfo = null;
+  }
+  if (originalConsoleWarn) {
+    console.warn = originalConsoleWarn;
+    originalConsoleWarn = null;
+  }
+  // Note: console.error is restored in restoreErrorHandlers via originalConsoleError
+}
 let navigationPollingInterval = null;
+/** Interval ID from optional expo-router entry; cleared in cleanupNavigationTracking */
+let expoRouterPollingIntervalId = null;
 let lastDetectedScreen = '';
 let navigationSetupDone = false;
-let navigationPollingErrors = 0;
-const MAX_POLLING_ERRORS = 10; // Stop polling after 10 consecutive errors
+
+/**
+ * Register the polling interval from the optional expo-router entry so we can clear it on cleanup.
+ * Used by src/expoRouterTracking.ts (only loaded when app imports '@rejourneyco/react-native/expo-router').
+ */
+function setExpoRouterPollingInterval(id) {
+  expoRouterPollingIntervalId = id;
+}
+
+/**
+ * Check if Expo Router auto-tracking is enabled in the current configuration.
+ * Used by src/expoRouterTracking.ts.
+ */
+function isExpoRouterTrackingEnabled() {
+  return config.autoTrackExpoRouter !== false;
+}
 
 /**
  * Track a navigation state change from React Navigation.
@@ -594,91 +715,94 @@ function useNavigationTracking() {
 }
 
 /**
- * Setup automatic Expo Router tracking
- * 
- * For Expo apps using expo-router - works automatically.
- * For bare React Native apps - use trackNavigationState instead.
+ * Setup automatic navigation tracking.
+ *
+ * Expo Router: not set up here to avoid pulling expo-router into the main bundle
+ * (Metro resolves require() at build time, which causes "Requiring unknown module"
+ * in apps that use Expo + react-navigation without expo-router). If you use
+ * expo-router, add: import '@rejourneyco/react-native/expo-router';
+ *
+ * For React Navigation (non–expo-router), use trackNavigationState() on your
+ * NavigationContainer's onStateChange.
  */
 function setupNavigationTracking() {
   if (navigationSetupDone) return;
   navigationSetupDone = true;
-  if (__DEV__) {
-    _utils.logger.debug('Setting up navigation tracking...');
+
+  // Auto-detect expo-router and set up screen tracking if available.
+  // This is safe: if expo-router isn't installed, the require fails silently.
+  // We defer slightly so the router has time to initialize after JS bundle load.
+  if (config.autoTrackExpoRouter !== false) {
+    tryAutoSetupExpoRouter();
   }
-  let attempts = 0;
-  const maxAttempts = 5;
-  const trySetup = () => {
-    attempts++;
-    if (__DEV__) {
-      _utils.logger.debug('Navigation setup attempt', attempts, 'of', maxAttempts);
-    }
-    const success = trySetupExpoRouter();
-    if (success) {
-      if (__DEV__) {
-        _utils.logger.debug('Expo Router setup: SUCCESS on attempt', attempts);
-      }
-    } else if (attempts < maxAttempts) {
-      const delay = 200 * attempts;
-      if (__DEV__) {
-        _utils.logger.debug('Expo Router not ready, retrying in', delay, 'ms');
+}
+
+/**
+ * Attempt to auto-detect and set up expo-router screen tracking.
+ * Uses a retry mechanism because the router may not be ready immediately
+ * after JS bundle load.
+ */
+function tryAutoSetupExpoRouter(attempt = 0, maxAttempts = 5) {
+  const delay = 200 * (attempt + 1); // 200, 400, 600, 800, 1000ms
+
+  setTimeout(() => {
+    try {
+      // Dynamic require wrapped in a variable to prevent Metro from statically resolving it
+      const EXPO_ROUTER = 'expo-router';
+      const expoRouter = require(EXPO_ROUTER);
+      if (!expoRouter?.router) {
+        // expo-router exists but router not ready yet — retry
+        if (attempt < maxAttempts - 1) {
+          tryAutoSetupExpoRouter(attempt + 1, maxAttempts);
+        }
+        return;
       }
-      setTimeout(trySetup, delay);
-    } else {
-      if (__DEV__) {
-        _utils.logger.debug('Expo Router setup: FAILED after', maxAttempts, 'attempts');
-        _utils.logger.debug('For manual navigation tracking, use trackNavigationState() on your NavigationContainer');
+
+      // Router is ready — set up the polling-based screen tracker
+      setupExpoRouterPolling(expoRouter.router);
+    } catch {
+      // expo-router not installed — this is fine, just means the app
+      // uses bare React Navigation or no navigation at all.
+      if (__DEV__ && attempt === 0) {
+        _utils.logger.debug('Expo Router not detected, skipping auto screen tracking. Use trackNavigationState() for React Navigation.');
       }
     }
-  };
-  setTimeout(trySetup, 200);
+  }, delay);
 }
 
 /**
-   * Set up Expo Router auto-tracking by polling the internal router store
-   * 
-   * Supports both expo-router v3 (store.rootState) and v6+ (store.state, store.navigationRef)
-   */
-function trySetupExpoRouter() {
+ * Poll expo-router state for screen changes.
+ * Inlined from expoRouterTracking.ts so no separate import is needed.
+ */
+function setupExpoRouterPolling(router) {
+  // Guard against double-setup (core auto-detection + legacy expoRouterTracking.ts import)
+  if (expoRouterPollingIntervalId != null) return;
+  const MAX_POLLING_ERRORS = 10;
+  let pollingErrors = 0;
   try {
-    const expoRouter = require('expo-router');
-    const router = expoRouter.router;
-    if (!router) {
-      if (__DEV__) {
-        _utils.logger.debug('Expo Router: router object not found');
-      }
-      return false;
-    }
-    if (__DEV__) {
-      _utils.logger.debug('Expo Router: Setting up navigation tracking');
-    }
     const {
       normalizeScreenName,
       getScreenNameFromPath
     } = require('./navigation');
-    navigationPollingInterval = setInterval(() => {
+    const intervalId = setInterval(() => {
       try {
         let state = null;
-        let stateSource = '';
         if (typeof router.getState === 'function') {
           state = router.getState();
-          stateSource = 'router.getState()';
         } else if (router.rootState) {
           state = router.rootState;
-          stateSource = 'router.rootState';
         }
         if (!state) {
           try {
-            const storeModule = require('expo-router/build/global-state/router-store');
+            const STORE_PATH = 'expo-router/build/global-state/router-store';
+            const storeModule = require(STORE_PATH);
             if (storeModule?.store) {
               state = storeModule.store.state;
-              if (state) stateSource = 'store.state';
               if (!state && storeModule.store.navigationRef?.current) {
                 state = storeModule.store.navigationRef.current.getRootState?.();
-                if (state) stateSource = 'navigationRef.getRootState()';
               }
               if (!state) {
                 state = storeModule.store.rootState || storeModule.store.initialState;
-                if (state) stateSource = 'store.rootState/initialState';
               }
             }
           } catch {
@@ -687,67 +811,53 @@ function trySetupExpoRouter() {
         }
         if (!state) {
           try {
-            const imperative = require('expo-router/build/imperative-api');
+            const IMPERATIVE_PATH = 'expo-router/build/imperative-api';
+            const imperative = require(IMPERATIVE_PATH);
             if (imperative?.router) {
               state = imperative.router.getState?.();
-              if (state) stateSource = 'imperative-api';
             }
           } catch {
             // Ignore
           }
         }
         if (state) {
-          navigationPollingErrors = 0;
-          navigationPollingErrors = 0;
+          pollingErrors = 0;
           const screenName = extractScreenNameFromRouterState(state, getScreenNameFromPath, normalizeScreenName);
           if (screenName && screenName !== lastDetectedScreen) {
-            if (__DEV__) {
-              _utils.logger.debug('Screen changed:', lastDetectedScreen, '->', screenName, `(source: ${stateSource})`);
-            }
             lastDetectedScreen = screenName;
             trackScreen(screenName);
           }
         } else {
-          navigationPollingErrors++;
-          if (__DEV__ && navigationPollingErrors === 1) {
-            _utils.logger.debug('Expo Router: Could not get navigation state');
-          }
-          if (navigationPollingErrors >= MAX_POLLING_ERRORS) {
-            cleanupNavigationTracking();
+          pollingErrors++;
+          if (pollingErrors >= MAX_POLLING_ERRORS) {
+            clearInterval(intervalId);
+            expoRouterPollingIntervalId = null;
           }
         }
-      } catch (e) {
-        navigationPollingErrors++;
-        if (__DEV__ && navigationPollingErrors === 1) {
-          _utils.logger.debug('Expo Router polling error:', e);
-        }
-        if (navigationPollingErrors >= MAX_POLLING_ERRORS) {
-          cleanupNavigationTracking();
+      } catch {
+        pollingErrors++;
+        if (pollingErrors >= MAX_POLLING_ERRORS) {
+          clearInterval(intervalId);
+          expoRouterPollingIntervalId = null;
         }
       }
     }, 500);
-    return true;
-  } catch (e) {
-    if (__DEV__) {
-      _utils.logger.debug('Expo Router not available:', e);
-    }
-    return false;
+    expoRouterPollingIntervalId = intervalId;
+  } catch {
+    // navigation module not available — ignore
   }
 }
 
 /**
- * Extract screen name from Expo Router navigation state
- * 
- * Handles complex nested structures like Drawer → Tabs → Stack
- * by recursively accumulating segments from each navigation level.
+ * Extract the active screen name from expo-router navigation state.
  */
-function extractScreenNameFromRouterState(state, getScreenNameFromPath, normalizeScreenName, accumulatedSegments = []) {
+function extractScreenNameFromRouterState(state, getScreenNameFromPathFn, normalizeScreenNameFn, accumulatedSegments = []) {
   if (!state?.routes) return null;
   const route = state.routes[state.index ?? state.routes.length - 1];
   if (!route) return null;
   const newSegments = [...accumulatedSegments, route.name];
   if (route.state) {
-    return extractScreenNameFromRouterState(route.state, getScreenNameFromPath, normalizeScreenName, newSegments);
+    return extractScreenNameFromRouterState(route.state, getScreenNameFromPathFn, normalizeScreenNameFn, newSegments);
   }
   const cleanSegments = newSegments.filter(s => !s.startsWith('(') && !s.endsWith(')'));
   if (cleanSegments.length === 0) {
@@ -760,7 +870,7 @@ function extractScreenNameFromRouterState(state, getScreenNameFromPath, normaliz
     }
   }
   const pathname = '/' + cleanSegments.join('/');
-  return getScreenNameFromPath(pathname, newSegments);
+  return getScreenNameFromPathFn(pathname, newSegments);
 }
 
 /**
@@ -771,9 +881,12 @@ function cleanupNavigationTracking() {
     clearInterval(navigationPollingInterval);
     navigationPollingInterval = null;
   }
+  if (expoRouterPollingIntervalId != null) {
+    clearInterval(expoRouterPollingIntervalId);
+    expoRouterPollingIntervalId = null;
+  }
   navigationSetupDone = false;
   lastDetectedScreen = '';
-  navigationPollingErrors = 0;
 }
 
 /**
@@ -1016,7 +1129,26 @@ async function collectDeviceInfo() {
 function generateAnonymousId() {
   const timestamp = Date.now().toString(36);
   const random = Math.random().toString(36).substring(2, 15);
-  return `anon_${timestamp}_${random}`;
+  const id = `anon_${timestamp}_${random}`;
+  // Persist so the same ID survives app restarts
+  _persistAnonymousId(id);
+  return id;
+}
+
+/**
+ * Best-effort async persist of anonymous ID to native storage
+ */
+function _persistAnonymousId(id) {
+  const nativeModule = getRejourneyNativeModule();
+  if (!nativeModule?.setAnonymousId) return;
+  try {
+    const result = nativeModule.setAnonymousId(id);
+    if (result && typeof result.catch === 'function') {
+      result.catch(() => {});
+    }
+  } catch {
+    // Native storage unavailable — ID will still be stable for this session
+  }
 }
 
 /**
@@ -1047,17 +1179,41 @@ async function ensurePersistentAnonymousId() {
 
 /**
  * Load anonymous ID from persistent storage
- * Call this at app startup for best results
+ * Checks native anonymous storage first, then falls back to native getUserIdentity,
+ * and finally generates a new ID if nothing is persisted.
  */
 async function loadAnonymousId() {
   const nativeModule = getRejourneyNativeModule();
-  if (nativeModule && nativeModule.getUserIdentity) {
+
+  // 1. Try native anonymous ID storage
+  if (nativeModule?.getAnonymousId) {
+    try {
+      const stored = await nativeModule.getAnonymousId();
+      if (stored && typeof stored === 'string') return stored;
+    } catch {
+      // Continue to fallbacks
+    }
+  }
+
+  // 2. Backward compatibility fallback for older native modules
+  if (nativeModule?.getUserIdentity) {
     try {
-      return (await nativeModule.getUserIdentity()) || generateAnonymousId();
+      const nativeId = await nativeModule.getUserIdentity();
+      if (nativeId && typeof nativeId === 'string') {
+        const normalized = nativeId.trim();
+        // Only migrate legacy anonymous identifiers. Never treat explicit user identities
+        // as anonymous fingerprints, or session correlation becomes unstable.
+        if (normalized.startsWith('anon_')) {
+          _persistAnonymousId(normalized);
+          return normalized;
+        }
+      }
     } catch {
-      return generateAnonymousId();
+      // Continue to fallback
     }
   }
+
+  // 3. Generate and persist new ID
   return generateAnonymousId();
 }
 
@@ -1065,7 +1221,13 @@ async function loadAnonymousId() {
  * Set a custom anonymous ID
  */
 function setAnonymousId(id) {
-  anonymousId = id;
+  const normalized = (id || '').trim();
+  if (!normalized) {
+    anonymousId = generateAnonymousId();
+    return;
+  }
+  anonymousId = normalized;
+  _persistAnonymousId(normalized);
 }
 var _default = exports.default = {
   init: initAutoTracking,