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

package/lib/components/VerifyAIScanner.js

@@ -8,6 +8,7 @@ import { SDK_VERSION } from '../version';
 import { BikeOverlay } from './BikeOverlay';
 import { ScooterOverlay } from './ScooterOverlay';
 import { ANDROID_ACCELEROMETER_AXIS_DOMINANCE_THRESHOLD, classifyAndroidAccelerometerOrientation, getOverlayRotationDeg, } from './scannerOrientation';
+import { CAMERA_CAPTURE_RETRY_DELAY_MS, getCameraCaptureRetryPlan, } from './cameraCaptureRetry';
 /** Quality used when expo-image-manipulator is not available (lower = smaller). */
 const FALLBACK_QUALITY = 0.65;
 /** Quality used when expo-image-manipulator IS available (resize handles size). */
@@ -19,14 +20,18 @@ const CAMERA_NOT_READY_ERROR_CODE = 'ERR_CAMERA_NOT_READY';
 const CAMERA_INIT_ERROR_CODE = 'ERR_CAMERA_INIT_FAILED';
 const DEFAULT_TERMINAL_RESULT_DISPLAY_MS = 3000;
 const TRANSIENT_ERROR_DISPLAY_MS = 3000;
-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 +849,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 +860,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,
                     });
                 }
@@ -947,6 +955,7 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
         let captureRetryTorchSuppressed = false;
         let captureRetrySettleDelayMs = CAMERA_CAPTURE_RETRY_DELAY_MS;
         let captureRetryRemountBackoffMs = 0;
+        let captureRetryReadyTimeoutMs = 0;
         let lastNativeCaptureErrorMessage = null;
         try {
             const capturePhysicalOrientation = physicalOrientation;
@@ -1014,13 +1023,11 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                         lastNativeCaptureErrorMessage = normalized.message;
                         if (attempt === 1 && isNativeCameraCaptureError(normalized) && !terminated) {
                             captureRetryAttempted = true;
-                            captureRetryTorchSuppressed = !!enableTorch;
-                            captureRetrySettleDelayMs = captureRetryTorchSuppressed
-                                ? CAMERA_CAPTURE_RETRY_TORCH_SETTLE_MS
-                                : CAMERA_CAPTURE_RETRY_DELAY_MS;
-                            captureRetryRemountBackoffMs = captureRetryTorchSuppressed
-                                ? CAMERA_CAPTURE_RETRY_DELAY_MS
-                                : 0;
+                            const retryPlan = getCameraCaptureRetryPlan(Platform.OS, !!enableTorch);
+                            captureRetryTorchSuppressed = retryPlan.suppressTorch;
+                            captureRetrySettleDelayMs = retryPlan.settleDelayMs;
+                            captureRetryRemountBackoffMs = retryPlan.remountBackoffMs;
+                            captureRetryReadyTimeoutMs = retryPlan.readyTimeoutMs;
                             const retryAt = new Date().toISOString();
                             lastCaptureRetryAtRef.current = retryAt;
                             cameraRemountCountRef.current++;
@@ -1031,9 +1038,6 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                                 ? { backoffMs: captureRetryRemountBackoffMs }
                                 : undefined);
                             await sleep(captureRetrySettleDelayMs);
-                            const captureRetryReadyTimeoutMs = Platform.OS === 'android'
-                                ? ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS
-                                : IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS;
                             captureRetryReady = await waitForCameraReady(captureRetryReadyTimeoutMs);
                             telemetry?.track('camera_capture_retry', {
                                 component: 'scanner',
@@ -1131,6 +1135,7 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                     capture_retry_torch_suppressed: captureRetryTorchSuppressed,
                     capture_retry_settle_delay_ms: captureRetrySettleDelayMs,
                     capture_retry_remount_backoff_ms: captureRetryRemountBackoffMs,
+                    capture_retry_ready_timeout_ms: captureRetryReadyTimeoutMs,
                     recovered_native_capture_failure: captureRetryAttempted ? 1 : 0,
                     last_native_capture_error: lastNativeCaptureErrorMessage,
                 }),
@@ -1207,6 +1212,7 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                         capture_retry_torch_suppressed: captureRetryTorchSuppressed,
                         capture_retry_settle_delay_ms: captureRetrySettleDelayMs,
                         capture_retry_remount_backoff_ms: captureRetryRemountBackoffMs,
+                        capture_retry_ready_timeout_ms: captureRetryReadyTimeoutMs,
                         is_native_camera_capture_error: isNativeCameraCaptureError(error),
                         last_native_capture_error: lastNativeCaptureErrorMessage,
                     }),

package/lib/components/cameraCaptureRetry.d.ts

@@ -0,0 +1,12 @@
+export declare const CAMERA_CAPTURE_RETRY_DELAY_MS = 350;
+export declare const CAMERA_CAPTURE_RETRY_TORCH_SETTLE_MS = 800;
+export declare const IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 3000;
+export declare const ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 10000;
+export type CameraCaptureRetryPlatform = 'ios' | 'android' | string;
+export interface CameraCaptureRetryPlan {
+    readyTimeoutMs: number;
+    remountBackoffMs: number;
+    settleDelayMs: number;
+    suppressTorch: boolean;
+}
+export declare function getCameraCaptureRetryPlan(platform: CameraCaptureRetryPlatform, torchRequested: boolean): CameraCaptureRetryPlan;

package/lib/components/cameraCaptureRetry.js

@@ -0,0 +1,23 @@
+export const CAMERA_CAPTURE_RETRY_DELAY_MS = 350;
+export const CAMERA_CAPTURE_RETRY_TORCH_SETTLE_MS = 800;
+export const IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 3000;
+export const ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 10000;
+export function getCameraCaptureRetryPlan(platform, torchRequested) {
+    const suppressTorch = torchRequested;
+    return {
+        readyTimeoutMs: platform === 'android'
+            ? ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS
+            : IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS,
+        // Flutter fully restarts its CameraController after native capture errors.
+        // On iOS/Expo Camera, a key-only remount can report ready too quickly while
+        // the native capture session is still unable to produce a photo, so force a
+        // brief unmount before the retry.
+        remountBackoffMs: platform === 'ios' || suppressTorch
+            ? CAMERA_CAPTURE_RETRY_DELAY_MS
+            : 0,
+        settleDelayMs: suppressTorch
+            ? CAMERA_CAPTURE_RETRY_TORCH_SETTLE_MS
+            : CAMERA_CAPTURE_RETRY_DELAY_MS,
+        suppressTorch,
+    };
+}

package/lib/types/index.d.ts

@@ -33,6 +33,8 @@ export interface VerificationResult {
     policy: string;
     violation_reasons: string[];
     feedback: string;
+    warning_violation_reasons?: string[];
+    warning_feedback?: string | null;
     metadata: Record<string, unknown>;
     image_url: string | null;
     /** Base64-encoded image data URI. Only present when `include_image_data` is requested. */

package/lib/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.5.2";
+export declare const SDK_VERSION = "2.5.4";

package/lib/version.js

@@ -1 +1 @@
-export const SDK_VERSION = '2.5.2';
+export const SDK_VERSION = '2.5.4';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@switchlabs/verify-ai-react-native",
-  "version": "2.5.2",
+  "version": "2.5.4",
   "description": "React Native SDK for Verify AI - photo verification with AI vision processing",
   "repository": {
     "type": "git",
@@ -25,6 +25,7 @@
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
     "build": "tsc",
     "prepublishOnly": "npm run build"
   },

package/src/components/VerifyAIScanner.tsx

@@ -32,6 +32,10 @@ import {
   getOverlayRotationDeg,
   type ScannerPhysicalOrientation,
 } from './scannerOrientation';
+import {
+  CAMERA_CAPTURE_RETRY_DELAY_MS,
+  getCameraCaptureRetryPlan,
+} from './cameraCaptureRetry';
 
 /** Quality used when expo-image-manipulator is not available (lower = smaller). */
 const FALLBACK_QUALITY = 0.65;
@@ -44,14 +48,18 @@ const CAMERA_NOT_READY_ERROR_CODE = 'ERR_CAMERA_NOT_READY';
 const CAMERA_INIT_ERROR_CODE = 'ERR_CAMERA_INIT_FAILED';
 const DEFAULT_TERMINAL_RESULT_DISPLAY_MS = 3000;
 const TRANSIENT_ERROR_DISPLAY_MS = 3000;
-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,
           });
         }
@@ -1158,6 +1172,7 @@ export function VerifyAIScanner({
     let captureRetryTorchSuppressed = false;
     let captureRetrySettleDelayMs = CAMERA_CAPTURE_RETRY_DELAY_MS;
     let captureRetryRemountBackoffMs = 0;
+    let captureRetryReadyTimeoutMs = 0;
     let lastNativeCaptureErrorMessage: string | null = null;
 
     try {
@@ -1237,13 +1252,11 @@ export function VerifyAIScanner({
 
             if (attempt === 1 && isNativeCameraCaptureError(normalized) && !terminated) {
               captureRetryAttempted = true;
-              captureRetryTorchSuppressed = !!enableTorch;
-              captureRetrySettleDelayMs = captureRetryTorchSuppressed
-                ? CAMERA_CAPTURE_RETRY_TORCH_SETTLE_MS
-                : CAMERA_CAPTURE_RETRY_DELAY_MS;
-              captureRetryRemountBackoffMs = captureRetryTorchSuppressed
-                ? CAMERA_CAPTURE_RETRY_DELAY_MS
-                : 0;
+              const retryPlan = getCameraCaptureRetryPlan(Platform.OS, !!enableTorch);
+              captureRetryTorchSuppressed = retryPlan.suppressTorch;
+              captureRetrySettleDelayMs = retryPlan.settleDelayMs;
+              captureRetryRemountBackoffMs = retryPlan.remountBackoffMs;
+              captureRetryReadyTimeoutMs = retryPlan.readyTimeoutMs;
               const retryAt = new Date().toISOString();
               lastCaptureRetryAtRef.current = retryAt;
               cameraRemountCountRef.current++;
@@ -1257,9 +1270,6 @@ export function VerifyAIScanner({
                   : undefined,
               );
               await sleep(captureRetrySettleDelayMs);
-              const captureRetryReadyTimeoutMs = Platform.OS === 'android'
-                ? ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS
-                : IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS;
               captureRetryReady = await waitForCameraReady(captureRetryReadyTimeoutMs);
               telemetry?.track('camera_capture_retry', {
                 component: 'scanner',
@@ -1383,6 +1393,7 @@ export function VerifyAIScanner({
           capture_retry_torch_suppressed: captureRetryTorchSuppressed,
           capture_retry_settle_delay_ms: captureRetrySettleDelayMs,
           capture_retry_remount_backoff_ms: captureRetryRemountBackoffMs,
+          capture_retry_ready_timeout_ms: captureRetryReadyTimeoutMs,
           recovered_native_capture_failure: captureRetryAttempted ? 1 : 0,
           last_native_capture_error: lastNativeCaptureErrorMessage,
         }),
@@ -1465,6 +1476,7 @@ export function VerifyAIScanner({
               capture_retry_torch_suppressed: captureRetryTorchSuppressed,
               capture_retry_settle_delay_ms: captureRetrySettleDelayMs,
               capture_retry_remount_backoff_ms: captureRetryRemountBackoffMs,
+              capture_retry_ready_timeout_ms: captureRetryReadyTimeoutMs,
               is_native_camera_capture_error: isNativeCameraCaptureError(error),
               last_native_capture_error: lastNativeCaptureErrorMessage,
             }),

package/src/components/cameraCaptureRetry.ts

@@ -0,0 +1,37 @@
+export const CAMERA_CAPTURE_RETRY_DELAY_MS = 350;
+export const CAMERA_CAPTURE_RETRY_TORCH_SETTLE_MS = 800;
+export const IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 3000;
+export const ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 10000;
+
+export type CameraCaptureRetryPlatform = 'ios' | 'android' | string;
+
+export interface CameraCaptureRetryPlan {
+  readyTimeoutMs: number;
+  remountBackoffMs: number;
+  settleDelayMs: number;
+  suppressTorch: boolean;
+}
+
+export function getCameraCaptureRetryPlan(
+  platform: CameraCaptureRetryPlatform,
+  torchRequested: boolean,
+): CameraCaptureRetryPlan {
+  const suppressTorch = torchRequested;
+
+  return {
+    readyTimeoutMs: platform === 'android'
+      ? ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS
+      : IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS,
+    // Flutter fully restarts its CameraController after native capture errors.
+    // On iOS/Expo Camera, a key-only remount can report ready too quickly while
+    // the native capture session is still unable to produce a photo, so force a
+    // brief unmount before the retry.
+    remountBackoffMs: platform === 'ios' || suppressTorch
+      ? CAMERA_CAPTURE_RETRY_DELAY_MS
+      : 0,
+    settleDelayMs: suppressTorch
+      ? CAMERA_CAPTURE_RETRY_TORCH_SETTLE_MS
+      : CAMERA_CAPTURE_RETRY_DELAY_MS,
+    suppressTorch,
+  };
+}

package/src/types/index.ts

@@ -37,6 +37,8 @@ export interface VerificationResult {
   policy: string;
   violation_reasons: string[];
   feedback: string;
+  warning_violation_reasons?: string[];
+  warning_feedback?: string | null;
   metadata: Record<string, unknown>;
   image_url: string | null;
   /** Base64-encoded image data URI. Only present when `include_image_data` is requested. */

package/src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = '2.5.2';
+export const SDK_VERSION = '2.5.4';