@hexar/biometric-identity-sdk-react-native 1.13.0 → 1.15.0

package/dist/components/CameraCapture.js

@@ -47,7 +47,6 @@ const { width, height } = react_native_1.Dimensions.get('window');
 const CameraCapture = ({ mode, theme, language, onCapture, onCancel, }) => {
     const [isCapturing, setIsCapturing] = (0, react_1.useState)(false);
     const [hasPermission, setHasPermission] = (0, react_1.useState)(false);
-    const [deviceReady, setDeviceReady] = (0, react_1.useState)(false);
     const cameraRef = (0, react_1.useRef)(null);
     const { hasPermission: cameraPermission, requestPermission } = (0, react_native_vision_camera_1.useCameraPermission)();
     if (language) {
@@ -56,6 +55,7 @@ const CameraCapture = ({ mode, theme, language, onCapture, onCancel, }) => {
     const strings = (0, biometric_identity_sdk_core_1.getStrings)();
     // Get camera device (back camera for document capture)
     const device = (0, react_native_vision_camera_1.useCameraDevice)('back');
+    const [deviceReady, setDeviceReady] = (0, react_1.useState)(!!device);
     (0, react_1.useEffect)(() => {
         checkPermissions();
     }, []);

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

@@ -1 +1 @@
-{"version":3,"file":"ProfilePictureCapture.d.ts","sourceRoot":"","sources":["../../src/components/ProfilePictureCapture.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAYxE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAmC,cAAc,EAAsB,MAAM,oCAAoC,CAAC;AAGzJ,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,CAAC,MAAM,EAAE,8BAA8B,KAAK,IAAI,CAAC;IAC7D,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAyYtE,CAAC;AA4EF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"ProfilePictureCapture.d.ts","sourceRoot":"","sources":["../../src/components/ProfilePictureCapture.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAYxE,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAmC,cAAc,EAAsB,MAAM,oCAAoC,CAAC;AAGzJ,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,CAAC,MAAM,EAAE,8BAA8B,KAAK,IAAI,CAAC;IAC7D,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAsZtE,CAAC;AA4EF,eAAe,qBAAqB,CAAC"}

package/dist/components/ProfilePictureCapture.js

@@ -51,6 +51,12 @@ const ProfilePictureCapture = ({ onComplete, onError, onCancel, theme, language,
     const [displayProgress, setDisplayProgress] = (0, react_1.useState)(0);
     const animationRef = (0, react_1.useRef)(null);
     const hasStartedAnimation = (0, react_1.useRef)(false);
+    const isMountedRef = (0, react_1.useRef)(true);
+    const challengeSessionIdRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        isMountedRef.current = true;
+        return () => { isMountedRef.current = false; };
+    }, []);
     const handleFetchChallenges = (0, react_1.useCallback)(async () => {
         return await fetchChallenges('active');
     }, [fetchChallenges]);
@@ -78,8 +84,12 @@ const ProfilePictureCapture = ({ onComplete, onError, onCancel, theme, language,
                 setIsLoadingChallenges(true);
                 try {
                     const challenges = await fetchChallenges('active');
+                    // Capture session ID right after challenge fetch — this is the session
+                    // the backend expects when we submit the video for validation.
+                    challengeSessionIdRef.current = sdk.getSessionId();
                     biometric_identity_sdk_core_1.logger.info('ProfilePictureCapture: Challenges loaded', {
                         challengeCount: challenges.length,
+                        sessionId: challengeSessionIdRef.current,
                         challenges: challenges.map(c => c.action)
                     });
                     setCurrentChallenges(challenges);
@@ -101,29 +111,26 @@ const ProfilePictureCapture = ({ onComplete, onError, onCancel, theme, language,
     const strings = (0, biometric_identity_sdk_core_1.getStrings)();
     const validateWithBackend = (0, react_1.useCallback)(async (videoResult) => {
         try {
-            if (!isInitialized) {
-                biometric_identity_sdk_core_1.logger.error('SDK not initialized');
-                throw new Error('NETWORK_ERROR');
-            }
-            if (!isUsingBackend) {
-                biometric_identity_sdk_core_1.logger.error('Backend not available - SDK not configured with backend');
-                throw new Error('NETWORK_ERROR');
-            }
-            let sessionId = videoResult.sessionId || sdk.getSessionId();
-            if (!sessionId) {
-                biometric_identity_sdk_core_1.logger.info('No session ID available, generating challenge to create one');
-                try {
-                    const challengeResponse = await sdk.generateLivenessChallenge('active');
-                    sessionId = challengeResponse.session_id;
-                    biometric_identity_sdk_core_1.logger.info('Session ID generated', { sessionId });
-                }
-                catch (challengeError) {
-                    biometric_identity_sdk_core_1.logger.error('Failed to generate challenge for session ID', challengeError);
-                }
+            if (!isInitialized || !isUsingBackend) {
+                biometric_identity_sdk_core_1.logger.error('SDK not ready', { isInitialized, isUsingBackend });
+                throw {
+                    name: 'BiometricError',
+                    message: strings.errors.unknownError || 'An unexpected error occurred. Please try again.',
+                    code: biometric_identity_sdk_core_1.BiometricErrorCode.UNKNOWN_ERROR,
+                };
             }
+            // Use the session ID from the original challenge fetch (stored in ref),
+            // falling back to the video result or SDK state. NEVER generate a new
+            // challenge here — that creates a session mismatch where the backend
+            // expects challenges from the old session but receives a new one.
+            const sessionId = videoResult.sessionId || challengeSessionIdRef.current || sdk.getSessionId();
             if (!sessionId) {
-                biometric_identity_sdk_core_1.logger.error('Session ID not available after attempting to generate');
-                throw new Error('VALIDATION_ERROR');
+                biometric_identity_sdk_core_1.logger.error('No session ID available — challenge was not properly loaded');
+                throw {
+                    name: 'BiometricError',
+                    message: strings.errors.unknownError || 'An unexpected error occurred. Please try again.',
+                    code: biometric_identity_sdk_core_1.BiometricErrorCode.UNKNOWN_ERROR,
+                };
             }
             if (!videoResult.frames || videoResult.frames.length === 0) {
                 throw new Error('No video frames available for validation');
@@ -165,10 +172,10 @@ const ProfilePictureCapture = ({ onComplete, onError, onCancel, theme, language,
             hasStartedAnimation.current = true;
             animatedProgress.setValue(0);
             setDisplayProgress(0);
-            // Start animation to 90% over 25 seconds
+            // Slow cosmetic fill to 80% over 45 seconds — real progress snaps ahead when it arrives
             animationRef.current = react_native_1.Animated.timing(animatedProgress, {
-                toValue: 90,
-                duration: 25000, // 25 seconds
+                toValue: 80,
+                duration: 45000,
                 useNativeDriver: false,
             });
             animationRef.current.start();
@@ -204,6 +211,8 @@ const ProfilePictureCapture = ({ onComplete, onError, onCancel, theme, language,
         setIsValidating(true);
         try {
             const result = await validateWithBackend(videoResult);
+            if (!isMountedRef.current)
+                return;
             if (animationRef.current) {
                 animationRef.current.stop();
             }
@@ -212,10 +221,13 @@ const ProfilePictureCapture = ({ onComplete, onError, onCancel, theme, language,
                 duration: 500,
                 useNativeDriver: false,
             }).start(() => {
-                setDisplayProgress(100);
+                if (isMountedRef.current)
+                    setDisplayProgress(100);
             });
             // Small delay to show 100% before completing
             await new Promise(resolve => setTimeout(resolve, 500));
+            if (!isMountedRef.current)
+                return;
             if (!result.isValid) {
                 if (animationRef.current) {
                     animationRef.current.stop();
@@ -233,6 +245,8 @@ const ProfilePictureCapture = ({ onComplete, onError, onCancel, theme, language,
             onComplete(result);
         }
         catch (error) {
+            if (!isMountedRef.current)
+                return;
             // Stop animation on error
             if (animationRef.current) {
                 animationRef.current.stop();
@@ -262,15 +276,16 @@ const ProfilePictureCapture = ({ onComplete, onError, onCancel, theme, language,
             }
             let errorCode = biometric_identity_sdk_core_1.BiometricErrorCode.UNKNOWN_ERROR;
             let errorMessage = strings.errors.unknownError || 'An unexpected error occurred.';
-            if (error?.message === 'NETWORK_ERROR' || (error?.message && error.message.toLowerCase().includes('network'))) {
+            const msg = error?.message?.toLowerCase() || '';
+            if (msg.includes('network request failed') || msg.includes('failed to fetch')) {
                 errorCode = biometric_identity_sdk_core_1.BiometricErrorCode.NETWORK_ERROR;
                 errorMessage = strings.errors.networkError || 'Network error. Please check your connection.';
             }
-            else if (error?.message && error.message.toLowerCase().includes('timeout')) {
+            else if (msg.includes('timeout') || msg.includes('aborterror')) {
                 errorCode = biometric_identity_sdk_core_1.BiometricErrorCode.VALIDATION_TIMEOUT;
                 errorMessage = strings.errors.timeout || 'Timeout. Please try again.';
             }
-            else if (error?.message && error.message.toLowerCase().includes('liveness')) {
+            else if (msg.includes('liveness')) {
                 errorCode = biometric_identity_sdk_core_1.BiometricErrorCode.LIVENESS_CHECK_FAILED;
                 errorMessage = strings.errors.livenessCheckFailed || 'Liveness check failed. Please try again.';
             }
@@ -332,7 +347,7 @@ const ProfilePictureCapture = ({ onComplete, onError, onCancel, theme, language,
     if (showFacePositioningGuide) {
         return (react_1.default.createElement(FacePositioningGuide_1.FacePositioningGuide, { theme: theme, language: language, onContinue: () => setShowFacePositioningGuide(false), onCancel: onCancel }));
     }
-    return (react_1.default.createElement(VideoRecorder_1.VideoRecorder, { theme: theme, language: language, smartMode: true, challenges: currentChallenges, sessionId: sdk.getSessionId() || undefined, onComplete: handleVideoComplete, onCancel: handleVideoCancel, onFetchChallenges: handleFetchChallenges }));
+    return (react_1.default.createElement(VideoRecorder_1.VideoRecorder, { theme: theme, language: language, smartMode: true, challenges: currentChallenges, sessionId: challengeSessionIdRef.current || sdk.getSessionId() || undefined, onComplete: handleVideoComplete, onCancel: handleVideoCancel, onFetchChallenges: handleFetchChallenges }));
 };
 exports.ProfilePictureCapture = ProfilePictureCapture;
 const styles = react_native_1.StyleSheet.create({

package/dist/components/ValidationProgress.js

@@ -52,29 +52,30 @@ const ValidationProgress = ({ progress, theme, language = 'en', }) => {
         }
     }, [language]);
     (0, react_1.useEffect)(() => {
-        // Start animation from 0 to 90% over 60 seconds (1 minute) - only once
+        // Animate to whichever is higher: the fake "filling" target or real progress.
+        // The fake fill reaches 80% in 60s so the bar never looks stuck even if the
+        // backend is slow, but real progress always takes precedence.
         if (!hasStartedAnimation.current) {
             hasStartedAnimation.current = true;
-            // Start animation to 90% over 35 seconds, regardless of backend progress
+            // Slow fill to 80% over 60 seconds — purely cosmetic
             animationRef.current = react_native_1.Animated.timing(animatedProgress, {
-                toValue: 90,
-                duration: 35000, // 35 seconds
+                toValue: 80,
+                duration: 60000,
                 useNativeDriver: false,
             });
             animationRef.current.start();
         }
-        // Only update to actual progress if it's 90% or more (validation complete)
-        if (progress >= 90) {
+        // When real progress arrives and exceeds the current animated value, snap to it
+        if (progress > 0) {
             if (animationRef.current) {
                 animationRef.current.stop();
             }
             react_native_1.Animated.timing(animatedProgress, {
-                toValue: progress,
-                duration: 500,
+                toValue: Math.max(progress, 80), // never go backwards
+                duration: progress >= 90 ? 500 : 300,
                 useNativeDriver: false,
             }).start();
         }
-        // Update display value
         const listener = animatedProgress.addListener(({ value }) => {
             setDisplayProgress(Math.round(value));
         });

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;AAcxE,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,CAy6BtD,CAAC;AA6OF,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;AAcxE,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,CAq+BtD,CAAC;AA4PF,eAAe,aAAa,CAAC"}

package/dist/components/VideoRecorder.js

@@ -99,11 +99,12 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
     const completedChallengesRef = (0, react_1.useRef)([]);
     const [frames, setFrames] = (0, react_1.useState)([]);
     const framesRef = (0, react_1.useRef)([]);
+    const [guidanceText, setGuidanceText] = (0, react_1.useState)(null);
     const [hasPermission, setHasPermission] = (0, react_1.useState)(false);
-    const [deviceReady, setDeviceReady] = (0, react_1.useState)(false);
     const cameraRef = (0, react_1.useRef)(null);
     const { hasPermission: cameraPermission, requestPermission } = (0, react_native_vision_camera_1.useCameraPermission)();
     const device = (0, react_native_vision_camera_1.useCameraDevice)('front');
+    const [deviceReady, setDeviceReady] = (0, react_1.useState)(!!device);
     const fadeAnim = (0, react_1.useRef)(new react_native_1.Animated.Value(0)).current;
     const scaleAnim = (0, react_1.useRef)(new react_native_1.Animated.Value(1)).current;
     const pulseAnim = (0, react_1.useRef)(new react_native_1.Animated.Value(1)).current;
@@ -337,7 +338,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                 frames: finalFrames,
                 duration: actualDuration,
                 instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-                qualityScore: finalFrames.length > 0 ? Math.min(100, (finalFrames.length / 30) * 100) : 85,
+                qualityScore: finalFrames.length > 0 ? Math.min(100, (finalFrames.length / 20) * 100) : 85,
                 challengesCompleted: currentCompletedChallenges,
                 sessionId,
             };
@@ -358,7 +359,43 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
             framesRef.current = [];
             let consecutiveErrors = 0;
             const maxConsecutiveErrors = 10;
-            const MAX_FRAMES = 30;
+            // Backend samples down to 15 anyway — 20 gives margin without OOM risk
+            const MAX_FRAMES = 20;
+            const FRAME_MAX_PX = 640;
+            const JPEG_QUALITY = 60;
+            // Quality gate: reject dark/corrupt frames (< 5KB) and abnormally large ones (> 500KB)
+            const MIN_FRAME_KB = 5;
+            const MAX_FRAME_KB = 500;
+            // Compress + read a photo to base64 — resize to 640px JPEG60
+            // to keep each frame at ~30-50KB instead of ~3MB raw.
+            const compressAndRead = async (photoPath) => {
+                const RNFS = require('react-native-fs');
+                const cleanPath = photoPath.startsWith('file://') ? photoPath.replace('file://', '') : photoPath;
+                let readPath = cleanPath;
+                // Try resizing with react-native-image-resizer (already a project dep)
+                try {
+                    const ImageResizer = require('react-native-image-resizer').default;
+                    const resized = await ImageResizer.createResizedImage(photoPath, FRAME_MAX_PX, FRAME_MAX_PX, 'JPEG', JPEG_QUALITY, 0, undefined, false, { mode: 'contain', onlyScaleDown: true });
+                    readPath = resized.uri.startsWith('file://') ? resized.uri.replace('file://', '') : resized.uri;
+                }
+                catch {
+                    // Resizer not available or failed — fall back to raw photo
+                }
+                // Read with one retry (transient I/O on some Android OEMs)
+                try {
+                    return await RNFS.readFile(readPath, 'base64');
+                }
+                catch {
+                    await new Promise(r => setTimeout(r, 50));
+                    try {
+                        return await RNFS.readFile(readPath, 'base64');
+                    }
+                    catch (retryErr) {
+                        biometric_identity_sdk_core_1.logger.error('RNFS readFile failed after retry', { path: readPath, error: retryErr });
+                        return null;
+                    }
+                }
+            };
             // Serial capture: each frame is captured only after the previous one
             // finishes, preventing overlapping takePhoto() calls that cause the
             // camera to throw "busy" errors and kill the capture loop.
@@ -372,25 +409,35 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                     });
                     if (photo) {
                         consecutiveErrors = 0;
-                        let base64Data = null;
-                        try {
-                            const RNFS = require('react-native-fs');
-                            // Try with original path first, then strip file:// prefix
-                            try {
-                                base64Data = await RNFS.readFile(photo.path, 'base64');
+                        const base64Data = await compressAndRead(photo.path);
+                        if (base64Data) {
+                            const sizeKB = base64Data.length / 1024;
+                            if (sizeKB >= MIN_FRAME_KB && sizeKB <= MAX_FRAME_KB) {
+                                framesRef.current = [...framesRef.current, base64Data];
+                                // Clear guidance when we get a good frame
+                                if (guidanceText)
+                                    setGuidanceText(null);
+                            }
+                            else if (sizeKB < MIN_FRAME_KB) {
+                                // Very small frame = dark/black image
+                                setGuidanceText('Mejorá la iluminación');
+                                biometric_identity_sdk_core_1.logger.warn(`Frame rejected (too dark): ${sizeKB.toFixed(1)}KB`);
                             }
-                            catch {
-                                base64Data = await RNFS.readFile(photo.path.replace('file://', ''), 'base64');
+                            else {
+                                biometric_identity_sdk_core_1.logger.warn(`Frame rejected by quality gate: ${sizeKB.toFixed(1)}KB`);
                             }
                         }
-                        catch (fsError) {
-                            biometric_identity_sdk_core_1.logger.warn('Could not convert photo to base64, skipping frame');
-                            base64Data = null;
+                        else {
+                            // RNFS failed — likely device I/O issue
+                            setGuidanceText('Mantené el celular quieto');
                         }
-                        if (base64Data) {
-                            framesRef.current = [...framesRef.current, base64Data];
-                            setFrames(framesRef.current);
+                        // Clean up temp photo to free disk space on low-storage devices
+                        try {
+                            const RNFS = require('react-native-fs');
+                            const cleanPath = photo.path.startsWith('file://') ? photo.path.replace('file://', '') : photo.path;
+                            RNFS.unlink(cleanPath).catch(() => { });
                         }
+                        catch { }
                     }
                 }
                 catch (error) {
@@ -443,7 +490,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                         frames: currentFrames,
                         duration: actualDuration,
                         instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-                        qualityScore: Math.min(100, (currentFrames.length / 30) * 100),
+                        qualityScore: Math.min(100, (currentFrames.length / 20) * 100),
                         challengesCompleted: currentCompletedChallenges,
                         sessionId,
                     };
@@ -455,7 +502,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                         frames: currentFrames.length > 0 ? currentFrames : [],
                         duration: actualDuration,
                         instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-                        qualityScore: currentFrames.length > 0 ? Math.min(100, (currentFrames.length / 30) * 100) : 0,
+                        qualityScore: currentFrames.length > 0 ? Math.min(100, (currentFrames.length / 20) * 100) : 0,
                         challengesCompleted: currentCompletedChallenges,
                         sessionId,
                     };
@@ -486,7 +533,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                 frames: currentFrames.length > 0 ? currentFrames : [],
                 duration: actualDuration,
                 instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-                qualityScore: currentFrames.length > 0 ? Math.min(100, (currentFrames.length / 30) * 100) : 0,
+                qualityScore: currentFrames.length > 0 ? Math.min(100, (currentFrames.length / 20) * 100) : 0,
                 challengesCompleted: currentCompletedChallenges,
                 sessionId,
             };
@@ -525,12 +572,13 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
             else {
                 const actualDuration = Date.now() - recordingStartTime.current;
                 const currentCompletedChallenges = completedChallengesRef.current.length > 0 ? completedChallengesRef.current : completedChallenges;
-                if (actualDuration >= minDurationMs && frames.length > 0) {
+                const currentFrames = framesRef.current.length > 0 ? framesRef.current : frames;
+                if (actualDuration >= minDurationMs && currentFrames.length > 0) {
                     const result = {
-                        frames,
+                        frames: currentFrames,
                         duration: actualDuration,
                         instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-                        qualityScore: Math.min(100, (frames.length / 30) * 100),
+                        qualityScore: Math.min(100, (currentFrames.length / 20) * 100),
                         challengesCompleted: currentCompletedChallenges,
                         sessionId,
                     };
@@ -776,6 +824,8 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                 react_1.default.createElement(react_native_1.Text, { style: styles.bottomText }, strings.liveness.countdownMessage || `You'll perform ${challenges.length} action${challenges.length > 1 ? 's' : ''}.\nFollow the on-screen instructions.`),
                 react_1.default.createElement(react_native_1.TouchableOpacity, { style: [styles.cancelButton, { borderColor: theme?.errorColor || '#EF4444' }], onPress: onCancel },
                     react_1.default.createElement(react_native_1.Text, { style: [styles.cancelButtonText, { color: theme?.errorColor || '#EF4444' }] }, strings.common.cancel || 'Cancel')))),
+            phase === 'recording' && guidanceText && (react_1.default.createElement(react_native_1.View, { style: styles.guidanceContainer },
+                react_1.default.createElement(react_native_1.Text, { style: styles.guidanceText }, guidanceText))),
             phase === 'recording' && (react_1.default.createElement(react_native_1.Text, { style: styles.bottomText }, strings.liveness.recordingInstructions || 'Keep your face visible and follow the instructions')),
             phase === 'processing' && (react_1.default.createElement(react_native_1.Text, { style: styles.bottomText }, strings.validation.almostDone || 'Almost done...')))));
 };
@@ -996,6 +1046,21 @@ const styles = react_native_1.StyleSheet.create({
         backgroundColor: 'rgba(0, 0, 0, 0.9)',
         alignItems: 'center',
     },
+    guidanceContainer: {
+        backgroundColor: 'rgba(239, 68, 68, 0.85)',
+        borderRadius: 8,
+        paddingVertical: 8,
+        paddingHorizontal: 16,
+        marginHorizontal: 20,
+        marginBottom: 8,
+        alignItems: 'center',
+    },
+    guidanceText: {
+        color: '#FFFFFF',
+        fontSize: 14,
+        fontWeight: '600',
+        textAlign: 'center',
+    },
     bottomText: {
         color: '#FFFFFF',
         fontSize: 16,

package/dist/hooks/useBiometricSDK.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBiometricSDK.d.ts","sourceRoot":"","sources":["../../src/hooks/useBiometricSDK.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,QAAQ,EACR,WAAW,EAGZ,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,oBAAoB,CAAC;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,mBAAmB,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7E,gBAAgB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,eAAO,MAAM,eAAe,QAAO,qBA2QlC,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"useBiometricSDK.d.ts","sourceRoot":"","sources":["../../src/hooks/useBiometricSDK.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,QAAQ,EACR,WAAW,EAGZ,MAAM,oCAAoC,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,oBAAoB,CAAC;IAC1B,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,mBAAmB,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC7E,gBAAgB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,WAAW,EAAE,CAAC,SAAS,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,eAAO,MAAM,eAAe,QAAO,qBAmRlC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/hooks/useBiometricSDK.js

@@ -11,7 +11,8 @@ const useBiometricSDK = () => {
     const isMounted = (0, react_1.useRef)(true);
     (0, react_1.useEffect)(() => {
         isMounted.current = true;
-        const init = async () => {
+        let retryTimeout = null;
+        const init = async (attempt = 1) => {
             try {
                 await sdk.initialize();
                 if (isMounted.current) {
@@ -20,12 +21,20 @@ const useBiometricSDK = () => {
                 }
             }
             catch (error) {
-                biometric_identity_sdk_core_1.logger.error('SDK initialization failed:', error);
+                biometric_identity_sdk_core_1.logger.error(`SDK initialization failed (attempt ${attempt}):`, error);
+                // Retry up to 3 times with exponential backoff (1s, 2s, 4s)
+                if (attempt < 4 && isMounted.current) {
+                    const delay = Math.min(1000 * Math.pow(2, attempt - 1), 4000);
+                    biometric_identity_sdk_core_1.logger.info(`Retrying SDK init in ${delay}ms`);
+                    retryTimeout = setTimeout(() => init(attempt + 1), delay);
+                }
             }
         };
         init();
         return () => {
             isMounted.current = false;
+            if (retryTimeout)
+                clearTimeout(retryTimeout);
             sdk.dispose();
         };
     }, [sdk]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexar/biometric-identity-sdk-react-native",
-  "version": "1.13.0",
+  "version": "1.15.0",
   "description": "React Native wrapper for Biometric Identity SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,7 +11,7 @@
     "clean": "rm -rf dist"
   },
   "peerDependencies": {
-    "@hexar/biometric-identity-sdk-core": ">=1.7.0",
+    "@hexar/biometric-identity-sdk-core": ">=1.8.0",
     "react": ">=18.0.0",
     "react-native": ">=0.70.0",
     "react-native-fs": ">=2.20.0",

package/src/components/CameraCapture.tsx

@@ -37,7 +37,6 @@ export const CameraCapture: React.FC<CameraCaptureProps> = ({
 }) => {
   const [isCapturing, setIsCapturing] = useState(false);
   const [hasPermission, setHasPermission] = useState(false);
-  const [deviceReady, setDeviceReady] = useState(false);
   const cameraRef = useRef<Camera>(null);
   const { hasPermission: cameraPermission, requestPermission } = useCameraPermission();
 
@@ -48,6 +47,7 @@ export const CameraCapture: React.FC<CameraCaptureProps> = ({
 
   // Get camera device (back camera for document capture)
   const device = useCameraDevice('back');
+  const [deviceReady, setDeviceReady] = useState(!!device);
 
   useEffect(() => {
     checkPermissions();

package/src/components/ProfilePictureCapture.tsx

@@ -53,6 +53,13 @@ export const ProfilePictureCapture: React.FC<ProfilePictureCaptureProps> = ({
   const [displayProgress, setDisplayProgress] = useState(0);
   const animationRef = useRef<Animated.CompositeAnimation | null>(null);
   const hasStartedAnimation = useRef(false);
+  const isMountedRef = useRef(true);
+  const challengeSessionIdRef = useRef<string | null>(null);
+
+  useEffect(() => {
+    isMountedRef.current = true;
+    return () => { isMountedRef.current = false; };
+  }, []);
 
   const handleFetchChallenges = useCallback(async () => {
     return await fetchChallenges('active');
@@ -83,8 +90,12 @@ export const ProfilePictureCapture: React.FC<ProfilePictureCaptureProps> = ({
         setIsLoadingChallenges(true);
         try {
           const challenges = await fetchChallenges('active');
+          // Capture session ID right after challenge fetch — this is the session
+          // the backend expects when we submit the video for validation.
+          challengeSessionIdRef.current = sdk.getSessionId();
           logger.info('ProfilePictureCapture: Challenges loaded', {
             challengeCount: challenges.length,
+            sessionId: challengeSessionIdRef.current,
             challenges: challenges.map(c => c.action)
           });
           setCurrentChallenges(challenges);
@@ -106,32 +117,28 @@ export const ProfilePictureCapture: React.FC<ProfilePictureCaptureProps> = ({
 
   const validateWithBackend = useCallback(async (videoResult: VideoRecordingResult): Promise<ProfilePictureValidationResult> => {
     try {
-      if (!isInitialized) {
-        logger.error('SDK not initialized');
-        throw new Error('NETWORK_ERROR');
-      }
-
-      if (!isUsingBackend) {
-        logger.error('Backend not available - SDK not configured with backend');
-        throw new Error('NETWORK_ERROR');
+      if (!isInitialized || !isUsingBackend) {
+        logger.error('SDK not ready', { isInitialized, isUsingBackend });
+        throw {
+          name: 'BiometricError',
+          message: strings.errors.unknownError || 'An unexpected error occurred. Please try again.',
+          code: BiometricErrorCode.UNKNOWN_ERROR,
+        };
       }
 
-      let sessionId = videoResult.sessionId || sdk.getSessionId();
-      
-      if (!sessionId) {
-        logger.info('No session ID available, generating challenge to create one');
-        try {
-          const challengeResponse = await sdk.generateLivenessChallenge('active');
-          sessionId = challengeResponse.session_id;
-          logger.info('Session ID generated', { sessionId });
-        } catch (challengeError) {
-          logger.error('Failed to generate challenge for session ID', challengeError);
-        }
-      }
+      // Use the session ID from the original challenge fetch (stored in ref),
+      // falling back to the video result or SDK state. NEVER generate a new
+      // challenge here — that creates a session mismatch where the backend
+      // expects challenges from the old session but receives a new one.
+      const sessionId = videoResult.sessionId || challengeSessionIdRef.current || sdk.getSessionId();
 
       if (!sessionId) {
-        logger.error('Session ID not available after attempting to generate');
-        throw new Error('VALIDATION_ERROR');
+        logger.error('No session ID available — challenge was not properly loaded');
+        throw {
+          name: 'BiometricError',
+          message: strings.errors.unknownError || 'An unexpected error occurred. Please try again.',
+          code: BiometricErrorCode.UNKNOWN_ERROR,
+        };
       }
 
       if (!videoResult.frames || videoResult.frames.length === 0) {
@@ -178,10 +185,10 @@ export const ProfilePictureCapture: React.FC<ProfilePictureCaptureProps> = ({
       animatedProgress.setValue(0);
       setDisplayProgress(0);
       
-      // Start animation to 90% over 25 seconds
+      // Slow cosmetic fill to 80% over 45 seconds — real progress snaps ahead when it arrives
       animationRef.current = Animated.timing(animatedProgress, {
-        toValue: 90,
-        duration: 25000, // 25 seconds
+        toValue: 80,
+        duration: 45000,
         useNativeDriver: false,
       });
       
@@ -222,7 +229,9 @@ export const ProfilePictureCapture: React.FC<ProfilePictureCaptureProps> = ({
 
     try {
       const result = await validateWithBackend(videoResult);
-      
+
+      if (!isMountedRef.current) return;
+
       if (animationRef.current) {
         animationRef.current.stop();
       }
@@ -231,12 +240,14 @@ export const ProfilePictureCapture: React.FC<ProfilePictureCaptureProps> = ({
         duration: 500,
         useNativeDriver: false,
       }).start(() => {
-        setDisplayProgress(100);
+        if (isMountedRef.current) setDisplayProgress(100);
       });
-      
+
       // Small delay to show 100% before completing
       await new Promise(resolve => setTimeout(resolve, 500));
-      
+
+      if (!isMountedRef.current) return;
+
       if (!result.isValid) {
         if (animationRef.current) {
           animationRef.current.stop();
@@ -254,6 +265,7 @@ export const ProfilePictureCapture: React.FC<ProfilePictureCaptureProps> = ({
       setIsValidating(false);
       onComplete(result);
     } catch (error: any) {
+      if (!isMountedRef.current) return;
       // Stop animation on error
       if (animationRef.current) {
         animationRef.current.stop();
@@ -284,13 +296,14 @@ export const ProfilePictureCapture: React.FC<ProfilePictureCaptureProps> = ({
       let errorCode = BiometricErrorCode.UNKNOWN_ERROR;
       let errorMessage = strings.errors.unknownError || 'An unexpected error occurred.';
 
-      if (error?.message === 'NETWORK_ERROR' || (error?.message && error.message.toLowerCase().includes('network'))) {
+      const msg = error?.message?.toLowerCase() || '';
+      if (msg.includes('network request failed') || msg.includes('failed to fetch')) {
         errorCode = BiometricErrorCode.NETWORK_ERROR;
         errorMessage = strings.errors.networkError || 'Network error. Please check your connection.';
-      } else if (error?.message && error.message.toLowerCase().includes('timeout')) {
+      } else if (msg.includes('timeout') || msg.includes('aborterror')) {
         errorCode = BiometricErrorCode.VALIDATION_TIMEOUT;
         errorMessage = strings.errors.timeout || 'Timeout. Please try again.';
-      } else if (error?.message && error.message.toLowerCase().includes('liveness')) {
+      } else if (msg.includes('liveness')) {
         errorCode = BiometricErrorCode.LIVENESS_CHECK_FAILED;
         errorMessage = strings.errors.livenessCheckFailed || 'Liveness check failed. Please try again.';
       }
@@ -416,7 +429,7 @@ export const ProfilePictureCapture: React.FC<ProfilePictureCaptureProps> = ({
       language={language}
       smartMode={true}
       challenges={currentChallenges}
-      sessionId={sdk.getSessionId() || undefined}
+      sessionId={challengeSessionIdRef.current || sdk.getSessionId() || undefined}
       onComplete={handleVideoComplete}
       onCancel={handleVideoCancel}
       onFetchChallenges={handleFetchChallenges}

package/src/components/ValidationProgress.tsx

@@ -36,33 +36,33 @@ export const ValidationProgress: React.FC<ValidationProgressProps> = ({
   }, [language]);
 
   useEffect(() => {
-    // Start animation from 0 to 90% over 60 seconds (1 minute) - only once
+    // Animate to whichever is higher: the fake "filling" target or real progress.
+    // The fake fill reaches 80% in 60s so the bar never looks stuck even if the
+    // backend is slow, but real progress always takes precedence.
     if (!hasStartedAnimation.current) {
       hasStartedAnimation.current = true;
-      
-      // Start animation to 90% over 35 seconds, regardless of backend progress
+
+      // Slow fill to 80% over 60 seconds — purely cosmetic
       animationRef.current = Animated.timing(animatedProgress, {
-        toValue: 90,
-        duration: 35000, // 35 seconds
+        toValue: 80,
+        duration: 60000,
         useNativeDriver: false,
       });
-      
       animationRef.current.start();
     }
-    
-    // Only update to actual progress if it's 90% or more (validation complete)
-    if (progress >= 90) {
+
+    // When real progress arrives and exceeds the current animated value, snap to it
+    if (progress > 0) {
       if (animationRef.current) {
         animationRef.current.stop();
       }
       Animated.timing(animatedProgress, {
-        toValue: progress,
-        duration: 500,
+        toValue: Math.max(progress, 80), // never go backwards
+        duration: progress >= 90 ? 500 : 300,
         useNativeDriver: false,
       }).start();
     }
 
-    // Update display value
     const listener = animatedProgress.addListener(({ value }) => {
       setDisplayProgress(Math.round(value));
     });

package/src/components/VideoRecorder.tsx

@@ -127,12 +127,12 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
   const completedChallengesRef = useRef<string[]>([]);
   const [frames, setFrames] = useState<string[]>([]);
   const framesRef = useRef<string[]>([]);
+  const [guidanceText, setGuidanceText] = useState<string | null>(null);
   const [hasPermission, setHasPermission] = useState(false);
-  const [deviceReady, setDeviceReady] = useState(false);
-
   const cameraRef = useRef<Camera>(null);
   const { hasPermission: cameraPermission, requestPermission } = useCameraPermission();
   const device = useCameraDevice('front');
+  const [deviceReady, setDeviceReady] = useState(!!device);
   
   const fadeAnim = useRef(new Animated.Value(0)).current;
   const scaleAnim = useRef(new Animated.Value(1)).current;
@@ -405,7 +405,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
         frames: finalFrames,
         duration: actualDuration,
         instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-        qualityScore: finalFrames.length > 0 ? Math.min(100, (finalFrames.length / 30) * 100) : 85,
+        qualityScore: finalFrames.length > 0 ? Math.min(100, (finalFrames.length / 20) * 100) : 85,
         challengesCompleted: currentCompletedChallenges,
         sessionId,
       };
@@ -428,7 +428,53 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
       framesRef.current = [];
       let consecutiveErrors = 0;
       const maxConsecutiveErrors = 10;
-      const MAX_FRAMES = 30;
+      // Backend samples down to 15 anyway — 20 gives margin without OOM risk
+      const MAX_FRAMES = 20;
+      const FRAME_MAX_PX = 640;
+      const JPEG_QUALITY = 60;
+      // Quality gate: reject dark/corrupt frames (< 5KB) and abnormally large ones (> 500KB)
+      const MIN_FRAME_KB = 5;
+      const MAX_FRAME_KB = 500;
+
+      // Compress + read a photo to base64 — resize to 640px JPEG60
+      // to keep each frame at ~30-50KB instead of ~3MB raw.
+      const compressAndRead = async (photoPath: string): Promise<string | null> => {
+        const RNFS = require('react-native-fs');
+        const cleanPath = photoPath.startsWith('file://') ? photoPath.replace('file://', '') : photoPath;
+        let readPath = cleanPath;
+
+        // Try resizing with react-native-image-resizer (already a project dep)
+        try {
+          const ImageResizer = require('react-native-image-resizer').default;
+          const resized = await ImageResizer.createResizedImage(
+            photoPath,
+            FRAME_MAX_PX,
+            FRAME_MAX_PX,
+            'JPEG',
+            JPEG_QUALITY,
+            0,
+            undefined,
+            false,
+            { mode: 'contain', onlyScaleDown: true },
+          );
+          readPath = resized.uri.startsWith('file://') ? resized.uri.replace('file://', '') : resized.uri;
+        } catch {
+          // Resizer not available or failed — fall back to raw photo
+        }
+
+        // Read with one retry (transient I/O on some Android OEMs)
+        try {
+          return await RNFS.readFile(readPath, 'base64');
+        } catch {
+          await new Promise(r => setTimeout(r, 50));
+          try {
+            return await RNFS.readFile(readPath, 'base64');
+          } catch (retryErr) {
+            logger.error('RNFS readFile failed after retry', { path: readPath, error: retryErr });
+            return null;
+          }
+        }
+      };
 
       // Serial capture: each frame is captured only after the previous one
       // finishes, preventing overlapping takePhoto() calls that cause the
@@ -445,25 +491,32 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
 
           if (photo) {
             consecutiveErrors = 0;
-            let base64Data: string | null = null;
+            const base64Data = await compressAndRead(photo.path);
 
-            try {
-              const RNFS = require('react-native-fs');
-              // Try with original path first, then strip file:// prefix
-              try {
-                base64Data = await RNFS.readFile(photo.path, 'base64');
-              } catch {
-                base64Data = await RNFS.readFile(photo.path.replace('file://', ''), 'base64');
+            if (base64Data) {
+              const sizeKB = base64Data.length / 1024;
+              if (sizeKB >= MIN_FRAME_KB && sizeKB <= MAX_FRAME_KB) {
+                framesRef.current = [...framesRef.current, base64Data];
+                // Clear guidance when we get a good frame
+                if (guidanceText) setGuidanceText(null);
+              } else if (sizeKB < MIN_FRAME_KB) {
+                // Very small frame = dark/black image
+                setGuidanceText('Mejorá la iluminación');
+                logger.warn(`Frame rejected (too dark): ${sizeKB.toFixed(1)}KB`);
+              } else {
+                logger.warn(`Frame rejected by quality gate: ${sizeKB.toFixed(1)}KB`);
               }
-            } catch (fsError) {
-              logger.warn('Could not convert photo to base64, skipping frame');
-              base64Data = null;
+            } else {
+              // RNFS failed — likely device I/O issue
+              setGuidanceText('Mantené el celular quieto');
             }
 
-            if (base64Data) {
-              framesRef.current = [...framesRef.current, base64Data];
-              setFrames(framesRef.current);
-            }
+            // Clean up temp photo to free disk space on low-storage devices
+            try {
+              const RNFS = require('react-native-fs');
+              const cleanPath = photo.path.startsWith('file://') ? photo.path.replace('file://', '') : photo.path;
+              RNFS.unlink(cleanPath).catch(() => {});
+            } catch {}
           }
         } catch (error: any) {
           consecutiveErrors++;
@@ -522,7 +575,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
             frames: currentFrames,
             duration: actualDuration,
             instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-            qualityScore: Math.min(100, (currentFrames.length / 30) * 100),
+            qualityScore: Math.min(100, (currentFrames.length / 20) * 100),
             challengesCompleted: currentCompletedChallenges,
             sessionId,
           };
@@ -533,7 +586,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
             frames: currentFrames.length > 0 ? currentFrames : [],
             duration: actualDuration,
             instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-            qualityScore: currentFrames.length > 0 ? Math.min(100, (currentFrames.length / 30) * 100) : 0,
+            qualityScore: currentFrames.length > 0 ? Math.min(100, (currentFrames.length / 20) * 100) : 0,
             challengesCompleted: currentCompletedChallenges,
             sessionId,
           };
@@ -570,7 +623,7 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
         frames: currentFrames.length > 0 ? currentFrames : [],
         duration: actualDuration,
         instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-        qualityScore: currentFrames.length > 0 ? Math.min(100, (currentFrames.length / 30) * 100) : 0,
+        qualityScore: currentFrames.length > 0 ? Math.min(100, (currentFrames.length / 20) * 100) : 0,
         challengesCompleted: currentCompletedChallenges,
         sessionId,
       };
@@ -615,12 +668,13 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
       } else {
         const actualDuration = Date.now() - recordingStartTime.current;
         const currentCompletedChallenges = completedChallengesRef.current.length > 0 ? completedChallengesRef.current : completedChallenges;
-        if (actualDuration >= minDurationMs && frames.length > 0) {
+        const currentFrames = framesRef.current.length > 0 ? framesRef.current : frames;
+        if (actualDuration >= minDurationMs && currentFrames.length > 0) {
           const result: VideoRecordingResult = {
-            frames,
+            frames: currentFrames,
             duration: actualDuration,
             instructionsFollowed: currentCompletedChallenges.length === challenges.length,
-            qualityScore: Math.min(100, (frames.length / 30) * 100),
+            qualityScore: Math.min(100, (currentFrames.length / 20) * 100),
             challengesCompleted: currentCompletedChallenges,
             sessionId,
           };
@@ -1021,6 +1075,12 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
           </>
         )}
         
+        {phase === 'recording' && guidanceText && (
+          <View style={styles.guidanceContainer}>
+            <Text style={styles.guidanceText}>{guidanceText}</Text>
+          </View>
+        )}
+
         {phase === 'recording' && (
           <Text style={styles.bottomText}>
             {strings.liveness.recordingInstructions || 'Keep your face visible and follow the instructions'}
@@ -1253,6 +1313,21 @@ const styles = StyleSheet.create({
     backgroundColor: 'rgba(0, 0, 0, 0.9)',
     alignItems: 'center',
   },
+  guidanceContainer: {
+    backgroundColor: 'rgba(239, 68, 68, 0.85)',
+    borderRadius: 8,
+    paddingVertical: 8,
+    paddingHorizontal: 16,
+    marginHorizontal: 20,
+    marginBottom: 8,
+    alignItems: 'center' as const,
+  },
+  guidanceText: {
+    color: '#FFFFFF',
+    fontSize: 14,
+    fontWeight: '600' as const,
+    textAlign: 'center' as const,
+  },
   bottomText: {
     color: '#FFFFFF',
     fontSize: 16,

package/src/hooks/useBiometricSDK.ts

@@ -39,8 +39,9 @@ export const useBiometricSDK = (): UseBiometricSDKResult => {
 
   useEffect(() => {
     isMounted.current = true;
-    
-    const init = async () => {
+    let retryTimeout: NodeJS.Timeout | null = null;
+
+    const init = async (attempt = 1) => {
       try {
         await sdk.initialize();
         if (isMounted.current) {
@@ -48,7 +49,13 @@ export const useBiometricSDK = (): UseBiometricSDKResult => {
           setState(sdk.getState());
         }
       } catch (error) {
-        logger.error('SDK initialization failed:', error);
+        logger.error(`SDK initialization failed (attempt ${attempt}):`, error);
+        // Retry up to 3 times with exponential backoff (1s, 2s, 4s)
+        if (attempt < 4 && isMounted.current) {
+          const delay = Math.min(1000 * Math.pow(2, attempt - 1), 4000);
+          logger.info(`Retrying SDK init in ${delay}ms`);
+          retryTimeout = setTimeout(() => init(attempt + 1), delay);
+        }
       }
     };
 
@@ -56,6 +63,7 @@ export const useBiometricSDK = (): UseBiometricSDKResult => {
 
     return () => {
       isMounted.current = false;
+      if (retryTimeout) clearTimeout(retryTimeout);
       sdk.dispose();
     };
   }, [sdk]);