@switchlabs/verify-ai-react-native 2.4.20 → 2.4.22

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,10 +19,43 @@ 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) {
-            throw new Error('VerifyAI: apiKey is required');
+            throw new Error(`VerifyAI[v${SDK_VERSION}]: apiKey is required`);
         }
         this.apiKey = config.apiKey;
         this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, '');
@@ -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,
@@ -95,7 +129,7 @@ export class VerifyAIClient {
                 });
             }
             if (!body || typeof body !== 'object') {
-                throw this.buildRequestError('VerifyAI: Invalid response payload', 0, context, {
+                throw this.buildRequestError(`VerifyAI[v${SDK_VERSION}]: Invalid response payload`, 0, context, {
                     code: 'invalid_response',
                     request_id: response.headers.get('X-Request-Id') || undefined,
                 });
@@ -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/hooks/useVerifyAI.js

@@ -3,6 +3,7 @@ import { AppState, Platform } from 'react-native';
 import { VerifyAIClient, VerifyAIRequestError } from '../client';
 import { OfflineQueue } from '../storage/offlineQueue';
 import { TelemetryContext } from '../telemetry/TelemetryContext';
+import { SDK_VERSION } from '../version';
 function isQueueableError(error) {
     if (error instanceof VerifyAIRequestError) {
         return error.isRetryable;
@@ -86,7 +87,7 @@ export function useVerifyAI(config) {
                 inferenceEngineRef.current = new InferenceEngine();
             }
             catch (err) {
-                console.warn('[VerifyAI] Failed to load ML modules:', err);
+                console.warn(`[VerifyAI v${SDK_VERSION}] Failed to load ML modules:`, err);
             }
         })();
         return () => {

package/lib/ml/modelManager.js

@@ -4,6 +4,7 @@
  */
 import { Buffer } from 'buffer';
 import { sha256 } from '@noble/hashes/sha2.js';
+import { SDK_VERSION } from '../version';
 async function loadFileSystem() {
     try {
         return await import('expo-file-system');
@@ -68,7 +69,7 @@ export class ModelManager {
     async downloadArtifacts(manifest, policyId) {
         const fileSystem = await loadFileSystem();
         if (!fileSystem || !fileSystem.documentDirectory) {
-            console.warn('[VerifyAI] expo-file-system not available, skipping download');
+            console.warn(`[VerifyAI v${SDK_VERSION}] expo-file-system not available, skipping download`);
             return;
         }
         const cacheDir = `${fileSystem.documentDirectory}verify-ai/bundles/${policyId}/`;

package/lib/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.4.20";
+export declare const SDK_VERSION = "2.4.22";

package/lib/version.js

@@ -1 +1 @@
-export const SDK_VERSION = '2.4.20';
+export const SDK_VERSION = '2.4.22';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@switchlabs/verify-ai-react-native",
-  "version": "2.4.20",
+  "version": "2.4.22",
   "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;
@@ -48,7 +86,7 @@ export class VerifyAIClient {
 
   constructor(config: VerifyAIConfig) {
     if (!config.apiKey) {
-      throw new Error('VerifyAI: apiKey is required');
+      throw new Error(`VerifyAI[v${SDK_VERSION}]: apiKey is required`);
     }
     this.apiKey = config.apiKey;
     this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, '');
@@ -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,
           {
@@ -147,7 +186,7 @@ export class VerifyAIClient {
 
       if (!body || typeof body !== 'object') {
         throw this.buildRequestError(
-          'VerifyAI: Invalid response payload',
+          `VerifyAI[v${SDK_VERSION}]: Invalid response payload`,
           0,
           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/hooks/useVerifyAI.ts

@@ -4,6 +4,7 @@ import { VerifyAIClient, VerifyAIRequestError } from '../client';
 import { OfflineQueue } from '../storage/offlineQueue';
 import { TelemetryContext } from '../telemetry/TelemetryContext';
 import type { TelemetryReporter } from '../telemetry/TelemetryReporter';
+import { SDK_VERSION } from '../version';
 import type {
   VerifyAIConfig,
   VerificationRequest,
@@ -161,7 +162,7 @@ export function useVerifyAI(config: UseVerifyAIConfig): UseVerifyAIReturn {
         });
         inferenceEngineRef.current = new InferenceEngine();
       } catch (err) {
-        console.warn('[VerifyAI] Failed to load ML modules:', err);
+        console.warn(`[VerifyAI v${SDK_VERSION}] Failed to load ML modules:`, err);
       }
     })();
 

package/src/ml/modelManager.ts

@@ -6,6 +6,7 @@
 import { Buffer } from 'buffer';
 import { sha256 } from '@noble/hashes/sha2.js';
 import type { BundleManifest, ModelArtifact } from './types';
+import { SDK_VERSION } from '../version';
 
 export type { BundleManifest, ModelArtifact };
 
@@ -113,7 +114,7 @@ export class ModelManager {
   private async downloadArtifacts(manifest: BundleManifest, policyId: string): Promise<void> {
     const fileSystem = await loadFileSystem();
     if (!fileSystem || !fileSystem.documentDirectory) {
-      console.warn('[VerifyAI] expo-file-system not available, skipping download');
+      console.warn(`[VerifyAI v${SDK_VERSION}] expo-file-system not available, skipping download`);
       return;
     }
 

package/src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = '2.4.20';
+export const SDK_VERSION = '2.4.22';