@hexar/biometric-identity-sdk-react-native 1.0.16 → 1.0.18

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

@@ -1 +1 @@
-{"version":3,"file":"BiometricIdentityFlow.d.ts","sourceRoot":"","sources":["../../src/components/BiometricIdentityFlow.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,EAOL,SAAS,EACV,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,cAAc,EAKd,iBAAiB,EAElB,MAAM,oCAAoC,CAAC;AAU5C,MAAM,WAAW,0BAA0B;IACzC,oBAAoB,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,OAAO,CAAC,EAAE,SAAS,CAAC;KACrB,CAAC;CACH;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CA8VtE,CAAC;AAiOF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"BiometricIdentityFlow.d.ts","sourceRoot":"","sources":["../../src/components/BiometricIdentityFlow.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,EAOL,SAAS,EACV,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,cAAc,EAKd,iBAAiB,EAElB,MAAM,oCAAoC,CAAC;AAU5C,MAAM,WAAW,0BAA0B;IACzC,oBAAoB,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACzD,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,OAAO,CAAC,EAAE,SAAS,CAAC;KACrB,CAAC;CACH;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAiWtE,CAAC;AA8NF,eAAe,qBAAqB,CAAC"}

package/dist/components/BiometricIdentityFlow.js

@@ -55,49 +55,37 @@ const BiometricIdentityFlow = ({ onValidationComplete, onError, theme, language,
     const [showInstructions, setShowInstructions] = (0, react_1.useState)(true);
     const [currentChallenges, setCurrentChallenges] = (0, react_1.useState)([]);
     const [isLoadingChallenges, setIsLoadingChallenges] = (0, react_1.useState)(false);
-    // Use refs to store callbacks to avoid dependency issues in useEffect
     const onValidationCompleteRef = (0, react_1.useRef)(onValidationComplete);
     const onErrorRef = (0, react_1.useRef)(onError);
     const hasCalledValidationComplete = (0, react_1.useRef)(false);
-    // Update refs when callbacks change
     (0, react_1.useEffect)(() => {
         onValidationCompleteRef.current = onValidationComplete;
         onErrorRef.current = onError;
     }, [onValidationComplete, onError]);
-    // Set language early, before any components render
-    // Priority: language prop > SDK config language > default 'en'
-    // Run on mount and whenever language prop changes
     (0, react_1.useEffect)(() => {
         if (language) {
-            // If language prop is provided, override the config
             (0, biometric_identity_sdk_core_1.setLanguage)(language);
         }
-        // If no language prop, the language should already be set by BiometricIdentitySDK.configure()
-        // The global language state is set when configure() is called, so getStrings() will
-        // automatically return strings for the configured language (or 'en' as default)
     }, [language]);
     const strings = (0, biometric_identity_sdk_core_1.getStrings)();
     const styles = createStyles(theme);
-    // Handle validation result - call callback when RESULT step is reached
     (0, react_1.useEffect)(() => {
+        console.log('🔵 [BiometricIdentityFlow] useEffect triggered - currentStep:', state.currentStep, 'hasResult:', !!state.validationResult, 'hasCalled:', hasCalledValidationComplete.current);
         if (state.currentStep === biometric_identity_sdk_core_1.SDKStep.RESULT && state.validationResult && !hasCalledValidationComplete.current) {
+            console.log('🟢 [BiometricIdentityFlow] Calling onValidationComplete callback');
             biometric_identity_sdk_core_1.logger.info('Validation completed, calling onValidationComplete callback');
             hasCalledValidationComplete.current = true;
-            // Use ref to avoid dependency issues
             onValidationCompleteRef.current(state.validationResult);
         }
     }, [state.currentStep, state.validationResult]);
-    // Reset the flag when validation result changes or component resets
     (0, react_1.useEffect)(() => {
         if (state.currentStep !== biometric_identity_sdk_core_1.SDKStep.RESULT) {
             hasCalledValidationComplete.current = false;
         }
     }, [state.currentStep]);
-    // Handle error
     (0, react_1.useEffect)(() => {
         if (state.error) {
             biometric_identity_sdk_core_1.logger.error('SDK error detected:', state.error);
-            // Use ref to avoid dependency issues
             onErrorRef.current(state.error);
         }
     }, [state.error]);
@@ -106,7 +94,6 @@ const BiometricIdentityFlow = ({ onValidationComplete, onError, theme, language,
      */
     const handleCaptureStart = (0, react_1.useCallback)(async (mode) => {
         setCameraMode(mode);
-        // If video mode, fetch challenges first
         if (mode === 'video' && smartLivenessMode && isUsingBackend) {
             setIsLoadingChallenges(true);
             try {
@@ -120,7 +107,6 @@ const BiometricIdentityFlow = ({ onValidationComplete, onError, theme, language,
             setIsLoadingChallenges(false);
         }
         else if (mode === 'video' && smartLivenessMode) {
-            // Use default challenges for offline mode
             setCurrentChallenges(sdk.getDefaultChallenges());
         }
         setShowCamera(true);
@@ -147,29 +133,55 @@ const BiometricIdentityFlow = ({ onValidationComplete, onError, theme, language,
                     challengesCompleted: videoResult.challengesCompleted,
                     sessionId: videoResult.sessionId,
                 });
+                console.log('🔵 [BiometricIdentityFlow] Video stored, starting validation...');
                 biometric_identity_sdk_core_1.logger.info('Starting validation...');
-                const result = await validateIdentity();
-                biometric_identity_sdk_core_1.logger.info('Validation completed successfully:', result);
-                // Ensure state is synced after validation
-                // The state should be updated by validateIdentity, but we'll force a sync
+                let result = null;
+                try {
+                    result = await validateIdentity();
+                    console.log('🟢 [BiometricIdentityFlow] Validation completed:', result);
+                    biometric_identity_sdk_core_1.logger.info('Validation completed successfully:', result);
+                }
+                catch (validationError) {
+                    console.error('❌ [BiometricIdentityFlow] Validation error:', validationError);
+                    biometric_identity_sdk_core_1.logger.error('Validation error:', validationError);
+                    throw validationError; // Re-throw to be caught by outer catch
+                }
                 const finalState = sdk.getState();
+                console.log('🔵 [BiometricIdentityFlow] Final state after validation:', JSON.stringify({
+                    currentStep: finalState.currentStep,
+                    hasResult: !!finalState.validationResult,
+                    progress: finalState.progress,
+                    isLoading: finalState.isLoading
+                }));
                 biometric_identity_sdk_core_1.logger.info('Final state after validation:', finalState);
-                // Backup: If we have a result but the useEffect didn't fire, call the callback directly
+                if (result && !hasCalledValidationComplete.current) {
+                    console.log('🟢 [BiometricIdentityFlow] Calling onValidationComplete directly with result');
+                    biometric_identity_sdk_core_1.logger.info('Calling onValidationComplete directly with validation result');
+                    hasCalledValidationComplete.current = true;
+                    onValidationCompleteRef.current(result);
+                }
                 if (finalState.currentStep === biometric_identity_sdk_core_1.SDKStep.RESULT && finalState.validationResult && !hasCalledValidationComplete.current) {
-                    biometric_identity_sdk_core_1.logger.info('Backup: Calling onValidationComplete directly after validation');
+                    console.log('🟢 [BiometricIdentityFlow] Backup: Calling onValidationComplete from state');
+                    biometric_identity_sdk_core_1.logger.info('Backup: Calling onValidationComplete from state');
                     hasCalledValidationComplete.current = true;
                     onValidationCompleteRef.current(finalState.validationResult);
                 }
             }
         }
         catch (error) {
+            console.error('❌ [BiometricIdentityFlow] Capture/validation error:', error);
             biometric_identity_sdk_core_1.logger.error('Capture/validation error:', error);
-            const biometricError = {
-                name: 'BiometricError',
-                message: error instanceof Error ? error.message : 'Unknown error during capture',
-                code: 'LIVENESS_CHECK_FAILED',
-            };
-            onErrorRef.current(biometricError);
+            if (error && typeof error === 'object' && 'code' in error) {
+                onErrorRef.current(error);
+            }
+            else {
+                const biometricError = {
+                    name: 'BiometricError',
+                    message: error instanceof Error ? error.message : 'Unknown error during capture',
+                    code: 'LIVENESS_CHECK_FAILED',
+                };
+                onErrorRef.current(biometricError);
+            }
         }
     }, [cameraMode, uploadFrontID, uploadBackID, storeVideoRecording, validateIdentity, sdk]);
     /**
@@ -181,18 +193,15 @@ const BiometricIdentityFlow = ({ onValidationComplete, onError, theme, language,
         setCurrentChallenges([]);
         setShowInstructions(true);
     }, [reset]);
-    // Show loading while initializing
     if (!isInitialized) {
         return (react_1.default.createElement(react_native_1.SafeAreaView, { style: [styles.container, customStyles?.container] },
             react_1.default.createElement(react_native_1.View, { style: styles.loadingFullScreen },
                 react_1.default.createElement(react_native_1.ActivityIndicator, { size: "large", color: theme?.primaryColor || '#6366F1' }),
                 react_1.default.createElement(react_native_1.Text, { style: styles.loadingText }, strings.initialization.initializing))));
     }
-    // Show instructions on first load
     if (showInstructions) {
         return (react_1.default.createElement(InstructionsScreen_1.InstructionsScreen, { theme: theme, language: language, onStart: () => setShowInstructions(false), routeBack: routeBack, styles: customStyles }));
     }
-    // Show camera/video recorder
     if (showCamera) {
         if (cameraMode === 'video') {
             return (react_1.default.createElement(VideoRecorder_1.VideoRecorder, { theme: theme, language: language, challenges: currentChallenges, smartMode: smartLivenessMode, sessionId: sdk.getSessionId() || undefined, onComplete: handleCaptureComplete, onCancel: () => setShowCamera(false), onFetchChallenges: async () => {
@@ -202,23 +211,16 @@ const BiometricIdentityFlow = ({ onValidationComplete, onError, theme, language,
         }
         return (react_1.default.createElement(CameraCapture_1.CameraCapture, { mode: cameraMode, theme: theme, language: language, onCapture: handleCaptureComplete, onCancel: () => setShowCamera(false) }));
     }
-    // Show result (check this first, even if step is still VALIDATING but result exists)
-    // This handles edge cases where state transition might be delayed
     if (state.validationResult && (state.currentStep === biometric_identity_sdk_core_1.SDKStep.RESULT || state.progress >= 100)) {
-        // If we have a result but step is still VALIDATING, force transition to RESULT
         if (state.currentStep === biometric_identity_sdk_core_1.SDKStep.VALIDATING && state.progress >= 100) {
             biometric_identity_sdk_core_1.logger.info('Result available but step still VALIDATING, showing ResultScreen');
         }
         return (react_1.default.createElement(ResultScreen_1.ResultScreen, { result: state.validationResult, theme: theme, language: language, onClose: () => {
-                // Callback already called automatically when RESULT step was reached
-                // This onClose is just for UI cleanup/navigation
             } }));
     }
-    // Show validation progress
     if (state.currentStep === biometric_identity_sdk_core_1.SDKStep.VALIDATING) {
         return (react_1.default.createElement(ValidationProgress_1.ValidationProgress, { progress: state.progress, theme: theme, language: language }));
     }
-    // Show error
     if (state.currentStep === biometric_identity_sdk_core_1.SDKStep.ERROR && state.error) {
         return (react_1.default.createElement(ErrorScreen_1.ErrorScreen, { error: state.error, theme: theme, language: language, onRetry: handleRetry, onClose: () => onError(state.error) }));
     }
@@ -323,7 +325,6 @@ const buttonStyles = react_native_1.StyleSheet.create({
         marginTop: 4,
     },
 });
-// Create styles based on theme
 const createStyles = (theme) => {
     const backgroundColor = theme?.backgroundColor || '#FFFFFF';
     const textColor = theme?.textColor || '#000000';

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;AAaxE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,iBAAiB,EAAmC,MAAM,oCAAoC,CAAC;AAG1I,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;AA+CD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAkyBtD,CAAC;AA4OF,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;AAaxE,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;AA8CD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA2xBtD,CAAC;AA4OF,eAAe,aAAa,CAAC"}

package/dist/components/VideoRecorder.js

@@ -43,32 +43,31 @@ const react_native_1 = require("react-native");
 const react_native_vision_camera_1 = require("react-native-vision-camera");
 const react_native_permissions_1 = require("react-native-permissions");
 const biometric_identity_sdk_core_1 = require("@hexar/biometric-identity-sdk-core");
-// Default challenge set (used if backend not available)
-const DEFAULT_CHALLENGES = [
+const getDefaultChallenges = (strings) => [
     {
         action: 'look_left',
-        instruction: 'Slowly turn your head to the LEFT',
+        instruction: strings.liveness.instructions.lookLeft || 'Slowly turn your head to the LEFT',
         duration_ms: 2500,
         order: 1,
         icon: '←',
     },
     {
         action: 'look_right',
-        instruction: 'Slowly turn your head to the RIGHT',
+        instruction: strings.liveness.instructions.lookRight || 'Slowly turn your head to the RIGHT',
         duration_ms: 2500,
         order: 2,
         icon: '→',
     },
     {
         action: 'blink',
-        instruction: 'Blink your eyes naturally',
+        instruction: strings.liveness.instructions.blink || 'Blink your eyes naturally',
         duration_ms: 2000,
         order: 3,
         icon: '👁',
     },
     {
         action: 'smile',
-        instruction: 'Smile 😊',
+        instruction: strings.liveness.instructions.smile || 'Smile 😊',
         duration_ms: 2000,
         order: 4,
         icon: '😊',
@@ -87,11 +86,12 @@ const getInstructionMap = (strings) => ({
     stay_still: { text: strings.liveness.instructions.stayStill || 'Look at the camera and follow the instructions', icon: '📷' },
 });
 const VideoRecorder = ({ theme, language, duration, instructions, challenges: propChallenges, sessionId, smartMode = true, onComplete, onCancel, onFetchChallenges, }) => {
-    if (language) {
-        (0, biometric_identity_sdk_core_1.setLanguage)(language);
-    }
+    (0, react_1.useEffect)(() => {
+        if (language) {
+            (0, biometric_identity_sdk_core_1.setLanguage)(language);
+        }
+    }, [language]);
     const strings = (0, biometric_identity_sdk_core_1.getStrings)();
-    // State
     const [phase, setPhase] = (0, react_1.useState)('loading');
     const [countdown, setCountdown] = (0, react_1.useState)(3);
     const [challenges, setChallenges] = (0, react_1.useState)([]);
@@ -101,11 +101,9 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
     const [completedChallenges, setCompletedChallenges] = (0, react_1.useState)([]);
     const [frames, setFrames] = (0, react_1.useState)([]);
     const [hasPermission, setHasPermission] = (0, react_1.useState)(false);
-    // Camera
     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');
-    // Animations
     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;
@@ -119,19 +117,15 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
     const recordingTimeoutRef = (0, react_1.useRef)(null);
     const minDurationMs = 8000;
     const totalDuration = duration || Math.max(minDurationMs, challenges.reduce((sum, c) => sum + c.duration_ms, 0) + 2000);
-    // Check camera permissions
     (0, react_1.useEffect)(() => {
         const checkPermissions = async () => {
             try {
-                // First check if we already have permission from the hook
                 if (cameraPermission) {
                     setHasPermission(true);
                     return;
                 }
-                // Otherwise, request permission using the hook
                 const granted = await requestPermission();
                 setHasPermission(granted);
-                // If hook method didn't work, try platform-specific request
                 if (!granted) {
                     if (react_native_1.Platform.OS === 'ios') {
                         const result = await (0, react_native_permissions_1.request)(react_native_permissions_1.PERMISSIONS.IOS.CAMERA);
@@ -151,21 +145,28 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
         };
         checkPermissions();
     }, [cameraPermission, requestPermission]);
-    // Initialize challenges
     (0, react_1.useEffect)(() => {
         const initChallenges = async () => {
             try {
                 let challengeList;
+                const currentStrings = (0, biometric_identity_sdk_core_1.getStrings)();
+                const instructionMap = getInstructionMap(currentStrings);
                 if (propChallenges && propChallenges.length > 0) {
-                    // Use provided challenges
-                    challengeList = propChallenges;
+                    challengeList = propChallenges.map(challenge => ({
+                        ...challenge,
+                        instruction: instructionMap[challenge.action]?.text || challenge.instruction,
+                        icon: instructionMap[challenge.action]?.icon || challenge.icon,
+                    }));
                 }
                 else if (onFetchChallenges) {
-                    // Fetch from backend
-                    challengeList = await onFetchChallenges();
+                    const fetchedChallenges = await onFetchChallenges();
+                    challengeList = fetchedChallenges.map(challenge => ({
+                        ...challenge,
+                        instruction: instructionMap[challenge.action]?.text || challenge.instruction,
+                        icon: instructionMap[challenge.action]?.icon || challenge.icon,
+                    }));
                 }
                 else if (instructions && instructions.length > 0) {
-                    const instructionMap = getInstructionMap(strings);
                     challengeList = instructions.map((inst, idx) => ({
                         action: inst,
                         instruction: instructionMap[inst]?.text || inst,
@@ -175,11 +176,10 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                     }));
                 }
                 else {
-                    // Use default challenges
-                    challengeList = smartMode ? DEFAULT_CHALLENGES : [
+                    challengeList = smartMode ? getDefaultChallenges(currentStrings) : [
                         {
                             action: 'stay_still',
-                            instruction: 'Look at the camera and stay still',
+                            instruction: currentStrings.liveness.instructions.stayStill || 'Look at the camera and stay still',
                             duration_ms: duration || 5000,
                             order: 1,
                             icon: '📷',
@@ -191,19 +191,16 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
             }
             catch (error) {
                 biometric_identity_sdk_core_1.logger.error('Failed to fetch challenges:', error);
-                // Fallback to default
-                setChallenges(DEFAULT_CHALLENGES);
+                setChallenges(getDefaultChallenges((0, biometric_identity_sdk_core_1.getStrings)()));
                 setPhase('countdown');
             }
         };
         initChallenges();
-    }, [propChallenges, instructions, onFetchChallenges, smartMode, duration]);
-    // Countdown phase
+    }, [propChallenges, instructions, onFetchChallenges, smartMode, duration, language]);
     (0, react_1.useEffect)(() => {
         if (phase !== 'countdown')
             return;
         if (countdown > 0) {
-            // Animate countdown number
             react_native_1.Animated.sequence([
                 react_native_1.Animated.timing(scaleAnim, {
                     toValue: 1.3,
@@ -223,7 +220,6 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
             startRecording();
         }
     }, [countdown, phase]);
-    // Start pulse animation for recording indicator
     (0, react_1.useEffect)(() => {
         if (phase === 'recording') {
             react_native_1.Animated.loop(react_native_1.Animated.sequence([
@@ -242,7 +238,6 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
             ])).start();
         }
     }, [phase]);
-    // Animate arrow for directional challenges
     const animateArrow = (0, react_1.useCallback)((direction) => {
         const toValue = direction.includes('left') ? -20 : direction.includes('right') ? 20 : 0;
         react_native_1.Animated.loop(react_native_1.Animated.sequence([
@@ -356,7 +351,6 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
                     }
                 }
                 catch (error) {
-                    // Silent frame capture errors
                 }
             }, 100);
         }
@@ -546,9 +540,7 @@ const VideoRecorder = ({ theme, language, duration, instructions, challenges: pr
             }
         };
     }, [device, totalDuration, minDurationMs, handleVideoComplete, handleRecordingError, runChallenge, stopRecording, startFrameCapture]);
-    // Current challenge
     const currentChallenge = challenges[currentChallengeIndex];
-    // Get direction arrow for the current challenge
     const getDirectionIndicator = () => {
         if (!currentChallenge)
             return null;

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,qBAgQlC,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,qBA4QlC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/hooks/useBiometricSDK.js

@@ -137,6 +137,7 @@ const useBiometricSDK = () => {
      * Validate identity with all collected data
      */
     const validateIdentity = (0, react_1.useCallback)(async () => {
+        console.log('🔵 [useBiometricSDK] validateIdentity called');
         biometric_identity_sdk_core_1.logger.info('validateIdentity called, current state:', sdk.getState());
         setState(sdk.getState());
         const pollInterval = setInterval(() => {
@@ -145,13 +146,16 @@ const useBiometricSDK = () => {
                 setState(currentState);
             }
         }, 200);
+        let finalPollInterval = null;
         try {
+            console.log('🔵 [useBiometricSDK] Calling sdk.validateIdentity()...');
             const result = await sdk.validateIdentity();
+            console.log('🟢 [useBiometricSDK] sdk.validateIdentity() completed, result:', result);
             // Keep polling for a bit to ensure we capture the RESULT state transition
             // The SDK updates state synchronously, but we want to make sure React sees it
             let pollCount = 0;
             const maxPolls = 10; // Poll for up to 2 seconds (10 * 200ms)
-            const finalPollInterval = setInterval(() => {
+            finalPollInterval = setInterval(() => {
                 pollCount++;
                 if (isMounted.current) {
                     const currentState = sdk.getState();
@@ -159,13 +163,16 @@ const useBiometricSDK = () => {
                     setState(currentState);
                     // Stop polling once we reach RESULT or ERROR state
                     if (currentState.currentStep === biometric_identity_sdk_core_1.SDKStep.RESULT || currentState.currentStep === biometric_identity_sdk_core_1.SDKStep.ERROR) {
-                        clearInterval(finalPollInterval);
+                        console.log('🟢 [useBiometricSDK] Reached final state:', currentState.currentStep);
+                        if (finalPollInterval)
+                            clearInterval(finalPollInterval);
                         clearInterval(pollInterval);
                         biometric_identity_sdk_core_1.logger.info('Reached final state, stopped polling:', currentState);
                     }
                     else if (pollCount >= maxPolls) {
                         // Force stop after max polls
-                        clearInterval(finalPollInterval);
+                        if (finalPollInterval)
+                            clearInterval(finalPollInterval);
                         clearInterval(pollInterval);
                         const finalState = sdk.getState();
                         biometric_identity_sdk_core_1.logger.warn('Max polls reached, forcing final state:', finalState);
@@ -180,17 +187,23 @@ const useBiometricSDK = () => {
                 setState(immediateState);
                 // If we're already at RESULT, clear intervals immediately
                 if (immediateState.currentStep === biometric_identity_sdk_core_1.SDKStep.RESULT || immediateState.currentStep === biometric_identity_sdk_core_1.SDKStep.ERROR) {
-                    clearInterval(finalPollInterval);
+                    if (finalPollInterval)
+                        clearInterval(finalPollInterval);
                     clearInterval(pollInterval);
                 }
             }
             return result;
         }
         catch (error) {
+            // Clear all intervals on error
             clearInterval(pollInterval);
+            if (finalPollInterval) {
+                clearInterval(finalPollInterval);
+            }
+            console.error('❌ [useBiometricSDK] Validation error:', error);
+            biometric_identity_sdk_core_1.logger.error('Validation error, state:', sdk.getState(), error);
             if (isMounted.current) {
                 const errorState = sdk.getState();
-                biometric_identity_sdk_core_1.logger.error('Validation error, state:', errorState, error);
                 setState(errorState);
             }
             throw error;

package/package.json

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

package/src/components/BiometricIdentityFlow.tsx

@@ -77,55 +77,43 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
   const [currentChallenges, setCurrentChallenges] = useState<ChallengeAction[]>([]);
   const [isLoadingChallenges, setIsLoadingChallenges] = useState(false);
   
-  // Use refs to store callbacks to avoid dependency issues in useEffect
   const onValidationCompleteRef = useRef(onValidationComplete);
   const onErrorRef = useRef(onError);
   const hasCalledValidationComplete = useRef(false);
 
-  // Update refs when callbacks change
   useEffect(() => {
     onValidationCompleteRef.current = onValidationComplete;
     onErrorRef.current = onError;
   }, [onValidationComplete, onError]);
 
-  // Set language early, before any components render
-  // Priority: language prop > SDK config language > default 'en'
-  // Run on mount and whenever language prop changes
   useEffect(() => {
     if (language) {
-      // If language prop is provided, override the config
       setLanguage(language);
     }
-    // If no language prop, the language should already be set by BiometricIdentitySDK.configure()
-    // The global language state is set when configure() is called, so getStrings() will
-    // automatically return strings for the configured language (or 'en' as default)
   }, [language]);
 
   const strings = getStrings();
   const styles = createStyles(theme);
 
-  // Handle validation result - call callback when RESULT step is reached
   useEffect(() => {
+    console.log('🔵 [BiometricIdentityFlow] useEffect triggered - currentStep:', state.currentStep, 'hasResult:', !!state.validationResult, 'hasCalled:', hasCalledValidationComplete.current);
     if (state.currentStep === SDKStep.RESULT && state.validationResult && !hasCalledValidationComplete.current) {
+      console.log('🟢 [BiometricIdentityFlow] Calling onValidationComplete callback');
       logger.info('Validation completed, calling onValidationComplete callback');
       hasCalledValidationComplete.current = true;
-      // Use ref to avoid dependency issues
       onValidationCompleteRef.current(state.validationResult);
     }
   }, [state.currentStep, state.validationResult]);
   
-  // Reset the flag when validation result changes or component resets
   useEffect(() => {
     if (state.currentStep !== SDKStep.RESULT) {
       hasCalledValidationComplete.current = false;
     }
   }, [state.currentStep]);
 
-  // Handle error
   useEffect(() => {
     if (state.error) {
       logger.error('SDK error detected:', state.error);
-      // Use ref to avoid dependency issues
       onErrorRef.current(state.error);
     }
   }, [state.error]);
@@ -136,7 +124,6 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
   const handleCaptureStart = useCallback(async (mode: 'front' | 'back' | 'video') => {
     setCameraMode(mode);
     
-    // If video mode, fetch challenges first
     if (mode === 'video' && smartLivenessMode && isUsingBackend) {
       setIsLoadingChallenges(true);
       try {
@@ -148,7 +135,6 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
       }
       setIsLoadingChallenges(false);
     } else if (mode === 'video' && smartLivenessMode) {
-      // Use default challenges for offline mode
       setCurrentChallenges(sdk.getDefaultChallenges());
     }
     
@@ -178,30 +164,57 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
           sessionId: videoResult.sessionId,
         });
         
+        console.log('🔵 [BiometricIdentityFlow] Video stored, starting validation...');
         logger.info('Starting validation...');
-        const result = await validateIdentity();
-        logger.info('Validation completed successfully:', result);
         
-        // Ensure state is synced after validation
-        // The state should be updated by validateIdentity, but we'll force a sync
+        let result: ValidationResult | null = null;
+        try {
+          result = await validateIdentity();
+          console.log('🟢 [BiometricIdentityFlow] Validation completed:', result);
+          logger.info('Validation completed successfully:', result);
+        } catch (validationError) {
+          console.error('❌ [BiometricIdentityFlow] Validation error:', validationError);
+          logger.error('Validation error:', validationError);
+          throw validationError; // Re-throw to be caught by outer catch
+        }
+        
         const finalState = sdk.getState();
+        console.log('🔵 [BiometricIdentityFlow] Final state after validation:', JSON.stringify({
+          currentStep: finalState.currentStep,
+          hasResult: !!finalState.validationResult,
+          progress: finalState.progress,
+          isLoading: finalState.isLoading
+        }));
         logger.info('Final state after validation:', finalState);
         
-        // Backup: If we have a result but the useEffect didn't fire, call the callback directly
+        if (result && !hasCalledValidationComplete.current) {
+          console.log('🟢 [BiometricIdentityFlow] Calling onValidationComplete directly with result');
+          logger.info('Calling onValidationComplete directly with validation result');
+          hasCalledValidationComplete.current = true;
+          onValidationCompleteRef.current(result);
+        }
+        
         if (finalState.currentStep === SDKStep.RESULT && finalState.validationResult && !hasCalledValidationComplete.current) {
-          logger.info('Backup: Calling onValidationComplete directly after validation');
+          console.log('🟢 [BiometricIdentityFlow] Backup: Calling onValidationComplete from state');
+          logger.info('Backup: Calling onValidationComplete from state');
           hasCalledValidationComplete.current = true;
           onValidationCompleteRef.current(finalState.validationResult);
         }
       }
     } catch (error) {
+      console.error('❌ [BiometricIdentityFlow] Capture/validation error:', error);
       logger.error('Capture/validation error:', error);
-      const biometricError: BiometricError = {
-        name: 'BiometricError',
-        message: error instanceof Error ? error.message : 'Unknown error during capture',
-        code: 'LIVENESS_CHECK_FAILED',
-      } as BiometricError;
-      onErrorRef.current(biometricError);
+      
+      if (error && typeof error === 'object' && 'code' in error) {
+        onErrorRef.current(error as BiometricError);
+      } else {
+        const biometricError: BiometricError = {
+          name: 'BiometricError',
+          message: error instanceof Error ? error.message : 'Unknown error during capture',
+          code: 'LIVENESS_CHECK_FAILED',
+        } as BiometricError;
+        onErrorRef.current(biometricError);
+      }
     }
   }, [cameraMode, uploadFrontID, uploadBackID, storeVideoRecording, validateIdentity, sdk]);
 
@@ -215,7 +228,6 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
     setShowInstructions(true);
   }, [reset]);
 
-  // Show loading while initializing
   if (!isInitialized) {
     return (
       <SafeAreaView style={[styles.container, customStyles?.container]}>
@@ -227,7 +239,6 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
     );
   }
 
-  // Show instructions on first load
   if (showInstructions) {
     return (
       <InstructionsScreen
@@ -240,7 +251,6 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
     );
   }
 
-  // Show camera/video recorder
   if (showCamera) {
     if (cameraMode === 'video') {
       return (
@@ -271,10 +281,7 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
     );
   }
 
-  // Show result (check this first, even if step is still VALIDATING but result exists)
-  // This handles edge cases where state transition might be delayed
   if (state.validationResult && (state.currentStep === SDKStep.RESULT || state.progress >= 100)) {
-    // If we have a result but step is still VALIDATING, force transition to RESULT
     if (state.currentStep === SDKStep.VALIDATING && state.progress >= 100) {
       logger.info('Result available but step still VALIDATING, showing ResultScreen');
     }
@@ -284,14 +291,11 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
         theme={theme}
         language={language}
         onClose={() => {
-          // Callback already called automatically when RESULT step was reached
-          // This onClose is just for UI cleanup/navigation
         }}
       />
     );
   }
 
-  // Show validation progress
   if (state.currentStep === SDKStep.VALIDATING) {
     return (
       <ValidationProgress
@@ -302,7 +306,6 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
     );
   }
 
-  // Show error
   if (state.currentStep === SDKStep.ERROR && state.error) {
     return (
       <ErrorScreen
@@ -399,7 +402,6 @@ export const BiometricIdentityFlow: React.FC<BiometricIdentityFlowProps> = ({
   );
 };
 
-// Step Indicator Component
 interface StepIndicatorProps {
   step: number;
   active: boolean;
@@ -467,7 +469,6 @@ const stepStyles = StyleSheet.create({
   },
 });
 
-// Action Button Component
 interface ActionButtonProps {
   title: string;
   subtitle?: string;
@@ -531,7 +532,6 @@ const buttonStyles = StyleSheet.create({
   },
 });
 
-// Create styles based on theme
 const createStyles = (theme?: ThemeConfig) => {
   const backgroundColor = theme?.backgroundColor || '#FFFFFF';
   const textColor = theme?.textColor || '#000000';

package/src/components/VideoRecorder.tsx

@@ -18,7 +18,6 @@ import { Camera, useCameraDevice, useCameraPermission } from 'react-native-visio
 import { request, PERMISSIONS, RESULTS } from 'react-native-permissions';
 import { ThemeConfig, LivenessInstruction, SupportedLanguage, getStrings, setLanguage, logger } from '@hexar/biometric-identity-sdk-core';
 
-// Challenge action configuration (matches backend response)
 export interface ChallengeAction {
   action: string;
   instruction: string;
@@ -57,32 +56,31 @@ export interface VideoRecordingResult {
   sessionId?: string;
 }
 
-// Default challenge set (used if backend not available)
-const DEFAULT_CHALLENGES: ChallengeAction[] = [
+const getDefaultChallenges = (strings: any): ChallengeAction[] => [
   {
     action: 'look_left',
-    instruction: 'Slowly turn your head to the LEFT',
+    instruction: strings.liveness.instructions.lookLeft || 'Slowly turn your head to the LEFT',
     duration_ms: 2500,
     order: 1,
     icon: '←',
   },
   {
     action: 'look_right',
-    instruction: 'Slowly turn your head to the RIGHT',
+    instruction: strings.liveness.instructions.lookRight || 'Slowly turn your head to the RIGHT',
     duration_ms: 2500,
     order: 2,
     icon: '→',
   },
   {
     action: 'blink',
-    instruction: 'Blink your eyes naturally',
+    instruction: strings.liveness.instructions.blink || 'Blink your eyes naturally',
     duration_ms: 2000,
     order: 3,
     icon: '👁',
   },
   {
     action: 'smile',
-    instruction: 'Smile 😊',
+    instruction: strings.liveness.instructions.smile || 'Smile 😊',
     duration_ms: 2000,
     order: 4,
     icon: '😊',
@@ -114,12 +112,13 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
   onCancel,
   onFetchChallenges,
 }) => {
-  if (language) {
-    setLanguage(language);
-  }
-  const strings = getStrings();
+  useEffect(() => {
+    if (language) {
+      setLanguage(language);
+    }
+  }, [language]);
   
-  // State
+  const strings = getStrings();
   const [phase, setPhase] = useState<'loading' | 'countdown' | 'recording' | 'processing'>('loading');
   const [countdown, setCountdown] = useState(3);
   const [challenges, setChallenges] = useState<ChallengeAction[]>([]);
@@ -130,12 +129,10 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
   const [frames, setFrames] = useState<string[]>([]);
   const [hasPermission, setHasPermission] = useState(false);
   
-  // Camera
   const cameraRef = useRef<Camera>(null);
   const { hasPermission: cameraPermission, requestPermission } = useCameraPermission();
   const device = useCameraDevice('front');
   
-  // Animations
   const fadeAnim = useRef(new Animated.Value(0)).current;
   const scaleAnim = useRef(new Animated.Value(1)).current;
   const pulseAnim = useRef(new Animated.Value(1)).current;
@@ -154,21 +151,17 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
     challenges.reduce((sum, c) => sum + c.duration_ms, 0) + 2000
   );
 
-  // Check camera permissions
   useEffect(() => {
     const checkPermissions = async () => {
       try {
-        // First check if we already have permission from the hook
         if (cameraPermission) {
           setHasPermission(true);
           return;
         }
         
-        // Otherwise, request permission using the hook
         const granted = await requestPermission();
         setHasPermission(granted);
         
-        // If hook method didn't work, try platform-specific request
         if (!granted) {
           if (Platform.OS === 'ios') {
             const result = await request(PERMISSIONS.IOS.CAMERA);
@@ -191,20 +184,27 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
     checkPermissions();
   }, [cameraPermission, requestPermission]);
 
-  // Initialize challenges
   useEffect(() => {
     const initChallenges = async () => {
       try {
         let challengeList: ChallengeAction[];
+        const currentStrings = getStrings();
+        const instructionMap = getInstructionMap(currentStrings);
         
         if (propChallenges && propChallenges.length > 0) {
-          // Use provided challenges
-          challengeList = propChallenges;
+          challengeList = propChallenges.map(challenge => ({
+            ...challenge,
+            instruction: instructionMap[challenge.action]?.text || challenge.instruction,
+            icon: instructionMap[challenge.action]?.icon || challenge.icon,
+          }));
         } else if (onFetchChallenges) {
-          // Fetch from backend
-          challengeList = await onFetchChallenges();
+          const fetchedChallenges = await onFetchChallenges();
+          challengeList = fetchedChallenges.map(challenge => ({
+            ...challenge,
+            instruction: instructionMap[challenge.action]?.text || challenge.instruction,
+            icon: instructionMap[challenge.action]?.icon || challenge.icon,
+          }));
         } else if (instructions && instructions.length > 0) {
-          const instructionMap = getInstructionMap(strings);
           challengeList = instructions.map((inst, idx) => ({
             action: inst,
             instruction: instructionMap[inst]?.text || inst,
@@ -213,11 +213,10 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
             icon: instructionMap[inst]?.icon,
           }));
         } else {
-          // Use default challenges
-          challengeList = smartMode ? DEFAULT_CHALLENGES : [
+          challengeList = smartMode ? getDefaultChallenges(currentStrings) : [
             {
               action: 'stay_still',
-              instruction: 'Look at the camera and stay still',
+              instruction: currentStrings.liveness.instructions.stayStill || 'Look at the camera and stay still',
               duration_ms: duration || 5000,
               order: 1,
               icon: '📷',
@@ -229,21 +228,18 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
         setPhase('countdown');
       } catch (error) {
         logger.error('Failed to fetch challenges:', error);
-        // Fallback to default
-        setChallenges(DEFAULT_CHALLENGES);
+        setChallenges(getDefaultChallenges(getStrings()));
         setPhase('countdown');
       }
     };
 
     initChallenges();
-  }, [propChallenges, instructions, onFetchChallenges, smartMode, duration]);
+  }, [propChallenges, instructions, onFetchChallenges, smartMode, duration, language]);
 
-  // Countdown phase
   useEffect(() => {
     if (phase !== 'countdown') return;
 
     if (countdown > 0) {
-      // Animate countdown number
       Animated.sequence([
         Animated.timing(scaleAnim, {
           toValue: 1.3,
@@ -264,7 +260,6 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
     }
   }, [countdown, phase]);
 
-  // Start pulse animation for recording indicator
   useEffect(() => {
     if (phase === 'recording') {
       Animated.loop(
@@ -286,7 +281,6 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
     }
   }, [phase]);
 
-  // Animate arrow for directional challenges
   const animateArrow = useCallback((direction: string) => {
     const toValue = direction.includes('left') ? -20 : direction.includes('right') ? 20 : 0;
     
@@ -422,7 +416,6 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
             }
           }
         } catch (error) {
-          // Silent frame capture errors
         }
       }, 100);
     }
@@ -641,10 +634,8 @@ export const VideoRecorder: React.FC<VideoRecorderProps> = ({
     };
   }, [device, totalDuration, minDurationMs, handleVideoComplete, handleRecordingError, runChallenge, stopRecording, startFrameCapture]);
 
-  // Current challenge
   const currentChallenge = challenges[currentChallengeIndex];
 
-  // Get direction arrow for the current challenge
   const getDirectionIndicator = () => {
     if (!currentChallenge) return null;
     

package/src/hooks/useBiometricSDK.ts

@@ -194,6 +194,7 @@ export const useBiometricSDK = (): UseBiometricSDKResult => {
    * Validate identity with all collected data
    */
   const validateIdentity = useCallback(async () => {
+    console.log('🔵 [useBiometricSDK] validateIdentity called');
     logger.info('validateIdentity called, current state:', sdk.getState());
     setState(sdk.getState());
     
@@ -204,15 +205,19 @@ export const useBiometricSDK = (): UseBiometricSDKResult => {
       }
     }, 200);
     
+    let finalPollInterval: NodeJS.Timeout | null = null;
+    
     try {
+      console.log('🔵 [useBiometricSDK] Calling sdk.validateIdentity()...');
       const result = await sdk.validateIdentity();
+      console.log('🟢 [useBiometricSDK] sdk.validateIdentity() completed, result:', result);
       
       // Keep polling for a bit to ensure we capture the RESULT state transition
       // The SDK updates state synchronously, but we want to make sure React sees it
       let pollCount = 0;
       const maxPolls = 10; // Poll for up to 2 seconds (10 * 200ms)
       
-      const finalPollInterval = setInterval(() => {
+      finalPollInterval = setInterval(() => {
         pollCount++;
         if (isMounted.current) {
           const currentState = sdk.getState();
@@ -221,12 +226,13 @@ export const useBiometricSDK = (): UseBiometricSDKResult => {
           
           // Stop polling once we reach RESULT or ERROR state
           if (currentState.currentStep === SDKStep.RESULT || currentState.currentStep === SDKStep.ERROR) {
-            clearInterval(finalPollInterval);
+            console.log('🟢 [useBiometricSDK] Reached final state:', currentState.currentStep);
+            if (finalPollInterval) clearInterval(finalPollInterval);
             clearInterval(pollInterval);
             logger.info('Reached final state, stopped polling:', currentState);
           } else if (pollCount >= maxPolls) {
             // Force stop after max polls
-            clearInterval(finalPollInterval);
+            if (finalPollInterval) clearInterval(finalPollInterval);
             clearInterval(pollInterval);
             const finalState = sdk.getState();
             logger.warn('Max polls reached, forcing final state:', finalState);
@@ -243,17 +249,23 @@ export const useBiometricSDK = (): UseBiometricSDKResult => {
         
         // If we're already at RESULT, clear intervals immediately
         if (immediateState.currentStep === SDKStep.RESULT || immediateState.currentStep === SDKStep.ERROR) {
-          clearInterval(finalPollInterval);
+          if (finalPollInterval) clearInterval(finalPollInterval);
           clearInterval(pollInterval);
         }
       }
       
       return result;
     } catch (error) {
+      // Clear all intervals on error
       clearInterval(pollInterval);
+      if (finalPollInterval) {
+        clearInterval(finalPollInterval);
+      }
+      console.error('❌ [useBiometricSDK] Validation error:', error);
+      logger.error('Validation error, state:', sdk.getState(), error);
+      
       if (isMounted.current) {
         const errorState = sdk.getState();
-        logger.error('Validation error, state:', errorState, error);
         setState(errorState);
       }
       throw error;