@switchlabs/verify-ai-react-native 2.4.0 → 2.4.2

package/lib/client/index.js

@@ -118,9 +118,12 @@ export class VerifyAIClient {
                                 : normalized.status >= 400 && normalized.status < 500
                                     ? 'request_error'
                                     : 'server_error';
+                const telemetryError = eventType === 'request_timeout'
+                    ? `${normalized.message} [${context.method} ${context.path}; timeout=${this.timeout}ms]`
+                    : normalized;
                 this.telemetry.track(eventType, {
                     component: 'client',
-                    error: normalized,
+                    error: telemetryError,
                     errorCode,
                 });
             }

package/lib/components/VerifyAIScanner.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useRef, useState, useCallback, useEffect } from 'react';
-import { View, Text, TouchableOpacity, StyleSheet, ActivityIndicator, } from 'react-native';
+import { View, Text, TouchableOpacity, StyleSheet, ActivityIndicator, AppState, useWindowDimensions, } from 'react-native';
 import { CameraView, useCameraPermissions, } from 'expo-camera';
 import { useTelemetry } from '../telemetry/TelemetryContext';
 /** Quality used when expo-image-manipulator is not available (lower = smaller). */
@@ -89,6 +89,45 @@ export function VerifyAIScanner({ onCapture, onResult, onError, overlay, style,
     const cameraReadyRef = useRef(false);
     const cameraInitFailedRef = useRef(false);
     const permissionDeniedTrackedRef = useRef(false);
+    // Track dimensions to detect orientation changes and remount camera
+    const { width: windowWidth, height: windowHeight } = useWindowDimensions();
+    const prevDimensionsRef = useRef({ width: windowWidth, height: windowHeight });
+    useEffect(() => {
+        const prev = prevDimensionsRef.current;
+        const orientationChanged = (prev.width > prev.height) !== (windowWidth > windowHeight);
+        prevDimensionsRef.current = { width: windowWidth, height: windowHeight };
+        if (orientationChanged && !terminated) {
+            // Force camera remount to fix preview distortion on iOS
+            telemetry?.track('camera_orientation_remount', {
+                component: 'scanner',
+                metadata: {
+                    from: prev.width > prev.height ? 'landscape' : 'portrait',
+                    to: windowWidth > windowHeight ? 'landscape' : 'portrait',
+                },
+            });
+            setCameraReady(false);
+            cameraReadyRef.current = false;
+            setCameraKey((k) => k + 1);
+        }
+    }, [windowWidth, windowHeight, terminated]);
+    // Resume camera when app returns from background/inactive (e.g. notification bar)
+    useEffect(() => {
+        if (terminated)
+            return;
+        const subscription = AppState.addEventListener('change', (nextState) => {
+            if (nextState === 'active') {
+                // Force camera remount — on iOS, AVCaptureSession often fails to resume
+                // its preview layer after returning from the notification bar or control center.
+                telemetry?.track('camera_appstate_remount', {
+                    component: 'scanner',
+                });
+                setCameraReady(false);
+                cameraReadyRef.current = false;
+                setCameraKey((k) => k + 1);
+            }
+        });
+        return () => subscription.remove();
+    }, [terminated]);
     const pausePreview = useCallback(() => {
         cameraRef.current?.pausePreview?.().catch(() => { });
     }, []);

package/lib/telemetry/TelemetryReporter.d.ts

@@ -24,17 +24,18 @@ export declare class TelemetryReporter {
     private flushNow;
     private clearFlushTimer;
     /**
-     * Persist the current buffer to AsyncStorage so events survive app crashes.
+     * Persist the current buffer to AsyncStorage so events survive abrupt app exits.
      * Fire-and-forget — never throws or blocks.
      *
      * IMPORTANT: skips persist if loadPersistedBuffer() hasn't completed yet,
-     * to avoid overwriting orphaned events from a crashed previous session.
+     * to avoid overwriting orphaned events from a previous session before recovery.
      */
     private persistBuffer;
     /**
-     * Load crash-persisted events from a previous session and merge into current buffer.
-     * Runs once per instance. If orphaned events are found, emits an `sdk_crash` event
-     * so the monitor can detect and investigate app crashes.
+     * Load persisted events from a previous session and merge into current buffer.
+     * Runs once per instance. If orphaned events are found, emits an
+     * `sdk_session_recovered` event so monitoring can flag that the prior
+     * session ended without a clean telemetry flush.
      */
     private loadPersistedBuffer;
 }

package/lib/telemetry/TelemetryReporter.js

@@ -26,7 +26,7 @@ export class TelemetryReporter {
         this.apiKey = apiKey;
         this.baseUrl = baseUrl.replace(/\/$/, '');
         this.sessionId = Math.random().toString(36).slice(2) + Date.now().toString(36);
-        // Load any crash-persisted events from the previous session
+        // Load any persisted events left behind by a previous session
         this.loadPersistedBuffer();
     }
     /** Track an error event. Fire-and-forget — never throws. */
@@ -72,7 +72,7 @@ export class TelemetryReporter {
             else {
                 this.scheduleFlush();
             }
-            // Persist immediately once crash recovery has completed. If startup
+            // Persist immediately once prior-session recovery has completed. If startup
             // recovery is still in flight, write the merged buffer back afterwards.
             if (this.loadedPersisted) {
                 this.persistBuffer();
@@ -91,7 +91,7 @@ export class TelemetryReporter {
     }
     /** Flush all buffered events immediately. Returns a promise but never rejects. */
     async flush() {
-        // Merge any crash-persisted events from previous session before flushing
+        // Merge any persisted events from a previous session before flushing
         await this.loadPersistedBuffer();
         if (this.buffer.size === 0 || this.flushing)
             return;
@@ -168,15 +168,15 @@ export class TelemetryReporter {
         }
     }
     /**
-     * Persist the current buffer to AsyncStorage so events survive app crashes.
+     * Persist the current buffer to AsyncStorage so events survive abrupt app exits.
      * Fire-and-forget — never throws or blocks.
      *
      * IMPORTANT: skips persist if loadPersistedBuffer() hasn't completed yet,
-     * to avoid overwriting orphaned events from a crashed previous session.
+     * to avoid overwriting orphaned events from a previous session before recovery.
      */
     persistBuffer() {
         if (!this.loadedPersisted)
-            return; // Don't overwrite orphaned crash data before it's loaded
+            return; // Don't overwrite orphaned prior-session data before it's loaded
         try {
             const entries = {};
             for (const [key, event] of this.buffer) {
@@ -196,9 +196,10 @@ export class TelemetryReporter {
         }
     }
     /**
-     * Load crash-persisted events from a previous session and merge into current buffer.
-     * Runs once per instance. If orphaned events are found, emits an `sdk_crash` event
-     * so the monitor can detect and investigate app crashes.
+     * Load persisted events from a previous session and merge into current buffer.
+     * Runs once per instance. If orphaned events are found, emits an
+     * `sdk_session_recovered` event so monitoring can flag that the prior
+     * session ended without a clean telemetry flush.
      */
     async loadPersistedBuffer() {
         if (this.loadedPersisted)
@@ -236,14 +237,14 @@ export class TelemetryReporter {
                         this.buffer.set(key, event);
                     }
                 }
-                // Emit sdk_crash event if we recovered orphaned events from a dead session
+                // Emit sdk_session_recovered if we recovered orphaned events from a previous session
                 if (orphanedCount > 0) {
                     const now = new Date().toISOString();
                     const uniqueTypes = [...new Set(orphanedTypes)];
                     const crashEvent = {
-                        event_type: 'sdk_crash',
+                        event_type: 'sdk_session_recovered',
                         component: 'TelemetryReporter',
-                        error_message: `Recovered ${orphanedCount} unflushed event(s) from crashed/killed session: ${uniqueTypes.join(', ')}`,
+                        error_message: `Recovered ${orphanedCount} unflushed event(s) from a previous session that ended without a clean telemetry flush: ${uniqueTypes.join(', ')}`,
                         sdk_platform: Platform.OS,
                         sdk_version: SDK_VERSION,
                         os_name: Platform.OS,
@@ -253,7 +254,7 @@ export class TelemetryReporter {
                         first_occurred_at: now,
                         last_occurred_at: now,
                     };
-                    this.buffer.set(`sdk_crash|recovered|${this.sessionId}`, crashEvent);
+                    this.buffer.set(`sdk_session_recovered|recovered|${this.sessionId}`, crashEvent);
                 }
                 // Clear persisted data now that it's loaded into memory. The merged
                 // buffer will be re-persisted below until a flush succeeds.

package/lib/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.4.0";
+export declare const SDK_VERSION = "2.4.2";

package/lib/version.js

@@ -1 +1 @@
-export const SDK_VERSION = '2.4.0';
+export const SDK_VERSION = '2.4.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@switchlabs/verify-ai-react-native",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "React Native SDK for Verify AI - photo verification with AI vision processing",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",

package/src/client/index.ts

@@ -173,13 +173,16 @@ export class VerifyAIClient {
                 : normalized.status === 429
                   ? 'rate_limited'
                   : normalized.status >= 400 && normalized.status < 500
-                    ? 'request_error'
+                  ? 'request_error'
                     : 'server_error';
+        const telemetryError = eventType === 'request_timeout'
+          ? `${normalized.message} [${context.method} ${context.path}; timeout=${this.timeout}ms]`
+          : normalized;
         this.telemetry.track(
           eventType,
           {
             component: 'client',
-            error: normalized,
+            error: telemetryError,
             errorCode,
           },
         );

package/src/components/VerifyAIScanner.tsx

@@ -5,6 +5,8 @@ import {
   TouchableOpacity,
   StyleSheet,
   ActivityIndicator,
+  AppState,
+  useWindowDimensions,
   type ViewStyle,
 } from 'react-native';
 import {
@@ -152,6 +154,51 @@ export function VerifyAIScanner({
   const cameraInitFailedRef = useRef(false);
   const permissionDeniedTrackedRef = useRef(false);
 
+  // Track dimensions to detect orientation changes and remount camera
+  const { width: windowWidth, height: windowHeight } = useWindowDimensions();
+  const prevDimensionsRef = useRef({ width: windowWidth, height: windowHeight });
+
+  useEffect(() => {
+    const prev = prevDimensionsRef.current;
+    const orientationChanged =
+      (prev.width > prev.height) !== (windowWidth > windowHeight);
+    prevDimensionsRef.current = { width: windowWidth, height: windowHeight };
+
+    if (orientationChanged && !terminated) {
+      // Force camera remount to fix preview distortion on iOS
+      telemetry?.track('camera_orientation_remount', {
+        component: 'scanner',
+        metadata: {
+          from: prev.width > prev.height ? 'landscape' : 'portrait',
+          to: windowWidth > windowHeight ? 'landscape' : 'portrait',
+        },
+      });
+      setCameraReady(false);
+      cameraReadyRef.current = false;
+      setCameraKey((k) => k + 1);
+    }
+  }, [windowWidth, windowHeight, terminated]);
+
+  // Resume camera when app returns from background/inactive (e.g. notification bar)
+  useEffect(() => {
+    if (terminated) return;
+
+    const subscription = AppState.addEventListener('change', (nextState) => {
+      if (nextState === 'active') {
+        // Force camera remount — on iOS, AVCaptureSession often fails to resume
+        // its preview layer after returning from the notification bar or control center.
+        telemetry?.track('camera_appstate_remount', {
+          component: 'scanner',
+        });
+        setCameraReady(false);
+        cameraReadyRef.current = false;
+        setCameraKey((k) => k + 1);
+      }
+    });
+
+    return () => subscription.remove();
+  }, [terminated]);
+
   const pausePreview = useCallback(() => {
     cameraRef.current?.pausePreview?.().catch(() => {});
   }, []);

package/src/telemetry/TelemetryReporter.ts

@@ -56,7 +56,7 @@ export class TelemetryReporter {
     this.apiKey = apiKey;
     this.baseUrl = baseUrl.replace(/\/$/, '');
     this.sessionId = Math.random().toString(36).slice(2) + Date.now().toString(36);
-    // Load any crash-persisted events from the previous session
+    // Load any persisted events left behind by a previous session
     this.loadPersistedBuffer();
   }
 
@@ -116,7 +116,7 @@ export class TelemetryReporter {
         this.scheduleFlush();
       }
 
-      // Persist immediately once crash recovery has completed. If startup
+      // Persist immediately once prior-session recovery has completed. If startup
       // recovery is still in flight, write the merged buffer back afterwards.
       if (this.loadedPersisted) {
         this.persistBuffer();
@@ -134,7 +134,7 @@ export class TelemetryReporter {
 
   /** Flush all buffered events immediately. Returns a promise but never rejects. */
   async flush(): Promise<void> {
-    // Merge any crash-persisted events from previous session before flushing
+    // Merge any persisted events from a previous session before flushing
     await this.loadPersistedBuffer();
 
     if (this.buffer.size === 0 || this.flushing) return;
@@ -216,14 +216,14 @@ export class TelemetryReporter {
   }
 
   /**
-   * Persist the current buffer to AsyncStorage so events survive app crashes.
+   * Persist the current buffer to AsyncStorage so events survive abrupt app exits.
    * Fire-and-forget — never throws or blocks.
    *
    * IMPORTANT: skips persist if loadPersistedBuffer() hasn't completed yet,
-   * to avoid overwriting orphaned events from a crashed previous session.
+   * to avoid overwriting orphaned events from a previous session before recovery.
    */
   private persistBuffer(): void {
-    if (!this.loadedPersisted) return; // Don't overwrite orphaned crash data before it's loaded
+    if (!this.loadedPersisted) return; // Don't overwrite orphaned prior-session data before it's loaded
     try {
       const entries: Record<string, TelemetryEvent> = {};
       for (const [key, event] of this.buffer) {
@@ -242,9 +242,10 @@ export class TelemetryReporter {
   }
 
   /**
-   * Load crash-persisted events from a previous session and merge into current buffer.
-   * Runs once per instance. If orphaned events are found, emits an `sdk_crash` event
-   * so the monitor can detect and investigate app crashes.
+   * Load persisted events from a previous session and merge into current buffer.
+   * Runs once per instance. If orphaned events are found, emits an
+   * `sdk_session_recovered` event so monitoring can flag that the prior
+   * session ended without a clean telemetry flush.
    */
   private async loadPersistedBuffer(): Promise<void> {
     if (this.loadedPersisted) return;
@@ -282,14 +283,14 @@ export class TelemetryReporter {
           }
         }
 
-        // Emit sdk_crash event if we recovered orphaned events from a dead session
+        // Emit sdk_session_recovered if we recovered orphaned events from a previous session
         if (orphanedCount > 0) {
           const now = new Date().toISOString();
           const uniqueTypes = [...new Set(orphanedTypes)];
           const crashEvent: TelemetryEvent = {
-            event_type: 'sdk_crash',
+            event_type: 'sdk_session_recovered',
             component: 'TelemetryReporter',
-            error_message: `Recovered ${orphanedCount} unflushed event(s) from crashed/killed session: ${uniqueTypes.join(', ')}`,
+            error_message: `Recovered ${orphanedCount} unflushed event(s) from a previous session that ended without a clean telemetry flush: ${uniqueTypes.join(', ')}`,
             sdk_platform: Platform.OS,
             sdk_version: SDK_VERSION,
             os_name: Platform.OS,
@@ -299,7 +300,7 @@ export class TelemetryReporter {
             first_occurred_at: now,
             last_occurred_at: now,
           };
-          this.buffer.set(`sdk_crash|recovered|${this.sessionId}`, crashEvent);
+          this.buffer.set(`sdk_session_recovered|recovered|${this.sessionId}`, crashEvent);
         }
 
         // Clear persisted data now that it's loaded into memory. The merged

package/src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = '2.4.0';
+export const SDK_VERSION = '2.4.2';