@souscheflabs/ml-vision 0.1.1 → 0.1.3

package/dist/esm/hooks/useMultiBarcodeScanner.js

@@ -0,0 +1,290 @@
+/**
+ * useMultiBarcodeScanner Hook
+ *
+ * React hook for scanning multiple barcodes in a single frame or photo.
+ * Uses VisionCamera's built-in MLKit barcode scanning.
+ *
+ * @example
+ * ```typescript
+ * import { useMultiBarcodeScanner } from '@souschef/ml-vision';
+ *
+ * function GroceryScanner() {
+ *   const {
+ *     isScanning,
+ *     results,
+ *     startScanning,
+ *     stopScanning,
+ *     scanPhoto,
+ *   } = useMultiBarcodeScanner({
+ *     formats: ['ean-13', 'upc-a'],
+ *     onDetected: (barcodes) => console.log('Found:', barcodes),
+ *   });
+ *
+ *   return (
+ *     // Your camera UI
+ *   );
+ * }
+ * ```
+ */
+import { useState, useCallback, useRef, useMemo } from 'react';
+import { GROCERY_BARCODE_FORMATS } from '../types/barcode';
+import { useMLVisionContext } from '../core/MLVisionProvider';
+import { logger } from '../utils/logger';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Default scan interval in milliseconds */
+const DEFAULT_SCAN_INTERVAL = 100;
+/** Maximum barcodes to detect per scan */
+const DEFAULT_MAX_BARCODES = 20;
+// ============================================================================
+// Hook Implementation
+// ============================================================================
+/**
+ * Hook for multi-barcode scanning
+ */
+export function useMultiBarcodeScanner(options = {}) {
+    const { formats = GROCERY_BARCODE_FORMATS, maxBarcodes = DEFAULT_MAX_BARCODES, scanInterval = DEFAULT_SCAN_INTERVAL, onDetected, onError, hapticFeedback = true, deduplicate = true, } = options;
+    // Context
+    const { cacheManager } = useMLVisionContext();
+    // State
+    // MLKit barcode scanning is always ready once the app loads
+    const isReady = true;
+    const [isScanning, setIsScanning] = useState(false);
+    const [results, setResults] = useState([]);
+    const [error, setError] = useState(null);
+    // Refs
+    const seenBarcodesRef = useRef(new Set());
+    const lastScanTimeRef = useRef(0);
+    // ============================================================================
+    // Barcode Processing
+    // ============================================================================
+    /**
+     * Process detected barcodes from VisionCamera
+     */
+    const processDetectedBarcodes = useCallback((codes) => {
+        const now = Date.now();
+        // Throttle processing
+        if (now - lastScanTimeRef.current < scanInterval) {
+            return;
+        }
+        lastScanTimeRef.current = now;
+        // Convert to our format
+        const detections = codes
+            .slice(0, maxBarcodes)
+            .map((code) => {
+            const format = mapCodeType(code.type);
+            const barcodeData = {
+                format,
+                value: code.value,
+                displayValue: formatBarcodeDisplay(code.value, format),
+            };
+            return {
+                id: `barcode_${now}_${Math.random().toString(36).substr(2, 9)}`,
+                type: 'barcode',
+                confidence: 1.0, // MLKit doesn't provide confidence
+                data: barcodeData,
+                source: 'on_device',
+                processingTimeMs: 0,
+                timestamp: now,
+            };
+        })
+            .filter((det) => formats.includes(det.data.format));
+        // Deduplicate if enabled
+        let newDetections = detections;
+        if (deduplicate) {
+            newDetections = detections.filter((det) => {
+                const key = `${det.data.format}:${det.data.value}`;
+                if (seenBarcodesRef.current.has(key)) {
+                    return false;
+                }
+                seenBarcodesRef.current.add(key);
+                return true;
+            });
+        }
+        if (newDetections.length === 0)
+            return;
+        // Update results
+        setResults((prev) => [...prev, ...newDetections]);
+        // Cache barcodes
+        if (cacheManager) {
+            for (const det of newDetections) {
+                cacheManager.setBarcode(det.data.value, {
+                    barcode: det.data.value,
+                    format: det.data.format,
+                    found: true,
+                });
+            }
+        }
+        // Callback
+        onDetected?.(newDetections);
+        // Haptic feedback
+        if (hapticFeedback && newDetections.length > 0) {
+            // Trigger haptic - implement based on your haptic service
+            // HapticService.light();
+        }
+    }, [
+        formats,
+        maxBarcodes,
+        scanInterval,
+        deduplicate,
+        cacheManager,
+        onDetected,
+        hapticFeedback,
+    ]);
+    // ============================================================================
+    // Actions
+    // ============================================================================
+    /**
+     * Start continuous scanning
+     */
+    const startScanning = useCallback(() => {
+        setIsScanning(true);
+        setError(null);
+    }, []);
+    /**
+     * Stop scanning
+     */
+    const stopScanning = useCallback(() => {
+        setIsScanning(false);
+    }, []);
+    /**
+     * Scan a photo for barcodes
+     */
+    const scanPhoto = useCallback(async (_uri) => {
+        try {
+            setError(null);
+            // Note: Photo scanning requires native module integration
+            // This is a placeholder that would use MLKit's image labeling
+            // In practice, you'd use a native module or server endpoint
+            logger.debug('[BarcodeScanner] Photo scanning not yet implemented natively');
+            logger.debug('[BarcodeScanner] Use real-time camera scanning instead');
+            // Return empty for now - implement with native module
+            return [];
+        }
+        catch (err) {
+            const scanError = err instanceof Error ? err : new Error('Scan failed');
+            setError(scanError);
+            onError?.(scanError);
+            return [];
+        }
+    }, [onError]);
+    /**
+     * Clear all results
+     */
+    const clearResults = useCallback(() => {
+        setResults([]);
+    }, []);
+    /**
+     * Reset scanner state
+     */
+    const reset = useCallback(() => {
+        setResults([]);
+        setError(null);
+        seenBarcodesRef.current.clear();
+        setIsScanning(false);
+    }, []);
+    // ============================================================================
+    // Frame Processor Configuration
+    // ============================================================================
+    /**
+     * VisionCamera code scanner configuration
+     * Use this with VisionCamera's codeScanner prop
+     */
+    const codeScannerConfig = useMemo(() => ({
+        codeTypes: formats.map(mapFormatToCodeType),
+        onCodeScanned: processDetectedBarcodes,
+    }), [formats, processDetectedBarcodes]);
+    // Frame processor is the code scanner config for VisionCamera
+    const frameProcessor = useMemo(() => {
+        if (!isScanning)
+            return null;
+        return codeScannerConfig;
+    }, [isScanning, codeScannerConfig]);
+    // ============================================================================
+    // Return
+    // ============================================================================
+    return {
+        // State
+        isReady,
+        isScanning,
+        results,
+        error,
+        // Actions
+        startScanning,
+        stopScanning,
+        scanPhoto,
+        clearResults,
+        reset,
+        // Frame processor
+        frameProcessor,
+    };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Map VisionCamera code type to our BarcodeFormat
+ */
+function mapCodeType(codeType) {
+    const mapping = {
+        'ean-13': 'ean-13',
+        'ean-8': 'ean-8',
+        'upc-a': 'upc-a',
+        'upc-e': 'upc-e',
+        'code-128': 'code-128',
+        'code-39': 'code-39',
+        'code-93': 'code-93',
+        'itf': 'itf',
+        'codabar': 'codabar',
+        'qr': 'qr',
+        'data-matrix': 'data-matrix',
+        'pdf-417': 'pdf-417',
+        'aztec': 'aztec',
+        // Handle variations
+        EAN_13: 'ean-13',
+        EAN_8: 'ean-8',
+        UPC_A: 'upc-a',
+        UPC_E: 'upc-e',
+        CODE_128: 'code-128',
+        CODE_39: 'code-39',
+        CODE_93: 'code-93',
+        ITF: 'itf',
+        CODABAR: 'codabar',
+        QR_CODE: 'qr',
+        DATA_MATRIX: 'data-matrix',
+        PDF_417: 'pdf-417',
+        AZTEC: 'aztec',
+    };
+    return mapping[codeType] || 'code-128';
+}
+/**
+ * Map our BarcodeFormat to VisionCamera code type
+ */
+function mapFormatToCodeType(format) {
+    // VisionCamera uses the same format names
+    return format;
+}
+/**
+ * Format barcode value for display
+ */
+function formatBarcodeDisplay(value, format) {
+    switch (format) {
+        case 'ean-13':
+            // Format: X-XXXXXX-XXXXX-X
+            if (value.length === 13) {
+                return `${value[0]}-${value.slice(1, 7)}-${value.slice(7, 12)}-${value[12]}`;
+            }
+            return value;
+        case 'upc-a':
+            // Format: X-XXXXX-XXXXX-X
+            if (value.length === 12) {
+                return `${value[0]}-${value.slice(1, 6)}-${value.slice(6, 11)}-${value[11]}`;
+            }
+            return value;
+        default:
+            return value;
+    }
+}
+export default useMultiBarcodeScanner;
+//# sourceMappingURL=useMultiBarcodeScanner.js.map

package/dist/esm/hooks/useMultiBarcodeScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMultiBarcodeScanner.js","sourceRoot":"","sources":["../../../src/hooks/useMultiBarcodeScanner.ts"],"names":[],"mappings":"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"}