@rejourneyco/react-native 1.0.8 → 1.0.10

package/lib/typescript/NativeRejourney.d.ts

@@ -106,8 +106,7 @@ export interface Spec extends TurboModule {
      */
     debugCrash(): void;
     /**
-     * Trigger a debug ANR (Dev only)
-     * Blocks the main thread for the specified duration
+     * Trigger an ANR test by blocking the main thread for the specified duration.
      */
     debugTriggerANR(durationMs: number): void;
     /**
@@ -130,6 +129,10 @@ export interface Spec extends TurboModule {
         success: boolean;
     }>;
     getUserIdentity(): Promise<string | null>;
+    setAnonymousId(anonymousId: string): Promise<{
+        success: boolean;
+    }>;
+    getAnonymousId(): Promise<string | null>;
     setDebugMode(enabled: boolean): Promise<{
         success: boolean;
     }>;

package/lib/typescript/expoRouterTracking.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Optional Expo Router integration for @rejourneyco/react-native
+ *
+ * This file is only loaded when you import '@rejourneyco/react-native/expo-router'.
+ * It contains require('expo-router') and related subpaths. Metro bundles require()
+ * at build time, so keeping this in a separate entry ensures apps that use
+ * Expo with react-navigation (without expo-router) never pull in expo-router
+ * and avoid "Requiring unknown module" crashes.
+ *
+ * If you use expo-router, add this once (e.g. in your root _layout.tsx):
+ *   import '@rejourneyco/react-native/expo-router';
+ */
+export {};
+//# sourceMappingURL=expoRouterTracking.d.ts.map

package/lib/typescript/index.d.ts

@@ -26,7 +26,7 @@ import type { RejourneyConfig, RejourneyAPI } from './types';
 /**
  * Main Rejourney API (Internal)
  */
-declare const Rejourney: RejourneyAPI;
+export declare const Rejourney: RejourneyAPI;
 /**
  * Initialize Rejourney SDK - STEP 1 of 3
  *
@@ -81,7 +81,7 @@ export declare function startRejourney(): void;
 export declare function stopRejourney(): void;
 export default Rejourney;
 export * from './types';
-export { trackTap, trackScroll, trackGesture, trackInput, trackScreen, captureError, getSessionMetrics, } from './sdk/autoTracking';
+export { trackTap, trackScroll, trackGesture, trackInput, captureError, getSessionMetrics, } from './sdk/autoTracking';
 export { trackNavigationState, useNavigationTracking } from './sdk/autoTracking';
 export { LogLevel } from './sdk/utils';
 /**

package/lib/typescript/sdk/autoTracking.d.ts

@@ -64,9 +64,11 @@ export interface AutoTrackingConfig {
     trackJSErrors?: boolean;
     trackPromiseRejections?: boolean;
     trackReactNativeErrors?: boolean;
+    trackConsoleLogs?: boolean;
     collectDeviceInfo?: boolean;
     maxSessionDurationMs?: number;
     detectDeadTaps?: boolean;
+    autoTrackExpoRouter?: boolean;
 }
 /**
  * Mark a tap as handled.
@@ -100,6 +102,16 @@ export declare function notifyStateChange(): void;
  * Manually track an error (for API errors, etc.)
  */
 export declare function captureError(message: string, stack?: string, name?: string): void;
+/**
+ * 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').
+ */
+export declare function setExpoRouterPollingInterval(id: ReturnType<typeof setInterval> | null): void;
+/**
+ * Check if Expo Router auto-tracking is enabled in the current configuration.
+ * Used by src/expoRouterTracking.ts.
+ */
+export declare function isExpoRouterTrackingEnabled(): boolean;
 /**
  * Track a navigation state change from React Navigation.
  *
@@ -198,7 +210,8 @@ export declare function getAnonymousId(): string;
 export declare function ensurePersistentAnonymousId(): Promise<string>;
 /**
  * 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.
  */
 export declare function loadAnonymousId(): Promise<string>;
 /**

package/lib/typescript/types/index.d.ts

@@ -25,6 +25,8 @@ export interface RejourneyConfig {
     maxStorageSize?: number;
     /** Enable automatic screen name detection with React Navigation (default: true) */
     autoScreenTracking?: boolean;
+    /** Enable automatic screen name detection with Expo Router (default: true) */
+    autoTrackExpoRouter?: boolean;
     /** Enable automatic gesture detection (default: true) */
     autoGestureTracking?: boolean;
     /** Enable privacy occlusion for text inputs (default: true) */
@@ -90,6 +92,11 @@ export interface RejourneyConfig {
      * Disable if you want minimal network tracking overhead.
      */
     networkCaptureSizes?: boolean;
+    /**
+     * Automatically intercept console.log/info/warn/error and include them in session recordings.
+     * Useful for debugging sessions. Capped at 1,000 logs per session. (default: true)
+     */
+    trackConsoleLogs?: boolean;
 }
 export type GestureType = 'tap' | 'double_tap' | 'long_press' | 'force_touch' | 'swipe_left' | 'swipe_right' | 'swipe_up' | 'swipe_down' | 'pinch' | 'pinch_in' | 'pinch_out' | 'pan_up' | 'pan_down' | 'pan_left' | 'pan_right' | 'rotate_cw' | 'rotate_ccw' | 'scroll' | 'scroll_up' | 'scroll_down' | 'two_finger_tap' | 'three_finger_gesture' | 'multi_touch' | 'keyboard_tap' | 'rage_tap';
 export type EventType = 'gesture' | 'screen_change' | 'custom' | 'app_state' | 'app_lifecycle' | 'keyboard_show' | 'keyboard_hide' | 'keyboard_typing' | 'oauth_started' | 'oauth_completed' | 'oauth_returned' | 'external_url_opened' | 'session_start' | 'session_timeout' | 'frustration' | 'error';
@@ -428,7 +435,17 @@ export interface RejourneyNativeModule {
 export interface RejourneyAPI {
     /** SDK version */
     readonly version: string;
-    /** Internal method to start recording session (called by startRejourney) */
+    /**
+     * Initialize Rejourney SDK
+     * @param publicRouteKey - Your public route key from the Rejourney dashboard
+     * @param options - Optional configuration options
+     */
+    init(publicRouteKey: string, options?: Omit<RejourneyConfig, 'publicRouteKey'>): void;
+    /** Start recording (call after user consent) */
+    start(): void;
+    /** Stop recording */
+    stop(): void;
+    /** Internal method to start recording session (called by start() / startRejourney()) */
     _startSession(): Promise<boolean>;
     /** Internal method to stop recording session (called by stopRejourney) */
     _stopSession(): Promise<void>;
@@ -438,8 +455,18 @@ export interface RejourneyAPI {
     setUserIdentity(userId: string): void;
     /** Clear user identity */
     clearUserIdentity(): void;
-    /** Tag current screen */
-    tagScreen(screenName: string, params?: Record<string, unknown>): void;
+    /**
+     * Set custom session metadata.
+     * Can be called with a single key-value pair or an object of properties.
+     * Useful for filtering sessions later (e.g., plan: 'premium', role: 'admin').
+     * Caps at 100 properties per session.
+     *
+     * @param keyOrProperties Property name string, or an object containing key-value pairs
+     * @param value Property value (if first argument is a string)
+     */
+    setMetadata(keyOrProperties: string | Record<string, string | number | boolean>, value?: string | number | boolean): void;
+    /** Track current screen (manual) */
+    trackScreen(screenName: string, params?: Record<string, unknown>): void;
     /** Mark a view as sensitive (will be occluded in recording) */
     setOccluded(viewRef: {
         current: any;
@@ -492,15 +519,22 @@ export interface RejourneyAPI {
         used: number;
         max: number;
     }>;
+    /**
+     * Log customer feedback (e.g. from an in-app survey or NPS widget).
+     *
+     * @param rating - Numeric rating (e.g. 1 to 5)
+     * @param message - Associated feedback text or comment
+     */
+    logFeedback(rating: number, message: string): void;
     /**
      * Get SDK telemetry metrics for observability
+  
      * Returns metrics about SDK health including upload success rates,
      * retry attempts, circuit breaker events, and memory pressure.
      */
     getSDKMetrics(): Promise<SDKMetrics>;
     /**
-     * Trigger a debug ANR (Dev only)
-     * Blocks the main thread for the specified duration
+     * Trigger an ANR test by blocking the main thread for the specified duration.
      */
     debugTriggerANR(durationMs: number): void;
     /**
@@ -528,6 +562,21 @@ export interface RejourneyAPI {
      * @param nativeID - The nativeID prop of the view to unmask
      */
     unmaskView(nativeID: string): void;
+    /**
+     * Hook for automatic React Navigation tracking.
+     * Pass the returned object to your NavigationContainer props.
+     *
+     * @example
+     * ```tsx
+     * const navigationTracking = Rejourney.useNavigationTracking();
+     * <NavigationContainer {...navigationTracking}>
+     * ```
+     */
+    useNavigationTracking(): {
+        ref: any;
+        onReady: () => void;
+        onStateChange: (state: any) => void;
+    };
 }
 /**
  * SDK telemetry metrics for observability
@@ -595,6 +644,8 @@ export interface UseRejourneyResult {
     stopRecording: () => Promise<void>;
     /** Log custom event */
     logEvent: (name: string, properties?: Record<string, unknown>) => void;
+    /** Set custom session metadata */
+    setMetadata: (keyOrProperties: string | Record<string, string | number | boolean>, value?: string | number | boolean) => void;
     /** Error if any */
     error: Error | null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rejourneyco/react-native",
-    "version": "1.0.8",
+    "version": "1.0.10",
     "description": "Rejourney Session Recording SDK for React Native",
     "main": "lib/commonjs/index.js",
     "module": "lib/module/index.js",
@@ -75,7 +75,7 @@
         "@types/react-native": "*",
         "@typescript-eslint/eslint-plugin": "^8.15.0",
         "@typescript-eslint/parser": "^8.15.0",
-        "@vitest/coverage-v8": "^2.1.0",
+        "@vitest/coverage-v8": "^4.0.18",
         "dependency-cruiser": "^16.10.4",
         "@react-navigation/native": "*",
         "expo-router": "*",
@@ -84,7 +84,7 @@
         "react-native": "*",
         "react-native-builder-bob": "^0.23.0",
         "typescript": "^5.0.0",
-        "vitest": "^3.2.4"
+        "vitest": "^4.0.18"
     },
     "peerDependencies": {
         "react": "*",
@@ -92,6 +92,26 @@
         "@react-navigation/native": ">=6.0.0",
         "expo-router": ">=3.0.0"
     },
+    "peerDependenciesMeta": {
+        "expo-router": {
+            "optional": true
+        }
+    },
+    "exports": {
+        ".": {
+            "types": "./lib/typescript/index.d.ts",
+            "react-native": "./lib/module/index.js",
+            "import": "./lib/module/index.js",
+            "require": "./lib/commonjs/index.js"
+        },
+        "./expo-router": {
+            "types": "./lib/typescript/expoRouterTracking.d.ts",
+            "react-native": "./lib/module/expoRouterTracking.js",
+            "import": "./lib/module/expoRouterTracking.js",
+            "require": "./lib/commonjs/expoRouterTracking.js",
+            "default": "./lib/module/expoRouterTracking.js"
+        }
+    },
     "codegenConfig": {
         "name": "RejourneySpec",
         "type": "modules",

package/src/NativeRejourney.ts

@@ -128,8 +128,7 @@ export interface Spec extends TurboModule {
   debugCrash(): void;
 
   /**
-   * Trigger a debug ANR (Dev only)
-   * Blocks the main thread for the specified duration
+   * Trigger an ANR test by blocking the main thread for the specified duration.
    */
   debugTriggerANR(durationMs: number): void;
 
@@ -152,11 +151,15 @@ export interface Spec extends TurboModule {
 
   getUserIdentity(): Promise<string | null>;
 
+  setAnonymousId(anonymousId: string): Promise<{ success: boolean }>;
+
+  getAnonymousId(): Promise<string | null>;
+
   setDebugMode(enabled: boolean): Promise<{ success: boolean }>;
 
-/**
-   * Set SDK version from JS (called during init with version from package.json)
-   */
+  /**
+     * Set SDK version from JS (called during init with version from package.json)
+     */
   setSDKVersion(version: string): void;
 
   /**

package/src/expoRouterTracking.ts

@@ -0,0 +1,167 @@
+/**
+ * Optional Expo Router integration for @rejourneyco/react-native
+ *
+ * This file is only loaded when you import '@rejourneyco/react-native/expo-router'.
+ * It contains require('expo-router') and related subpaths. Metro bundles require()
+ * at build time, so keeping this in a separate entry ensures apps that use
+ * Expo with react-navigation (without expo-router) never pull in expo-router
+ * and avoid "Requiring unknown module" crashes.
+ *
+ * If you use expo-router, add this once (e.g. in your root _layout.tsx):
+ *   import '@rejourneyco/react-native/expo-router';
+ */
+
+import { trackScreen, setExpoRouterPollingInterval, isExpoRouterTrackingEnabled } from './sdk/autoTracking';
+import { normalizeScreenName, getScreenNameFromPath } from './sdk/navigation';
+
+const MAX_POLLING_ERRORS = 10;
+
+function extractScreenNameFromRouterState(
+  state: any,
+  getScreenNameFromPathFn: (path: string, segments: string[]) => string,
+  normalizeScreenNameFn: (name: string) => string,
+  accumulatedSegments: string[] = []
+): string | null {
+  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,
+      getScreenNameFromPathFn,
+      normalizeScreenNameFn,
+      newSegments
+    );
+  }
+
+  const cleanSegments = newSegments.filter((s) => !s.startsWith('(') && !s.endsWith(')'));
+
+  if (cleanSegments.length === 0) {
+    for (let i = newSegments.length - 1; i >= 0; i--) {
+      const seg = newSegments[i];
+      if (seg && !seg.startsWith('(') && !seg.endsWith(')')) {
+        cleanSegments.push(seg);
+        break;
+      }
+    }
+  }
+
+  const pathname = '/' + cleanSegments.join('/');
+  return getScreenNameFromPathFn(pathname, newSegments);
+}
+
+function setupExpoRouterPolling(): void {
+  let lastDetectedScreen = '';
+  let pollingErrors = 0;
+
+  try {
+    const EXPO_ROUTER = 'expo-router';
+    const expoRouter = require(EXPO_ROUTER);
+    const router = expoRouter.router;
+
+    if (!router) {
+      if (typeof __DEV__ !== 'undefined' && __DEV__) {
+        console.debug('[Rejourney] Expo Router: router object not found');
+      }
+      return;
+    }
+
+    const intervalId = setInterval(() => {
+      try {
+        let state: any = null;
+        if (typeof router.getState === 'function') {
+          state = router.getState();
+        } else if ((router as any).rootState) {
+          state = (router as any).rootState;
+        }
+
+        if (!state) {
+          try {
+            const STORE_PATH = 'expo-router/build/global-state/router-store';
+            const storeModule = require(STORE_PATH);
+            if (storeModule?.store) {
+              state = storeModule.store.state;
+              if (!state && storeModule.store.navigationRef?.current) {
+                state = storeModule.store.navigationRef.current.getRootState?.();
+              }
+              if (!state) {
+                state = storeModule.store.rootState || storeModule.store.initialState;
+              }
+            }
+          } catch {
+            // Ignore
+          }
+        }
+
+        if (!state) {
+          try {
+            const IMPERATIVE_PATH = 'expo-router/build/imperative-api';
+            const imperative = require(IMPERATIVE_PATH);
+            if (imperative?.router) {
+              state = imperative.router.getState?.();
+            }
+          } catch {
+            // Ignore
+          }
+        }
+
+        if (state) {
+          pollingErrors = 0;
+          const screenName = extractScreenNameFromRouterState(
+            state,
+            getScreenNameFromPath,
+            normalizeScreenName
+          );
+          if (screenName && screenName !== lastDetectedScreen) {
+            lastDetectedScreen = screenName;
+            trackScreen(screenName);
+          }
+        } else {
+          pollingErrors++;
+          if (pollingErrors >= MAX_POLLING_ERRORS) {
+            clearInterval(intervalId);
+            setExpoRouterPollingInterval(null);
+          }
+        }
+      } catch {
+        pollingErrors++;
+        if (pollingErrors >= MAX_POLLING_ERRORS) {
+          clearInterval(intervalId);
+          setExpoRouterPollingInterval(null);
+        }
+      }
+    }, 500);
+
+    setExpoRouterPollingInterval(intervalId);
+  } catch (e) {
+    if (typeof __DEV__ !== 'undefined' && __DEV__) {
+      console.debug('[Rejourney] Expo Router not available:', e);
+    }
+  }
+}
+
+let attempts = 0;
+const maxAttempts = 5;
+
+function trySetup(): void {
+  attempts++;
+  try {
+    const EXPO_ROUTER = 'expo-router';
+    const expoRouter = require(EXPO_ROUTER);
+    if (expoRouter?.router && isExpoRouterTrackingEnabled()) {
+      setupExpoRouterPolling();
+      return;
+    }
+  } catch {
+    // Not ready or not installed
+  }
+  if (attempts < maxAttempts) {
+    setTimeout(trySetup, 200 * attempts);
+  }
+}
+
+setTimeout(trySetup, 200);