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

package/lib/components/VerifyAIScanner.js

@@ -20,8 +20,12 @@ const CAMERA_INIT_ERROR_CODE = 'ERR_CAMERA_INIT_FAILED';
 const DEFAULT_TERMINAL_RESULT_DISPLAY_MS = 3000;
 const TRANSIENT_ERROR_DISPLAY_MS = 3000;
 const CAMERA_CAPTURE_RETRY_DELAY_MS = 350;
-const IOS_CAMERA_STARTUP_WATCHDOG_MS = 5000;
-const ANDROID_CAMERA_STARTUP_WATCHDOG_MS = 5000;
+const IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 3000;
+const ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 10000;
+const IOS_CAMERA_STARTUP_WATCHDOG_MS = 8000;
+const ANDROID_CAMERA_STARTUP_WATCHDOG_MS = 10000;
+const CAMERA_STARTUP_SLOW_TELEMETRY_MS = 3000;
+const CAMERA_STARTUP_REMOUNT_BACKOFF_MS = 350;
 const CAMERA_STARTUP_WATCHDOG_MAX_REMOUNTS = 5;
 const ANDROID_ORIENTATION_NO_EVENT_TIMEOUT_MS = 3000;
 const ANDROID_ORIENTATION_SAMPLE_TELEMETRY_MS = 3000;
@@ -205,6 +209,7 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
     const [currentAppState, setCurrentAppState] = useState(AppState.currentState);
     const [cameraReady, setCameraReady] = useState(false);
     const [cameraKey, setCameraKey] = useState(0);
+    const [cameraMounted, setCameraMounted] = useState(true);
     const terminalResultRef = useRef(null);
     const terminalResultTimerRef = useRef(null);
     const terminalResultDeliveredRef = useRef(false);
@@ -217,6 +222,11 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
     const lastAppStateRemountAtRef = useRef(null);
     const lastOrientationRemountAtRef = useRef(null);
     const lastCaptureRetryAtRef = useRef(null);
+    const cameraStartupStartedAtRef = useRef(Date.now());
+    const cameraStartupAttemptStartedAtRef = useRef(cameraStartupStartedAtRef.current);
+    const cameraStartupSlowTrackedRef = useRef(false);
+    const cameraStartupReadyTrackedRef = useRef(false);
+    const startupRemountTimerRef = useRef(null);
     const cameraRemountCountRef = useRef(0);
     const startupWatchdogRemountCountRef = useRef(0);
     const telemetryRef = useRef(telemetry);
@@ -258,7 +268,10 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
         camera_ever_ready: cameraEverReadyRef.current,
         camera_init_failed: cameraInitFailedRef.current,
         camera_key: cameraKey,
+        camera_mounted: cameraMounted ? 1 : 0,
         camera_remount_count: cameraRemountCountRef.current,
+        camera_startup_total_elapsed_ms: Date.now() - cameraStartupStartedAtRef.current,
+        camera_startup_attempt_elapsed_ms: Date.now() - cameraStartupAttemptStartedAtRef.current,
         terminated,
         exhausted,
         app_state: appStateRef.current,
@@ -276,6 +289,7 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
         last_appstate_remount_at: lastAppStateRemountAtRef.current,
         last_orientation_remount_at: lastOrientationRemountAtRef.current,
         last_capture_retry_at: lastCaptureRetryAtRef.current,
+        requested_torch_enabled: enableTorch ? 1 : 0,
         android_native_orientation_subscription_active: 0,
         android_native_orientation_event_count: 0,
         android_native_orientation_change_count: 0,
@@ -312,7 +326,9 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
         ...extra,
     }), [
         cameraKey,
+        cameraMounted,
         exhausted,
+        enableTorch,
         isLandscape,
         overlayRotationDeg,
         physicalOrientation,
@@ -356,6 +372,37 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
             void activeTelemetry?.flush();
         };
     }, []);
+    const requestCameraRemount = useCallback((reason, opts = {}) => {
+        if (startupRemountTimerRef.current) {
+            clearTimeout(startupRemountTimerRef.current);
+            startupRemountTimerRef.current = null;
+        }
+        setCameraReady(false);
+        cameraReadyRef.current = false;
+        cameraStartupAttemptStartedAtRef.current = Date.now();
+        if (opts.log) {
+            console.warn(`VerifyAI[${SDK_VERSION}]: remounting camera reason=${reason} ` +
+                `backoffMs=${opts.backoffMs ?? 0} torchRequested=${enableTorch ? 1 : 0}`);
+        }
+        const remount = () => {
+            setCameraKey((k) => k + 1);
+            setCameraMounted(true);
+            startupRemountTimerRef.current = null;
+        };
+        if ((opts.backoffMs ?? 0) > 0) {
+            setCameraMounted(false);
+            startupRemountTimerRef.current = setTimeout(remount, opts.backoffMs);
+            return;
+        }
+        setCameraMounted(true);
+        remount();
+    }, [enableTorch]);
+    useEffect(() => () => {
+        if (startupRemountTimerRef.current) {
+            clearTimeout(startupRemountTimerRef.current);
+            startupRemountTimerRef.current = null;
+        }
+    }, []);
     useEffect(() => {
         if (Platform.OS !== 'android')
             return;
@@ -572,16 +619,9 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                     to: windowWidth > windowHeight ? 'landscape' : 'portrait',
                 },
             });
-            setCameraReady(false);
-            cameraReadyRef.current = false;
-            // Delay remount so iOS rotation animation completes before the new
-            // AVCaptureVideoPreviewLayer initializes with the final frame bounds.
-            const timer = setTimeout(() => {
-                setCameraKey((k) => k + 1);
-            }, 400);
-            return () => clearTimeout(timer);
+            requestCameraRemount('orientation_change', { backoffMs: 400 });
         }
-    }, [windowWidth, windowHeight, terminated, buildScannerTelemetryMetadata, telemetry]);
+    }, [windowWidth, windowHeight, terminated, buildScannerTelemetryMetadata, requestCameraRemount, telemetry]);
     // Resume camera when app returns from background/inactive (e.g. notification bar)
     useEffect(() => {
         if (terminated)
@@ -609,12 +649,10 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                     remount_requested_at: at,
                 }),
             });
-            setCameraReady(false);
-            cameraReadyRef.current = false;
-            setCameraKey((k) => k + 1);
+            requestCameraRemount('appstate_active');
         });
         return () => subscription.remove();
-    }, [terminated, buildScannerTelemetryMetadata, telemetry]);
+    }, [terminated, buildScannerTelemetryMetadata, requestCameraRemount, telemetry]);
     const pausePreview = useCallback(() => {
         cameraRef.current?.pausePreview?.().catch(() => { });
     }, []);
@@ -668,13 +706,34 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
     }, [onClose, result]);
     // Camera init callbacks
     const onCameraReady = useCallback(() => {
-        lastCameraReadyAtRef.current = new Date().toISOString();
+        const readyAt = new Date().toISOString();
+        const startupTotalElapsedMs = Date.now() - cameraStartupStartedAtRef.current;
+        const startupAttemptElapsedMs = Date.now() - cameraStartupAttemptStartedAtRef.current;
+        lastCameraReadyAtRef.current = readyAt;
         setCameraReady(true);
         cameraReadyRef.current = true;
         cameraEverReadyRef.current = true;
         cameraInitFailedRef.current = false;
         startupWatchdogRemountCountRef.current = 0;
-    }, []);
+        if (!cameraStartupReadyTrackedRef.current) {
+            cameraStartupReadyTrackedRef.current = true;
+            console.log(`VerifyAI[${SDK_VERSION}]: camera ready ` +
+                `startupTotalMs=${startupTotalElapsedMs} ` +
+                `startupAttemptMs=${startupAttemptElapsedMs} ` +
+                `torchRequested=${enableTorch ? 1 : 0}`);
+            telemetry?.track('camera_ready', {
+                component: 'scanner',
+                error: 'camera_ready',
+                metadata: buildScannerTelemetryMetadata({
+                    camera_ready_at: readyAt,
+                    startup_total_elapsed_ms: startupTotalElapsedMs,
+                    startup_attempt_elapsed_ms: startupAttemptElapsedMs,
+                    startup_watchdog_remount_count: startupWatchdogRemountCountRef.current,
+                    torch_deferred_until_ready: enableTorch ? 1 : 0,
+                }),
+            });
+        }
+    }, [buildScannerTelemetryMetadata, enableTorch, telemetry]);
     const onMountError = useCallback((event) => {
         const error = new Error(event.message || 'Camera mount error');
         error.code = CAMERA_INIT_ERROR_CODE;
@@ -695,12 +754,58 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
             }),
         });
     }, [buildScannerTelemetryMetadata, onError, telemetry]);
+    useEffect(() => {
+        if (!permission?.granted ||
+            terminated ||
+            currentAppState !== 'active' ||
+            !cameraMounted ||
+            cameraReadyRef.current ||
+            cameraInitFailedRef.current ||
+            cameraStartupSlowTrackedRef.current) {
+            return;
+        }
+        const timer = setTimeout(() => {
+            if (appStateRef.current !== 'active' ||
+                cameraReadyRef.current ||
+                cameraInitFailedRef.current ||
+                cameraStartupSlowTrackedRef.current) {
+                return;
+            }
+            cameraStartupSlowTrackedRef.current = true;
+            const startupTotalElapsedMs = Date.now() - cameraStartupStartedAtRef.current;
+            const startupAttemptElapsedMs = Date.now() - cameraStartupAttemptStartedAtRef.current;
+            console.warn(`VerifyAI[${SDK_VERSION}]: camera startup slow ` +
+                `startupTotalMs=${startupTotalElapsedMs} ` +
+                `startupAttemptMs=${startupAttemptElapsedMs} ` +
+                `torchRequested=${enableTorch ? 1 : 0}`);
+            telemetry?.track('camera_startup_slow', {
+                component: 'scanner',
+                error: 'camera_startup_slow',
+                metadata: buildScannerTelemetryMetadata({
+                    startup_slow_threshold_ms: CAMERA_STARTUP_SLOW_TELEMETRY_MS,
+                    startup_total_elapsed_ms: startupTotalElapsedMs,
+                    startup_attempt_elapsed_ms: startupAttemptElapsedMs,
+                    startup_watchdog_remount_count: startupWatchdogRemountCountRef.current,
+                    torch_deferred_until_ready: enableTorch ? 1 : 0,
+                }),
+            });
+        }, CAMERA_STARTUP_SLOW_TELEMETRY_MS);
+        return () => clearTimeout(timer);
+    }, [
+        permission?.granted,
+        terminated,
+        currentAppState,
+        cameraMounted,
+        buildScannerTelemetryMetadata,
+        enableTorch,
+        telemetry,
+    ]);
     // Startup watchdog — if camera hasn't fired onCameraReady in time, force remount.
     // On iOS the native AVCaptureSession sometimes fails to start its preview layer on first
     // mount (e.g. during navigation transitions). Changing the key forces React to destroy and
     // recreate the CameraView, which starts a fresh native session.
     useEffect(() => {
-        if (!permission?.granted || terminated || currentAppState !== 'active')
+        if (!permission?.granted || terminated || currentAppState !== 'active' || !cameraMounted)
             return;
         const watchdogMs = Platform.OS === 'android'
             ? ANDROID_CAMERA_STARTUP_WATCHDOG_MS
@@ -732,11 +837,14 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                             remount_reason: 'startup_watchdog',
                             startup_watchdog_remount_count: startupWatchdogRemountCount,
                             startup_watchdog_max_remounts: CAMERA_STARTUP_WATCHDOG_MAX_REMOUNTS,
+                            startup_remount_backoff_ms: CAMERA_STARTUP_REMOUNT_BACKOFF_MS,
+                            torch_deferred_until_ready: enableTorch ? 1 : 0,
                         }),
                     });
-                    setCameraReady(false);
-                    cameraReadyRef.current = false;
-                    setCameraKey((k) => k + 1);
+                    requestCameraRemount('startup_watchdog', {
+                        backoffMs: CAMERA_STARTUP_REMOUNT_BACKOFF_MS,
+                        log: true,
+                    });
                 }
             }
         }, watchdogMs);
@@ -745,9 +853,12 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
         permission?.granted,
         terminated,
         currentAppState,
+        cameraMounted,
         cameraKey,
         buildScannerTelemetryMetadata,
+        enableTorch,
         onMountError,
+        requestCameraRemount,
         telemetry,
     ]);
     // Track permission denied
@@ -880,11 +991,12 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                             const retryAt = new Date().toISOString();
                             lastCaptureRetryAtRef.current = retryAt;
                             cameraRemountCountRef.current++;
-                            setCameraReady(false);
-                            cameraReadyRef.current = false;
-                            setCameraKey((key) => key + 1);
+                            requestCameraRemount('capture_retry');
                             await sleep(CAMERA_CAPTURE_RETRY_DELAY_MS);
-                            captureRetryReady = await waitForCameraReady(2500);
+                            const captureRetryReadyTimeoutMs = Platform.OS === 'android'
+                                ? ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS
+                                : IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS;
+                            captureRetryReady = await waitForCameraReady(captureRetryReadyTimeoutMs);
                             telemetry?.track('camera_capture_retry', {
                                 component: 'scanner',
                                 error: normalized,
@@ -894,7 +1006,7 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                                     capture_retry_attempted: captureRetryAttempted,
                                     capture_retry_ready: captureRetryReady,
                                     capture_retry_delay_ms: CAMERA_CAPTURE_RETRY_DELAY_MS,
-                                    capture_retry_ready_timeout_ms: 2500,
+                                    capture_retry_ready_timeout_ms: captureRetryReadyTimeoutMs,
                                     last_native_capture_error: lastNativeCaptureErrorMessage,
                                 }),
                             });
@@ -1051,7 +1163,7 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                 setTimeout(() => setStatus('idle'), TRANSIENT_ERROR_DISPLAY_MS);
             }
         }
-    }, [status, exhausted, onCapture, onError, overlay?.maxAttempts, overlay?.autoApproveOnExhaust, releaseCamera, scheduleTerminalResult, buildScannerTelemetryMetadata, telemetry, terminated, physicalOrientation, overlayRotationDeg]);
+    }, [status, exhausted, onCapture, onError, overlay?.maxAttempts, overlay?.autoApproveOnExhaust, releaseCamera, scheduleTerminalResult, buildScannerTelemetryMetadata, requestCameraRemount, telemetry, terminated, physicalOrientation, overlayRotationDeg]);
     // Expose capture to parent via ref
     if (captureRef) {
         captureRef.current = handleCapture;
@@ -1063,7 +1175,8 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
         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, responsiveOrientationWhenOrientationLocked: true, onResponsiveOrientationChanged: (event) => {
+    const shouldEnableTorch = !terminated && cameraReady && !!enableTorch;
+    return (_jsx(View, { style: [styles.container, style], children: cameraMounted && (_jsx(CameraView, { ref: cameraRef, style: styles.camera, facing: "back", enableTorch: shouldEnableTorch, onCameraReady: onCameraReady, onMountError: onMountError, responsiveOrientationWhenOrientationLocked: true, onResponsiveOrientationChanged: (event) => {
                 setPhysicalOrientation(event.orientation);
             }, children: _jsxs(View, { style: styles.overlay, children: [overlay?.title && (_jsx(View, { style: [styles.topBar, isLandscape && styles.topBarLandscape], children: _jsx(Text, { style: [
                                 styles.titleText,
@@ -1134,7 +1247,7 @@ export function VerifyAIScanner({ onCapture, policy, onResult, onError, onClose,
                                                 overlay?.theme?.captureButtonColor ? { borderColor: overlay.theme.captureButtonColor } : undefined,
                                                 (!cameraReady || status === 'capturing' || status === 'processing') &&
                                                     styles.captureButtonDisabled,
-                                            ], onPress: handleCapture, disabled: !cameraReady || status === 'capturing' || status === 'processing', activeOpacity: 0.7, children: _jsx(View, { style: [styles.captureButtonInner, overlay?.theme?.captureButtonColor ? { backgroundColor: overlay.theme.captureButtonColor } : undefined] }) }) }))] }))] }), showCloseButton && onClose && (_jsx(TouchableOpacity, { accessibilityRole: "button", accessibilityLabel: "Close scanner", style: styles.closeButton, onPress: handleClose, children: _jsx(Text, { style: styles.closeButtonText, children: "X" }) }))] }) }, cameraKey) }));
+                                            ], onPress: handleCapture, disabled: !cameraReady || status === 'capturing' || status === 'processing', activeOpacity: 0.7, children: _jsx(View, { style: [styles.captureButtonInner, overlay?.theme?.captureButtonColor ? { backgroundColor: overlay.theme.captureButtonColor } : undefined] }) }) }))] }))] }), showCloseButton && onClose && (_jsx(TouchableOpacity, { accessibilityRole: "button", accessibilityLabel: "Close scanner", style: styles.closeButton, onPress: handleClose, children: _jsx(Text, { style: styles.closeButtonText, children: "X" }) }))] }) }, cameraKey)) }));
 }
 const CORNER_SIZE = 30;
 const CORNER_THICKNESS = 3;

package/lib/ml/featureExtractor.d.ts

@@ -6,7 +6,7 @@ import type { FeatureVector } from './types';
 /** Ontology class name mapping (must match ontology.ts) */
 export declare const ONTOLOGY_CLASS_NAMES: Record<number, string>;
 /** Detection model class index -> ontology class ID mapping. */
-export declare const MODEL_OUTPUT_CLASS_IDS: readonly [1, 2, 3, 4, 5, 20, 21, 22, 23, 24, 40, 41, 42, 43, 44, 45, 46, 47, 48, 60, 61, 62, 63, 64, 65, 66, 80, 81, 82, 83, 84, 85, 86, 87];
+export declare const MODEL_OUTPUT_CLASS_IDS: readonly [1, 2, 3, 4, 5, 6, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 60, 61, 62, 63, 64, 65, 66, 80, 81, 82, 83, 84, 85, 86, 87];
 interface RawDetection {
     classId: number;
     confidence: number;

package/lib/ml/featureExtractor.js

@@ -2,15 +2,22 @@
  * Feature extractor — converts raw detections into a structured FeatureVector.
  * Must produce identical output to the Dart and server TypeScript implementations.
  */
-const SCHEMA_VERSION = '1.0.0';
+const SCHEMA_VERSION = '2.0.0';
 /** Vehicle class IDs (must match ontology.ts) */
-const VEHICLE_CLASS_IDS = new Set([1, 2, 3, 4, 5]);
+const VEHICLE_CLASS_IDS = new Set([1, 2, 3, 4, 5, 6]);
 /** Surface class IDs */
 const SURFACE_CLASS_IDS = new Set([60, 61, 62, 63, 64, 65, 66]);
 /** Ontology class name mapping (must match ontology.ts) */
 export const ONTOLOGY_CLASS_NAMES = {
-    1: 'scooter', 2: 'bicycle', 3: 'ebike', 4: 'moped', 5: 'motorcycle',
+    1: 'scooter', 2: 'bicycle', 3: 'ebike', 4: 'moped', 5: 'motorcycle', 6: 'car',
     20: 'kickstand', 21: 'handlebar', 22: 'wheel', 23: 'saddle', 24: 'basket',
+    // Car panels (ontology v2 — damage intelligence)
+    25: 'car_hood', 26: 'car_roof', 27: 'car_trunk',
+    28: 'car_front_bumper', 29: 'car_rear_bumper',
+    30: 'car_door_fl', 31: 'car_door_fr', 32: 'car_door_rl', 33: 'car_door_rr',
+    34: 'car_fender_fl', 35: 'car_fender_fr',
+    36: 'car_quarter_rl', 37: 'car_quarter_rr',
+    38: 'car_rocker', 39: 'car_mirror',
     40: 'bike_rack', 41: 'curb', 42: 'parking_bay', 43: 'green_bay',
     44: 'tactile_paving', 45: 'bollard', 46: 'fence', 47: 'pole', 48: 'yellow_lines',
     60: 'sidewalk', 61: 'road', 62: 'grass', 63: 'crosswalk',
@@ -20,8 +27,9 @@ export const ONTOLOGY_CLASS_NAMES = {
 };
 /** Detection model class index -> ontology class ID mapping. */
 export const MODEL_OUTPUT_CLASS_IDS = [
-    1, 2, 3, 4, 5,
+    1, 2, 3, 4, 5, 6,
     20, 21, 22, 23, 24,
+    25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39,
     40, 41, 42, 43, 44, 45, 46, 47, 48,
     60, 61, 62, 63, 64, 65, 66,
     80, 81, 82, 83, 84, 85, 86, 87,

package/lib/ml/modelManager.d.ts

@@ -15,8 +15,21 @@ export declare class ModelManager {
     private _currentBundle;
     constructor(config: ModelManagerConfig);
     get currentBundle(): BundleManifest | null;
-    /** Check for bundle updates from the server. */
-    checkForUpdates(policyId: string, platform: 'ios' | 'android'): Promise<BundleManifest | null>;
+    /**
+     * Check for bundle updates from the server.
+     *
+     * `opts` lets callers narrow which bundle they receive when the server
+     * has per-asset / per-region / per-app-version targeted bundles
+     * configured (see `app/api/v1/models/latest`). All fields are optional;
+     * omitting them keeps the legacy behaviour of receiving the wildcard
+     * bundle for the policy.
+     */
+    checkForUpdates(policyId: string, platform: 'ios' | 'android', opts?: {
+        assetType?: string;
+        region?: string;
+        appVersion?: string;
+        deviceId?: string;
+    }): Promise<BundleManifest | null>;
     /** Download model artifacts and verify integrity. */
     private downloadArtifacts;
     private readFileSha256;

package/lib/ml/modelManager.js

@@ -26,8 +26,16 @@ export class ModelManager {
     get currentBundle() {
         return this._currentBundle;
     }
-    /** Check for bundle updates from the server. */
-    async checkForUpdates(policyId, platform) {
+    /**
+     * Check for bundle updates from the server.
+     *
+     * `opts` lets callers narrow which bundle they receive when the server
+     * has per-asset / per-region / per-app-version targeted bundles
+     * configured (see `app/api/v1/models/latest`). All fields are optional;
+     * omitting them keeps the legacy behaviour of receiving the wildcard
+     * bundle for the policy.
+     */
+    async checkForUpdates(policyId, platform, opts) {
         try {
             const headers = {
                 'X-API-Key': this.apiKey,
@@ -36,7 +44,16 @@ export class ModelManager {
             if (this.cachedETag) {
                 headers['If-None-Match'] = this.cachedETag;
             }
-            const url = `${this.baseUrl}/models/latest?policy=${policyId}&platform=${platform}`;
+            const qs = new URLSearchParams({ policy: policyId, platform });
+            if (opts?.assetType)
+                qs.set('asset_type', opts.assetType);
+            if (opts?.region)
+                qs.set('region', opts.region);
+            if (opts?.appVersion)
+                qs.set('app_version', opts.appVersion);
+            if (opts?.deviceId)
+                qs.set('device_id', opts.deviceId);
+            const url = `${this.baseUrl}/models/latest?${qs.toString()}`;
             const response = await fetch(url, { headers });
             if (response.status === 304) {
                 return this._currentBundle;

package/lib/ml/policyEngine.js

@@ -5,6 +5,24 @@
  * This file shares the same logic as lib/verify-ai/ml/policy-engine.ts
  * but is self-contained for the SDK package.
  */
+// Severity ordering for `severity_gte`. Must match server TS + Dart impls.
+const SEVERITY_ORDER = ['none', 'light', 'medium', 'severe'];
+function severityRank(s) {
+    if (typeof s !== 'string')
+        return -1;
+    return SEVERITY_ORDER.indexOf(s);
+}
+function compareNumber(a, op, b) {
+    switch (op) {
+        case 'eq': return a === b;
+        case 'neq': return a !== b;
+        case 'gt': return a > b;
+        case 'gte': return a >= b;
+        case 'lt': return a < b;
+        case 'lte': return a <= b;
+        default: return false;
+    }
+}
 // ─── Field Resolution ───
 function resolveField(features, field) {
     const parts = field.split('.');
@@ -67,9 +85,62 @@ function applyOperator(fieldValue, operator, value) {
     }
 }
 function evaluateCondition(features, condition) {
+    if (condition.operator === 'severity_gte' ||
+        condition.operator === 'panel_has_damage' ||
+        condition.operator === 'aggregate_count') {
+        return applyDamageOperator(features, condition);
+    }
     const fieldValue = resolveField(features, condition.field);
     return applyOperator(fieldValue, condition.operator, condition.value);
 }
+function applyDamageOperator(features, condition) {
+    const findings = Array.isArray(features.damage_findings)
+        ? features.damage_findings
+        : [];
+    switch (condition.operator) {
+        case 'severity_gte': {
+            const minRank = severityRank(condition.value);
+            if (minRank < 0)
+                return false;
+            if (condition.field && condition.field !== 'damage_findings') {
+                const f = resolveField(features, condition.field);
+                return severityRank(f) >= minRank;
+            }
+            return findings.some((finding) => severityRank(finding.severity) >= minRank);
+        }
+        case 'panel_has_damage': {
+            const panelName = typeof condition.value === 'string'
+                ? condition.value
+                : typeof condition.field === 'string' &&
+                    condition.field !== 'damage_findings' &&
+                    condition.field !== ''
+                    ? condition.field
+                    : null;
+            if (!panelName)
+                return false;
+            return findings.some((finding) => finding.panel === panelName && finding.severity !== 'none');
+        }
+        case 'aggregate_count': {
+            const v = condition.value;
+            if (!v || typeof v !== 'object' || typeof v.value !== 'number' || !v.op)
+                return false;
+            const where = v.where || {};
+            const minSeverityRank = where.severity_gte !== undefined ? severityRank(where.severity_gte) : -1;
+            const count = findings.filter((finding) => {
+                if (where.panel && finding.panel !== where.panel)
+                    return false;
+                if (where.damage_type && finding.damage_type !== where.damage_type)
+                    return false;
+                if (minSeverityRank >= 0 && severityRank(finding.severity) < minSeverityRank)
+                    return false;
+                return true;
+            }).length;
+            return compareNumber(count, v.op, v.value);
+        }
+        default:
+            return false;
+    }
+}
 function evaluateRule(features, rule) {
     const passed = rule.conditions.every((c) => evaluateCondition(features, c));
     return {

package/lib/ml/types.d.ts

@@ -32,6 +32,18 @@ export interface ImageQuality {
     is_dark: boolean;
     has_vehicle: boolean;
 }
+export type DamageSeverity = 'none' | 'light' | 'medium' | 'severe';
+export type DamageType = 'scratch' | 'dent' | 'paint_chip' | 'crack' | 'broken' | 'missing' | 'rust' | 'tear' | 'stain' | 'glass_damage' | 'other';
+export interface DamageFinding {
+    finding_id: string;
+    panel: string;
+    damage_type: DamageType;
+    severity: DamageSeverity;
+    severity_score: number;
+    bbox: [number, number, number, number];
+    area_pct: number;
+    confidence: number;
+}
 export interface FeatureVector {
     schema_version: string;
     detections: Detection[];
@@ -39,8 +51,12 @@ export interface FeatureVector {
     image_quality: ImageQuality;
     vehicle_on_surface: string | null;
     vehicle_near: string[];
+    /** Damage observations (schema v2). Defaults to [] when damage mode disabled. */
+    damage_findings?: DamageFinding[];
+    /** Panels visible in this frame (schema v2). */
+    panel_inventory?: string[];
 }
-export type ComparisonOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'not_contains' | 'exists' | 'not_exists' | 'in' | 'not_in' | 'overlaps';
+export type ComparisonOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'not_contains' | 'exists' | 'not_exists' | 'in' | 'not_in' | 'overlaps' | 'severity_gte' | 'panel_has_damage' | 'aggregate_count';
 export interface Condition {
     field: string;
     operator: ComparisonOperator;

package/lib/telemetry/TelemetryReporter.js

@@ -13,6 +13,7 @@ const TELEMETRY_PERSIST_KEY = '@verifyai/telemetry_buffer';
 const CRITICAL_EVENTS = new Set([
     'camera_init_failure',
     'camera_preview_timeout',
+    'camera_startup_slow',
     'camera_permission_denied',
     'camera_scanner_mounted',
     'camera_scanner_disposed',

package/lib/version.d.ts

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

package/lib/version.js

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

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@switchlabs/verify-ai-react-native",
-  "version": "2.4.23",
+  "version": "2.5.1",
   "description": "React Native SDK for Verify AI - photo verification with AI vision processing",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/levyelectric/verify.git",
+    "directory": "packages/verify-ai-react-native"
+  },
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
   "exports": {

package/src/components/VerifyAIScanner.tsx

@@ -45,8 +45,12 @@ const CAMERA_INIT_ERROR_CODE = 'ERR_CAMERA_INIT_FAILED';
 const DEFAULT_TERMINAL_RESULT_DISPLAY_MS = 3000;
 const TRANSIENT_ERROR_DISPLAY_MS = 3000;
 const CAMERA_CAPTURE_RETRY_DELAY_MS = 350;
-const IOS_CAMERA_STARTUP_WATCHDOG_MS = 5000;
-const ANDROID_CAMERA_STARTUP_WATCHDOG_MS = 5000;
+const IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 3000;
+const ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS = 10000;
+const IOS_CAMERA_STARTUP_WATCHDOG_MS = 8000;
+const ANDROID_CAMERA_STARTUP_WATCHDOG_MS = 10000;
+const CAMERA_STARTUP_SLOW_TELEMETRY_MS = 3000;
+const CAMERA_STARTUP_REMOUNT_BACKOFF_MS = 350;
 const CAMERA_STARTUP_WATCHDOG_MAX_REMOUNTS = 5;
 const ANDROID_ORIENTATION_NO_EVENT_TIMEOUT_MS = 3000;
 const ANDROID_ORIENTATION_SAMPLE_TELEMETRY_MS = 3000;
@@ -307,6 +311,7 @@ export function VerifyAIScanner({
   const [currentAppState, setCurrentAppState] = useState(AppState.currentState);
   const [cameraReady, setCameraReady] = useState(false);
   const [cameraKey, setCameraKey] = useState(0);
+  const [cameraMounted, setCameraMounted] = useState(true);
   const terminalResultRef = useRef<VerificationResult | null>(null);
   const terminalResultTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const terminalResultDeliveredRef = useRef(false);
@@ -319,6 +324,11 @@ export function VerifyAIScanner({
   const lastAppStateRemountAtRef = useRef<string | null>(null);
   const lastOrientationRemountAtRef = useRef<string | null>(null);
   const lastCaptureRetryAtRef = useRef<string | null>(null);
+  const cameraStartupStartedAtRef = useRef(Date.now());
+  const cameraStartupAttemptStartedAtRef = useRef(cameraStartupStartedAtRef.current);
+  const cameraStartupSlowTrackedRef = useRef(false);
+  const cameraStartupReadyTrackedRef = useRef(false);
+  const startupRemountTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const cameraRemountCountRef = useRef(0);
   const startupWatchdogRemountCountRef = useRef(0);
   const telemetryRef = useRef<TelemetryReporter | null | undefined>(telemetry);
@@ -369,7 +379,10 @@ export function VerifyAIScanner({
     camera_ever_ready: cameraEverReadyRef.current,
     camera_init_failed: cameraInitFailedRef.current,
     camera_key: cameraKey,
+    camera_mounted: cameraMounted ? 1 : 0,
     camera_remount_count: cameraRemountCountRef.current,
+    camera_startup_total_elapsed_ms: Date.now() - cameraStartupStartedAtRef.current,
+    camera_startup_attempt_elapsed_ms: Date.now() - cameraStartupAttemptStartedAtRef.current,
     terminated,
     exhausted,
     app_state: appStateRef.current,
@@ -387,6 +400,7 @@ export function VerifyAIScanner({
     last_appstate_remount_at: lastAppStateRemountAtRef.current,
     last_orientation_remount_at: lastOrientationRemountAtRef.current,
     last_capture_retry_at: lastCaptureRetryAtRef.current,
+    requested_torch_enabled: enableTorch ? 1 : 0,
     android_native_orientation_subscription_active: 0,
     android_native_orientation_event_count: 0,
     android_native_orientation_change_count: 0,
@@ -423,7 +437,9 @@ export function VerifyAIScanner({
     ...extra,
   }), [
     cameraKey,
+    cameraMounted,
     exhausted,
+    enableTorch,
     isLandscape,
     overlayRotationDeg,
     physicalOrientation,
@@ -474,6 +490,52 @@ export function VerifyAIScanner({
     };
   }, []);
 
+  const requestCameraRemount = useCallback((
+    reason: string,
+    opts: {
+      backoffMs?: number;
+      log?: boolean;
+    } = {},
+  ) => {
+    if (startupRemountTimerRef.current) {
+      clearTimeout(startupRemountTimerRef.current);
+      startupRemountTimerRef.current = null;
+    }
+
+    setCameraReady(false);
+    cameraReadyRef.current = false;
+    cameraStartupAttemptStartedAtRef.current = Date.now();
+
+    if (opts.log) {
+      console.warn(
+        `VerifyAI[${SDK_VERSION}]: remounting camera reason=${reason} ` +
+          `backoffMs=${opts.backoffMs ?? 0} torchRequested=${enableTorch ? 1 : 0}`,
+      );
+    }
+
+    const remount = () => {
+      setCameraKey((k) => k + 1);
+      setCameraMounted(true);
+      startupRemountTimerRef.current = null;
+    };
+
+    if ((opts.backoffMs ?? 0) > 0) {
+      setCameraMounted(false);
+      startupRemountTimerRef.current = setTimeout(remount, opts.backoffMs);
+      return;
+    }
+
+    setCameraMounted(true);
+    remount();
+  }, [enableTorch]);
+
+  useEffect(() => () => {
+    if (startupRemountTimerRef.current) {
+      clearTimeout(startupRemountTimerRef.current);
+      startupRemountTimerRef.current = null;
+    }
+  }, []);
+
   useEffect(() => {
     if (Platform.OS !== 'android') return;
 
@@ -726,17 +788,9 @@ export function VerifyAIScanner({
           to: windowWidth > windowHeight ? 'landscape' : 'portrait',
         },
       });
-      setCameraReady(false);
-      cameraReadyRef.current = false;
-
-      // Delay remount so iOS rotation animation completes before the new
-      // AVCaptureVideoPreviewLayer initializes with the final frame bounds.
-      const timer = setTimeout(() => {
-        setCameraKey((k) => k + 1);
-      }, 400);
-      return () => clearTimeout(timer);
+      requestCameraRemount('orientation_change', { backoffMs: 400 });
     }
-  }, [windowWidth, windowHeight, terminated, buildScannerTelemetryMetadata, telemetry]);
+  }, [windowWidth, windowHeight, terminated, buildScannerTelemetryMetadata, requestCameraRemount, telemetry]);
 
   // Resume camera when app returns from background/inactive (e.g. notification bar)
   useEffect(() => {
@@ -767,13 +821,11 @@ export function VerifyAIScanner({
           remount_requested_at: at,
         }),
       });
-      setCameraReady(false);
-      cameraReadyRef.current = false;
-      setCameraKey((k) => k + 1);
+      requestCameraRemount('appstate_active');
     });
 
     return () => subscription.remove();
-  }, [terminated, buildScannerTelemetryMetadata, telemetry]);
+  }, [terminated, buildScannerTelemetryMetadata, requestCameraRemount, telemetry]);
 
   const pausePreview = useCallback(() => {
     cameraRef.current?.pausePreview?.().catch(() => {});
@@ -834,13 +886,36 @@ export function VerifyAIScanner({
 
   // Camera init callbacks
   const onCameraReady = useCallback(() => {
-    lastCameraReadyAtRef.current = new Date().toISOString();
+    const readyAt = new Date().toISOString();
+    const startupTotalElapsedMs = Date.now() - cameraStartupStartedAtRef.current;
+    const startupAttemptElapsedMs = Date.now() - cameraStartupAttemptStartedAtRef.current;
+    lastCameraReadyAtRef.current = readyAt;
     setCameraReady(true);
     cameraReadyRef.current = true;
     cameraEverReadyRef.current = true;
     cameraInitFailedRef.current = false;
     startupWatchdogRemountCountRef.current = 0;
-  }, []);
+    if (!cameraStartupReadyTrackedRef.current) {
+      cameraStartupReadyTrackedRef.current = true;
+      console.log(
+        `VerifyAI[${SDK_VERSION}]: camera ready ` +
+          `startupTotalMs=${startupTotalElapsedMs} ` +
+          `startupAttemptMs=${startupAttemptElapsedMs} ` +
+          `torchRequested=${enableTorch ? 1 : 0}`,
+      );
+      telemetry?.track('camera_ready', {
+        component: 'scanner',
+        error: 'camera_ready',
+        metadata: buildScannerTelemetryMetadata({
+          camera_ready_at: readyAt,
+          startup_total_elapsed_ms: startupTotalElapsedMs,
+          startup_attempt_elapsed_ms: startupAttemptElapsedMs,
+          startup_watchdog_remount_count: startupWatchdogRemountCountRef.current,
+          torch_deferred_until_ready: enableTorch ? 1 : 0,
+        }),
+      });
+    }
+  }, [buildScannerTelemetryMetadata, enableTorch, telemetry]);
 
   const onMountError = useCallback((event: { message?: string }) => {
     const error = new Error(event.message || 'Camera mount error') as ErrorWithDetails;
@@ -863,12 +938,68 @@ export function VerifyAIScanner({
     });
   }, [buildScannerTelemetryMetadata, onError, telemetry]);
 
+  useEffect(() => {
+    if (
+      !permission?.granted ||
+      terminated ||
+      currentAppState !== 'active' ||
+      !cameraMounted ||
+      cameraReadyRef.current ||
+      cameraInitFailedRef.current ||
+      cameraStartupSlowTrackedRef.current
+    ) {
+      return;
+    }
+
+    const timer = setTimeout(() => {
+      if (
+        appStateRef.current !== 'active' ||
+        cameraReadyRef.current ||
+        cameraInitFailedRef.current ||
+        cameraStartupSlowTrackedRef.current
+      ) {
+        return;
+      }
+
+      cameraStartupSlowTrackedRef.current = true;
+      const startupTotalElapsedMs = Date.now() - cameraStartupStartedAtRef.current;
+      const startupAttemptElapsedMs = Date.now() - cameraStartupAttemptStartedAtRef.current;
+      console.warn(
+        `VerifyAI[${SDK_VERSION}]: camera startup slow ` +
+          `startupTotalMs=${startupTotalElapsedMs} ` +
+          `startupAttemptMs=${startupAttemptElapsedMs} ` +
+          `torchRequested=${enableTorch ? 1 : 0}`,
+      );
+      telemetry?.track('camera_startup_slow', {
+        component: 'scanner',
+        error: 'camera_startup_slow',
+        metadata: buildScannerTelemetryMetadata({
+          startup_slow_threshold_ms: CAMERA_STARTUP_SLOW_TELEMETRY_MS,
+          startup_total_elapsed_ms: startupTotalElapsedMs,
+          startup_attempt_elapsed_ms: startupAttemptElapsedMs,
+          startup_watchdog_remount_count: startupWatchdogRemountCountRef.current,
+          torch_deferred_until_ready: enableTorch ? 1 : 0,
+        }),
+      });
+    }, CAMERA_STARTUP_SLOW_TELEMETRY_MS);
+
+    return () => clearTimeout(timer);
+  }, [
+    permission?.granted,
+    terminated,
+    currentAppState,
+    cameraMounted,
+    buildScannerTelemetryMetadata,
+    enableTorch,
+    telemetry,
+  ]);
+
   // Startup watchdog — if camera hasn't fired onCameraReady in time, force remount.
   // On iOS the native AVCaptureSession sometimes fails to start its preview layer on first
   // mount (e.g. during navigation transitions). Changing the key forces React to destroy and
   // recreate the CameraView, which starts a fresh native session.
   useEffect(() => {
-    if (!permission?.granted || terminated || currentAppState !== 'active') return;
+    if (!permission?.granted || terminated || currentAppState !== 'active' || !cameraMounted) return;
 
     const watchdogMs = Platform.OS === 'android'
       ? ANDROID_CAMERA_STARTUP_WATCHDOG_MS
@@ -902,11 +1033,14 @@ export function VerifyAIScanner({
               remount_reason: 'startup_watchdog',
               startup_watchdog_remount_count: startupWatchdogRemountCount,
               startup_watchdog_max_remounts: CAMERA_STARTUP_WATCHDOG_MAX_REMOUNTS,
+              startup_remount_backoff_ms: CAMERA_STARTUP_REMOUNT_BACKOFF_MS,
+              torch_deferred_until_ready: enableTorch ? 1 : 0,
             }),
           });
-          setCameraReady(false);
-          cameraReadyRef.current = false;
-          setCameraKey((k) => k + 1);
+          requestCameraRemount('startup_watchdog', {
+            backoffMs: CAMERA_STARTUP_REMOUNT_BACKOFF_MS,
+            log: true,
+          });
         }
       }
     }, watchdogMs);
@@ -916,9 +1050,12 @@ export function VerifyAIScanner({
     permission?.granted,
     terminated,
     currentAppState,
+    cameraMounted,
     cameraKey,
     buildScannerTelemetryMetadata,
+    enableTorch,
     onMountError,
+    requestCameraRemount,
     telemetry,
   ]);
 
@@ -1075,11 +1212,12 @@ export function VerifyAIScanner({
               const retryAt = new Date().toISOString();
               lastCaptureRetryAtRef.current = retryAt;
               cameraRemountCountRef.current++;
-              setCameraReady(false);
-              cameraReadyRef.current = false;
-              setCameraKey((key) => key + 1);
+              requestCameraRemount('capture_retry');
               await sleep(CAMERA_CAPTURE_RETRY_DELAY_MS);
-              captureRetryReady = await waitForCameraReady(2500);
+              const captureRetryReadyTimeoutMs = Platform.OS === 'android'
+                ? ANDROID_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS
+                : IOS_CAMERA_CAPTURE_RETRY_READY_TIMEOUT_MS;
+              captureRetryReady = await waitForCameraReady(captureRetryReadyTimeoutMs);
               telemetry?.track('camera_capture_retry', {
                 component: 'scanner',
                 error: normalized,
@@ -1089,7 +1227,7 @@ export function VerifyAIScanner({
                   capture_retry_attempted: captureRetryAttempted,
                   capture_retry_ready: captureRetryReady,
                   capture_retry_delay_ms: CAMERA_CAPTURE_RETRY_DELAY_MS,
-                  capture_retry_ready_timeout_ms: 2500,
+                  capture_retry_ready_timeout_ms: captureRetryReadyTimeoutMs,
                   last_native_capture_error: lastNativeCaptureErrorMessage,
                 }),
               });
@@ -1280,7 +1418,7 @@ export function VerifyAIScanner({
         setTimeout(() => setStatus('idle'), TRANSIENT_ERROR_DISPLAY_MS);
       }
     }
-  }, [status, exhausted, onCapture, onError, overlay?.maxAttempts, overlay?.autoApproveOnExhaust, releaseCamera, scheduleTerminalResult, buildScannerTelemetryMetadata, telemetry, terminated, physicalOrientation, overlayRotationDeg]);
+  }, [status, exhausted, onCapture, onError, overlay?.maxAttempts, overlay?.autoApproveOnExhaust, releaseCamera, scheduleTerminalResult, buildScannerTelemetryMetadata, requestCameraRemount, telemetry, terminated, physicalOrientation, overlayRotationDeg]);
 
   // Expose capture to parent via ref
   if (captureRef) {
@@ -1303,22 +1441,24 @@ export function VerifyAIScanner({
   }
 
   const showBottomCard = status === 'success' || status === 'error';
+  const shouldEnableTorch = !terminated && cameraReady && !!enableTorch;
 
   return (
     <View style={[styles.container, style]}>
-      <CameraView
-        key={cameraKey}
-        ref={cameraRef}
-        style={styles.camera}
-        facing="back"
-        enableTorch={!terminated && enableTorch}
-        onCameraReady={onCameraReady}
-        onMountError={onMountError}
-        responsiveOrientationWhenOrientationLocked
-        onResponsiveOrientationChanged={(event) => {
-          setPhysicalOrientation(event.orientation);
-        }}
-      >
+      {cameraMounted && (
+        <CameraView
+          key={cameraKey}
+          ref={cameraRef}
+          style={styles.camera}
+          facing="back"
+          enableTorch={shouldEnableTorch}
+          onCameraReady={onCameraReady}
+          onMountError={onMountError}
+          responsiveOrientationWhenOrientationLocked
+          onResponsiveOrientationChanged={(event) => {
+            setPhysicalOrientation(event.orientation);
+          }}
+        >
         {/* Overlay */}
         <View style={styles.overlay}>
           {overlay?.title && (
@@ -1522,7 +1662,8 @@ export function VerifyAIScanner({
             </TouchableOpacity>
           )}
         </View>
-      </CameraView>
+        </CameraView>
+      )}
     </View>
   );
 }

package/src/ml/featureExtractor.ts

@@ -5,17 +5,24 @@
 
 import type { FeatureVector, Detection, ImageQuality } from './types';
 
-const SCHEMA_VERSION = '1.0.0';
+const SCHEMA_VERSION = '2.0.0';
 
 /** Vehicle class IDs (must match ontology.ts) */
-const VEHICLE_CLASS_IDS = new Set([1, 2, 3, 4, 5]);
+const VEHICLE_CLASS_IDS = new Set([1, 2, 3, 4, 5, 6]);
 /** Surface class IDs */
 const SURFACE_CLASS_IDS = new Set([60, 61, 62, 63, 64, 65, 66]);
 
 /** Ontology class name mapping (must match ontology.ts) */
 export const ONTOLOGY_CLASS_NAMES: Record<number, string> = {
-  1: 'scooter', 2: 'bicycle', 3: 'ebike', 4: 'moped', 5: 'motorcycle',
+  1: 'scooter', 2: 'bicycle', 3: 'ebike', 4: 'moped', 5: 'motorcycle', 6: 'car',
   20: 'kickstand', 21: 'handlebar', 22: 'wheel', 23: 'saddle', 24: 'basket',
+  // Car panels (ontology v2 — damage intelligence)
+  25: 'car_hood', 26: 'car_roof', 27: 'car_trunk',
+  28: 'car_front_bumper', 29: 'car_rear_bumper',
+  30: 'car_door_fl', 31: 'car_door_fr', 32: 'car_door_rl', 33: 'car_door_rr',
+  34: 'car_fender_fl', 35: 'car_fender_fr',
+  36: 'car_quarter_rl', 37: 'car_quarter_rr',
+  38: 'car_rocker', 39: 'car_mirror',
   40: 'bike_rack', 41: 'curb', 42: 'parking_bay', 43: 'green_bay',
   44: 'tactile_paving', 45: 'bollard', 46: 'fence', 47: 'pole', 48: 'yellow_lines',
   60: 'sidewalk', 61: 'road', 62: 'grass', 63: 'crosswalk',
@@ -26,8 +33,9 @@ export const ONTOLOGY_CLASS_NAMES: Record<number, string> = {
 
 /** Detection model class index -> ontology class ID mapping. */
 export const MODEL_OUTPUT_CLASS_IDS = [
-  1, 2, 3, 4, 5,
+  1, 2, 3, 4, 5, 6,
   20, 21, 22, 23, 24,
+  25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39,
   40, 41, 42, 43, 44, 45, 46, 47, 48,
   60, 61, 62, 63, 64, 65, 66,
   80, 81, 82, 83, 84, 85, 86, 87,

package/src/ml/modelManager.ts

@@ -62,8 +62,25 @@ export class ModelManager {
     return this._currentBundle;
   }
 
-  /** Check for bundle updates from the server. */
-  async checkForUpdates(policyId: string, platform: 'ios' | 'android'): Promise<BundleManifest | null> {
+  /**
+   * Check for bundle updates from the server.
+   *
+   * `opts` lets callers narrow which bundle they receive when the server
+   * has per-asset / per-region / per-app-version targeted bundles
+   * configured (see `app/api/v1/models/latest`). All fields are optional;
+   * omitting them keeps the legacy behaviour of receiving the wildcard
+   * bundle for the policy.
+   */
+  async checkForUpdates(
+    policyId: string,
+    platform: 'ios' | 'android',
+    opts?: {
+      assetType?: string;
+      region?: string;
+      appVersion?: string;
+      deviceId?: string;
+    },
+  ): Promise<BundleManifest | null> {
     try {
       const headers: Record<string, string> = {
         'X-API-Key': this.apiKey,
@@ -74,7 +91,13 @@ export class ModelManager {
         headers['If-None-Match'] = this.cachedETag;
       }
 
-      const url = `${this.baseUrl}/models/latest?policy=${policyId}&platform=${platform}`;
+      const qs = new URLSearchParams({ policy: policyId, platform });
+      if (opts?.assetType) qs.set('asset_type', opts.assetType);
+      if (opts?.region) qs.set('region', opts.region);
+      if (opts?.appVersion) qs.set('app_version', opts.appVersion);
+      if (opts?.deviceId) qs.set('device_id', opts.deviceId);
+
+      const url = `${this.baseUrl}/models/latest?${qs.toString()}`;
       const response = await fetch(url, { headers });
 
       if (response.status === 304) {

package/src/ml/policyEngine.ts

@@ -7,6 +7,8 @@
  */
 
 import type {
+  DamageFinding,
+  DamageSeverity,
   FeatureVector,
   PolicyAST,
   PolicyResult,
@@ -17,6 +19,35 @@ import type {
   ComparisonOperator,
 } from './types';
 
+// Severity ordering for `severity_gte`. Must match server TS + Dart impls.
+const SEVERITY_ORDER: DamageSeverity[] = ['none', 'light', 'medium', 'severe'];
+function severityRank(s: unknown): number {
+  if (typeof s !== 'string') return -1;
+  return SEVERITY_ORDER.indexOf(s as DamageSeverity);
+}
+
+interface AggregateCountValue {
+  op: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte';
+  value: number;
+  where?: {
+    panel?: string;
+    damage_type?: string;
+    severity_gte?: DamageSeverity;
+  };
+}
+
+function compareNumber(a: number, op: AggregateCountValue['op'], b: number): boolean {
+  switch (op) {
+    case 'eq': return a === b;
+    case 'neq': return a !== b;
+    case 'gt': return a > b;
+    case 'gte': return a >= b;
+    case 'lt': return a < b;
+    case 'lte': return a <= b;
+    default: return false;
+  }
+}
+
 // ─── Field Resolution ───
 
 function resolveField(features: FeatureVector, field: string): unknown {
@@ -77,10 +108,65 @@ function applyOperator(fieldValue: unknown, operator: ComparisonOperator, value:
 }
 
 function evaluateCondition(features: FeatureVector, condition: Condition): boolean {
+  if (
+    condition.operator === 'severity_gte' ||
+    condition.operator === 'panel_has_damage' ||
+    condition.operator === 'aggregate_count'
+  ) {
+    return applyDamageOperator(features, condition);
+  }
   const fieldValue = resolveField(features, condition.field);
   return applyOperator(fieldValue, condition.operator, condition.value);
 }
 
+function applyDamageOperator(features: FeatureVector, condition: Condition): boolean {
+  const findings: DamageFinding[] = Array.isArray(features.damage_findings)
+    ? features.damage_findings
+    : [];
+
+  switch (condition.operator) {
+    case 'severity_gte': {
+      const minRank = severityRank(condition.value);
+      if (minRank < 0) return false;
+      if (condition.field && condition.field !== 'damage_findings') {
+        const f = resolveField(features, condition.field);
+        return severityRank(f) >= minRank;
+      }
+      return findings.some((finding) => severityRank(finding.severity) >= minRank);
+    }
+    case 'panel_has_damage': {
+      const panelName =
+        typeof condition.value === 'string'
+          ? condition.value
+          : typeof condition.field === 'string' &&
+              condition.field !== 'damage_findings' &&
+              condition.field !== ''
+            ? condition.field
+            : null;
+      if (!panelName) return false;
+      return findings.some(
+        (finding) => finding.panel === panelName && finding.severity !== 'none',
+      );
+    }
+    case 'aggregate_count': {
+      const v = condition.value as AggregateCountValue | null | undefined;
+      if (!v || typeof v !== 'object' || typeof v.value !== 'number' || !v.op) return false;
+      const where = v.where || {};
+      const minSeverityRank =
+        where.severity_gte !== undefined ? severityRank(where.severity_gte) : -1;
+      const count = findings.filter((finding) => {
+        if (where.panel && finding.panel !== where.panel) return false;
+        if (where.damage_type && finding.damage_type !== where.damage_type) return false;
+        if (minSeverityRank >= 0 && severityRank(finding.severity) < minSeverityRank) return false;
+        return true;
+      }).length;
+      return compareNumber(count, v.op, v.value);
+    }
+    default:
+      return false;
+  }
+}
+
 function evaluateRule(features: FeatureVector, rule: Rule): RuleResult {
   const passed = rule.conditions.every((c) => evaluateCondition(features, c));
   return {

package/src/ml/types.ts

@@ -39,6 +39,33 @@ export interface ImageQuality {
   has_vehicle: boolean;
 }
 
+// ─── Damage Findings (schema v2) ───
+
+export type DamageSeverity = 'none' | 'light' | 'medium' | 'severe';
+export type DamageType =
+  | 'scratch'
+  | 'dent'
+  | 'paint_chip'
+  | 'crack'
+  | 'broken'
+  | 'missing'
+  | 'rust'
+  | 'tear'
+  | 'stain'
+  | 'glass_damage'
+  | 'other';
+
+export interface DamageFinding {
+  finding_id: string;
+  panel: string;
+  damage_type: DamageType;
+  severity: DamageSeverity;
+  severity_score: number;
+  bbox: [number, number, number, number];
+  area_pct: number;
+  confidence: number;
+}
+
 export interface FeatureVector {
   schema_version: string;
   detections: Detection[];
@@ -46,6 +73,10 @@ export interface FeatureVector {
   image_quality: ImageQuality;
   vehicle_on_surface: string | null;
   vehicle_near: string[];
+  /** Damage observations (schema v2). Defaults to [] when damage mode disabled. */
+  damage_findings?: DamageFinding[];
+  /** Panels visible in this frame (schema v2). */
+  panel_inventory?: string[];
 }
 
 // ─── Policy AST Types ───
@@ -54,7 +85,9 @@ export type ComparisonOperator =
   | 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte'
   | 'contains' | 'not_contains'
   | 'exists' | 'not_exists'
-  | 'in' | 'not_in' | 'overlaps';
+  | 'in' | 'not_in' | 'overlaps'
+  // AST v1.1 — damage operators
+  | 'severity_gte' | 'panel_has_damage' | 'aggregate_count';
 
 export interface Condition {
   field: string;

package/src/telemetry/TelemetryReporter.ts

@@ -38,6 +38,7 @@ interface BufferedEvent {
 const CRITICAL_EVENTS = new Set([
   'camera_init_failure',
   'camera_preview_timeout',
+  'camera_startup_slow',
   'camera_permission_denied',
   'camera_scanner_mounted',
   'camera_scanner_disposed',

package/src/version.ts

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