@switchlabs/verify-ai-react-native 2.4.21 → 2.4.23

package/lib/client/index.d.ts

@@ -93,7 +93,7 @@ export declare class VerifyAIClient {
 export declare class VerifyAIRequestError extends Error {
     status: number;
     body: VerifyAIError;
-    constructor(message: string, status: number, body: VerifyAIError);
+    constructor(message: unknown, status: number, body: VerifyAIError);
     get isRateLimited(): boolean;
     get isUnauthorized(): boolean;
     get isServerError(): boolean;

package/lib/client/index.js

@@ -19,6 +19,39 @@ function enrichMetadata(metadata) {
     }
     return enriched;
 }
+function stringifyErrorMessage(value, fallback) {
+    if (typeof value === 'string' && value.trim()) {
+        return value;
+    }
+    if (value instanceof Error && value.message) {
+        return value.message;
+    }
+    if (value && typeof value === 'object') {
+        const record = value;
+        for (const key of ['message', 'error', 'detail', 'code']) {
+            const candidate = record[key];
+            if (typeof candidate === 'string' && candidate.trim()) {
+                return candidate;
+            }
+        }
+        try {
+            const json = JSON.stringify(value);
+            if (json && json !== '{}') {
+                return json;
+            }
+        }
+        catch {
+            // Fall through to String(value) below.
+        }
+    }
+    if (value != null) {
+        const text = String(value);
+        if (text && text !== '[object Object]') {
+            return text;
+        }
+    }
+    return fallback;
+}
 export class VerifyAIClient {
     constructor(config) {
         if (!config.apiKey) {
@@ -43,8 +76,9 @@ export class VerifyAIClient {
         }
     }
     buildRequestError(message, status, context, body = {}) {
+        const safeMessage = stringifyErrorMessage(message, 'VerifyAI request failed');
         const error = {
-            error: message,
+            error: safeMessage,
             status,
             code: status === 408 ? 'timeout' : status === 0 ? 'network_error' : 'request_error',
             path: context.path,
@@ -52,7 +86,7 @@ export class VerifyAIClient {
             method: context.method,
             ...body,
         };
-        return new VerifyAIRequestError(message, status, error);
+        return new VerifyAIRequestError(safeMessage, status, error);
     }
     normalizeRequestError(error, context) {
         if (error instanceof VerifyAIRequestError) {
@@ -64,7 +98,7 @@ export class VerifyAIClient {
         if (error instanceof TypeError) {
             return this.buildRequestError('Network request failed', 0, context, { code: 'network_error' });
         }
-        const message = error instanceof Error ? error.message : 'VerifyAI request failed';
+        const message = error instanceof Error ? error.message : stringifyErrorMessage(error, 'VerifyAI request failed');
         return this.buildRequestError(message, 0, context);
     }
     async executeRequest(path, options = {}) {
@@ -86,7 +120,7 @@ export class VerifyAIClient {
             const body = this.parseResponseBody(rawBody);
             if (!response.ok) {
                 const errorBody = (body && typeof body === 'object' ? body : null);
-                throw this.buildRequestError(errorBody?.error || `Request failed with status ${response.status}`, response.status, context, {
+                throw this.buildRequestError(stringifyErrorMessage(errorBody?.error, `Request failed with status ${response.status}`), response.status, context, {
                     current_usage: errorBody?.current_usage,
                     limit: errorBody?.limit,
                     upgrade_url: errorBody?.upgrade_url,
@@ -220,9 +254,11 @@ export class VerifyAIClient {
             });
         }
         catch (error) {
-            // Blank 500 means the server crashed during multipart parsing (e.g.
-            // Vercel function crash). Retry as JSON/base64 with a fresh request
-            // — the crashed request may have partially recorded the idempotency key.
+            // 5xx during multipart can mean the server crashed before reservation
+            // (e.g. Vercel multipart-parse failure) OR after the verification was
+            // saved (e.g. signed-URL generation throw). Retry as base64 JSON and
+            // forward the original Idempotency-Key so the server can dedupe instead
+            // of inserting a second verify_ai_verifications row.
             if (error instanceof VerifyAIRequestError && error.status >= 500 && error.isServerError) {
                 try {
                     const { Buffer } = await import('buffer');
@@ -235,7 +271,7 @@ export class VerifyAIClient {
                         metadata: request.metadata,
                         provider: request.provider,
                         include_image_data: request.include_image_data,
-                    });
+                    }, options?.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : undefined);
                 }
                 catch {
                     // If the retry itself fails, throw the original error
@@ -316,10 +352,14 @@ export class VerifyAIClient {
 }
 export class VerifyAIRequestError extends Error {
     constructor(message, status, body) {
-        super(message);
+        const safeMessage = stringifyErrorMessage(message, 'VerifyAI request failed');
+        super(safeMessage);
         this.name = 'VerifyAIRequestError';
         this.status = status;
-        this.body = body;
+        this.body = {
+            ...body,
+            error: stringifyErrorMessage(body.error, safeMessage),
+        };
     }
     get isRateLimited() {
         return this.status === 429;

package/lib/components/VerifyAIScanner.js

@@ -4,6 +4,7 @@ import { View, Text, TouchableOpacity, StyleSheet, ActivityIndicator, AppState,
 import { CameraView, useCameraPermissions, } from 'expo-camera';
 import { VerifyAIRequestError } from '../client';
 import { useTelemetry } from '../telemetry/TelemetryContext';
+import { SDK_VERSION } from '../version';
 import { BikeOverlay } from './BikeOverlay';
 import { ScooterOverlay } from './ScooterOverlay';
 import { ANDROID_ACCELEROMETER_AXIS_DOMINANCE_THRESHOLD, classifyAndroidAccelerometerOrientation, getOverlayRotationDeg, } from './scannerOrientation';
@@ -326,11 +327,23 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
     telemetryRef.current = telemetry;
     buildScannerTelemetryMetadataRef.current = buildScannerTelemetryMetadata;
     useEffect(() => {
-        telemetryRef.current?.track('camera_scanner_mounted', {
+        const reporter = telemetryRef.current;
+        if (reporter) {
+            console.log(`VerifyAI[${SDK_VERSION}]: scanner telemetry attached ` +
+                `baseUrl=${reporter.getBaseUrl()} apiKeyPrefix=${reporter.getApiKeyPrefix()}…`);
+        }
+        else {
+            console.warn(`VerifyAI[${SDK_VERSION}]: scanner telemetry is not attached; field ` +
+                'diagnostics will only appear in local device logs. Pass a ' +
+                '`TelemetryReporter` into `<VerifyAIScanner telemetry={…} />` or ' +
+                'wrap the tree in `<TelemetryContext.Provider value={reporter}>` ' +
+                'to enable server-side diagnostics.');
+        }
+        reporter?.track('camera_scanner_mounted', {
             component: 'scanner',
             error: 'scanner_mounted',
             metadata: buildScannerTelemetryMetadataRef.current?.({
-                scanner_telemetry_attached: telemetryRef.current ? 1 : 0,
+                scanner_telemetry_attached: reporter ? 1 : 0,
             }),
         });
         return () => {

package/lib/telemetry/TelemetryReporter.d.ts

@@ -9,6 +9,12 @@ export declare class TelemetryReporter {
     private loadedPersisted;
     private loadPersistedPromise;
     constructor(apiKey: string, baseUrl: string);
+    /** Telemetry POST destination — exposed so the scanner can log an init banner
+     * that helps field debugging confirm where events are being sent. */
+    getBaseUrl(): string;
+    /** First 6 characters of the API key, for log banners. Never returns the full key. */
+    getApiKeyPrefix(): string;
+    private logDeliveryFailure;
     /** Track an error event. Fire-and-forget — never throws. */
     track(eventType: string, opts?: {
         component?: string;

package/lib/telemetry/TelemetryReporter.js

@@ -40,6 +40,20 @@ export class TelemetryReporter {
         // Load any persisted events left behind by a previous session
         this.loadPersistedBuffer();
     }
+    /** Telemetry POST destination — exposed so the scanner can log an init banner
+     * that helps field debugging confirm where events are being sent. */
+    getBaseUrl() {
+        return this.baseUrl;
+    }
+    /** First 6 characters of the API key, for log banners. Never returns the full key. */
+    getApiKeyPrefix() {
+        return this.apiKey.length >= 6 ? this.apiKey.slice(0, 6) : this.apiKey;
+    }
+    logDeliveryFailure(kind, detail, eventCount) {
+        const trimmed = detail.length > 200 ? detail.slice(0, 200) : detail;
+        console.warn(`VerifyAI[${SDK_VERSION}]: telemetry POST failed kind=${kind} ` +
+            `events=${eventCount} url=${this.baseUrl}/telemetry detail=${trimmed}`);
+    }
     /** Track an error event. Fire-and-forget — never throws. */
     track(eventType, opts = {}) {
         if (this.disposed)
@@ -113,6 +127,7 @@ export class TelemetryReporter {
         this.clearFlushTimer();
         const controller = new AbortController();
         const timeout = setTimeout(() => controller.abort(), 10000);
+        let loggedDeliveryFailure = false;
         try {
             const response = await fetch(`${this.baseUrl}/telemetry`, {
                 method: 'POST',
@@ -124,12 +139,26 @@ export class TelemetryReporter {
                 signal: controller.signal,
             });
             if (!response.ok) {
+                let body = '';
+                try {
+                    body = await response.text();
+                }
+                catch {
+                    // ignore
+                }
+                this.logDeliveryFailure(`http_${response.status}`, body, events.length);
+                loggedDeliveryFailure = true;
                 throw new Error(`Telemetry request failed with status ${response.status}`);
             }
             // Success — clear persisted buffer since events are now server-side
             this.persistBuffer(); // buffer is empty at this point, so this clears the key
         }
-        catch {
+        catch (error) {
+            if (!loggedDeliveryFailure) {
+                const kind = error instanceof Error ? error.name : typeof error;
+                const detail = error instanceof Error ? error.message : String(error);
+                this.logDeliveryFailure(kind, detail, events.length);
+            }
             for (const [dedupKey, event] of bufferedEntries) {
                 const existing = this.buffer.get(dedupKey);
                 if (existing) {

package/lib/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.4.21";
+export declare const SDK_VERSION = "2.4.23";

package/lib/version.js

@@ -1 +1 @@
-export const SDK_VERSION = '2.4.21';
+export const SDK_VERSION = '2.4.23';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@switchlabs/verify-ai-react-native",
-  "version": "2.4.21",
+  "version": "2.4.23",
   "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

@@ -34,6 +34,44 @@ function enrichMetadata(metadata?: Record<string, unknown>): Record<string, unkn
   return enriched;
 }
 
+function stringifyErrorMessage(value: unknown, fallback: string): string {
+  if (typeof value === 'string' && value.trim()) {
+    return value;
+  }
+
+  if (value instanceof Error && value.message) {
+    return value.message;
+  }
+
+  if (value && typeof value === 'object') {
+    const record = value as Record<string, unknown>;
+    for (const key of ['message', 'error', 'detail', 'code']) {
+      const candidate = record[key];
+      if (typeof candidate === 'string' && candidate.trim()) {
+        return candidate;
+      }
+    }
+
+    try {
+      const json = JSON.stringify(value);
+      if (json && json !== '{}') {
+        return json;
+      }
+    } catch {
+      // Fall through to String(value) below.
+    }
+  }
+
+  if (value != null) {
+    const text = String(value);
+    if (text && text !== '[object Object]') {
+      return text;
+    }
+  }
+
+  return fallback;
+}
+
 interface RequestContext {
   path: string;
   url: string;
@@ -71,13 +109,14 @@ export class VerifyAIClient {
   }
 
   private buildRequestError(
-    message: string,
+    message: unknown,
     status: number,
     context: RequestContext,
     body: Partial<VerifyAIError> = {}
   ): VerifyAIRequestError {
+    const safeMessage = stringifyErrorMessage(message, 'VerifyAI request failed');
     const error: VerifyAIError = {
-      error: message,
+      error: safeMessage,
       status,
       code: status === 408 ? 'timeout' : status === 0 ? 'network_error' : 'request_error',
       path: context.path,
@@ -86,7 +125,7 @@ export class VerifyAIClient {
       ...body,
     };
 
-    return new VerifyAIRequestError(message, status, error);
+    return new VerifyAIRequestError(safeMessage, status, error);
   }
 
   private normalizeRequestError(error: unknown, context: RequestContext): VerifyAIRequestError {
@@ -102,7 +141,7 @@ export class VerifyAIClient {
       return this.buildRequestError('Network request failed', 0, context, { code: 'network_error' });
     }
 
-    const message = error instanceof Error ? error.message : 'VerifyAI request failed';
+    const message = error instanceof Error ? error.message : stringifyErrorMessage(error, 'VerifyAI request failed');
     return this.buildRequestError(message, 0, context);
   }
 
@@ -132,7 +171,7 @@ export class VerifyAIClient {
       if (!response.ok) {
         const errorBody = (body && typeof body === 'object' ? body : null) as VerifyAIError | null;
         throw this.buildRequestError(
-          errorBody?.error || `Request failed with status ${response.status}`,
+          stringifyErrorMessage(errorBody?.error, `Request failed with status ${response.status}`),
           response.status,
           context,
           {
@@ -284,22 +323,27 @@ export class VerifyAIClient {
         body: formData,
       });
     } catch (error) {
-      // Blank 500 means the server crashed during multipart parsing (e.g.
-      // Vercel function crash). Retry as JSON/base64 with a fresh request
-      // — the crashed request may have partially recorded the idempotency key.
+      // 5xx during multipart can mean the server crashed before reservation
+      // (e.g. Vercel multipart-parse failure) OR after the verification was
+      // saved (e.g. signed-URL generation throw). Retry as base64 JSON and
+      // forward the original Idempotency-Key so the server can dedupe instead
+      // of inserting a second verify_ai_verifications row.
       if (error instanceof VerifyAIRequestError && error.status >= 500 && error.isServerError) {
         try {
           const { Buffer } = await import('buffer');
           const fileResponse = await fetch(request.imageUri);
           const arrayBuffer = await fileResponse.arrayBuffer();
           const base64 = Buffer.from(arrayBuffer).toString('base64');
-          return this.verify({
-            image: base64,
-            policy: request.policy,
-            metadata: request.metadata,
-            provider: request.provider,
-            include_image_data: request.include_image_data,
-          });
+          return this.verify(
+            {
+              image: base64,
+              policy: request.policy,
+              metadata: request.metadata,
+              provider: request.provider,
+              include_image_data: request.include_image_data,
+            },
+            options?.idempotencyKey ? { idempotencyKey: options.idempotencyKey } : undefined,
+          );
         } catch {
           // If the retry itself fails, throw the original error
           throw error;
@@ -384,11 +428,15 @@ export class VerifyAIRequestError extends Error {
   status: number;
   body: VerifyAIError;
 
-  constructor(message: string, status: number, body: VerifyAIError) {
-    super(message);
+  constructor(message: unknown, status: number, body: VerifyAIError) {
+    const safeMessage = stringifyErrorMessage(message, 'VerifyAI request failed');
+    super(safeMessage);
     this.name = 'VerifyAIRequestError';
     this.status = status;
-    this.body = body;
+    this.body = {
+      ...body,
+      error: stringifyErrorMessage(body.error, safeMessage),
+    };
   }
 
   get isRateLimited(): boolean {

package/src/components/VerifyAIScanner.tsx

@@ -23,6 +23,7 @@ import type {
 import { VerifyAIRequestError } from '../client';
 import { useTelemetry } from '../telemetry/TelemetryContext';
 import type { TelemetryReporter } from '../telemetry/TelemetryReporter';
+import { SDK_VERSION } from '../version';
 import { BikeOverlay } from './BikeOverlay';
 import { ScooterOverlay } from './ScooterOverlay';
 import {
@@ -439,11 +440,26 @@ export function VerifyAIScanner({
   buildScannerTelemetryMetadataRef.current = buildScannerTelemetryMetadata;
 
   useEffect(() => {
-    telemetryRef.current?.track('camera_scanner_mounted', {
+    const reporter = telemetryRef.current;
+    if (reporter) {
+      console.log(
+        `VerifyAI[${SDK_VERSION}]: scanner telemetry attached ` +
+          `baseUrl=${reporter.getBaseUrl()} apiKeyPrefix=${reporter.getApiKeyPrefix()}…`,
+      );
+    } else {
+      console.warn(
+        `VerifyAI[${SDK_VERSION}]: scanner telemetry is not attached; field ` +
+          'diagnostics will only appear in local device logs. Pass a ' +
+          '`TelemetryReporter` into `<VerifyAIScanner telemetry={…} />` or ' +
+          'wrap the tree in `<TelemetryContext.Provider value={reporter}>` ' +
+          'to enable server-side diagnostics.',
+      );
+    }
+    reporter?.track('camera_scanner_mounted', {
       component: 'scanner',
       error: 'scanner_mounted',
       metadata: buildScannerTelemetryMetadataRef.current?.({
-        scanner_telemetry_attached: telemetryRef.current ? 1 : 0,
+        scanner_telemetry_attached: reporter ? 1 : 0,
       }),
     });
 

package/src/telemetry/TelemetryReporter.ts

@@ -71,6 +71,25 @@ export class TelemetryReporter {
     this.loadPersistedBuffer();
   }
 
+  /** Telemetry POST destination — exposed so the scanner can log an init banner
+   * that helps field debugging confirm where events are being sent. */
+  getBaseUrl(): string {
+    return this.baseUrl;
+  }
+
+  /** First 6 characters of the API key, for log banners. Never returns the full key. */
+  getApiKeyPrefix(): string {
+    return this.apiKey.length >= 6 ? this.apiKey.slice(0, 6) : this.apiKey;
+  }
+
+  private logDeliveryFailure(kind: string, detail: string, eventCount: number): void {
+    const trimmed = detail.length > 200 ? detail.slice(0, 200) : detail;
+    console.warn(
+      `VerifyAI[${SDK_VERSION}]: telemetry POST failed kind=${kind} ` +
+        `events=${eventCount} url=${this.baseUrl}/telemetry detail=${trimmed}`,
+    );
+  }
+
   /** Track an error event. Fire-and-forget — never throws. */
   track(
     eventType: string,
@@ -158,6 +177,7 @@ export class TelemetryReporter {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 10000);
 
+    let loggedDeliveryFailure = false;
     try {
       const response = await fetch(`${this.baseUrl}/telemetry`, {
         method: 'POST',
@@ -170,12 +190,25 @@ export class TelemetryReporter {
       });
 
       if (!response.ok) {
+        let body = '';
+        try {
+          body = await response.text();
+        } catch {
+          // ignore
+        }
+        this.logDeliveryFailure(`http_${response.status}`, body, events.length);
+        loggedDeliveryFailure = true;
         throw new Error(`Telemetry request failed with status ${response.status}`);
       }
 
       // Success — clear persisted buffer since events are now server-side
       this.persistBuffer(); // buffer is empty at this point, so this clears the key
-    } catch {
+    } catch (error) {
+      if (!loggedDeliveryFailure) {
+        const kind = error instanceof Error ? error.name : typeof error;
+        const detail = error instanceof Error ? error.message : String(error);
+        this.logDeliveryFailure(kind, detail, events.length);
+      }
       for (const [dedupKey, event] of bufferedEntries) {
         const existing = this.buffer.get(dedupKey);
         if (existing) {

package/src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = '2.4.21';
+export const SDK_VERSION = '2.4.23';