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

package/lib/components/VerifyAIScanner.js

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

package/lib/telemetry/TelemetryReporter.d.ts

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

package/lib/telemetry/TelemetryReporter.js

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

package/lib/version.d.ts

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

package/lib/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@switchlabs/verify-ai-react-native",
-  "version": "2.4.22",
+  "version": "2.4.23",
   "description": "React Native SDK for Verify AI - photo verification with AI vision processing",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",

package/src/components/VerifyAIScanner.tsx

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

package/src/telemetry/TelemetryReporter.ts

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

package/src/version.ts

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