@switchlabs/verify-ai-react-native 2.1.0 → 2.3.0

package/lib/client/index.js

@@ -195,11 +195,37 @@ export class VerifyAIClient {
         if (options?.idempotencyKey) {
             headers['Idempotency-Key'] = options.idempotencyKey;
         }
-        return this.executeRequest('/verify', {
-            method: 'POST',
-            headers,
-            body: formData,
-        });
+        try {
+            return await this.executeRequest('/verify', {
+                method: 'POST',
+                headers,
+                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.
+            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,
+                    });
+                }
+                catch {
+                    // If the retry itself fails, throw the original error
+                    throw error;
+                }
+            }
+            throw error;
+        }
     }
     /**
      * List past verifications with optional filters.

package/lib/components/VerifyAIScanner.js

@@ -312,12 +312,12 @@ export function VerifyAIScanner({ onCapture, onResult, onError, overlay, style,
         return (_jsxs(View, { style: [styles.container, styles.permissionContainer, style], children: [_jsx(Text, { style: styles.permissionText, children: "Camera access is required for photo verification" }), _jsx(TouchableOpacity, { style: styles.permissionButton, onPress: requestPermission, children: _jsx(Text, { style: styles.permissionButtonText, children: "Grant Camera Access" }) })] }));
     }
     const showBottomCard = status === 'success' || status === 'error';
-    return (_jsx(View, { style: [styles.container, style], children: _jsx(CameraView, { ref: cameraRef, style: styles.camera, facing: "back", enableTorch: !terminated && enableTorch, onCameraReady: onCameraReady, onMountError: onMountError, children: _jsxs(View, { style: styles.overlay, children: [overlay?.title && (_jsx(View, { style: styles.topBar, children: _jsx(Text, { style: styles.titleText, children: overlay.title }) })), overlay?.showGuideFrame && (_jsx(View, { style: styles.guideContainer, children: _jsxs(View, { style: [
-                                styles.guideFrame,
-                                overlay.guideFrameAspectRatio
-                                    ? { aspectRatio: overlay.guideFrameAspectRatio }
-                                    : undefined,
-                            ], children: [overlay.guideOverlayContent && (_jsx(View, { style: [StyleSheet.absoluteFill, { opacity: overlay.guideOverlayOpacity ?? 0.3 }], children: overlay.guideOverlayContent })), _jsx(View, { style: [styles.corner, styles.cornerTopLeft] }), _jsx(View, { style: [styles.corner, styles.cornerTopRight] }), _jsx(View, { style: [styles.corner, styles.cornerBottomLeft] }), _jsx(View, { style: [styles.corner, styles.cornerBottomRight] })] }) })), status === 'processing' && (_jsxs(View, { style: styles.processingOverlay, children: [_jsx(ActivityIndicator, { size: "large", color: "#fff" }), _jsx(Text, { style: styles.statusText, children: overlay?.processingMessage || 'Analyzing photo...' })] })), showBottomCard && _jsx(View, { style: styles.cardBackdrop }), _jsxs(View, { style: styles.bottomArea, children: [status === 'success' && result && (_jsxs(View, { style: styles.resultCard, children: [_jsxs(View, { style: styles.resultCardHeader, children: [_jsx(View, { style: [
+    return (_jsx(View, { style: [styles.container, style], children: _jsx(CameraView, { ref: cameraRef, style: styles.camera, facing: "back", enableTorch: !terminated && enableTorch, onCameraReady: onCameraReady, onMountError: onMountError, children: _jsxs(View, { style: styles.overlay, children: [overlay?.title && (_jsx(View, { style: styles.topBar, children: _jsx(Text, { style: styles.titleText, children: overlay.title }) })), overlay?.showGuideFrame && (_jsxs(View, { style: styles.guideContainer, children: [_jsxs(View, { style: [
+                                    styles.guideFrame,
+                                    overlay.guideFrameAspectRatio
+                                        ? { aspectRatio: overlay.guideFrameAspectRatio }
+                                        : undefined,
+                                ], children: [overlay.guideOverlayContent && (_jsx(View, { style: [StyleSheet.absoluteFill, { opacity: overlay.guideOverlayOpacity ?? 0.3 }], children: overlay.guideOverlayContent })), _jsx(View, { style: [styles.corner, styles.cornerTopLeft] }), _jsx(View, { style: [styles.corner, styles.cornerTopRight] }), _jsx(View, { style: [styles.corner, styles.cornerBottomLeft] }), _jsx(View, { style: [styles.corner, styles.cornerBottomRight] })] }), overlay.guideCaption && (_jsx(Text, { style: styles.guideCaptionText, children: overlay.guideCaption }))] })), status === 'processing' && (_jsxs(View, { style: styles.processingOverlay, children: [_jsx(ActivityIndicator, { size: "large", color: "#fff" }), _jsx(Text, { style: styles.statusText, children: overlay?.processingMessage || 'Analyzing photo...' })] })), showBottomCard && _jsx(View, { style: styles.cardBackdrop }), _jsxs(View, { style: styles.bottomArea, children: [status === 'success' && result && (_jsxs(View, { style: styles.resultCard, children: [_jsxs(View, { style: styles.resultCardHeader, children: [_jsx(View, { style: [
                                                     styles.resultIconCircle,
                                                     result.is_compliant ? styles.resultIconPass : styles.resultIconFail,
                                                 ], children: _jsx(Text, { style: styles.resultIcon, children: result.is_compliant ? '\u2713' : '\u2717' }) }), _jsx(Text, { style: [
@@ -334,9 +334,16 @@ export function VerifyAIScanner({ onCapture, onResult, onError, overlay, style,
                                 }
                                 else if (overlay?.maxAttempts != null && attemptCountRef.current < overlay.maxAttempts && result && !result.is_compliant) {
                                     const remaining = overlay.maxAttempts - attemptCountRef.current;
-                                    errorTitle = 'Not Verified';
-                                    const template = overlay?.retryMessage || 'Please try again. {remaining} attempts left.';
-                                    errorMessage = template.replace('{remaining}', String(remaining));
+                                    errorTitle = overlay?.failureMessage || 'Not Verified';
+                                    if (overlay?.retryMessage) {
+                                        errorMessage = overlay.retryMessage.replace('{remaining}', String(remaining));
+                                    }
+                                    else {
+                                        // Show actual API feedback with retry count (matches Flutter)
+                                        const feedback = result.feedback?.trim();
+                                        const retryInfo = `${remaining} attempt${remaining === 1 ? '' : 's'} remaining.`;
+                                        errorMessage = feedback ? `${feedback}\n\n${retryInfo}` : `Please try again. ${retryInfo}`;
+                                    }
                                 }
                                 else {
                                     const display = getErrorDisplay(lastError, overlay?.showTechnicalErrorDetails);
@@ -382,6 +389,14 @@ const styles = StyleSheet.create({
         alignItems: 'center',
         paddingHorizontal: 40,
     },
+    guideCaptionText: {
+        color: 'rgba(255,255,255,0.8)',
+        fontSize: 13,
+        fontWeight: '500',
+        textAlign: 'center',
+        marginTop: 12,
+        lineHeight: 18,
+    },
     guideFrame: {
         width: '100%',
         aspectRatio: 4 / 3,

package/lib/types/index.d.ts

@@ -30,6 +30,8 @@ export interface VerificationResult {
     feedback: string;
     metadata: Record<string, unknown>;
     image_url: string | null;
+    /** Classification category (e.g. good_parking, no_vehicle, poor_photo). */
+    category?: string;
 }
 export interface VerificationListResponse {
     data: VerificationResult[];
@@ -87,6 +89,8 @@ export interface ScannerOverlayConfig {
     guideOverlayContent?: React.ReactNode;
     /** Opacity of the guideOverlayContent (0–1). Default: 0.3. */
     guideOverlayOpacity?: number;
+    /** Caption text shown directly below the guide frame. */
+    guideCaption?: string;
     processingMessage?: string;
     successMessage?: string;
     failureMessage?: string;

package/lib/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.1.0";
+export declare const SDK_VERSION = "2.3.0";

package/lib/version.js

@@ -1 +1 @@
-export const SDK_VERSION = '2.1.0';
+export const SDK_VERSION = '2.3.0';

package/package.json

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

@@ -262,11 +262,35 @@ export class VerifyAIClient {
       headers['Idempotency-Key'] = options.idempotencyKey;
     }
 
-    return this.executeRequest<VerificationResult>('/verify', {
-      method: 'POST',
-      headers,
-      body: formData,
-    });
+    try {
+      return await this.executeRequest<VerificationResult>('/verify', {
+        method: 'POST',
+        headers,
+        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.
+      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,
+          });
+        } catch {
+          // If the retry itself fails, throw the original error
+          throw error;
+        }
+      }
+      throw error;
+    }
   }
 
   /**

package/src/components/VerifyAIScanner.tsx

@@ -450,6 +450,9 @@ export function VerifyAIScanner({
                 <View style={[styles.corner, styles.cornerBottomLeft]} />
                 <View style={[styles.corner, styles.cornerBottomRight]} />
               </View>
+              {overlay.guideCaption && (
+                <Text style={styles.guideCaptionText}>{overlay.guideCaption}</Text>
+              )}
             </View>
           )}
 
@@ -505,9 +508,15 @@ export function VerifyAIScanner({
                 errorMessage = overlay?.exhaustedMessage || 'Maximum attempts reached.';
               } else if (overlay?.maxAttempts != null && attemptCountRef.current < overlay.maxAttempts && result && !result.is_compliant) {
                 const remaining = overlay.maxAttempts - attemptCountRef.current;
-                errorTitle = 'Not Verified';
-                const template = overlay?.retryMessage || 'Please try again. {remaining} attempts left.';
-                errorMessage = template.replace('{remaining}', String(remaining));
+                errorTitle = overlay?.failureMessage || 'Not Verified';
+                if (overlay?.retryMessage) {
+                  errorMessage = overlay.retryMessage.replace('{remaining}', String(remaining));
+                } else {
+                  // Show actual API feedback with retry count (matches Flutter)
+                  const feedback = result.feedback?.trim();
+                  const retryInfo = `${remaining} attempt${remaining === 1 ? '' : 's'} remaining.`;
+                  errorMessage = feedback ? `${feedback}\n\n${retryInfo}` : `Please try again. ${retryInfo}`;
+                }
               } else {
                 const display = getErrorDisplay(lastError, overlay?.showTechnicalErrorDetails);
                 errorTitle = display.title;
@@ -595,6 +604,14 @@ const styles = StyleSheet.create({
     alignItems: 'center',
     paddingHorizontal: 40,
   },
+  guideCaptionText: {
+    color: 'rgba(255,255,255,0.8)',
+    fontSize: 13,
+    fontWeight: '500',
+    textAlign: 'center' as const,
+    marginTop: 12,
+    lineHeight: 18,
+  },
   guideFrame: {
     width: '100%',
     aspectRatio: 4 / 3,

package/src/types/index.ts

@@ -34,6 +34,8 @@ export interface VerificationResult {
   feedback: string;
   metadata: Record<string, unknown>;
   image_url: string | null;
+  /** Classification category (e.g. good_parking, no_vehicle, poor_photo). */
+  category?: string;
 }
 
 export interface VerificationListResponse {
@@ -98,6 +100,8 @@ export interface ScannerOverlayConfig {
   guideOverlayContent?: React.ReactNode;
   /** Opacity of the guideOverlayContent (0–1). Default: 0.3. */
   guideOverlayOpacity?: number;
+  /** Caption text shown directly below the guide frame. */
+  guideCaption?: string;
   processingMessage?: string;
   successMessage?: string;
   failureMessage?: string;

package/src/version.ts

@@ -1 +1 @@
-export const SDK_VERSION = '2.1.0';
+export const SDK_VERSION = '2.3.0';