@switchlabs/verify-ai-react-native 2.5.2 → 2.5.3

package/lib/components/VerifyAIScanner.js

@@ -23,10 +23,18 @@ const CAMERA_CAPTURE_RETRY_DELAY_MS = 350;
 const CAMERA_CAPTURE_RETRY_TORCH_SETTLE_MS = 800;
 const IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 3000;
 const ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 10000;
-const IOS_CAMERA_STARTUP_WATCHDOG_MS = 8000;
+// iOS AVCaptureSession cold start can legitimately exceed 8s on first launch (permission
+// prompt, first-ever session spin-up, thermal/low-power throttling). An 8s watchdog tore
+// down sessions that were seconds from ready and restarted from scratch, which made slow
+// cold starts *worse* and fired camera_preview_timeout in bursts. Match Android at 10s.
+const IOS_CAMERA_STARTUP_WATCHDOG_MS = 10000;
 const ANDROID_CAMERA_STARTUP_WATCHDOG_MS = 10000;
 const CAMERA_STARTUP_SLOW_TELEMETRY_MS = 3000;
+// Base backoff between startup remounts. Each successive remount escalates this (see
+// startupRemountBackoffMs below) so later attempts get progressively more uninterrupted
+// time to initialize the native session instead of thrashing at a fixed interval.
 const CAMERA_STARTUP_REMOUNT_BACKOFF_MS = 350;
+const CAMERA_STARTUP_REMOUNT_BACKOFF_MAX_MS = 1200;
 const CAMERA_STARTUP_WATCHDOG_MAX_REMOUNTS = 5;
 const ANDROID_ORIENTATION_NO_EVENT_TIMEOUT_MS = 3000;
 const ANDROID_ORIENTATION_SAMPLE_TELEMETRY_MS = 3000;
@@ -844,6 +852,9 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                     const startupWatchdogRemountCount = startupWatchdogRemountCountRef.current + 1;
                     startupWatchdogRemountCountRef.current = startupWatchdogRemountCount;
                     cameraRemountCountRef.current++;
+                    // Escalate the backoff with each attempt (350, 700, 1050, capped at 1200ms) so a
+                    // camera that just needs more time isn't repeatedly interrupted at a fixed cadence.
+                    const startupRemountBackoffMs = Math.min(CAMERA_STARTUP_REMOUNT_BACKOFF_MS * startupWatchdogRemountCount, CAMERA_STARTUP_REMOUNT_BACKOFF_MAX_MS);
                     telemetry?.track('camera_preview_timeout', {
                         component: 'scanner',
                         error: `Camera did not initialize within ${Math.round(watchdogMs / 1000)} seconds — remounting`,
@@ -852,12 +863,12 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                             remount_reason: 'startup_watchdog',
                             startup_watchdog_remount_count: startupWatchdogRemountCount,
                             startup_watchdog_max_remounts: CAMERA_STARTUP_WATCHDOG_MAX_REMOUNTS,
-                            startup_remount_backoff_ms: CAMERA_STARTUP_REMOUNT_BACKOFF_MS,
+                            startup_remount_backoff_ms: startupRemountBackoffMs,
                             torch_deferred_until_ready: enableTorch ? 1 : 0,
                         }),
                     });
                     requestCameraRemount('startup_watchdog', {
-                        backoffMs: CAMERA_STARTUP_REMOUNT_BACKOFF_MS,
+                        backoffMs: startupRemountBackoffMs,
                         log: true,
                     });
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@switchlabs/verify-ai-react-native",
-  "version": "2.5.2",
+  "version": "2.5.3",
   "description": "React Native SDK for Verify AI - photo verification with AI vision processing",
   "repository": {
     "type": "git",

package/src/components/VerifyAIScanner.tsx

@@ -48,10 +48,18 @@ const CAMERA_CAPTURE_RETRY_DELAY_MS = 350;
 const CAMERA_CAPTURE_RETRY_TORCH_SETTLE_MS = 800;
 const IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 3000;
 const ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 10000;
-const IOS_CAMERA_STARTUP_WATCHDOG_MS = 8000;
+// iOS AVCaptureSession cold start can legitimately exceed 8s on first launch (permission
+// prompt, first-ever session spin-up, thermal/low-power throttling). An 8s watchdog tore
+// down sessions that were seconds from ready and restarted from scratch, which made slow
+// cold starts *worse* and fired camera_preview_timeout in bursts. Match Android at 10s.
+const IOS_CAMERA_STARTUP_WATCHDOG_MS = 10000;
 const ANDROID_CAMERA_STARTUP_WATCHDOG_MS = 10000;
 const CAMERA_STARTUP_SLOW_TELEMETRY_MS = 3000;
+// Base backoff between startup remounts. Each successive remount escalates this (see
+// startupRemountBackoffMs below) so later attempts get progressively more uninterrupted
+// time to initialize the native session instead of thrashing at a fixed interval.
 const CAMERA_STARTUP_REMOUNT_BACKOFF_MS = 350;
+const CAMERA_STARTUP_REMOUNT_BACKOFF_MAX_MS = 1200;
 const CAMERA_STARTUP_WATCHDOG_MAX_REMOUNTS = 5;
 const ANDROID_ORIENTATION_NO_EVENT_TIMEOUT_MS = 3000;
 const ANDROID_ORIENTATION_SAMPLE_TELEMETRY_MS = 3000;
@@ -1042,6 +1050,12 @@ export function VerifyAIScanner({
           const startupWatchdogRemountCount = startupWatchdogRemountCountRef.current + 1;
           startupWatchdogRemountCountRef.current = startupWatchdogRemountCount;
           cameraRemountCountRef.current++;
+          // Escalate the backoff with each attempt (350, 700, 1050, capped at 1200ms) so a
+          // camera that just needs more time isn't repeatedly interrupted at a fixed cadence.
+          const startupRemountBackoffMs = Math.min(
+            CAMERA_STARTUP_REMOUNT_BACKOFF_MS * startupWatchdogRemountCount,
+            CAMERA_STARTUP_REMOUNT_BACKOFF_MAX_MS,
+          );
           telemetry?.track('camera_preview_timeout', {
             component: 'scanner',
             error: `Camera did not initialize within ${Math.round(watchdogMs / 1000)} seconds — remounting`,
@@ -1050,12 +1064,12 @@ export function VerifyAIScanner({
               remount_reason: 'startup_watchdog',
               startup_watchdog_remount_count: startupWatchdogRemountCount,
               startup_watchdog_max_remounts: CAMERA_STARTUP_WATCHDOG_MAX_REMOUNTS,
-              startup_remount_backoff_ms: CAMERA_STARTUP_REMOUNT_BACKOFF_MS,
+              startup_remount_backoff_ms: startupRemountBackoffMs,
               torch_deferred_until_ready: enableTorch ? 1 : 0,
             }),
           });
           requestCameraRemount('startup_watchdog', {
-            backoffMs: CAMERA_STARTUP_REMOUNT_BACKOFF_MS,
+            backoffMs: startupRemountBackoffMs,
             log: true,
           });
         }