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

package/README.md

@@ -4,18 +4,20 @@ React Native SDK for Verify AI photo verification.
 
 ## Install
 
-Expo-managed apps:
+Core SDK (client, hooks, types):
 
 ```bash
-npx expo install @switchlabs/verify-ai-react-native expo-camera @react-native-async-storage/async-storage
+npm install @switchlabs/verify-ai-react-native
 ```
 
-React Native CLI:
+With built-in camera scanner:
 
 ```bash
-npm install @switchlabs/verify-ai-react-native expo-camera @react-native-async-storage/async-storage
+npm install @switchlabs/verify-ai-react-native expo-camera expo-image-manipulator
 ```
 
+For offline queue support, also install `@react-native-async-storage/async-storage`.
+
 If you want on-device inference, also install `expo-file-system`,
 `react-native-fast-tflite`, and configure `react-native-fast-tflite` for the
 delegates you plan to use.
@@ -44,18 +46,18 @@ function ParkingScreen() {
 
 ## Scanner Component
 
+The scanner is exported from a separate subpath to avoid pulling in `expo-camera` for consumers that only need the client.
+
 ```tsx
-import { useVerifyAI, VerifyAIScanner } from '@switchlabs/verify-ai-react-native';
+import { useVerifyAI } from '@switchlabs/verify-ai-react-native';
+import { VerifyAIScanner } from '@switchlabs/verify-ai-react-native/scanner';
 
 function ScannerScreen() {
-  const { verifyMultipart } = useVerifyAI({
-    apiKey: 'vai_your_api_key',
-    enableOnDeviceML: true,
-  });
+  const { verify } = useVerifyAI({ apiKey: 'vai_your_api_key' });
   return (
     <VerifyAIScanner
-      onCapture={(imageUri) =>
-        verifyMultipart({ imageUri, policy: 'scooter_parking' })
+      onCapture={(base64) =>
+        verify({ image: base64, policy: 'scooter_parking' })
       }
       onResult={(result) => console.log(result.is_compliant ? 'PASS' : 'FAIL')}
     />
@@ -65,6 +67,8 @@ function ScannerScreen() {
 
 ## Offline Mode
 
+Requires `@react-native-async-storage/async-storage` to be installed.
+
 Set `offlineMode: true` to queue transient failures (network, timeout, 429, 5xx) and retry later.
 
 ```tsx

package/lib/client/index.d.ts

@@ -38,9 +38,6 @@ export declare class VerifyAIClient {
      * Submit a photo for AI verification using multipart/form-data.
      * Streams the image directly from disk — avoids base64 encoding overhead.
      *
-     * **Breaking change:** `onCapture` prop on `VerifyAIScanner` now receives
-     * an image URI instead of a base64 string.
-     *
      * @param request - Multipart request with file URI and policy
      * @param options - Optional verify options (e.g. idempotency key)
      * @returns The verification result with compliance status and feedback

package/lib/client/index.js

@@ -1,6 +1,24 @@
 import { TelemetryReporter } from '../telemetry/TelemetryReporter';
+import { SDK_VERSION } from '../version';
 const DEFAULT_BASE_URL = 'https://verify.switchlabs.dev/api/v1';
 const DEFAULT_TIMEOUT = 30000;
+const VEHICLE_TYPE_LABELS = {
+    scooter: 'Scooter',
+    'e-bike': 'E-Bike',
+    ebike: 'E-Bike',
+    bike: 'Bike',
+    moped: 'Moped',
+    car: 'Car',
+};
+/** Auto-inject sdkVersion and vehicleTypeLabel into metadata. */
+function enrichMetadata(metadata) {
+    const enriched = { ...metadata, sdkVersion: SDK_VERSION };
+    const vehicleType = enriched.vehicleType;
+    if (typeof vehicleType === 'string' && !enriched.vehicleTypeLabel) {
+        enriched.vehicleTypeLabel = VEHICLE_TYPE_LABELS[vehicleType.toLowerCase()] || vehicleType;
+    }
+    return enriched;
+}
 export class VerifyAIClient {
     constructor(config) {
         if (!config.apiKey) {
@@ -142,19 +160,17 @@ export class VerifyAIClient {
         if (options?.idempotencyKey) {
             headers['Idempotency-Key'] = options.idempotencyKey;
         }
+        const enrichedRequest = { ...request, metadata: enrichMetadata(request.metadata) };
         return this.request('/verify', {
             method: 'POST',
             headers,
-            body: JSON.stringify(request),
+            body: JSON.stringify(enrichedRequest),
         });
     }
     /**
      * Submit a photo for AI verification using multipart/form-data.
      * Streams the image directly from disk — avoids base64 encoding overhead.
      *
-     * **Breaking change:** `onCapture` prop on `VerifyAIScanner` now receives
-     * an image URI instead of a base64 string.
-     *
      * @param request - Multipart request with file URI and policy
      * @param options - Optional verify options (e.g. idempotency key)
      * @returns The verification result with compliance status and feedback
@@ -168,9 +184,7 @@ export class VerifyAIClient {
             name: 'photo.jpg',
         });
         formData.append('policy', request.policy);
-        if (request.metadata) {
-            formData.append('metadata', JSON.stringify(request.metadata));
-        }
+        formData.append('metadata', JSON.stringify(enrichMetadata(request.metadata)));
         if (request.provider) {
             formData.append('provider', request.provider);
         }

package/lib/components/VerifyAIScanner.d.ts

@@ -3,8 +3,8 @@ import { type ViewStyle } from 'react-native';
 import type { VerificationResult, ScannerOverlayConfig } from '../types';
 import type { TelemetryReporter } from '../telemetry/TelemetryReporter';
 export interface VerifyAIScannerProps {
-    /** Called with the image URI when the user captures a photo. */
-    onCapture: (imageUri: string) => Promise<VerificationResult | null>;
+    /** Called with base64 image data when the user captures a photo. */
+    onCapture: (base64: string) => Promise<VerificationResult | null>;
     /** Called when a terminal verification result is reached. */
     onResult?: (result: VerificationResult) => void;
     /** Called when an error occurs. */
@@ -28,13 +28,10 @@ export interface VerifyAIScannerProps {
  *
  * @example
  * ```tsx
- * const { verifyMultipart } = useVerifyAI({
- *   apiKey: 'vai_...',
- *   enableOnDeviceML: true,
- * });
+ * const { verify } = useVerifyAI({ apiKey: 'vai_...' });
  *
  * <VerifyAIScanner
- *   onCapture={(imageUri) => verifyMultipart({ imageUri, policy: 'scooter_parking' })}
+ *   onCapture={(base64) => verify({ image: base64, policy: 'scooter_parking' })}
  *   onResult={(result) => {
  *     if (result.is_compliant) navigation.navigate('Success');
  *   }}

package/lib/components/VerifyAIScanner.js

@@ -2,8 +2,13 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useRef, useState, useCallback, useEffect } from 'react';
 import { View, Text, TouchableOpacity, StyleSheet, ActivityIndicator, } from 'react-native';
 import { CameraView, useCameraPermissions, } from 'expo-camera';
-import * as ImageManipulator from 'expo-image-manipulator';
 import { useTelemetry } from '../telemetry/TelemetryContext';
+/** Quality used when expo-image-manipulator is not available (lower = smaller). */
+const FALLBACK_QUALITY = 0.5;
+/** Quality used when expo-image-manipulator IS available (resize handles size). */
+const MANIPULATOR_QUALITY = 0.7;
+/** Max dimension (px) on longest side when resize is available. */
+const MAX_DIMENSION = 2048;
 function getErrorDisplay(error, showTechnicalDetails) {
     if (!error) {
         return {
@@ -24,6 +29,9 @@ function getErrorDisplay(error, showTechnicalDetails) {
     else if (status === 401) {
         message = 'Verification is not configured correctly.';
     }
+    else if (status === 413) {
+        message = 'Image is too large. Please try again — the photo will be resized automatically.';
+    }
     else if (status === 429) {
         message = 'Verification is temporarily unavailable. Please try again.';
     }
@@ -50,13 +58,10 @@ function getErrorDisplay(error, showTechnicalDetails) {
  *
  * @example
  * ```tsx
- * const { verifyMultipart } = useVerifyAI({
- *   apiKey: 'vai_...',
- *   enableOnDeviceML: true,
- * });
+ * const { verify } = useVerifyAI({ apiKey: 'vai_...' });
  *
  * <VerifyAIScanner
- *   onCapture={(imageUri) => verifyMultipart({ imageUri, policy: 'scooter_parking' })}
+ *   onCapture={(base64) => verify({ image: base64, policy: 'scooter_parking' })}
  *   onResult={(result) => {
  *     if (result.is_compliant) navigation.navigate('Success');
  *   }}
@@ -157,19 +162,89 @@ export function VerifyAIScanner({ onCapture, onResult, onError, overlay, style,
         setResult(null);
         setLastError(null);
         try {
-            const photo = await cameraRef.current.takePictureAsync({
-                quality: 0.8,
-                exif: false,
-            });
-            if (!photo?.uri) {
-                throw new Error('Failed to capture photo');
+            // --- Capture + best-effort resize ---
+            // Strategy: try to dynamically import expo-image-manipulator.
+            //   If available → resize to MAX_DIMENSION, EXIF-normalize, return base64.
+            //   If not available → use expo-camera's built-in base64 at lower quality.
+            // This keeps expo-image-manipulator as an *optional* dependency.
+            let base64;
+            let origWidth = 0;
+            let origHeight = 0;
+            let processedWidth = 0;
+            let processedHeight = 0;
+            let didResize = false;
+            let ImageManipulator = null;
+            try {
+                ImageManipulator = await import('expo-image-manipulator');
+            }
+            catch {
+                // Not installed — fall back to camera-only base64 below
+            }
+            if (ImageManipulator) {
+                // Capture without base64 — ImageManipulator will produce it after resize.
+                const photo = await cameraRef.current.takePictureAsync({
+                    quality: 0.8,
+                    exif: false,
+                });
+                if (!photo?.uri) {
+                    throw new Error('Failed to capture photo');
+                }
+                origWidth = photo.width ?? 0;
+                origHeight = photo.height ?? 0;
+                const actions = [];
+                if (origWidth > MAX_DIMENSION || origHeight > MAX_DIMENSION) {
+                    if (origWidth >= origHeight) {
+                        actions.push({ resize: { width: MAX_DIMENSION } });
+                    }
+                    else {
+                        actions.push({ resize: { height: MAX_DIMENSION } });
+                    }
+                    didResize = true;
+                }
+                const normalized = await ImageManipulator.manipulateAsync(photo.uri, actions, {
+                    compress: MANIPULATOR_QUALITY,
+                    format: ImageManipulator.SaveFormat.JPEG,
+                    base64: true,
+                });
+                if (!normalized.base64) {
+                    throw new Error('ImageManipulator did not return base64');
+                }
+                base64 = normalized.base64;
+                processedWidth = normalized.width;
+                processedHeight = normalized.height;
             }
-            // Normalize EXIF orientation into actual pixels so the server
-            // receives an upright image (Gemini and other vision APIs ignore EXIF).
-            // An empty actions array makes ImageManipulator apply EXIF rotation only.
-            const normalized = await ImageManipulator.manipulateAsync(photo.uri, [], { compress: 0.8, format: ImageManipulator.SaveFormat.JPEG });
+            else {
+                // Fallback: capture base64 directly from the camera at reduced quality.
+                // No resize is possible without ImageManipulator, but the lower quality
+                // significantly reduces payload size (e.g. 50 MP @ 0.5 ≈ 3–4 MB base64).
+                const photo = await cameraRef.current.takePictureAsync({
+                    base64: true,
+                    quality: FALLBACK_QUALITY,
+                    exif: false,
+                });
+                if (!photo?.base64) {
+                    throw new Error('Failed to capture photo');
+                }
+                origWidth = photo.width ?? 0;
+                origHeight = photo.height ?? 0;
+                processedWidth = origWidth;
+                processedHeight = origHeight;
+                base64 = photo.base64;
+            }
+            // Best-effort telemetry — never blocks capture
+            telemetry?.track('image_processed', {
+                component: 'scanner',
+                metadata: {
+                    original_width: origWidth,
+                    original_height: origHeight,
+                    processed_width: processedWidth,
+                    processed_height: processedHeight,
+                    resized: didResize ? 1 : 0,
+                    has_manipulator: ImageManipulator ? 1 : 0,
+                },
+            });
             setStatus('processing');
-            const verificationResult = await onCapture(normalized.uri);
+            const verificationResult = await onCapture(base64);
             attemptCountRef.current++;
             if (verificationResult) {
                 const maxAttempts = overlay?.maxAttempts;

package/lib/index.d.ts

@@ -1,8 +1,6 @@
 export { VerifyAIClient, VerifyAIRequestError } from './client';
 export { useVerifyAI } from './hooks/useVerifyAI';
 export type { UseVerifyAIReturn, UseVerifyAIConfig } from './hooks/useVerifyAI';
-export { VerifyAIScanner } from './components/VerifyAIScanner';
-export type { VerifyAIScannerProps } from './components/VerifyAIScanner';
 export { TelemetryReporter } from './telemetry/TelemetryReporter';
 export { TelemetryContext } from './telemetry/TelemetryContext';
 export { OfflineQueue } from './storage/offlineQueue';

package/lib/index.js

@@ -2,8 +2,6 @@
 export { VerifyAIClient, VerifyAIRequestError } from './client';
 // Hooks
 export { useVerifyAI } from './hooks/useVerifyAI';
-// Components
-export { VerifyAIScanner } from './components/VerifyAIScanner';
 // Telemetry
 export { TelemetryReporter } from './telemetry/TelemetryReporter';
 export { TelemetryContext } from './telemetry/TelemetryContext';

package/lib/scanner.d.ts

@@ -0,0 +1,2 @@
+export { VerifyAIScanner } from './components/VerifyAIScanner';
+export type { VerifyAIScannerProps } from './components/VerifyAIScanner';

package/lib/scanner.js

@@ -0,0 +1 @@
+export { VerifyAIScanner } from './components/VerifyAIScanner';

package/lib/storage/offlineQueue.js

@@ -1,5 +1,12 @@
-import AsyncStorage from '@react-native-async-storage/async-storage';
 import { VerifyAIRequestError } from '../client';
+let _storage = null;
+async function getStorage() {
+    if (!_storage) {
+        const mod = await import('@react-native-async-storage/async-storage');
+        _storage = mod.default;
+    }
+    return _storage;
+}
 const MANIFEST_KEY = '@verifyai/queue_manifest';
 const ITEM_PREFIX = '@verifyai/queue_item_';
 const LEGACY_KEY = '@verifyai/offline_queue';
@@ -17,13 +24,13 @@ export class OfflineQueue {
         if (this.migrated)
             return;
         this.migrated = true;
-        const legacy = await AsyncStorage.getItem(LEGACY_KEY);
+        const legacy = await (await getStorage()).getItem(LEGACY_KEY);
         if (!legacy)
             return;
         try {
             const items = JSON.parse(legacy);
             if (!Array.isArray(items) || items.length === 0) {
-                await AsyncStorage.removeItem(LEGACY_KEY);
+                await (await getStorage()).removeItem(LEGACY_KEY);
                 return;
             }
             const ids = [];
@@ -32,24 +39,25 @@ export class OfflineQueue {
                 ids.push(item.id);
                 pairs.push([`${ITEM_PREFIX}${item.id}`, JSON.stringify(item)]);
             }
-            await AsyncStorage.multiSet([
+            const storage = await getStorage();
+            await storage.multiSet([
                 [MANIFEST_KEY, JSON.stringify(ids)],
                 ...pairs,
             ]);
-            await AsyncStorage.removeItem(LEGACY_KEY);
+            await storage.removeItem(LEGACY_KEY);
         }
         catch {
             // If migration fails, remove corrupt legacy data
-            await AsyncStorage.removeItem(LEGACY_KEY);
+            await (await getStorage()).removeItem(LEGACY_KEY);
         }
     }
     async getManifest() {
         await this.migrateIfNeeded();
-        const raw = await AsyncStorage.getItem(MANIFEST_KEY);
+        const raw = await (await getStorage()).getItem(MANIFEST_KEY);
         return raw ? JSON.parse(raw) : [];
     }
     async setManifest(ids) {
-        await AsyncStorage.setItem(MANIFEST_KEY, JSON.stringify(ids));
+        await (await getStorage()).setItem(MANIFEST_KEY, JSON.stringify(ids));
     }
     /**
      * Add a verification request to the offline queue.
@@ -64,7 +72,7 @@ export class OfflineQueue {
         };
         const ids = await this.getManifest();
         ids.push(item.id);
-        await AsyncStorage.setItem(`${ITEM_PREFIX}${item.id}`, JSON.stringify(item));
+        await (await getStorage()).setItem(`${ITEM_PREFIX}${item.id}`, JSON.stringify(item));
         await this.setManifest(ids);
         return item.id;
     }
@@ -76,7 +84,7 @@ export class OfflineQueue {
         if (ids.length === 0)
             return [];
         const keys = ids.map((id) => `${ITEM_PREFIX}${id}`);
-        const pairs = await AsyncStorage.multiGet(keys);
+        const pairs = await (await getStorage()).multiGet(keys);
         const items = [];
         for (const [, value] of pairs) {
             if (value) {
@@ -104,7 +112,7 @@ export class OfflineQueue {
         const ids = await this.getManifest();
         const filtered = ids.filter((i) => i !== id);
         await this.setManifest(filtered);
-        await AsyncStorage.removeItem(`${ITEM_PREFIX}${id}`);
+        await (await getStorage()).removeItem(`${ITEM_PREFIX}${id}`);
     }
     /**
      * Clear all items from the queue.
@@ -113,10 +121,10 @@ export class OfflineQueue {
         const ids = await this.getManifest();
         if (ids.length > 0) {
             const keys = ids.map((id) => `${ITEM_PREFIX}${id}`);
-            await AsyncStorage.multiRemove([MANIFEST_KEY, ...keys]);
+            await (await getStorage()).multiRemove([MANIFEST_KEY, ...keys]);
         }
         else {
-            await AsyncStorage.removeItem(MANIFEST_KEY);
+            await (await getStorage()).removeItem(MANIFEST_KEY);
         }
     }
     /**
@@ -140,7 +148,7 @@ export class OfflineQueue {
         try {
             const ids = await this.getManifest();
             for (const id of ids) {
-                const raw = await AsyncStorage.getItem(`${ITEM_PREFIX}${id}`);
+                const raw = await (await getStorage()).getItem(`${ITEM_PREFIX}${id}`);
                 if (!raw)
                     continue;
                 let item;
@@ -149,13 +157,13 @@ export class OfflineQueue {
                 }
                 catch {
                     // Remove corrupt item
-                    await AsyncStorage.removeItem(`${ITEM_PREFIX}${id}`);
+                    await (await getStorage()).removeItem(`${ITEM_PREFIX}${id}`);
                     continue;
                 }
                 try {
                     const result = await this.client.verify(item.request, { idempotencyKey: item.id });
                     processed++;
-                    await AsyncStorage.removeItem(`${ITEM_PREFIX}${id}`);
+                    await (await getStorage()).removeItem(`${ITEM_PREFIX}${id}`);
                     onResult?.(item.id, result);
                 }
                 catch (err) {
@@ -163,12 +171,12 @@ export class OfflineQueue {
                     const shouldRetry = !requestError || requestError.isRetryable;
                     item.retryCount++;
                     if (shouldRetry && item.retryCount < maxRetries) {
-                        await AsyncStorage.setItem(`${ITEM_PREFIX}${id}`, JSON.stringify(item));
+                        await (await getStorage()).setItem(`${ITEM_PREFIX}${id}`, JSON.stringify(item));
                         remainingIds.push(id);
                     }
                     else {
                         failed++;
-                        await AsyncStorage.removeItem(`${ITEM_PREFIX}${id}`);
+                        await (await getStorage()).removeItem(`${ITEM_PREFIX}${id}`);
                     }
                 }
             }

package/lib/telemetry/TelemetryReporter.d.ts

@@ -12,6 +12,7 @@ export declare class TelemetryReporter {
         component?: string;
         error?: unknown;
         errorCode?: string;
+        metadata?: Record<string, string | number>;
     }): void;
     /** Flush all buffered events immediately. Returns a promise but never rejects. */
     flush(): Promise<void>;

package/lib/telemetry/TelemetryReporter.js

@@ -42,6 +42,7 @@ export class TelemetryReporter {
                 error_message: errorMessage?.slice(0, 1000),
                 error_stack: errorObj?.stack?.slice(0, 2000),
                 error_code: opts.errorCode,
+                metadata: opts.metadata,
                 sdk_platform: Platform.OS,
                 sdk_version: SDK_VERSION,
                 os_name: Platform.OS,

package/lib/version.d.ts

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

package/lib/version.js

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

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "@switchlabs/verify-ai-react-native",
-  "version": "1.1.1",
+  "version": "2.1.0",
   "description": "React Native SDK for Verify AI - photo verification with AI vision processing",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./scanner": {
+      "types": "./lib/scanner.d.ts",
+      "default": "./lib/scanner.js"
+    }
+  },
   "files": [
     "src",
     "lib"

package/src/client/index.ts

@@ -10,10 +10,30 @@ import type {
   PolicyConfigResponse,
 } from '../types';
 import { TelemetryReporter } from '../telemetry/TelemetryReporter';
+import { SDK_VERSION } from '../version';
 
 const DEFAULT_BASE_URL = 'https://verify.switchlabs.dev/api/v1';
 const DEFAULT_TIMEOUT = 30000;
 
+const VEHICLE_TYPE_LABELS: Record<string, string> = {
+  scooter: 'Scooter',
+  'e-bike': 'E-Bike',
+  ebike: 'E-Bike',
+  bike: 'Bike',
+  moped: 'Moped',
+  car: 'Car',
+};
+
+/** Auto-inject sdkVersion and vehicleTypeLabel into metadata. */
+function enrichMetadata(metadata?: Record<string, unknown>): Record<string, unknown> {
+  const enriched: Record<string, unknown> = { ...metadata, sdkVersion: SDK_VERSION };
+  const vehicleType = enriched.vehicleType;
+  if (typeof vehicleType === 'string' && !enriched.vehicleTypeLabel) {
+    enriched.vehicleTypeLabel = VEHICLE_TYPE_LABELS[vehicleType.toLowerCase()] || vehicleType;
+  }
+  return enriched;
+}
+
 interface RequestContext {
   path: string;
   url: string;
@@ -204,10 +224,11 @@ export class VerifyAIClient {
     if (options?.idempotencyKey) {
       headers['Idempotency-Key'] = options.idempotencyKey;
     }
+    const enrichedRequest = { ...request, metadata: enrichMetadata(request.metadata) };
     return this.request<VerificationResult>('/verify', {
       method: 'POST',
       headers,
-      body: JSON.stringify(request),
+      body: JSON.stringify(enrichedRequest),
     });
   }
 
@@ -215,9 +236,6 @@ export class VerifyAIClient {
    * Submit a photo for AI verification using multipart/form-data.
    * Streams the image directly from disk — avoids base64 encoding overhead.
    *
-   * **Breaking change:** `onCapture` prop on `VerifyAIScanner` now receives
-   * an image URI instead of a base64 string.
-   *
    * @param request - Multipart request with file URI and policy
    * @param options - Optional verify options (e.g. idempotency key)
    * @returns The verification result with compliance status and feedback
@@ -231,9 +249,7 @@ export class VerifyAIClient {
       name: 'photo.jpg',
     } as unknown as Blob);
     formData.append('policy', request.policy);
-    if (request.metadata) {
-      formData.append('metadata', JSON.stringify(request.metadata));
-    }
+    formData.append('metadata', JSON.stringify(enrichMetadata(request.metadata)));
     if (request.provider) {
       formData.append('provider', request.provider);
     }

package/src/components/VerifyAIScanner.tsx

@@ -11,7 +11,6 @@ import {
   CameraView,
   useCameraPermissions,
 } from 'expo-camera';
-import * as ImageManipulator from 'expo-image-manipulator';
 import type {
   VerificationResult,
   ScannerStatus,
@@ -20,9 +19,16 @@ import type {
 import { useTelemetry } from '../telemetry/TelemetryContext';
 import type { TelemetryReporter } from '../telemetry/TelemetryReporter';
 
+/** Quality used when expo-image-manipulator is not available (lower = smaller). */
+const FALLBACK_QUALITY = 0.5;
+/** Quality used when expo-image-manipulator IS available (resize handles size). */
+const MANIPULATOR_QUALITY = 0.7;
+/** Max dimension (px) on longest side when resize is available. */
+const MAX_DIMENSION = 2048;
+
 export interface VerifyAIScannerProps {
-  /** Called with the image URI when the user captures a photo. */
-  onCapture: (imageUri: string) => Promise<VerificationResult | null>;
+  /** Called with base64 image data when the user captures a photo. */
+  onCapture: (base64: string) => Promise<VerificationResult | null>;
   /** Called when a terminal verification result is reached. */
   onResult?: (result: VerificationResult) => void;
   /** Called when an error occurs. */
@@ -72,6 +78,8 @@ function getErrorDisplay(error: ErrorWithDetails | null, showTechnicalDetails?:
     message = 'Network request failed. Check your connection and try again.';
   } else if (status === 401) {
     message = 'Verification is not configured correctly.';
+  } else if (status === 413) {
+    message = 'Image is too large. Please try again — the photo will be resized automatically.';
   } else if (status === 429) {
     message = 'Verification is temporarily unavailable. Please try again.';
   } else if (status !== undefined && status >= 500) {
@@ -101,13 +109,10 @@ function getErrorDisplay(error: ErrorWithDetails | null, showTechnicalDetails?:
  *
  * @example
  * ```tsx
- * const { verifyMultipart } = useVerifyAI({
- *   apiKey: 'vai_...',
- *   enableOnDeviceML: true,
- * });
+ * const { verify } = useVerifyAI({ apiKey: 'vai_...' });
  *
  * <VerifyAIScanner
- *   onCapture={(imageUri) => verifyMultipart({ imageUri, policy: 'scooter_parking' })}
+ *   onCapture={(base64) => verify({ image: base64, policy: 'scooter_parking' })}
  *   onResult={(result) => {
  *     if (result.is_compliant) navigation.navigate('Success');
  *   }}
@@ -230,26 +235,102 @@ export function VerifyAIScanner({
     setLastError(null);
 
     try {
-      const photo = await cameraRef.current.takePictureAsync({
-        quality: 0.8,
-        exif: false,
-      });
+      // --- Capture + best-effort resize ---
+      // Strategy: try to dynamically import expo-image-manipulator.
+      //   If available → resize to MAX_DIMENSION, EXIF-normalize, return base64.
+      //   If not available → use expo-camera's built-in base64 at lower quality.
+      // This keeps expo-image-manipulator as an *optional* dependency.
+      let base64: string;
+      let origWidth = 0;
+      let origHeight = 0;
+      let processedWidth = 0;
+      let processedHeight = 0;
+      let didResize = false;
+
+      let ImageManipulator: typeof import('expo-image-manipulator') | null = null;
+      try {
+        ImageManipulator = await import('expo-image-manipulator');
+      } catch {
+        // Not installed — fall back to camera-only base64 below
+      }
+
+      if (ImageManipulator) {
+        // Capture without base64 — ImageManipulator will produce it after resize.
+        const photo = await cameraRef.current.takePictureAsync({
+          quality: 0.8,
+          exif: false,
+        });
+
+        if (!photo?.uri) {
+          throw new Error('Failed to capture photo');
+        }
+
+        origWidth = photo.width ?? 0;
+        origHeight = photo.height ?? 0;
+
+        const actions: Array<{ resize: { width?: number; height?: number } }> = [];
+        if (origWidth > MAX_DIMENSION || origHeight > MAX_DIMENSION) {
+          if (origWidth >= origHeight) {
+            actions.push({ resize: { width: MAX_DIMENSION } });
+          } else {
+            actions.push({ resize: { height: MAX_DIMENSION } });
+          }
+          didResize = true;
+        }
+
+        const normalized = await ImageManipulator.manipulateAsync(
+          photo.uri,
+          actions,
+          {
+            compress: MANIPULATOR_QUALITY,
+            format: ImageManipulator.SaveFormat.JPEG,
+            base64: true,
+          },
+        );
+
+        if (!normalized.base64) {
+          throw new Error('ImageManipulator did not return base64');
+        }
+
+        base64 = normalized.base64;
+        processedWidth = normalized.width;
+        processedHeight = normalized.height;
+      } else {
+        // Fallback: capture base64 directly from the camera at reduced quality.
+        // No resize is possible without ImageManipulator, but the lower quality
+        // significantly reduces payload size (e.g. 50 MP @ 0.5 ≈ 3–4 MB base64).
+        const photo = await cameraRef.current.takePictureAsync({
+          base64: true,
+          quality: FALLBACK_QUALITY,
+          exif: false,
+        });
 
-      if (!photo?.uri) {
-        throw new Error('Failed to capture photo');
+        if (!photo?.base64) {
+          throw new Error('Failed to capture photo');
+        }
+
+        origWidth = photo.width ?? 0;
+        origHeight = photo.height ?? 0;
+        processedWidth = origWidth;
+        processedHeight = origHeight;
+        base64 = photo.base64;
       }
 
-      // Normalize EXIF orientation into actual pixels so the server
-      // receives an upright image (Gemini and other vision APIs ignore EXIF).
-      // An empty actions array makes ImageManipulator apply EXIF rotation only.
-      const normalized = await ImageManipulator.manipulateAsync(
-        photo.uri,
-        [],
-        { compress: 0.8, format: ImageManipulator.SaveFormat.JPEG },
-      );
+      // Best-effort telemetry — never blocks capture
+      telemetry?.track('image_processed', {
+        component: 'scanner',
+        metadata: {
+          original_width: origWidth,
+          original_height: origHeight,
+          processed_width: processedWidth,
+          processed_height: processedHeight,
+          resized: didResize ? 1 : 0,
+          has_manipulator: ImageManipulator ? 1 : 0,
+        },
+      });
 
       setStatus('processing');
-      const verificationResult = await onCapture(normalized.uri);
+      const verificationResult = await onCapture(base64);
 
       attemptCountRef.current++;
 

package/src/index.ts

@@ -5,10 +5,6 @@ export { VerifyAIClient, VerifyAIRequestError } from './client';
 export { useVerifyAI } from './hooks/useVerifyAI';
 export type { UseVerifyAIReturn, UseVerifyAIConfig } from './hooks/useVerifyAI';
 
-// Components
-export { VerifyAIScanner } from './components/VerifyAIScanner';
-export type { VerifyAIScannerProps } from './components/VerifyAIScanner';
-
 // Telemetry
 export { TelemetryReporter } from './telemetry/TelemetryReporter';
 export { TelemetryContext } from './telemetry/TelemetryContext';

package/src/scanner.ts

@@ -0,0 +1,2 @@
+export { VerifyAIScanner } from './components/VerifyAIScanner';
+export type { VerifyAIScannerProps } from './components/VerifyAIScanner';

package/src/storage/offlineQueue.ts

@@ -1,7 +1,15 @@
-import AsyncStorage from '@react-native-async-storage/async-storage';
 import type { VerificationRequest, VerificationResult, QueueItem } from '../types';
 import { VerifyAIClient, VerifyAIRequestError } from '../client';
 
+let _storage: typeof import('@react-native-async-storage/async-storage').default | null = null;
+async function getStorage() {
+  if (!_storage) {
+    const mod = await import('@react-native-async-storage/async-storage');
+    _storage = mod.default;
+  }
+  return _storage;
+}
+
 const MANIFEST_KEY = '@verifyai/queue_manifest';
 const ITEM_PREFIX = '@verifyai/queue_item_';
 const LEGACY_KEY = '@verifyai/offline_queue';
@@ -23,13 +31,13 @@ export class OfflineQueue {
     if (this.migrated) return;
     this.migrated = true;
 
-    const legacy = await AsyncStorage.getItem(LEGACY_KEY);
+    const legacy = await (await getStorage()).getItem(LEGACY_KEY);
     if (!legacy) return;
 
     try {
       const items: QueueItem[] = JSON.parse(legacy);
       if (!Array.isArray(items) || items.length === 0) {
-        await AsyncStorage.removeItem(LEGACY_KEY);
+        await (await getStorage()).removeItem(LEGACY_KEY);
         return;
       }
 
@@ -40,25 +48,26 @@ export class OfflineQueue {
         pairs.push([`${ITEM_PREFIX}${item.id}`, JSON.stringify(item)]);
       }
 
-      await AsyncStorage.multiSet([
+      const storage = await getStorage();
+      await storage.multiSet([
         [MANIFEST_KEY, JSON.stringify(ids)],
         ...pairs,
       ]);
-      await AsyncStorage.removeItem(LEGACY_KEY);
+      await storage.removeItem(LEGACY_KEY);
     } catch {
       // If migration fails, remove corrupt legacy data
-      await AsyncStorage.removeItem(LEGACY_KEY);
+      await (await getStorage()).removeItem(LEGACY_KEY);
     }
   }
 
   private async getManifest(): Promise<string[]> {
     await this.migrateIfNeeded();
-    const raw = await AsyncStorage.getItem(MANIFEST_KEY);
+    const raw = await (await getStorage()).getItem(MANIFEST_KEY);
     return raw ? JSON.parse(raw) : [];
   }
 
   private async setManifest(ids: string[]): Promise<void> {
-    await AsyncStorage.setItem(MANIFEST_KEY, JSON.stringify(ids));
+    await (await getStorage()).setItem(MANIFEST_KEY, JSON.stringify(ids));
   }
 
   /**
@@ -76,7 +85,7 @@ export class OfflineQueue {
     const ids = await this.getManifest();
     ids.push(item.id);
 
-    await AsyncStorage.setItem(`${ITEM_PREFIX}${item.id}`, JSON.stringify(item));
+    await (await getStorage()).setItem(`${ITEM_PREFIX}${item.id}`, JSON.stringify(item));
     await this.setManifest(ids);
     return item.id;
   }
@@ -89,7 +98,7 @@ export class OfflineQueue {
     if (ids.length === 0) return [];
 
     const keys = ids.map((id) => `${ITEM_PREFIX}${id}`);
-    const pairs = await AsyncStorage.multiGet(keys);
+    const pairs = await (await getStorage()).multiGet(keys);
 
     const items: QueueItem[] = [];
     for (const [, value] of pairs) {
@@ -119,7 +128,7 @@ export class OfflineQueue {
     const ids = await this.getManifest();
     const filtered = ids.filter((i) => i !== id);
     await this.setManifest(filtered);
-    await AsyncStorage.removeItem(`${ITEM_PREFIX}${id}`);
+    await (await getStorage()).removeItem(`${ITEM_PREFIX}${id}`);
   }
 
   /**
@@ -129,9 +138,9 @@ export class OfflineQueue {
     const ids = await this.getManifest();
     if (ids.length > 0) {
       const keys = ids.map((id) => `${ITEM_PREFIX}${id}`);
-      await AsyncStorage.multiRemove([MANIFEST_KEY, ...keys]);
+      await (await getStorage()).multiRemove([MANIFEST_KEY, ...keys]);
     } else {
-      await AsyncStorage.removeItem(MANIFEST_KEY);
+      await (await getStorage()).removeItem(MANIFEST_KEY);
     }
   }
 
@@ -162,7 +171,7 @@ export class OfflineQueue {
       const ids = await this.getManifest();
 
       for (const id of ids) {
-        const raw = await AsyncStorage.getItem(`${ITEM_PREFIX}${id}`);
+        const raw = await (await getStorage()).getItem(`${ITEM_PREFIX}${id}`);
         if (!raw) continue;
 
         let item: QueueItem;
@@ -170,14 +179,14 @@ export class OfflineQueue {
           item = JSON.parse(raw);
         } catch {
           // Remove corrupt item
-          await AsyncStorage.removeItem(`${ITEM_PREFIX}${id}`);
+          await (await getStorage()).removeItem(`${ITEM_PREFIX}${id}`);
           continue;
         }
 
         try {
           const result = await this.client.verify(item.request, { idempotencyKey: item.id });
           processed++;
-          await AsyncStorage.removeItem(`${ITEM_PREFIX}${id}`);
+          await (await getStorage()).removeItem(`${ITEM_PREFIX}${id}`);
           onResult?.(item.id, result);
         } catch (err) {
           const requestError = err instanceof VerifyAIRequestError ? err : null;
@@ -185,11 +194,11 @@ export class OfflineQueue {
 
           item.retryCount++;
           if (shouldRetry && item.retryCount < maxRetries) {
-            await AsyncStorage.setItem(`${ITEM_PREFIX}${id}`, JSON.stringify(item));
+            await (await getStorage()).setItem(`${ITEM_PREFIX}${id}`, JSON.stringify(item));
             remainingIds.push(id);
           } else {
             failed++;
-            await AsyncStorage.removeItem(`${ITEM_PREFIX}${id}`);
+            await (await getStorage()).removeItem(`${ITEM_PREFIX}${id}`);
           }
         }
       }

package/src/telemetry/TelemetryReporter.ts

@@ -7,6 +7,7 @@ interface TelemetryEvent {
   error_message?: string;
   error_stack?: string;
   error_code?: string;
+  metadata?: Record<string, string | number>;
   sdk_platform: string;
   sdk_version: string;
   os_name: string;
@@ -51,6 +52,7 @@ export class TelemetryReporter {
       component?: string;
       error?: unknown;
       errorCode?: string;
+      metadata?: Record<string, string | number>;
     } = {},
   ): void {
     if (this.disposed) return;
@@ -80,6 +82,7 @@ export class TelemetryReporter {
         error_message: errorMessage?.slice(0, 1000),
         error_stack: errorObj?.stack?.slice(0, 2000),
         error_code: opts.errorCode,
+        metadata: opts.metadata,
         sdk_platform: Platform.OS,
         sdk_version: SDK_VERSION,
         os_name: Platform.OS,

package/src/version.ts

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