@trustchex/react-native-sdk 1.267.0 → 1.354.0

package/lib/module/Shared/Components/IdentityDocumentCamera.js

@@ -3,6 +3,7 @@
 /* eslint-disable react-native/no-inline-styles */
 import React, { useEffect, useState } from 'react';
 import { View, StyleSheet, Text as TextView, Platform, Vibration, TouchableOpacity, Text, Linking, Image, ActivityIndicator } from 'react-native';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import { Camera, runAtTargetFps, useCameraDevice, useCameraFormat, useCameraPermission, useFrameProcessor } from 'react-native-vision-camera';
 import { runAsync } from "../Libs/worklet.utils.js";
 import { useRunOnJS, useSharedValue } from 'react-native-worklets-core';
@@ -14,10 +15,11 @@ import { useKeepAwake } from "../Libs/native-keep-awake.utils.js";
 import ImageEditor from '@react-native-community/image-editor';
 import { useIsFocused } from '@react-navigation/native';
 import { AdaptiveThresholdTypes, ColorConversionCodes, DataTypes, ObjectType, OpenCV, ThresholdTypes } from 'react-native-fast-opencv';
-import { getAverageBrightness } from "../Libs/camera.utils.js";
+import { getAverageBrightness, getScanAreaCenterPoint, calculateExposureStep, isBlurry as checkBlurry } from "../Libs/camera.utils.js";
 import { useTranslation } from 'react-i18next';
 import LottieView from 'lottie-react-native';
 import StyledButton from "./StyledButton.js";
+import { SafeAreaView } from 'react-native-safe-area-context';
 import { scanCodes } from "../VisionCameraPlugins/BarcodeScanner/index.js";
 import { speakWithDebounce } from "../Libs/tts.utils.js";
 import AppContext from "../Contexts/AppContext.js";
@@ -39,6 +41,7 @@ const IdentityDocumentCamera = ({
 }) => {
   useKeepAwake();
   const theme = useTheme();
+  const insets = useSafeAreaInsets();
   const appContext = React.useContext(AppContext);
   const cameraRef = React.useRef(null);
   const cameraPermission = useCameraPermission();
@@ -68,13 +71,17 @@ const IdentityDocumentCamera = ({
   const [currentHologramImage, setCurrentHologramImage] = useState(undefined);
   const [currentSecondaryFaceImage, setCurrentSecondaryFaceImage] = useState(undefined);
   const [isBrightnessLow, setIsBrightnessLow] = useState(false);
+  const [isFrameBlurry, setIsFrameBlurry] = useState(false);
   const [hasGuideShown, setHasGuideShown] = useState(false);
   const [status, setStatus] = useState('SEARCHING');
   const [nextStep, setNextStep] = useState('SCAN_ID_FRONT_OR_PASSPORT');
+  const [completedStep, setCompletedStep] = useState(null);
+  const [detectedDocumentType, setDetectedDocumentType] = useState('UNKNOWN');
   const hologramDetectionCurrentRetryCount = useSharedValue(0);
   const secondaryFaceDetectionCurrentRetryCount = useSharedValue(0);
   const mrzDetectionCurrentRetryCount = useSharedValue(0);
   const faceDetectionErrorCount = useSharedValue(0);
+  const consecutiveBlurCount = useSharedValue(0);
   const [faceDetectionEnabled, setFaceDetectionEnabled] = useState(true);
   const {
     t
@@ -146,12 +153,109 @@ const IdentityDocumentCamera = ({
   }, [device, format, isFocused, hologramDetectionCurrentRetryCount, secondaryFaceDetectionCurrentRetryCount, mrzDetectionCurrentRetryCount, faceDetectionErrorCount]);
   useEffect(() => {
     if (hasGuideShown) {
-      const message = isBrightnessLow ? t('identityDocumentCamera.lowBrightness') : nextStep === 'SCAN_ID_FRONT_OR_PASSPORT' ? t('identityDocumentCamera.alignPhotoSide') : nextStep === 'SCAN_HOLOGRAM' ? t('identityDocumentCamera.alignHologram') : nextStep === 'SCAN_ID_BACK' ? t('identityDocumentCamera.alignIDBackSide') : nextStep === 'COMPLETED' ? t('identityDocumentCamera.scanCompleted') : '';
+      let message = '';
+
+      // Priority: scanned > incorrect > blur during scanning > brightness > blur > step-specific
+      if (status === 'SCANNED') {
+        // Use step-specific completion messages
+        if (completedStep === 'SCAN_ID_FRONT_OR_PASSPORT') {
+          message = detectedDocumentType === 'PASSPORT' ? t('identityDocumentCamera.passportScanned') : t('identityDocumentCamera.frontSideScanned');
+        } else if (completedStep === 'SCAN_ID_BACK') {
+          message = t('identityDocumentCamera.backSideScanned');
+        } else if (completedStep === 'SCAN_HOLOGRAM') {
+          message = t('identityDocumentCamera.hologramVerified');
+        } else {
+          message = t('identityDocumentCamera.scanCompleted');
+        }
+      } else if (status === 'INCORRECT') {
+        // Wrong side detected - warn user
+        if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT') {
+          message = t('identityDocumentCamera.wrongSideFront');
+        } else if (nextStep === 'SCAN_ID_BACK') {
+          message = t('identityDocumentCamera.wrongSideBack');
+        }
+      } else if (isBrightnessLow) {
+        // Brightness warning takes priority over blur
+        message = t('identityDocumentCamera.lowBrightness');
+      } else if (isFrameBlurry) {
+        // Show blur warning only when brightness is sufficient
+        message = t('identityDocumentCamera.avoidBlur');
+      } else if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT') {
+        // Enhanced feedback based on detection status
+        if (status === 'SCANNING') {
+          if (currentFaceImage) {
+            // Document-specific detection message
+            if (detectedDocumentType === 'PASSPORT') {
+              message = t('identityDocumentCamera.passportDetected');
+            } else if (detectedDocumentType === 'ID_FRONT') {
+              message = t('identityDocumentCamera.idCardFrontDetected');
+            } else {
+              message = t('identityDocumentCamera.readingDocument');
+            }
+          } else {
+            message = t('identityDocumentCamera.readingDocument');
+          }
+        } else {
+          message = t('identityDocumentCamera.alignPhotoSide');
+        }
+      } else if (nextStep === 'SCAN_HOLOGRAM') {
+        message = t('identityDocumentCamera.alignHologram');
+      } else if (nextStep === 'SCAN_ID_BACK') {
+        if (status === 'SCANNING') {
+          message = t('identityDocumentCamera.readingDocument');
+        } else {
+          message = t('identityDocumentCamera.alignIDBackSide');
+        }
+      } else if (nextStep === 'COMPLETED') {
+        message = t('identityDocumentCamera.scanCompleted');
+      }
       if (appContext.currentWorkflowStep?.data?.voiceGuidanceActive && message) {
         speakWithDebounce(message);
       }
     }
-  }, [appContext.currentWorkflowStep?.data?.voiceGuidanceActive, hasGuideShown, isBrightnessLow, nextStep, t]);
+  }, [appContext.currentWorkflowStep?.data?.voiceGuidanceActive, hasGuideShown, isBrightnessLow, isFrameBlurry, nextStep, status, completedStep, currentFaceImage, detectedDocumentType, t]);
+
+  // Auto-reset INCORRECT status after showing warning briefly
+  useEffect(() => {
+    if (status === 'INCORRECT') {
+      const timeout = setTimeout(() => {
+        setStatus('SEARCHING');
+      }, 1500); // Show warning for 1.5 seconds
+      return () => clearTimeout(timeout);
+    }
+  }, [status]);
+
+  // Periodic autofocus - refocus on scan area center every 2.5 seconds
+  useEffect(() => {
+    if (!isActive || !device || !cameraRef.current || !device.supportsFocus) {
+      return;
+    }
+
+    // Only autofocus during searching and scanning states
+    if (status !== 'SEARCHING' && status !== 'SCANNING') {
+      return;
+    }
+    const autofocusInterval = setInterval(async () => {
+      try {
+        // Get camera dimensions (assuming format dimensions)
+        const width = format?.videoWidth ?? 1920;
+        const height = format?.videoHeight ?? 1080;
+
+        // Calculate center point of scan area
+        const centerPoint = getScanAreaCenterPoint(width, height);
+
+        // Focus on the center of the scan area
+        await cameraRef.current?.focus({
+          x: centerPoint.x,
+          y: centerPoint.y
+        });
+      } catch (error) {
+        // Ignore autofocus errors
+      }
+    }, 2500); // Every 2.5 seconds
+
+    return () => clearInterval(autofocusInterval);
+  }, [isActive, device, format, status]);
   const detectDocumentType = (faces, ocrText, mrzFields) => {
     if (faces.length > 0 && !mrzFields && ocrText?.includes('Signature')
     // ocrText?.includes('Surname') &&
@@ -357,13 +461,28 @@ const IdentityDocumentCamera = ({
     }
     return croppedFaces;
   };
-  const setNextStepAndVibrate = nextStepType => {
+  const setNextStepAndVibrate = (nextStepType, fromStep) => {
+    // Track which step was just completed for showing specific message
+    if (fromStep) {
+      setCompletedStep(fromStep);
+    }
     setNextStep(nextStepType);
     Vibration.vibrate(100);
+
+    // Reset status after delay to show success animation fully before next step
+    if (nextStepType !== 'COMPLETED') {
+      setTimeout(() => {
+        setStatus('SEARCHING');
+        setCompletedStep(null);
+      }, 2000); // Show success checkmark for 2 seconds before transitioning
+    }
   };
   const handleBrightness = useRunOnJS(isBright => {
     setIsBrightnessLow(!isBright);
   }, [setIsBrightnessLow]);
+  const handleBlurStatus = useRunOnJS(blurry => {
+    setIsFrameBlurry(blurry);
+  }, [setIsFrameBlurry]);
   const handleFaceAndText = useRunOnJS(async (text, faces, frameWidth, frameHeight, barcode, image) => {
     if (device?.hasTorch && isTorchOn && (currentHologramImage || hologramDetectionCurrentRetryCount.value >= HOLOGRAM_DETECTION_RETRY_COUNT)) {
       setIsTorchOn(false);
@@ -372,7 +491,18 @@ const IdentityDocumentCamera = ({
       setStatus('SCANNED');
       return;
     }
+
+    // Early wrong side detection for SCAN_ID_BACK: if faces detected, it's the front side
+    if (nextStep === 'SCAN_ID_BACK' && faces.length > 0) {
+      console.log('[WRONG_SIDE] Back side expected but faces detected:', faces.length);
+      setStatus('INCORRECT');
+      return;
+    }
     if (!text || text.length < 10 || !image) {
+      // Log when searching to help debug
+      if (nextStep === 'SCAN_ID_BACK') {
+        console.log('[SCAN_ID_BACK] Searching... faces:', faces.length, 'text length:', text?.length || 0);
+      }
       setStatus('SEARCHING');
       return;
     }
@@ -390,11 +520,21 @@ const IdentityDocumentCamera = ({
     };
     scannedData.faceImage = croppedFaces[0];
     setCurrentFaceImage(croppedFaces[0]);
+
+    // Track detected document type for UI feedback
+    if (documentType !== 'UNKNOWN') {
+      setDetectedDocumentType(documentType);
+    }
+
+    // Detect wrong side based on document type or face presence (works for both normal and eID scan)
+    // For ID_BACK step: if faces are detected, it's likely the front side (wrong)
+    // For FRONT step: if ID_BACK is detected, it's the wrong side
+    const isWrongSide = nextStep === 'SCAN_ID_FRONT_OR_PASSPORT' && documentType === 'ID_BACK' || nextStep === 'SCAN_ID_BACK' && (documentType === 'ID_FRONT' || documentType === 'PASSPORT' || croppedFaces.length > 0);
+    if (isWrongSide) {
+      setStatus('INCORRECT');
+      return;
+    }
     if (!onlyMRZScan) {
-      if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT' && !(documentType === 'ID_FRONT' || documentType === 'PASSPORT') || nextStep === 'SCAN_ID_BACK' && documentType !== 'ID_BACK') {
-        setStatus('INCORRECT');
-        return;
-      }
       if (croppedFaces.length > 0 && croppedFaces[0]) {
         if (currentFaceImage) {
           scannedData.faceImage = currentFaceImage;
@@ -433,28 +573,37 @@ const IdentityDocumentCamera = ({
       if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT') {
         setStatus('SCANNED');
         if (onlyMRZScan) {
-          setNextStepAndVibrate('SCAN_ID_BACK');
+          setNextStepAndVibrate('SCAN_ID_BACK', 'SCAN_ID_FRONT_OR_PASSPORT');
           onIdentityDocumentScanned(scannedData);
         } else {
-          setNextStepAndVibrate('SCAN_HOLOGRAM');
+          setNextStepAndVibrate('SCAN_HOLOGRAM', 'SCAN_ID_FRONT_OR_PASSPORT');
         }
       } else if (nextStep === 'SCAN_HOLOGRAM' && (!!scannedData.hologramImage || hologramDetectionCurrentRetryCount.value >= HOLOGRAM_DETECTION_RETRY_COUNT) && (!!scannedData.secondaryFaceImage || secondaryFaceDetectionCurrentRetryCount.value >= SECOND_FACE_DETECTION_RETRY_COUNT)) {
         setStatus('SCANNED');
-        setNextStepAndVibrate('SCAN_ID_BACK');
+        setNextStepAndVibrate('SCAN_ID_BACK', 'SCAN_HOLOGRAM');
         onIdentityDocumentScanned(scannedData);
       }
     } else if (documentType === 'PASSPORT') {
       if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT' && !scannedData.hologramImage) {
-        setStatus('SCANNED');
+        // For passport, require valid MRZ before proceeding
         if (onlyMRZScan) {
-          setNextStepAndVibrate('COMPLETED');
-          onIdentityDocumentScanned(scannedData);
+          // eID scan: require valid MRZ
+          if (!!scannedData.mrzText && (parsedMRZData?.valid || mrzDetectionCurrentRetryCount.value >= MRZ_VALIDATION_RETRY_COUNT)) {
+            setStatus('SCANNED');
+            setNextStepAndVibrate('COMPLETED', 'SCAN_ID_FRONT_OR_PASSPORT');
+            onIdentityDocumentScanned(scannedData);
+          } else if (!parsedMRZData?.valid) {
+            mrzDetectionCurrentRetryCount.value++;
+            setStatus('SCANNING');
+          }
         } else {
-          setNextStepAndVibrate('SCAN_HOLOGRAM');
+          // Normal scan: proceed to hologram check (MRZ validated later)
+          setStatus('SCANNED');
+          setNextStepAndVibrate('SCAN_HOLOGRAM', 'SCAN_ID_FRONT_OR_PASSPORT');
         }
       } else if ((nextStep === 'SCAN_HOLOGRAM' && (!!scannedData.hologramImage || hologramDetectionCurrentRetryCount.value >= HOLOGRAM_DETECTION_RETRY_COUNT) && (!!scannedData.secondaryFaceImage || secondaryFaceDetectionCurrentRetryCount.value >= SECOND_FACE_DETECTION_RETRY_COUNT) || onlyMRZScan) && !!scannedData.mrzText && (parsedMRZData?.valid || mrzDetectionCurrentRetryCount.value >= MRZ_VALIDATION_RETRY_COUNT)) {
         setStatus('SCANNED');
-        setNextStepAndVibrate('COMPLETED');
+        setNextStepAndVibrate('COMPLETED', 'SCAN_HOLOGRAM');
         onIdentityDocumentScanned(scannedData);
       } else if (!parsedMRZData?.valid) {
         mrzDetectionCurrentRetryCount.value++;
@@ -463,7 +612,7 @@ const IdentityDocumentCamera = ({
       if ((parsedMRZData?.fields?.issuingState === 'TUR' && barcode?.value?.trim() === parsedMRZData?.fields?.optional1?.trim() || parsedMRZData?.fields?.issuingState !== 'TUR' || onlyMRZScan) && nextStep === 'SCAN_ID_BACK' && !!scannedData.mrzText && (parsedMRZData?.valid || mrzDetectionCurrentRetryCount.value >= MRZ_VALIDATION_RETRY_COUNT)) {
         scannedData.barcodeValue = barcode?.value ?? undefined;
         setStatus('SCANNED');
-        setNextStepAndVibrate('COMPLETED');
+        setNextStepAndVibrate('COMPLETED', 'SCAN_ID_BACK');
         onIdentityDocumentScanned(scannedData);
       } else if (!parsedMRZData?.valid) {
         mrzDetectionCurrentRetryCount.value++;
@@ -483,19 +632,56 @@ const IdentityDocumentCamera = ({
   const handleExposureValue = useRunOnJS(value => {
     setExposure(value);
   }, [exposure]);
+
+  // Focus trigger for when blur is detected (called from worklet)
+  const triggerFocus = useRunOnJS(async () => {
+    if (!cameraRef.current || !device?.supportsFocus) {
+      return;
+    }
+    try {
+      const width = format?.videoWidth ?? 1920;
+      const height = format?.videoHeight ?? 1080;
+      const centerPoint = getScanAreaCenterPoint(width, height);
+      await cameraRef.current.focus({
+        x: centerPoint.x,
+        y: centerPoint.y
+      });
+    } catch (error) {
+      // Ignore focus errors
+    }
+  }, [device, format]);
   const handleExposureAndBrightness = frame => {
     'worklet';
 
     const averageBrightness = getAverageBrightness(frame);
     const minExposure = device?.minExposure ?? 0;
     const maxExposure = device?.maxExposure ?? 0;
-    const lowerBrightnessBound = 40;
-    const upperBrightnessBound = 120;
-    if (averageBrightness < lowerBrightnessBound && exposureValue.value < maxExposure) {
-      exposureValue.value = exposureValue.value + 1;
-    } else if (averageBrightness > upperBrightnessBound && exposureValue.value > minExposure) {
-      exposureValue.value = exposureValue.value - 1;
+
+    // Dynamic thresholds based on scanning state using config values
+    // Face detection requires higher minimum brightness for reliable detection
+    const isFrontOrPassport = nextStep === 'SCAN_ID_FRONT_OR_PASSPORT';
+    const isBack = nextStep === 'SCAN_ID_BACK';
+
+    // Using config values: faceDetection { low: 50, high: 110, target: 85 }, mrzScanning { low: 45, high: 130, target: 80 }
+    const lowerBrightnessBound = isFrontOrPassport ? 50 : 40;
+    const upperBrightnessBound = isBack ? 130 : 120;
+    const targetBrightness = isFrontOrPassport ? 85 : 80;
+
+    // Smooth exposure adjustment with hysteresis to prevent oscillation
+    // Only adjust if brightness is significantly outside the acceptable range
+    const hysteresis = 5; // Dead zone to prevent jitter
+
+    if (averageBrightness < lowerBrightnessBound - hysteresis && exposureValue.value < maxExposure) {
+      // Increase exposure smoothly when too dark
+      const step = calculateExposureStep(averageBrightness, targetBrightness);
+      exposureValue.value = Math.min(maxExposure, exposureValue.value + step);
+    } else if (averageBrightness > upperBrightnessBound + hysteresis && exposureValue.value > minExposure) {
+      // Decrease exposure smoothly when too bright
+      const step = calculateExposureStep(averageBrightness, targetBrightness);
+      exposureValue.value = Math.max(minExposure, exposureValue.value - step);
     }
+    // When within acceptable range (with hysteresis), don't adjust - prevents oscillation
+
     const isBright = averageBrightness > lowerBrightnessBound;
     handleExposureValue(exposureValue.value);
     handleBrightness(isBright);
@@ -510,6 +696,25 @@ const IdentityDocumentCamera = ({
         return;
       }
 
+      // Check for blur before processing - skip blurry frames
+      // Use different thresholds: 25 for front (face detection), 30 for back (MRZ/text)
+      // Higher thresholds with improved Laplacian algorithm using H+V gradients
+      const isFront = nextStep === 'SCAN_ID_FRONT_OR_PASSPORT';
+      const blurThreshold = isFront ? 25 : 30;
+      const blurry = checkBlurry(frame, blurThreshold);
+      handleBlurStatus(blurry);
+      if (blurry) {
+        consecutiveBlurCount.value++;
+        // Only trigger focus after 2 consecutive blurry frames (matching Flutter)
+        if (consecutiveBlurCount.value >= 2) {
+          triggerFocus();
+          consecutiveBlurCount.value = 0;
+        }
+        return;
+      }
+      // Reset blur count on sharp frame
+      consecutiveBlurCount.value = 0;
+
       // Validate frame dimensions before processing
       if (!frame.width || !frame.height || frame.width <= 0 || frame.height <= 0) {
         console.warn('Invalid frame dimensions:', {
@@ -562,6 +767,8 @@ const IdentityDocumentCamera = ({
       }
 
       // Text recognition with error handling
+      // Note: CLAHE enhancement is applied to captured images, not live frames
+      // ML Kit plugins work directly on Frame objects and don't support Mat input
       let scannedText;
       try {
         scannedText = scanText(frame);
@@ -623,7 +830,7 @@ const IdentityDocumentCamera = ({
     }
   }, [handleFaceAndText, isCameraInitialized]);
   if (!permissionsRequested) {
-    return /*#__PURE__*/_jsx(View, {
+    return /*#__PURE__*/_jsx(SafeAreaView, {
       style: styles.permissionContainer,
       children: /*#__PURE__*/_jsx(ActivityIndicator, {
         size: "large",
@@ -632,7 +839,7 @@ const IdentityDocumentCamera = ({
     });
   }
   if (!cameraPermission.hasPermission) {
-    return /*#__PURE__*/_jsxs(View, {
+    return /*#__PURE__*/_jsxs(SafeAreaView, {
       style: styles.permissionContainer,
       children: [/*#__PURE__*/_jsx(Text, {
         style: styles.permissionText,
@@ -647,7 +854,7 @@ const IdentityDocumentCamera = ({
     });
   }
   if (device == null) {
-    return /*#__PURE__*/_jsx(View, {
+    return /*#__PURE__*/_jsx(SafeAreaView, {
       style: styles.permissionContainer,
       children: /*#__PURE__*/_jsx(TextView, {
         style: styles.permissionText,
@@ -673,7 +880,7 @@ const IdentityDocumentCamera = ({
   };
   return /*#__PURE__*/_jsx(View, {
     style: StyleSheet.absoluteFill,
-    children: !hasGuideShown ? /*#__PURE__*/_jsxs(View, {
+    children: !hasGuideShown ? /*#__PURE__*/_jsxs(SafeAreaView, {
       style: styles.guide,
       children: [/*#__PURE__*/_jsx(LottieView, {
         source: require('../../Shared/Animations/id-or-passport.json'),
@@ -722,12 +929,26 @@ const IdentityDocumentCamera = ({
         onInitialized: () => {
           isCameraInitialized.value = true;
         }
-      }), /*#__PURE__*/_jsx(View, {
-        style: styles.topZone,
-        children: /*#__PURE__*/_jsx(TextView, {
-          style: styles.topZoneText,
-          children: isBrightnessLow ? t('identityDocumentCamera.lowBrightness') : nextStep === 'SCAN_ID_FRONT_OR_PASSPORT' ? t('identityDocumentCamera.alignPhotoSide') : nextStep === 'SCAN_HOLOGRAM' ? t('identityDocumentCamera.alignHologram') : nextStep === 'SCAN_ID_BACK' ? t('identityDocumentCamera.alignIDBackSide') : nextStep === 'COMPLETED' ? t('identityDocumentCamera.scanCompleted') : ''
-        })
+      }), /*#__PURE__*/_jsxs(View, {
+        style: [styles.topZone, {
+          paddingTop: insets.top
+        }],
+        children: [nextStep !== 'COMPLETED' && status !== 'SCANNED' && detectedDocumentType !== 'UNKNOWN' && /*#__PURE__*/_jsx(TextView, {
+          style: styles.stepIndicator,
+          children: nextStep === 'SCAN_ID_FRONT_OR_PASSPORT' ? `${t('identityDocumentCamera.frontSide')} • ${t('identityDocumentCamera.stepProgress', {
+            current: 1,
+            total: onlyMRZScan ? detectedDocumentType === 'PASSPORT' ? 1 : 2 : detectedDocumentType === 'PASSPORT' ? 2 : 3
+          })}` : nextStep === 'SCAN_HOLOGRAM' ? `${t('identityDocumentCamera.hologramCheck')} • ${t('identityDocumentCamera.stepProgress', {
+            current: 2,
+            total: detectedDocumentType === 'PASSPORT' ? 2 : 3
+          })}` : nextStep === 'SCAN_ID_BACK' ? `${t('identityDocumentCamera.backSide')} • ${t('identityDocumentCamera.stepProgress', {
+            current: 3,
+            total: 3
+          })}` : ''
+        }), /*#__PURE__*/_jsx(TextView, {
+          style: [styles.topZoneText, status === 'SCANNING' && styles.topZoneTextScanning, status === 'SCANNED' && styles.topZoneTextSuccess, status === 'INCORRECT' && styles.topZoneTextError, (isBrightnessLow || isFrameBlurry) && styles.topZoneTextWarning],
+          children: status === 'SCANNED' ? completedStep === 'SCAN_ID_FRONT_OR_PASSPORT' ? detectedDocumentType === 'PASSPORT' ? t('identityDocumentCamera.passportScanned') : t('identityDocumentCamera.frontSideScanned') : completedStep === 'SCAN_ID_BACK' ? t('identityDocumentCamera.backSideScanned') : completedStep === 'SCAN_HOLOGRAM' ? t('identityDocumentCamera.hologramVerified') : t('identityDocumentCamera.scanCompleted') : status === 'INCORRECT' ? nextStep === 'SCAN_ID_FRONT_OR_PASSPORT' ? t('identityDocumentCamera.wrongSideFront') : nextStep === 'SCAN_ID_BACK' ? t('identityDocumentCamera.wrongSideBack') : t('identityDocumentCamera.alignPhotoSide') : isBrightnessLow ? t('identityDocumentCamera.lowBrightness') : isFrameBlurry ? t('identityDocumentCamera.avoidBlur') : nextStep === 'SCAN_ID_FRONT_OR_PASSPORT' ? status === 'SCANNING' ? currentFaceImage ? detectedDocumentType === 'PASSPORT' ? t('identityDocumentCamera.passportDetected') : detectedDocumentType === 'ID_FRONT' ? t('identityDocumentCamera.idCardFrontDetected') : t('identityDocumentCamera.readingDocument') : t('identityDocumentCamera.readingDocument') : t('identityDocumentCamera.alignPhotoSide') : nextStep === 'SCAN_HOLOGRAM' ? t('identityDocumentCamera.alignHologram') : nextStep === 'SCAN_ID_BACK' ? status === 'SCANNING' ? t('identityDocumentCamera.readingDocument') : t('identityDocumentCamera.alignIDBackSide') : nextStep === 'COMPLETED' ? t('identityDocumentCamera.scanCompleted') : ''
+        })]
       }), /*#__PURE__*/_jsx(View, {
         style: styles.leftZone
       }), /*#__PURE__*/_jsx(View, {
@@ -797,29 +1018,40 @@ const IdentityDocumentCamera = ({
             children: `2nd Face: ${currentSecondaryFaceImage ? '✓' : '✗'} (${secondaryFaceDetectionCurrentRetryCount.value}/${SECOND_FACE_DETECTION_RETRY_COUNT})`
           })]
         })]
-      }), /*#__PURE__*/_jsxs(View, {
+      }), /*#__PURE__*/_jsx(View, {
         style: [styles.scanArea, {
-          borderColor: status === 'SCANNED' || nextStep === 'COMPLETED' ? 'green' : status === 'INCORRECT' ? 'red' : 'white'
+          borderColor: status === 'SCANNED' || nextStep === 'COMPLETED' ? '#4CAF50' // Green - success
+          : status === 'INCORRECT' ? '#f44336' // Red - error
+          : status === 'SCANNING' ? '#2196F3' // Blue - processing
+          : isBrightnessLow || isFrameBlurry ? '#FFC107' // Yellow - warning
+          : 'white',
+          borderWidth: status === 'SCANNING' ? 3 : 2
         }],
-        children: [nextStep === 'SCAN_HOLOGRAM' && isTorchOn && !isBrightnessLow && /*#__PURE__*/_jsx(LottieView, {
-          source: require('../../Shared/Animations/hologram-scan.json'),
+        children: nextStep === 'COMPLETED' || status === 'SCANNED' ? /*#__PURE__*/_jsx(LottieView, {
+          source: require('../../Shared/Animations/success.json'),
           style: styles.animation,
-          loop: true,
+          loop: false,
           autoPlay: true
-        }), nextStep !== 'COMPLETED' && isBrightnessLow && /*#__PURE__*/_jsx(LottieView, {
+        }) : isBrightnessLow ? /*#__PURE__*/_jsx(LottieView, {
           source: require('../../Shared/Animations/light.json'),
           style: styles.animation,
           loop: true,
           autoPlay: true
-        }), nextStep === 'COMPLETED' && /*#__PURE__*/_jsx(LottieView, {
-          source: require('../../Shared/Animations/success.json'),
+        }) : nextStep === 'SCAN_HOLOGRAM' && isTorchOn ? /*#__PURE__*/_jsx(LottieView, {
+          source: require('../../Shared/Animations/hologram-scan.json'),
           style: styles.animation,
-          loop: false,
+          loop: true,
           autoPlay: true
-        })]
+        }) : status === 'SCANNING' ? /*#__PURE__*/_jsx(LottieView, {
+          source: require('../../Shared/Animations/scanning.json'),
+          style: styles.animation,
+          loop: true,
+          autoPlay: true
+        }) : null
       }), /*#__PURE__*/_jsx(TouchableOpacity, {
         onPress: handleFocus,
-        style: styles.focusArea
+        style: styles.focusArea,
+        activeOpacity: 1
       })]
     })
   });
@@ -877,6 +1109,13 @@ const styles = StyleSheet.create({
     justifyContent: 'flex-end',
     alignItems: 'center'
   },
+  stepIndicator: {
+    color: '#aaaaaa',
+    fontSize: 14,
+    textAlign: 'center',
+    fontWeight: '500',
+    marginBottom: 4
+  },
   topZoneText: {
     color: 'white',
     fontSize: 20,
@@ -884,6 +1123,18 @@ const styles = StyleSheet.create({
     fontWeight: 'bold',
     padding: 20
   },
+  topZoneTextScanning: {
+    color: '#2196F3' // Blue when scanning
+  },
+  topZoneTextSuccess: {
+    color: '#4CAF50' // Green for success
+  },
+  topZoneTextWarning: {
+    color: '#FFC107' // Yellow for warnings
+  },
+  topZoneTextError: {
+    color: '#f44336' // Red for errors
+  },
   leftZone: {
     position: 'absolute',
     top: '36%',

package/lib/module/Shared/Components/NavigationManager.js

@@ -5,6 +5,7 @@ import AppContext from "../Contexts/AppContext.js";
 import { CommonActions, useNavigation, usePreventRemove } from '@react-navigation/native';
 import { View, StyleSheet, Alert } from 'react-native';
 import { useTranslation } from 'react-i18next';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import i18n from "../../Translation/index.js";
 import StyledButton from "./StyledButton.js";
 import { analyticsService } from "../Services/AnalyticsService.js";
@@ -21,6 +22,7 @@ const NavigationManager = /*#__PURE__*/forwardRef(({
   const {
     t
   } = useTranslation();
+  const insets = useSafeAreaInsets();
   const routes = {
     VERIFICATION_SESSION_CHECK: 'VerificationSessionCheckScreen',
     DYNAMIC_ROUTES: {
@@ -42,6 +44,12 @@ const NavigationManager = /*#__PURE__*/forwardRef(({
     };
   }, [navigation]);
   const getNextRoute = useCallback((workflowSteps, currentWorkFlowStep) => {
+    // If this was a debug navigation, go directly to result screen
+    if (appContext.isDebugNavigated) {
+      appContext.isDebugNavigated = false;
+      appContext.currentWorkflowStep = undefined;
+      return routes.RESULT;
+    }
     const currentStepIndex = workflowSteps?.findIndex(step => step.id ? step.id === currentWorkFlowStep?.id : step.type === currentWorkFlowStep?.type) ?? -1;
     const nextStep = workflowSteps && currentStepIndex < workflowSteps.length ? workflowSteps[currentStepIndex + 1] : null;
     if (!nextStep) {
@@ -105,10 +113,10 @@ const NavigationManager = /*#__PURE__*/forwardRef(({
     }
     isNavigating = true;
     try {
+      // Preserve demo session state when resetting
+      const wasDemoSession = appContext.isDemoSession;
       appContext.currentWorkflowStep = undefined;
       appContext.workflowSteps = undefined;
-      appContext.isDemoSession = false;
-      analyticsService.setDemoSession(false);
       appContext.identificationInfo = {
         sessionId: '',
         identificationId: '',
@@ -124,6 +132,12 @@ const NavigationManager = /*#__PURE__*/forwardRef(({
         secondaryColor: appContext.branding?.secondaryColor || '#CCCCCC',
         tertiaryColor: appContext.branding?.tertiaryColor || '#FF0000'
       };
+
+      // Only reset demo mode if it wasn't a demo session
+      if (!wasDemoSession) {
+        appContext.setIsDemoSession?.(false);
+        analyticsService.setDemoSession(false);
+      }
       navigation.dispatch(CommonActions.reset({
         index: 0,
         routes: [{
@@ -151,7 +165,9 @@ const NavigationManager = /*#__PURE__*/forwardRef(({
     allowSkipStep: appContext.currentWorkflowStep?.required
   }));
   return appContext.currentWorkflowStep && (!appContext.currentWorkflowStep?.required || canSkipStep) && /*#__PURE__*/_jsx(View, {
-    style: styles.container,
+    style: [styles.container, {
+      paddingBottom: insets.bottom
+    }],
     children: /*#__PURE__*/_jsx(StyledButton, {
       mode: "text",
       onPress: goToNextRouteWithAlert,

package/lib/module/Shared/Config/camera-enhancement.config.js

@@ -0,0 +1,58 @@
+"use strict";
+
+/**
+ * Centralized configuration for camera enhancements
+ * Including autofocus, brightness/exposure, and contrast enhancement
+ */
+
+export const ENHANCEMENT_CONFIG = {
+  autofocus: {
+    enabled: true,
+    intervalMs: 2500,
+    suspendOnDetection: true
+  },
+  brightness: {
+    thresholds: {
+      general: {
+        low: 40,
+        high: 120,
+        target: 80
+      },
+      faceDetection: {
+        low: 50,
+        high: 110,
+        target: 85
+      },
+      mrzScanning: {
+        low: 45,
+        high: 130,
+        target: 80
+      }
+    },
+    adaptiveStep: true,
+    maxStepSize: 2,
+    // Reduced from 3 for smoother transitions
+    hysteresis: 5 // Dead zone to prevent oscillation
+  },
+  contrast: {
+    enabled: true,
+    clahe: {
+      clipLimit: 2.0,
+      tileGridSize: [8, 8]
+    },
+    applyWhen: {
+      mrzFailing: true,
+      faceFailing: true,
+      documentBackSide: true,
+      retryThreshold: 2
+    },
+    performanceMode: 'adaptive'
+  },
+  performance: {
+    maxFrameProcessingTime: 180,
+    // ms
+    autoDisableThreshold: 200,
+    // ms
+    cachingEnabled: true
+  }
+};

package/lib/module/Shared/Contexts/AppContext.js

@@ -22,6 +22,7 @@ export default /*#__PURE__*/createContext({
   },
   workflowSteps: [],
   currentWorkflowStep: undefined,
+  isDebugNavigated: false,
   onCompleted: undefined,
   onError: undefined,
   setSessionId: undefined,