@rejourneyco/react-native 1.0.7 → 1.0.8

package/ios/Recording/VisualCapture.swift

@@ -25,8 +25,10 @@ public final class VisualCapture: NSObject {
     
     @objc public static let shared = VisualCapture()
     
-    @objc public var snapshotInterval: Double = 0.5
+    @objc public var snapshotInterval: Double = 1.0
     @objc public var quality: CGFloat = 0.5
+    /// Capture scale (e.g. 1.25 = capture at 80% linear size). Matches Android for parity; reduces JPEG size.
+    @objc public var captureScale: CGFloat = 1.25
     
     @objc public var isCapturing: Bool {
         _stateMachine.currentState == .capturing
@@ -58,6 +60,7 @@ public final class VisualCapture: NSObject {
     
     // Industry standard batch size (20 frames per batch, not 5)
     private let _batchSize = 20
+
     
     private override init() {
         _redactionMask = RedactionMask()
@@ -135,6 +138,13 @@ public final class VisualCapture: NSObject {
         _flushBufferToDisk()
     }
     
+    /// Submit any buffered frames to the upload pipeline immediately
+    /// (regardless of batch size threshold). Packages synchronously to
+    /// avoid race conditions during backgrounding.
+    @objc public func flushBufferToNetwork() {
+        _flushBuffer()
+    }
+    
     @objc public func activateDeferredMode() {
         _deferredUntilCommit = true
     }
@@ -152,9 +162,10 @@ public final class VisualCapture: NSObject {
         _redactionMask.remove(view)
     }
     
-    @objc public func configure(snapshotInterval: Double, jpegQuality: Double) {
+    @objc public func configure(snapshotInterval: Double, jpegQuality: Double, captureScale: CGFloat = 1.25) {
         self.snapshotInterval = snapshotInterval
         self.quality = CGFloat(jpegQuality)
+        self.captureScale = max(1.0, captureScale)
         if _stateMachine.currentState == .capturing {
             _stopCaptureTimer()
             _startCaptureTimer()
@@ -163,15 +174,12 @@ public final class VisualCapture: NSObject {
     
     @objc public func snapshotNow() {
         DispatchQueue.main.async { [weak self] in
-            self?._captureFrame()
+            self?._captureFrame(forced: true)
         }
     }
     
     private func _startCaptureTimer() {
         _stopCaptureTimer()
-        // Industry standard: Use default run loop mode (NOT .common)
-        // This lets the timer pause during scrolling/tracking which prevents stutter
-        // The capture will resume when scrolling stops
         _captureTimer = Timer.scheduledTimer(withTimeInterval: snapshotInterval, repeats: true) { [weak self] _ in
             self?._captureFrame()
         }
@@ -182,7 +190,7 @@ public final class VisualCapture: NSObject {
         _captureTimer = nil
     }
     
-    private func _captureFrame() {
+    private func _captureFrame(forced: Bool = false) {
         guard _stateMachine.currentState == .capturing else { return }
         
         // Skip capture if app is not in foreground (prevents "not in visible window" warnings)
@@ -190,10 +198,31 @@ public final class VisualCapture: NSObject {
         
         let frameStart = CFAbsoluteTimeGetCurrent()
         
+        // Refresh map detection state (very cheap shallow walk)
+        SpecialCases.shared.refreshMapState()
+        
+        // Debug-only: confirm capture is running and map state
+        if _frameCounter < 5 || _frameCounter % 30 == 0 {
+            DiagnosticLog.trace("[VisualCapture] frame#\(_frameCounter) mapVisible=\(SpecialCases.shared.mapVisible) mapIdle=\(SpecialCases.shared.mapIdle) forced=\(forced)")
+        }
+        
+        // Map stutter prevention: when a map view is visible and its camera
+        // is still moving (user gesture or animation), skip drawHierarchy
+        // entirely — this is the call that causes GPU readback stutter on
+        // Metal/OpenGL-backed map tiles.  We resume capture at 1 FPS once
+        // the map SDK reports idle.
+        if !forced && SpecialCases.shared.mapVisible && !SpecialCases.shared.mapIdle {
+            DiagnosticLog.trace("[VisualCapture] SKIPPING frame (map moving)")
+            return
+        }
+        
         // Capture the pixel buffer on the main thread (required by UIKit),
         // then move JPEG compression to the encode queue to reduce main-thread blocking.
         autoreleasepool {
-            guard let window = UIApplication.shared.windows.first(where: \.isKeyWindow) else { return }
+            guard let window = UIApplication.shared.connectedScenes
+                .compactMap({ $0 as? UIWindowScene })
+                .flatMap({ $0.windows })
+                .first(where: { $0.isKeyWindow }) else { return }
             let bounds = window.bounds
             // Guard against NaN and invalid bounds that cause CoreGraphics errors
             guard bounds.width > 0, bounds.height > 0 else { return }
@@ -201,15 +230,18 @@ public final class VisualCapture: NSObject {
             guard bounds.width.isFinite && bounds.height.isFinite else { return }
             
             let redactRects = _redactionMask.computeRects()
+            let scale = max(1.0, captureScale)
+            let scaledSize = CGSize(width: bounds.width / scale, height: bounds.height / scale)
+            guard scaledSize.width >= 1, scaledSize.height >= 1 else {
+                return
+            }
             
-            // Use UIGraphicsBeginImageContextWithOptions for lower overhead (industry pattern)
-            let screenScale: CGFloat = 1.25 // Lower scale reduces encoding time significantly
-            UIGraphicsBeginImageContextWithOptions(bounds.size, false, screenScale)
+            UIGraphicsBeginImageContextWithOptions(scaledSize, false, 1.0)
             guard let context = UIGraphicsGetCurrentContext() else {
                 UIGraphicsEndImageContext()
                 return
             }
-            
+            context.scaleBy(x: 1.0 / scale, y: 1.0 / scale)
             window.drawHierarchy(in: bounds, afterScreenUpdates: false)
             
             // Apply redactions inline while context is open
@@ -263,6 +295,8 @@ public final class VisualCapture: NSObject {
         }
     }
     
+
+    
     /// Enforce memory caps to prevent unbounded growth (industry standard backpressure)
     private func _enforceScreenshotCaps() {
         // Called with lock held
@@ -594,14 +628,10 @@ private final class RedactionMask {
     }
     
     private func _keyWindow() -> UIWindow? {
-        if #available(iOS 15.0, *) {
-            return UIApplication.shared.connectedScenes
-                .compactMap { $0 as? UIWindowScene }
-                .flatMap { $0.windows }
-                .first { $0.isKeyWindow }
-        } else {
-            return UIApplication.shared.windows.first { $0.isKeyWindow }
-        }
+        return UIApplication.shared.connectedScenes
+            .compactMap { $0 as? UIWindowScene }
+            .flatMap { $0.windows }
+            .first { $0.isKeyWindow }
     }
     
     private func _scanForSensitiveViews(in view: UIView, rects: inout [CGRect], depth: Int = 0) {

package/lib/commonjs/index.js

@@ -322,7 +322,7 @@ let _storedConfig = null;
 // Abort recording (fail-closed)
 
 let _remoteConfig = null;
-let _sessionSampledOut = false; // True = telemetry only, no replay video
+let _sessionSampledOut = false; // True = telemetry only, no visual replay capture
 
 /**
  * Fetch project configuration from backend
@@ -618,7 +618,7 @@ const Rejourney = {
         // =========================================================
         _sessionSampledOut = !shouldRecordSession(_remoteConfig.sampleRate ?? 100);
         if (_sessionSampledOut) {
-          getLogger().info(`Session sampled out (rate: ${_remoteConfig.sampleRate}%) - telemetry only, no replay video`);
+          getLogger().info(`Session sampled out (rate: ${_remoteConfig.sampleRate}%) - telemetry only, no visual replay capture`);
         }
 
         // =========================================================
@@ -865,7 +865,6 @@ const Rejourney = {
           pixelRatio: 1
         },
         eventCount: 0,
-        videoSegmentCount: 0,
         storageSize: 0,
         sdkVersion: _constants.SDK_VERSION,
         isComplete: false
@@ -941,10 +940,10 @@ const Rejourney = {
     }, false);
   },
   /**
-   * Report a scroll event for video capture timing
+   * Report a scroll event for visual replay 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
+   * The SDK captures visual replay frames continuously, and this helps log scroll events
    * for timeline correlation during replay.
    * 
    * @param scrollOffset - Current scroll offset (vertical or horizontal)

package/lib/commonjs/sdk/constants.js

@@ -37,7 +37,7 @@ var _version = require("./version");
 /** Default configuration values */
 const DEFAULT_CONFIG = exports.DEFAULT_CONFIG = {
   enabled: true,
-  captureFPS: 0.5,
+  captureFPS: 1.0,
   captureOnEvents: true,
   maxSessionDuration: 10 * 60 * 1000,
   maxStorageSize: 50 * 1024 * 1024,
@@ -90,7 +90,7 @@ const PLAYBACK_SPEEDS = exports.PLAYBACK_SPEEDS = [0.5, 1, 2, 4];
 
 /** Capture settings */
 const CAPTURE_SETTINGS = exports.CAPTURE_SETTINGS = {
-  DEFAULT_FPS: 0.5,
+  DEFAULT_FPS: 1.0,
   MIN_FPS: 0.1,
   MAX_FPS: 2,
   CAPTURE_SCALE: 0.25,

package/lib/commonjs/sdk/utils.js

@@ -322,7 +322,7 @@ class Logger {
     }
   }
   notice(...args) {
-    if (typeof __DEV__ !== 'undefined' && __DEV__) {
+    if (this.minimumLogLevel <= LogLevel.INFO) {
       console.info(this.prefix, ...args);
     }
   }

package/lib/module/index.js

@@ -214,7 +214,7 @@ let _storedConfig = null;
 // Abort recording (fail-closed)
 
 let _remoteConfig = null;
-let _sessionSampledOut = false; // True = telemetry only, no replay video
+let _sessionSampledOut = false; // True = telemetry only, no visual replay capture
 
 /**
  * Fetch project configuration from backend
@@ -510,7 +510,7 @@ const Rejourney = {
         // =========================================================
         _sessionSampledOut = !shouldRecordSession(_remoteConfig.sampleRate ?? 100);
         if (_sessionSampledOut) {
-          getLogger().info(`Session sampled out (rate: ${_remoteConfig.sampleRate}%) - telemetry only, no replay video`);
+          getLogger().info(`Session sampled out (rate: ${_remoteConfig.sampleRate}%) - telemetry only, no visual replay capture`);
         }
 
         // =========================================================
@@ -757,7 +757,6 @@ const Rejourney = {
           pixelRatio: 1
         },
         eventCount: 0,
-        videoSegmentCount: 0,
         storageSize: 0,
         sdkVersion: SDK_VERSION,
         isComplete: false
@@ -833,10 +832,10 @@ const Rejourney = {
     }, false);
   },
   /**
-   * Report a scroll event for video capture timing
+   * Report a scroll event for visual replay 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
+   * The SDK captures visual replay frames continuously, and this helps log scroll events
    * for timeline correlation during replay.
    * 
    * @param scrollOffset - Current scroll offset (vertical or horizontal)

package/lib/module/sdk/constants.js

@@ -25,7 +25,7 @@ export { SDK_VERSION };
 /** Default configuration values */
 export const DEFAULT_CONFIG = {
   enabled: true,
-  captureFPS: 0.5,
+  captureFPS: 1.0,
   captureOnEvents: true,
   maxSessionDuration: 10 * 60 * 1000,
   maxStorageSize: 50 * 1024 * 1024,
@@ -78,7 +78,7 @@ export const PLAYBACK_SPEEDS = [0.5, 1, 2, 4];
 
 /** Capture settings */
 export const CAPTURE_SETTINGS = {
-  DEFAULT_FPS: 0.5,
+  DEFAULT_FPS: 1.0,
   MIN_FPS: 0.1,
   MAX_FPS: 2,
   CAPTURE_SCALE: 0.25,

package/lib/module/sdk/utils.js

@@ -301,7 +301,7 @@ class Logger {
     }
   }
   notice(...args) {
-    if (typeof __DEV__ !== 'undefined' && __DEV__) {
+    if (this.minimumLogLevel <= LogLevel.INFO) {
       console.info(this.prefix, ...args);
     }
   }

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

@@ -21,7 +21,7 @@ export { SDK_VERSION };
 /** Default configuration values */
 export declare const DEFAULT_CONFIG: {
     readonly enabled: true;
-    readonly captureFPS: 0.5;
+    readonly captureFPS: 1;
     readonly captureOnEvents: true;
     readonly maxSessionDuration: number;
     readonly maxStorageSize: number;
@@ -70,7 +70,7 @@ export declare const GESTURE_TYPES: {
 export declare const PLAYBACK_SPEEDS: readonly [0.5, 1, 2, 4];
 /** Capture settings */
 export declare const CAPTURE_SETTINGS: {
-    readonly DEFAULT_FPS: 0.5;
+    readonly DEFAULT_FPS: 1;
     readonly MIN_FPS: 0.1;
     readonly MAX_FPS: 2;
     readonly CAPTURE_SCALE: 0.25;

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

@@ -17,7 +17,7 @@ export interface RejourneyConfig {
     packageName?: string;
     /** Enable or disable recording (default: true) */
     enabled?: boolean;
-    /** Video capture FPS (default: 2 = capture every 500ms) */
+    /** Visual capture FPS (default: 1 = capture every 1000ms) */
     captureFPS?: number;
     /** Maximum session duration in milliseconds (default: 30 minutes) */
     maxSessionDuration?: number;
@@ -325,8 +325,6 @@ export interface SessionMetadata {
     geoLocation?: GeoLocation;
     /** Number of events in session */
     eventCount: number;
-    /** Number of video segments */
-    videoSegmentCount?: number;
     /** Total storage size in bytes */
     storageSize: number;
     /** Session tags */
@@ -349,7 +347,6 @@ export interface SessionSummary {
     endTime?: number;
     duration?: number;
     eventCount: number;
-    videoSegmentCount?: number;
     storageSize: number;
     isComplete: boolean;
     filePath: string;
@@ -363,8 +360,6 @@ export interface ReplayState {
     speed: 0.5 | 1 | 2 | 4;
     /** Session duration */
     duration: number;
-    /** Current video segment time position */
-    currentVideoTime?: number;
     /** Events at or near current time */
     activeEvents: SessionEvent[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rejourneyco/react-native",
-"version": "1.0.7",
+    "version": "1.0.8",
     "description": "Rejourney Session Recording SDK for React Native",
     "main": "lib/commonjs/index.js",
     "module": "lib/module/index.js",
@@ -84,7 +84,7 @@
         "react-native": "*",
         "react-native-builder-bob": "^0.23.0",
         "typescript": "^5.0.0",
-        "vitest": "^2.1.0"
+        "vitest": "^3.2.4"
     },
     "peerDependencies": {
         "react": "*",

package/src/index.ts

@@ -247,13 +247,13 @@ interface RemoteConfig {
 }
 
 // Result type for fetchRemoteConfig - distinguishes network errors from access denial
-type ConfigFetchResult = 
+type ConfigFetchResult =
   | { status: 'success'; config: RemoteConfig }
   | { status: 'network_error' }  // Proceed with defaults (fail-open)
   | { status: 'access_denied'; httpStatus: number };  // Abort recording (fail-closed)
 
 let _remoteConfig: RemoteConfig | null = null;
-let _sessionSampledOut: boolean = false; // True = telemetry only, no replay video
+let _sessionSampledOut: boolean = false; // True = telemetry only, no visual replay capture
 
 /**
  * Fetch project configuration from backend
@@ -323,7 +323,7 @@ function shouldRecordSession(sampleRate: number): boolean {
   // sampleRate is 0-100 (percentage)
   if (sampleRate >= 100) return true;
   if (sampleRate <= 0) return false;
-  
+
   const randomValue = Math.random() * 100;
   return randomValue < sampleRate;
 }
@@ -522,7 +522,7 @@ const Rejourney: RejourneyAPI = {
       // This determines if recording is enabled and at what rate
       // =========================================================
       const configResult = await fetchRemoteConfig(apiUrl, publicKey);
-      
+
       // =========================================================
       // CASE 0: Access denied (401/403) - abort immediately
       // This means project disabled, invalid key, etc - HARD STOP
@@ -531,10 +531,10 @@ const Rejourney: RejourneyAPI = {
         getLogger().info(`Recording disabled - access denied (${configResult.httpStatus})`);
         return false;
       }
-      
+
       // For success, extract the config; for network_error, proceed with null
       _remoteConfig = configResult.status === 'success' ? configResult.config : null;
-      
+
       if (_remoteConfig) {
         // =========================================================
         // CASE 1: Rejourney completely disabled - abort early, nothing captured
@@ -560,7 +560,7 @@ const Rejourney: RejourneyAPI = {
         // =========================================================
         _sessionSampledOut = !shouldRecordSession(_remoteConfig.sampleRate ?? 100);
         if (_sessionSampledOut) {
-          getLogger().info(`Session sampled out (rate: ${_remoteConfig.sampleRate}%) - telemetry only, no replay video`);
+          getLogger().info(`Session sampled out (rate: ${_remoteConfig.sampleRate}%) - telemetry only, no visual replay capture`);
         }
 
         // =========================================================
@@ -868,7 +868,6 @@ const Rejourney: RejourneyAPI = {
         duration: 0,
         deviceInfo: { model: '', os: 'ios', osVersion: '', screenWidth: 0, screenHeight: 0, pixelRatio: 1 },
         eventCount: 0,
-        videoSegmentCount: 0,
         storageSize: 0,
         sdkVersion: SDK_VERSION,
         isComplete: false,
@@ -957,10 +956,10 @@ const Rejourney: RejourneyAPI = {
   },
 
   /**
-   * Report a scroll event for video capture timing
+   * Report a scroll event for visual replay 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
+   * The SDK captures visual replay frames continuously, and this helps log scroll events
    * for timeline correlation during replay.
    * 
    * @param scrollOffset - Current scroll offset (vertical or horizontal)

package/src/sdk/constants.ts

@@ -26,7 +26,7 @@ export { SDK_VERSION };
 /** Default configuration values */
 export const DEFAULT_CONFIG = {
   enabled: true,
-  captureFPS: 0.5,
+  captureFPS: 1.0,
   captureOnEvents: true,
   maxSessionDuration: 10 * 60 * 1000,
   maxStorageSize: 50 * 1024 * 1024,
@@ -79,7 +79,7 @@ export const PLAYBACK_SPEEDS = [0.5, 1, 2, 4] as const;
 
 /** Capture settings */
 export const CAPTURE_SETTINGS = {
-  DEFAULT_FPS: 0.5,
+  DEFAULT_FPS: 1.0,
   MIN_FPS: 0.1,
   MAX_FPS: 2,
   CAPTURE_SCALE: 0.25,

package/src/sdk/utils.ts

@@ -324,7 +324,7 @@ class Logger {
   }
 
   notice(...args: any[]): void {
-    if (typeof __DEV__ !== 'undefined' && __DEV__) {
+    if (this.minimumLogLevel <= LogLevel.INFO) {
       console.info(this.prefix, ...args);
     }
   }

package/src/types/index.ts

@@ -23,7 +23,7 @@ export interface RejourneyConfig {
 
   /** Enable or disable recording (default: true) */
   enabled?: boolean;
-  /** Video capture FPS (default: 2 = capture every 500ms) */
+  /** Visual capture FPS (default: 1 = capture every 1000ms) */
   captureFPS?: number;
   /** Maximum session duration in milliseconds (default: 30 minutes) */
   maxSessionDuration?: number;
@@ -410,8 +410,6 @@ export interface SessionMetadata {
   geoLocation?: GeoLocation;
   /** Number of events in session */
   eventCount: number;
-  /** Number of video segments */
-  videoSegmentCount?: number;
   /** Total storage size in bytes */
   storageSize: number;
   /** Session tags */
@@ -436,7 +434,6 @@ export interface SessionSummary {
   endTime?: number;
   duration?: number;
   eventCount: number;
-  videoSegmentCount?: number;
   storageSize: number;
   isComplete: boolean;
   filePath: string;
@@ -451,8 +448,6 @@ export interface ReplayState {
   speed: 0.5 | 1 | 2 | 4;
   /** Session duration */
   duration: number;
-  /** Current video segment time position */
-  currentVideoTime?: number;
   /** Events at or near current time */
   activeEvents: SessionEvent[];
 }