@trustchex/react-native-sdk 1.381.0 → 1.464.0

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

@@ -11,6 +11,7 @@ import { useTranslation } from 'react-i18next';
 import AppContext from "../Contexts/AppContext.js";
 import StyledButton from "./StyledButton.js";
 import LottieView from 'lottie-react-native';
+import { getLocalizedCountryName } from "../Libs/country-display.utils.js";
 import { useKeepAwake } from "../Libs/native-keep-awake.utils.js";
 import { speak, resetLastMessage } from "../Libs/tts.utils.js";
 import { trackEIDScanStart, trackEIDScanComplete, trackEIDScanFailed } from "../Libs/analytics.utils.js";
@@ -68,12 +69,34 @@ const EIDScanner = ({
   const [isScanned, setIsScanned] = React.useState(false);
   const [hasGuideShown, setHasGuideShown] = React.useState(false);
   const {
-    t
+    t,
+    i18n
   } = useTranslation();
   const appContext = React.useContext(AppContext);
+  const formatGender = useCallback(code => {
+    switch (code?.toUpperCase()) {
+      case 'M':
+        return t('eidScannerScreen.genderMale', 'Male');
+      case 'F':
+        return t('eidScannerScreen.genderFemale', 'Female');
+      default:
+        return t('eidScannerScreen.genderUnspecified', 'Unspecified');
+    }
+  }, [t]);
+  const formatDocumentType = useCallback(code => {
+    if (!code) return '';
+    const upper = code.toUpperCase();
+    if (upper.startsWith('P')) return t('eidScannerScreen.docTypePassport', 'Passport');
+    if (upper.startsWith('I')) return t('eidScannerScreen.docTypeID', 'ID Card');
+    if (upper.startsWith('A')) return t('eidScannerScreen.docTypeResidence', 'Residence Permit');
+    if (upper.startsWith('V')) return t('eidScannerScreen.docTypeVisa', 'Visa');
+    return code;
+  }, [t]);
+  const formatNationality = useCallback(code => {
+    return getLocalizedCountryName(code, i18n.language);
+  }, [i18n.language]);
   const [voiceGuidanceMessage, setVoiceGuidanceMessage] = useState();
   const [attemptNumber, setAttemptNumber] = useState(0);
-  const lastVoiceGuidanceMessage = useRef('');
   const readNFC = useCallback(async () => {
     const startTime = Date.now();
     const currentAttempt = attemptNumber + 1;
@@ -82,7 +105,6 @@ const EIDScanner = ({
     setIsScanned(false);
     setProgress(0);
     setProgressStage('');
-    lastVoiceGuidanceMessage.current = '';
     resetLastMessage();
 
     // Track EID scan start using analytics helper
@@ -241,8 +263,7 @@ const EIDScanner = ({
     }
   }, [isScanning, progress, pulseAnim]);
   useEffect(() => {
-    if (voiceGuidanceMessage && appContext.currentWorkflowStep?.data?.voiceGuidanceActive && voiceGuidanceMessage !== lastVoiceGuidanceMessage.current) {
-      lastVoiceGuidanceMessage.current = voiceGuidanceMessage;
+    if (voiceGuidanceMessage && appContext.currentWorkflowStep?.data?.voiceGuidanceActive) {
       speak(voiceGuidanceMessage, true);
     }
   }, [voiceGuidanceMessage, appContext.currentWorkflowStep?.data?.voiceGuidanceActive]);
@@ -299,101 +320,119 @@ const EIDScanner = ({
         children: t('eidScannerScreen.startScanning')
       })]
     }) : /*#__PURE__*/_jsxs(_Fragment, {
-      children: [isScanned && documentFaceImage && documentFaceImageMimeType === 'image/jpeg' && /*#__PURE__*/_jsx(Image, {
-        source: {
-          uri: `data:${documentFaceImageMimeType};base64,${documentFaceImage}`
-        },
-        style: styles.faceImage
-      }), isScanned && documentFaceImage &&
-      // TODO Add support for jp2 images
-      documentFaceImageMimeType === 'image/jp2' && /*#__PURE__*/_jsx(Text, {
-        style: styles.mainText,
-        children: t('eidScannerScreen.imageCannotBeShown')
-      }), isScanned && !documentFaceImage && /*#__PURE__*/_jsx(Text, {
-        style: styles.mainText,
-        children: t('eidScannerScreen.faceImageNotFound')
-      }), isScanned && documentMRZInfo && /*#__PURE__*/_jsxs(View, {
-        style: styles.mrzInfo,
+      children: [isScanned && /*#__PURE__*/_jsxs(View, {
+        style: styles.resultCard,
         children: [/*#__PURE__*/_jsxs(View, {
-          style: styles.mrzInfoItem,
-          children: [/*#__PURE__*/_jsxs(Text, {
-            style: styles.mrzInfoLabel,
-            children: [t('eidScannerScreen.documentCode'), ":"]
-          }), /*#__PURE__*/_jsx(Text, {
-            style: styles.mrzInfoText,
-            children: documentMRZInfo.getDocumentCode()
-          })]
-        }), /*#__PURE__*/_jsxs(View, {
-          style: styles.mrzInfoItem,
-          children: [/*#__PURE__*/_jsxs(Text, {
-            style: styles.mrzInfoLabel,
-            children: [t('eidScannerScreen.nationality'), ":"]
-          }), /*#__PURE__*/_jsx(Text, {
-            style: styles.mrzInfoText,
-            children: documentMRZInfo.getNationality()
-          })]
-        }), /*#__PURE__*/_jsxs(View, {
-          style: styles.mrzInfoItem,
-          children: [/*#__PURE__*/_jsxs(Text, {
-            style: styles.mrzInfoLabel,
-            children: [t('eidScannerScreen.personalNumber'), ":"]
-          }), /*#__PURE__*/_jsx(Text, {
-            style: styles.mrzInfoText,
-            children: documentMRZInfo.getOptionalData1()
-          })]
-        }), /*#__PURE__*/_jsxs(View, {
-          style: styles.mrzInfoItem,
-          children: [/*#__PURE__*/_jsxs(Text, {
-            style: styles.mrzInfoLabel,
-            children: [t('eidScannerScreen.documentNumber'), ":"]
-          }), /*#__PURE__*/_jsx(Text, {
-            style: styles.mrzInfoText,
-            children: documentMRZInfo.getDocumentNumber()
-          })]
-        }), /*#__PURE__*/_jsxs(View, {
-          style: styles.mrzInfoItem,
-          children: [/*#__PURE__*/_jsxs(Text, {
-            style: styles.mrzInfoLabel,
-            children: [t('eidScannerScreen.name'), ":"]
-          }), /*#__PURE__*/_jsx(Text, {
-            style: styles.mrzInfoText,
-            children: documentMRZInfo.getSecondaryIdentifier()
-          })]
-        }), /*#__PURE__*/_jsxs(View, {
-          style: styles.mrzInfoItem,
-          children: [/*#__PURE__*/_jsxs(Text, {
-            style: styles.mrzInfoLabel,
-            children: [t('eidScannerScreen.surname'), ":"]
-          }), /*#__PURE__*/_jsx(Text, {
-            style: styles.mrzInfoText,
-            children: documentMRZInfo.getPrimaryIdentifier()
+          style: styles.resultHeader,
+          children: [documentFaceImage && (documentFaceImageMimeType === 'image/jpeg' || documentFaceImageMimeType === 'image/png') ? /*#__PURE__*/_jsx(Image, {
+            source: {
+              uri: `data:${documentFaceImageMimeType};base64,${documentFaceImage}`
+            },
+            style: styles.faceImage,
+            resizeMode: "cover"
+          }) : /*#__PURE__*/_jsx(View, {
+            style: styles.faceImagePlaceholder,
+            children: /*#__PURE__*/_jsx(Text, {
+              style: styles.faceImagePlaceholderText,
+              children: "?"
+            })
+          }), documentMRZInfo && /*#__PURE__*/_jsxs(View, {
+            style: styles.resultHeaderInfo,
+            children: [/*#__PURE__*/_jsxs(Text, {
+              style: styles.fullName,
+              numberOfLines: 2,
+              children: [documentMRZInfo.getSecondaryIdentifier(), ' ', documentMRZInfo.getPrimaryIdentifier()]
+            }), /*#__PURE__*/_jsxs(Text, {
+              style: styles.subInfo,
+              children: [formatNationality(documentMRZInfo.getNationality()), " \xB7", ' ', formatDocumentType(documentMRZInfo.getDocumentCode())]
+            }), /*#__PURE__*/_jsxs(Text, {
+              style: styles.subInfo,
+              children: [formatGender(documentMRZInfo.getGender().getStrCode()), " \xB7", ' ', formatDate(documentMRZInfo.getDateOfBirth())]
+            })]
           })]
-        }), /*#__PURE__*/_jsxs(View, {
-          style: styles.mrzInfoItem,
-          children: [/*#__PURE__*/_jsxs(Text, {
-            style: styles.mrzInfoLabel,
-            children: [t('eidScannerScreen.birthDate'), ":"]
-          }), /*#__PURE__*/_jsx(Text, {
-            style: styles.mrzInfoText,
-            children: formatDate(documentMRZInfo.getDateOfBirth())
-          })]
-        }), /*#__PURE__*/_jsxs(View, {
-          style: styles.mrzInfoItem,
-          children: [/*#__PURE__*/_jsxs(Text, {
-            style: styles.mrzInfoLabel,
-            children: [t('eidScannerScreen.gender'), ":"]
-          }), /*#__PURE__*/_jsx(Text, {
-            style: styles.mrzInfoText,
-            children: documentMRZInfo.getGender().getStrCode()
-          })]
-        }), /*#__PURE__*/_jsxs(View, {
-          style: styles.mrzInfoItem,
-          children: [/*#__PURE__*/_jsxs(Text, {
-            style: styles.mrzInfoLabel,
-            children: [t('eidScannerScreen.expirationDate'), ":"]
-          }), /*#__PURE__*/_jsx(Text, {
-            style: styles.mrzInfoText,
-            children: formatDate(documentMRZInfo.getDateOfExpiry())
+        }), documentMRZInfo && /*#__PURE__*/_jsxs(View, {
+          style: styles.mrzInfo,
+          children: [/*#__PURE__*/_jsxs(View, {
+            style: styles.mrzInfoItem,
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoLabel,
+              children: t('eidScannerScreen.name')
+            }), /*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoText,
+              children: documentMRZInfo.getSecondaryIdentifier()
+            })]
+          }), /*#__PURE__*/_jsxs(View, {
+            style: styles.mrzInfoItem,
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoLabel,
+              children: t('eidScannerScreen.surname')
+            }), /*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoText,
+              children: documentMRZInfo.getPrimaryIdentifier()
+            })]
+          }), /*#__PURE__*/_jsxs(View, {
+            style: styles.mrzInfoItem,
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoLabel,
+              children: t('eidScannerScreen.documentCode')
+            }), /*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoText,
+              children: formatDocumentType(documentMRZInfo.getDocumentCode())
+            })]
+          }), /*#__PURE__*/_jsxs(View, {
+            style: styles.mrzInfoItem,
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoLabel,
+              children: t('eidScannerScreen.documentNumber')
+            }), /*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoText,
+              children: documentMRZInfo.getDocumentNumber()
+            })]
+          }), /*#__PURE__*/_jsxs(View, {
+            style: styles.mrzInfoItem,
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoLabel,
+              children: t('eidScannerScreen.personalNumber')
+            }), /*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoText,
+              children: documentMRZInfo.getOptionalData1()
+            })]
+          }), /*#__PURE__*/_jsxs(View, {
+            style: styles.mrzInfoItem,
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoLabel,
+              children: t('eidScannerScreen.nationality')
+            }), /*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoText,
+              children: formatNationality(documentMRZInfo.getNationality())
+            })]
+          }), /*#__PURE__*/_jsxs(View, {
+            style: styles.mrzInfoItem,
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoLabel,
+              children: t('eidScannerScreen.gender')
+            }), /*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoText,
+              children: formatGender(documentMRZInfo.getGender().getStrCode())
+            })]
+          }), /*#__PURE__*/_jsxs(View, {
+            style: styles.mrzInfoItem,
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoLabel,
+              children: t('eidScannerScreen.birthDate')
+            }), /*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoText,
+              children: formatDate(documentMRZInfo.getDateOfBirth())
+            })]
+          }), /*#__PURE__*/_jsxs(View, {
+            style: styles.mrzInfoItem,
+            children: [/*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoLabel,
+              children: t('eidScannerScreen.expirationDate')
+            }), /*#__PURE__*/_jsx(Text, {
+              style: styles.mrzInfoText,
+              children: formatDate(documentMRZInfo.getDateOfExpiry())
+            })]
           })]
         })]
       }), !hasNfc && /*#__PURE__*/_jsx(Text, {
@@ -426,7 +465,14 @@ const EIDScanner = ({
       }) || documentType === 'UNKNOWN' && /*#__PURE__*/_jsx(Text, {
         style: styles.mainText,
         children: t('eidScannerScreen.placeDocumentOnNFC')
-      })), hasNfc && isEnabled && isScanned && /*#__PURE__*/_jsx(View, {
+      })), hasNfc && isEnabled && !isScanning && !isScanned && /*#__PURE__*/_jsx(View, {
+        style: styles.buttonsContainer,
+        children: /*#__PURE__*/_jsx(StyledButton, {
+          mode: "contained",
+          onPress: readNFC,
+          children: t('eidScannerScreen.startScanning')
+        })
+      }), hasNfc && isEnabled && isScanned && /*#__PURE__*/_jsx(View, {
         style: styles.buttonsContainer,
         children: /*#__PURE__*/_jsx(StyledButton, {
           mode: "contained",
@@ -511,31 +557,86 @@ const styles = StyleSheet.create({
     color: 'black',
     textAlign: 'center'
   },
-  faceImage: {
-    width: 150,
-    height: 150,
-    borderRadius: 150,
-    borderColor: 'lightgray',
+  resultCard: {
+    backgroundColor: '#fff',
+    borderRadius: 16,
+    padding: 16,
+    gap: 16,
+    shadowColor: '#000',
+    shadowOffset: {
+      width: 0,
+      height: 2
+    },
+    shadowOpacity: 0.08,
+    shadowRadius: 8,
+    elevation: 3,
     borderWidth: 1,
-    alignSelf: 'center'
+    borderColor: '#f0f0f0'
+  },
+  resultHeader: {
+    flexDirection: 'row',
+    gap: 14,
+    alignItems: 'flex-start'
+  },
+  resultHeaderInfo: {
+    flex: 1,
+    gap: 4,
+    justifyContent: 'center'
+  },
+  fullName: {
+    fontSize: 17,
+    fontWeight: '700',
+    color: '#111',
+    letterSpacing: 0.2
+  },
+  subInfo: {
+    fontSize: 13,
+    color: '#666',
+    fontWeight: '500'
+  },
+  faceImage: {
+    width: 90,
+    height: 115,
+    borderRadius: 10,
+    overflow: 'hidden'
+  },
+  faceImagePlaceholder: {
+    width: 90,
+    height: 115,
+    borderRadius: 10,
+    backgroundColor: '#f5f5f5',
+    alignItems: 'center',
+    justifyContent: 'center'
+  },
+  faceImagePlaceholderText: {
+    fontSize: 32,
+    color: '#ccc'
   },
   mrzInfo: {
     flexDirection: 'column',
-    width: '100%'
+    width: '100%',
+    gap: 2
   },
   mrzInfoItem: {
     flexDirection: 'row',
     justifyContent: 'space-between',
-    borderBottomColor: 'lightgray',
-    borderBottomWidth: 1,
-    paddingVertical: 5
+    alignItems: 'center',
+    paddingVertical: 8,
+    borderBottomColor: '#f0f0f0',
+    borderBottomWidth: 1
   },
   mrzInfoLabel: {
-    color: 'black',
-    fontWeight: 'bold'
+    color: '#888',
+    fontSize: 13,
+    fontWeight: '500'
   },
   mrzInfoText: {
-    color: 'black'
+    color: '#111',
+    fontSize: 13,
+    fontWeight: '600',
+    textAlign: 'right',
+    flexShrink: 1,
+    marginLeft: 8
   },
   guide: {
     flex: 1,

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

@@ -8,7 +8,7 @@
  * KEY DISTINGUISHING FEATURES:
  * =============================
  * PASSPORT: Has MRZ on FRONT with pattern P<XXX (e.g., P<TUR, P<USA)
- * ID CARD:  Has NO MRZ on front; MRZ only on BACK with code 'I'
+ * ID CARD:  Has NO MRZ on front; MRZ only on BACK with code starting with I, A, or C
  *
  * IMPORTANT: Both passports and ID cards have signature sections!
  * Signature presence is NOT a distinguishing feature between document types.
@@ -31,6 +31,8 @@
  */
 
 import { PASSPORT_MRZ_PATTERN } from "./IdentityDocumentCamera.constants.js";
+import { isIDCardDocumentCode } from "./IdentityDocumentCamera.utils.js";
+
 /**
  * After this many retry attempts for ID_FRONT flow, proceed with face detection alone
  * even if signature text OCR fails. This prevents blocking users due to OCR limitations.
@@ -178,10 +180,10 @@ export function handleIDFrontFlow(faces, text, mrzText, mrzFields, retryCount) {
   }
 
   // ============================================================================
-  // STEP 4: Final MRZ code check (if present, must be 'I' not 'P')
+  // STEP 4: Final MRZ code check (if present, must be an ID card code, not P)
   // ============================================================================
   // ID cards should NOT have MRZ on front, but if detected, verify it's not passport
-  if (mrzFields?.documentCode && mrzFields.documentCode !== 'I') {
+  if (mrzFields?.documentCode && !isIDCardDocumentCode(mrzFields.documentCode)) {
     return {
       shouldProceed: false,
       reason: `MRZ shows unexpected document code: ${mrzFields.documentCode}`,

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

@@ -94,6 +94,7 @@ const IdentityDocumentCamera = ({
   const isHologramDetectionInProgress = useRef(false); // Prevent concurrent hologram detection calls
   const isCompletionCallbackInvoked = useRef(false); // Prevent multiple callback invocations when COMPLETED
   const isStepTransitionInProgress = useRef(false); // Prevent duplicate step transitions from rapid frames
+  const isCompletionAnnouncementSpoken = useRef(false); // Prevent duplicate "scan completed" voice guidance
 
   const faceDetectionErrorCount = useRef(0);
   const brightnessHistory = useRef([]);
@@ -101,7 +102,6 @@ const IdentityDocumentCamera = ({
   const faceImages = useRef([]);
   const hologramImageCountRef = useRef(0);
   const [hologramImageCount, setHologramImageCount] = useState(0);
-  const lastVoiceGuidanceMessage = useRef('');
   const [latestHologramFaceImage, setLatestHologramFaceImage] = useState(undefined);
   const lastFacePosition = useRef(null);
   const [documentPlaneBounds, setDocumentPlaneBounds] = useState(null);
@@ -135,6 +135,7 @@ const IdentityDocumentCamera = ({
       setIsActive(true);
       isCompletionCallbackInvoked.current = false; // Reset callback flag when starting new scan
       isStepTransitionInProgress.current = false;
+      isCompletionAnnouncementSpoken.current = false;
     } else {
       setIsActive(false);
       faceImages.current = [];
@@ -148,9 +149,9 @@ const IdentityDocumentCamera = ({
       lastValidMRZFields.current = null;
       validMRZConsecutiveCount.current = 0;
       cachedBarcode.current = null;
-      lastVoiceGuidanceMessage.current = '';
       isCompletionCallbackInvoked.current = false;
       isStepTransitionInProgress.current = false;
+      isCompletionAnnouncementSpoken.current = false;
       // Clear all captured image states from previous scan
       setCurrentFaceImage(undefined);
       setCurrentHologramImage(undefined);
@@ -163,9 +164,9 @@ const IdentityDocumentCamera = ({
       hologramImageCountRef.current = 0;
       setHologramImageCount(0);
       setLatestHologramFaceImage(undefined);
-      lastVoiceGuidanceMessage.current = '';
       isCompletionCallbackInvoked.current = false; // Reset callback flag on unmount
       isStepTransitionInProgress.current = false;
+      isCompletionAnnouncementSpoken.current = false;
       // Clear all captured image states on unmount
       setCurrentFaceImage(undefined);
       setCurrentHologramImage(undefined);
@@ -176,9 +177,17 @@ const IdentityDocumentCamera = ({
   useEffect(() => {
     if (!hasGuideShown || !appContext.currentWorkflowStep?.data?.voiceGuidanceActive) return;
     const message = getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, allElementsDetected, elementsOutsideScanArea, t);
-    if (message && message !== lastVoiceGuidanceMessage.current) {
-      lastVoiceGuidanceMessage.current = message;
-      speak(message, true);
+    if (message) {
+      if (nextStep === 'COMPLETED') {
+        if (isCompletionAnnouncementSpoken.current) {
+          return;
+        }
+        isCompletionAnnouncementSpoken.current = true;
+      } else {
+        isCompletionAnnouncementSpoken.current = false;
+      }
+      const shouldBypassInterval = nextStep !== 'COMPLETED';
+      speak(message, shouldBypassInterval);
     }
   }, [appContext.currentWorkflowStep?.data?.voiceGuidanceActive, hasGuideShown, isBrightnessLow, isFrameBlurry, nextStep, status, detectedDocumentType, allElementsDetected, elementsOutsideScanArea, t]);
   useEffect(() => {
@@ -207,6 +216,20 @@ const IdentityDocumentCamera = ({
     isStepTransitionInProgress.current = false;
   }, [nextStep]);
 
+  // Update status bar based on guide visibility
+  useEffect(() => {
+    if (hasGuideShown) {
+      // Scanning camera view - use light icons on dark background
+      StatusBar.setBarStyle('light-content', true);
+    } else {
+      // Guide screen with white background - use dark icons
+      StatusBar.setBarStyle('dark-content', true);
+      if (Platform.OS === 'android') {
+        StatusBar.setBackgroundColor('#ffffff', true);
+      }
+    }
+  }, [hasGuideShown]);
+
   // Error flash animation - flash red text when wrong side detected
   useEffect(() => {
     if (status === 'INCORRECT') {
@@ -1462,6 +1485,53 @@ const IdentityDocumentCamera = ({
   const handleCameraError = useCallback(event => {
     console.error('Camera error:', event.nativeEvent.error);
   }, []);
+
+  // Show the guide immediately — the guide is pure UI and does not need
+  // camera access. Permission is requested in the background (useEffect) so
+  // it will usually be resolved by the time the user taps "Let's Go".
+  // This avoids a white/blank screen while the async permission check runs.
+  if (!hasGuideShown) {
+    return /*#__PURE__*/_jsxs(View, {
+      style: StyleSheet.absoluteFill,
+      children: [/*#__PURE__*/_jsx(StatusBar, {
+        barStyle: "dark-content",
+        backgroundColor: "#ffffff",
+        translucent: true
+      }), /*#__PURE__*/_jsxs(SafeAreaView, {
+        style: styles.guide,
+        children: [/*#__PURE__*/_jsx(LottieView, {
+          source: require('../../Shared/Animations/id-or-passport.json'),
+          style: styles.guideAnimation,
+          loop: true,
+          autoPlay: true
+        }), /*#__PURE__*/_jsx(TextView, {
+          style: styles.guideHeader,
+          children: t('identityDocumentCamera.guideHeader')
+        }), /*#__PURE__*/_jsxs(View, {
+          style: styles.guidePoints,
+          children: [/*#__PURE__*/_jsx(TextView, {
+            style: styles.guideText,
+            children: t('identityDocumentCamera.guideText')
+          }), /*#__PURE__*/_jsxs(TextView, {
+            style: styles.guideText,
+            children: ["\u2022 ", t('identityDocumentCamera.guidePoint1')]
+          }), /*#__PURE__*/_jsxs(TextView, {
+            style: styles.guideText,
+            children: ["\u2022 ", t('identityDocumentCamera.guidePoint2')]
+          }), /*#__PURE__*/_jsxs(TextView, {
+            style: styles.guideText,
+            children: ["\u2022 ", t('identityDocumentCamera.guidePoint3')]
+          })]
+        }), /*#__PURE__*/_jsx(StyledButton, {
+          mode: "contained",
+          onPress: () => {
+            setHasGuideShown(true);
+          },
+          children: t('general.letsGo')
+        })]
+      })]
+    });
+  }
   if (!permissionsRequested) {
     return /*#__PURE__*/_jsxs(SafeAreaView, {
       style: styles.permissionContainer,
@@ -1496,39 +1566,7 @@ const IdentityDocumentCamera = ({
       barStyle: "light-content",
       backgroundColor: "transparent",
       translucent: true
-    }), !hasGuideShown ? /*#__PURE__*/_jsxs(SafeAreaView, {
-      style: styles.guide,
-      children: [/*#__PURE__*/_jsx(LottieView, {
-        source: require('../../Shared/Animations/id-or-passport.json'),
-        style: styles.guideAnimation,
-        loop: true,
-        autoPlay: true
-      }), /*#__PURE__*/_jsx(TextView, {
-        style: styles.guideHeader,
-        children: t('identityDocumentCamera.guideHeader')
-      }), /*#__PURE__*/_jsxs(View, {
-        style: styles.guidePoints,
-        children: [/*#__PURE__*/_jsx(TextView, {
-          style: styles.guideText,
-          children: t('identityDocumentCamera.guideText')
-        }), /*#__PURE__*/_jsxs(TextView, {
-          style: styles.guideText,
-          children: ["\u2022 ", t('identityDocumentCamera.guidePoint1')]
-        }), /*#__PURE__*/_jsxs(TextView, {
-          style: styles.guideText,
-          children: ["\u2022 ", t('identityDocumentCamera.guidePoint2')]
-        }), /*#__PURE__*/_jsxs(TextView, {
-          style: styles.guideText,
-          children: ["\u2022 ", t('identityDocumentCamera.guidePoint3')]
-        })]
-      }), /*#__PURE__*/_jsx(StyledButton, {
-        mode: "contained",
-        onPress: () => {
-          setHasGuideShown(true);
-        },
-        children: t('general.letsGo')
-      })]
-    }) : /*#__PURE__*/_jsxs(_Fragment, {
+    }), /*#__PURE__*/_jsxs(_Fragment, {
       children: [/*#__PURE__*/_jsx(TrustchexCamera, {
         ref: cameraRef,
         style: StyleSheet.absoluteFill,

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

@@ -4,6 +4,15 @@ import { Dimensions } from 'react-native';
 import { SIGNATURE_REGEX, PASSPORT_MRZ_PATTERN } from "./IdentityDocumentCamera.constants.js";
 import { debugLog, isDebugEnabled } from "../Libs/debug.utils.js";
 
+/**
+ * Checks if a document code represents an ID card (TD1/TD2).
+ * Per ICAO 9303, valid ID card codes start with 'I', 'A', or 'C'.
+ */
+export function isIDCardDocumentCode(code) {
+  if (!code) return false;
+  return code.startsWith('I') || code.startsWith('A') || code.startsWith('C');
+}
+
 /**
  * Frame-to-screen coordinate transform using FILL_CENTER scaling
  */
@@ -175,8 +184,8 @@ export function detectDocumentType(faces, ocrText, mrzFields, frameWidth, mrzTex
     });
   }
 
-  // ID Back: no face + ID MRZ
-  if (faces.length === 0 && mrzFields?.documentCode === 'I') {
+  // ID Back: no face + ID MRZ (codes starting with I, A, or C per ICAO 9303)
+  if (faces.length === 0 && isIDCardDocumentCode(mrzFields?.documentCode)) {
     return 'ID_BACK';
   }
 
@@ -205,8 +214,8 @@ export function detectDocumentType(faces, ocrText, mrzFields, frameWidth, mrzTex
     // Filter to card-sized faces only (min 5% of frame width to exclude tiny background faces)
     const cardSizedFaces = frameWidth ? faces.filter(face => face.bounds.width >= frameWidth * 0.05 && face.bounds.height >= frameWidth * 0.05) : faces;
     if (cardSizedFaces.length > 0) {
-      // If we have MRZ code 'I', it's definitely an ID card
-      if (mrzFields?.documentCode === 'I') {
+      // If we have an ID card MRZ code (I, A, or C), it's definitely an ID card
+      if (isIDCardDocumentCode(mrzFields?.documentCode)) {
         return 'ID_FRONT';
       }