@hexar/biometric-identity-sdk-react-native 1.21.0 → 1.23.0

package/dist/components/VideoRecorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoRecorder.d.ts","sourceRoot":"","sources":["../../src/components/VideoRecorder.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AAexE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,iBAAiB,EAAmC,MAAM,oCAAoC,CAAC;AAE1I,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAE,CAAC,SAAS,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACtD,iCAAiC;IACjC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2CD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAigCtD,CAAC;AA4PF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"VideoRecorder.d.ts","sourceRoot":"","sources":["../../src/components/VideoRecorder.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AAexE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,iBAAiB,EAAmC,MAAM,oCAAoC,CAAC;AAE1I,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAE,CAAC,SAAS,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACtD,iCAAiC;IACjC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2CD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAqiCtD,CAAC;AA4PF,eAAe,aAAa,CAAC"}

package/dist/components/VideoRecorder.js

@@ -101,12 +101,21 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
     const framesRef = (0, react_1.useRef)([]);
     const [guidanceText, setGuidanceText] = (0, react_1.useState)(null);
     const [hasPermission, setHasPermission] = (0, react_1.useState)(false);
+    const [isCameraReady, setIsCameraReady] = (0, react_1.useState)(false);
+    // Controlled via stopRecording — set to false before calling onComplete so
+    // VisionCamera tears down the native session and any in-flight takePhoto()
+    // calls fail gracefully instead of crashing with IllegalViewOperationException
+    // when the parent unmounts the <Camera> view underneath them.
+    const [isCameraActive, setIsCameraActive] = (0, react_1.useState)(true);
     const cameraRef = (0, react_1.useRef)(null);
     const { hasPermission: cameraPermission, requestPermission } = (0, react_native_vision_camera_1.useCameraPermission)();
     // Prefer wide-angle (main) front camera — some Android devices expose
     // multiple front sensors and the default may lack autofocus.
+    // Only request wide-angle — ultra-wide opens a multi-physical-camera session
+    // that is slow to release, causing CameraViewModule.findCameraView to throw
+    // IllegalViewOperationException when the component unmounts after recording.
     const device = (0, react_native_vision_camera_1.useCameraDevice)('front', {
-        physicalDevices: ['wide-angle-camera', 'ultra-wide-angle-camera'],
+        physicalDevices: ['wide-angle-camera'],
     });
     const [deviceReady, setDeviceReady] = (0, react_1.useState)(!!device);
     const fadeAnim = (0, react_1.useRef)(new react_native_1.Animated.Value(0)).current;
@@ -233,7 +242,11 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
         initChallenges();
     }, [propChallenges, instructions, onFetchChallenges, smartMode, duration, language]);
     (0, react_1.useEffect)(() => {
-        if (phase !== 'countdown')
+        // Don't start countdown until the native camera session is ready.
+        // On Motorola and other slow-to-initialize Android OEMs, isActive becoming
+        // true before the native view is registered causes IllegalViewOperationException
+        // inside CameraViewModule.findCameraView. We wait for onInitialized to fire.
+        if (phase !== 'countdown' || !isCameraReady)
             return;
         // Trigger focus at the start of countdown so the camera has ~3s to lock focus
         if (countdown === 3)
@@ -257,7 +270,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
         else {
             startRecording();
         }
-    }, [countdown, phase]);
+    }, [countdown, phase, isCameraReady]);
     (0, react_1.useEffect)(() => {
         if (phase === 'recording') {
             react_native_1.Animated.loop(react_native_1.Animated.sequence([
@@ -302,6 +315,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
         setChallengeProgress(0);
         setOverallProgress(0);
         recordingStartTime.current = 0;
+        setIsCameraActive(true);
         setPhase('countdown');
         setCountdown(3);
     }, []);
@@ -309,6 +323,19 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
         setPhase('loading');
         react_native_1.Alert.alert('Recording Error', 'Failed to record video. Please try again.', [{ text: 'OK', onPress: onCancel }]);
     }, [onCancel]);
+    // Safety timeout: if the camera session never fires onInitialized within
+    // 10 seconds, treat it as a hardware failure and send the user back.
+    (0, react_1.useEffect)(() => {
+        if (isCameraReady)
+            return;
+        const timeout = setTimeout(() => {
+            if (!isCameraReady) {
+                biometric_identity_sdk_core_1.logger.error('Camera onInitialized timed out — hardware may be unavailable');
+                handleRecordingError(new Error('Camera initialization timed out'));
+            }
+        }, 10000);
+        return () => clearTimeout(timeout);
+    }, [isCameraReady, handleRecordingError]);
     const handleVideoComplete = (0, react_1.useCallback)(async (video) => {
         if (phase === 'loading' && !video) {
             return;
@@ -362,11 +389,11 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
             };
             biometric_identity_sdk_core_1.logger.info('Video recording completed:', result.frames.length, 'frames,', (actualDuration / 1000).toFixed(1) + 's', 'challenges:', currentCompletedChallenges.length);
             isRecordingRef.current = false;
-            // Delay onComplete so Vision Camera's native session (especially
-            // multi-physical-camera sessions opened via physicalDevices) has time
-            // to fully close before the parent unmounts the <Camera> view.
-            // Without this delay, CameraViewModule.findCameraView throws
-            // IllegalViewOperationException on Android 13 (SDK 33).
+            // Deactivate the camera first so VisionCamera tears down its native
+            // session. Any in-flight takePhoto() calls will then fail gracefully
+            // rather than crashing with IllegalViewOperationException when the
+            // parent unmounts the <Camera> view underneath them.
+            setIsCameraActive(false);
             setTimeout(() => onComplete(result), 250);
         }
         catch (error) {
@@ -518,6 +545,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                         sessionId,
                     };
                     setPhase('processing');
+                    setIsCameraActive(false);
                     setTimeout(() => onComplete(result), 250);
                 }
                 else {
@@ -531,6 +559,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                         sessionId,
                     };
                     setPhase('processing');
+                    setIsCameraActive(false);
                     setTimeout(() => onComplete(result), 250);
                 }
             }
@@ -562,6 +591,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                 challengesCompleted: currentCompletedChallenges,
                 sessionId,
             };
+            setIsCameraActive(false);
             setTimeout(() => {
                 onComplete(result);
             }, 250);
@@ -608,6 +638,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                         sessionId,
                     };
                     setPhase('processing');
+                    setIsCameraActive(false);
                     setTimeout(() => onComplete(result), 250);
                 }
             }
@@ -789,7 +820,10 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
     }
     return (react_1.default.createElement(react_native_1.View, { style: styles.container },
         react_1.default.createElement(react_native_1.View, { style: styles.cameraContainer },
-            react_1.default.createElement(react_native_vision_camera_1.Camera, { ref: cameraRef, style: react_native_1.StyleSheet.absoluteFill, device: device, isActive: phase === 'recording' || phase === 'countdown', video: true, photo: true, audio: false }),
+            react_1.default.createElement(react_native_vision_camera_1.Camera, { ref: cameraRef, style: react_native_1.StyleSheet.absoluteFill, device: device, isActive: isCameraActive, video: true, photo: true, audio: false, onInitialized: () => setIsCameraReady(true), onError: (error) => {
+                    biometric_identity_sdk_core_1.logger.error('Camera hardware error:', error);
+                    handleRecordingError(error);
+                } }),
             react_1.default.createElement(react_native_1.View, { style: styles.overlay },
                 react_1.default.createElement(react_native_1.View, { style: [
                         styles.faceOval,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexar/biometric-identity-sdk-react-native",
-  "version": "1.21.0",
+  "version": "1.23.0",
   "description": "React Native wrapper for Biometric Identity SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/components/VideoRecorder.tsx

@@ -130,12 +130,21 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
   const framesRef = useRef<string[]>([]);
   const [guidanceText, setGuidanceText] = useState<string | null>(null);
   const [hasPermission, setHasPermission] = useState(false);
+  const [isCameraReady, setIsCameraReady] = useState(false);
+  // Controlled via stopRecording — set to false before calling onComplete so
+  // VisionCamera tears down the native session and any in-flight takePhoto()
+  // calls fail gracefully instead of crashing with IllegalViewOperationException
+  // when the parent unmounts the <Camera> view underneath them.
+  const [isCameraActive, setIsCameraActive] = useState(true);
   const cameraRef = useRef<Camera>(null);
   const { hasPermission: cameraPermission, requestPermission } = useCameraPermission();
   // Prefer wide-angle (main) front camera — some Android devices expose
   // multiple front sensors and the default may lack autofocus.
+  // Only request wide-angle — ultra-wide opens a multi-physical-camera session
+  // that is slow to release, causing CameraViewModule.findCameraView to throw
+  // IllegalViewOperationException when the component unmounts after recording.
   const device = useCameraDevice('front', {
-    physicalDevices: ['wide-angle-camera', 'ultra-wide-angle-camera'],
+    physicalDevices: ['wide-angle-camera'],
   });
   const [deviceReady, setDeviceReady] = useState(!!device);
   
@@ -274,7 +283,11 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
   }, [propChallenges, instructions, onFetchChallenges, smartMode, duration, language]);
 
   useEffect(() => {
-    if (phase !== 'countdown') return;
+    // Don't start countdown until the native camera session is ready.
+    // On Motorola and other slow-to-initialize Android OEMs, isActive becoming
+    // true before the native view is registered causes IllegalViewOperationException
+    // inside CameraViewModule.findCameraView. We wait for onInitialized to fire.
+    if (phase !== 'countdown' || !isCameraReady) return;
 
     // Trigger focus at the start of countdown so the camera has ~3s to lock focus
     if (countdown === 3) triggerFocus();
@@ -298,7 +311,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
     } else {
       startRecording();
     }
-  }, [countdown, phase]);
+  }, [countdown, phase, isCameraReady]);
 
   useEffect(() => {
     if (phase === 'recording') {
@@ -351,6 +364,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
     setChallengeProgress(0);
     setOverallProgress(0);
     recordingStartTime.current = 0;
+    setIsCameraActive(true);
     setPhase('countdown');
     setCountdown(3);
   }, []);
@@ -364,6 +378,19 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
     );
   }, [onCancel]);
 
+  // Safety timeout: if the camera session never fires onInitialized within
+  // 10 seconds, treat it as a hardware failure and send the user back.
+  useEffect(() => {
+    if (isCameraReady) return;
+    const timeout = setTimeout(() => {
+      if (!isCameraReady) {
+        logger.error('Camera onInitialized timed out — hardware may be unavailable');
+        handleRecordingError(new Error('Camera initialization timed out'));
+      }
+    }, 10000);
+    return () => clearTimeout(timeout);
+  }, [isCameraReady, handleRecordingError]);
+
   const handleVideoComplete = useCallback(async (video: any) => {
     if (phase === 'loading' && !video) {
       return;
@@ -432,11 +459,11 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
       logger.info('Video recording completed:', result.frames.length, 'frames,', (actualDuration / 1000).toFixed(1) + 's', 'challenges:', currentCompletedChallenges.length);
 
       isRecordingRef.current = false;
-      // Delay onComplete so Vision Camera's native session (especially
-      // multi-physical-camera sessions opened via physicalDevices) has time
-      // to fully close before the parent unmounts the <Camera> view.
-      // Without this delay, CameraViewModule.findCameraView throws
-      // IllegalViewOperationException on Android 13 (SDK 33).
+      // Deactivate the camera first so VisionCamera tears down its native
+      // session. Any in-flight takePhoto() calls will then fail gracefully
+      // rather than crashing with IllegalViewOperationException when the
+      // parent unmounts the <Camera> view underneath them.
+      setIsCameraActive(false);
       setTimeout(() => onComplete(result), 250);
     } catch (error) {
       logger.error('Error processing video:', error);
@@ -604,6 +631,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
             sessionId,
           };
           setPhase('processing');
+          setIsCameraActive(false);
           setTimeout(() => onComplete(result), 250);
         } else {
           logger.info('Stopping recording with frames (fallback):', currentFrames.length);
@@ -616,6 +644,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
             sessionId,
           };
           setPhase('processing');
+          setIsCameraActive(false);
           setTimeout(() => onComplete(result), 250);
         }
       }
@@ -654,6 +683,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
         sessionId,
       };
       
+      setIsCameraActive(false);
       setTimeout(() => {
         onComplete(result);
       }, 250);
@@ -705,6 +735,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
             sessionId,
           };
           setPhase('processing');
+          setIsCameraActive(false);
           setTimeout(() => onComplete(result), 250);
         }
       }
@@ -960,10 +991,15 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
           ref={cameraRef}
           style={StyleSheet.absoluteFill}
           device={device}
-          isActive={phase === 'recording' || phase === 'countdown'}
+          isActive={isCameraActive}
           video={true}
           photo={true}
           audio={false}
+          onInitialized={() => setIsCameraReady(true)}
+          onError={(error) => {
+            logger.error('Camera hardware error:', error);
+            handleRecordingError(error);
+          }}
         />
 
         {/* Face Oval Overlay */}