@trustchex/react-native-sdk 1.409.0 → 1.464.0

package/src/Shared/Components/IdentityDocumentCamera.flows.ts

@@ -6,7 +6,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,7 +31,7 @@
 import type { Face } from './IdentityDocumentCamera.types';
 import type { MRZFields } from '../Types/mrzFields';
 import { PASSPORT_MRZ_PATTERN } from './IdentityDocumentCamera.constants';
-import { debugLog, isDebugEnabled } from '../Libs/debug.utils';
+import { isIDCardDocumentCode } from './IdentityDocumentCamera.utils';
 
 /**
  * After this many retry attempts for ID_FRONT flow, proceed with face detection alone
@@ -222,10 +222,13 @@ export function handleIDFrontFlow(
   }
 
   // ============================================================================
-  // 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/src/Shared/Components/IdentityDocumentCamera.tsx

@@ -382,7 +382,9 @@ const IdentityDocumentCamera = ({
     } else {
       // Guide screen with white background - use dark icons
       StatusBar.setBarStyle('dark-content', true);
-      StatusBar.setBackgroundColor('#ffffff', true);
+      if (Platform.OS === 'android') {
+        StatusBar.setBackgroundColor('#ffffff', true);
+      }
     }
   }, [hasGuideShown]);
 
@@ -2251,42 +2253,18 @@ const IdentityDocumentCamera = ({
     []
   );
 
-  if (!permissionsRequested) {
+  // 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 (
-      <SafeAreaView style={styles.permissionContainer}>
-        <StatusBar barStyle="dark-content" />
-        <ActivityIndicator size="large" color={theme.colors.primary} />
-      </SafeAreaView>
-    );
-  }
-
-  if (!hasPermission) {
-    return (
-      <SafeAreaView style={styles.permissionContainer}>
-        <StatusBar barStyle="dark-content" />
-        <TextView style={styles.permissionText}>
-          {t('general.noCameraPermissionGiven')}
-        </TextView>
-        <StyledButton
-          mode="contained"
-          onPress={() => {
-            Linking.openSettings();
-          }}
-        >
-          {t('general.openSettings')}
-        </StyledButton>
-      </SafeAreaView>
-    );
-  }
-
-  return (
-    <View style={StyleSheet.absoluteFill}>
-      <StatusBar
-        barStyle={hasGuideShown ? 'light-content' : 'dark-content'}
-        backgroundColor={hasGuideShown ? 'transparent' : '#ffffff'}
-        translucent
-      />
-      {!hasGuideShown ? (
+      <View style={StyleSheet.absoluteFill}>
+        <StatusBar
+          barStyle="dark-content"
+          backgroundColor="#ffffff"
+          translucent
+        />
         <SafeAreaView style={styles.guide}>
           <LottieView
             source={require('../../Shared/Animations/id-or-passport.json')}
@@ -2320,163 +2298,200 @@ const IdentityDocumentCamera = ({
             {t('general.letsGo')}
           </StyledButton>
         </SafeAreaView>
-      ) : (
-        <>
-          <TrustchexCamera
-            ref={cameraRef}
-            style={StyleSheet.absoluteFill as ViewStyle}
-            cameraType="back"
-            enableFrameProcessing={isActive}
-            enableFaceDetection={isActive && faceDetectionEnabled}
-            enableTextRecognition={isActive}
-            enableBarcodeScanning={isActive && nextStep === 'SCAN_ID_BACK'}
-            includeBase64={isActive}
-            targetFps={10}
-            torchEnabled={isTorchOn}
-            onFrameAvailable={handleFrame}
-            onCameraReady={handleCameraReady}
-            onCameraError={handleCameraError}
-          />
-          <View style={[styles.topZone, { paddingTop: insets.top }]}>
-            {nextStep !== 'COMPLETED' &&
-              status !== 'SCANNED' &&
-              detectedDocumentType !== 'UNKNOWN' && (
-                <TextView style={styles.stepIndicator}>
-                  {nextStep === 'SCAN_ID_FRONT_OR_PASSPORT'
-                    ? `${t('identityDocumentCamera.frontSide')} • ${t(
+      </View>
+    );
+  }
+
+  if (!permissionsRequested) {
+    return (
+      <SafeAreaView style={styles.permissionContainer}>
+        <StatusBar barStyle="dark-content" />
+        <ActivityIndicator size="large" color={theme.colors.primary} />
+      </SafeAreaView>
+    );
+  }
+
+  if (!hasPermission) {
+    return (
+      <SafeAreaView style={styles.permissionContainer}>
+        <StatusBar barStyle="dark-content" />
+        <TextView style={styles.permissionText}>
+          {t('general.noCameraPermissionGiven')}
+        </TextView>
+        <StyledButton
+          mode="contained"
+          onPress={() => {
+            Linking.openSettings();
+          }}
+        >
+          {t('general.openSettings')}
+        </StyledButton>
+      </SafeAreaView>
+    );
+  }
+
+  return (
+    <View style={StyleSheet.absoluteFill}>
+      <StatusBar
+        barStyle="light-content"
+        backgroundColor="transparent"
+        translucent
+      />
+      <>
+        <TrustchexCamera
+          ref={cameraRef}
+          style={StyleSheet.absoluteFill as ViewStyle}
+          cameraType="back"
+          enableFrameProcessing={isActive}
+          enableFaceDetection={isActive && faceDetectionEnabled}
+          enableTextRecognition={isActive}
+          enableBarcodeScanning={isActive && nextStep === 'SCAN_ID_BACK'}
+          includeBase64={isActive}
+          targetFps={10}
+          torchEnabled={isTorchOn}
+          onFrameAvailable={handleFrame}
+          onCameraReady={handleCameraReady}
+          onCameraError={handleCameraError}
+        />
+        <View style={[styles.topZone, { paddingTop: insets.top }]}>
+          {nextStep !== 'COMPLETED' &&
+            status !== 'SCANNED' &&
+            detectedDocumentType !== 'UNKNOWN' && (
+              <TextView style={styles.stepIndicator}>
+                {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: 1,
-                          total: onlyMRZScan
-                            ? detectedDocumentType === 'PASSPORT'
-                              ? 1
-                              : 2
-                            : detectedDocumentType === 'PASSPORT'
-                              ? 2
-                              : 3,
+                          current: 2,
+                          total: 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 })}`
-                        : ''}
-                </TextView>
-              )}
-
-            <AnimatedText
-              style={[
-                styles.topZoneText,
-                // Priority order for coloring (later styles override earlier ones)
-                // 1. Success (green) - scan completed
-                nextStep === 'COMPLETED' && styles.topZoneTextSuccess,
-                // 2. Error (red) - wrong side - with flash opacity
-                status === 'INCORRECT' && styles.topZoneTextError,
-                status === 'INCORRECT' && {
-                  opacity: errorFlashAnim,
-                },
-                // 3. Warning (yellow) - quality issues
-                (isBrightnessLow || isFrameBlurry) && styles.topZoneTextWarning,
-                // 4. Scanning (green) - all elements detected AND inside scan area
-                status === 'SCANNING' &&
-                  allElementsDetected &&
-                  elementsOutsideScanArea.length === 0 &&
-                  !isBrightnessLow &&
-                  !isFrameBlurry &&
-                  styles.topZoneTextScanning,
-                // 5. Default (white) - aligning (not all detected OR elements outside scan area)
-              ]}
-            >
-              {getStatusMessage(
-                nextStep,
-                status,
-                detectedDocumentType,
-                isBrightnessLow,
-                isFrameBlurry,
-                allElementsDetected,
-                elementsOutsideScanArea,
-                t
-              )}
-            </AnimatedText>
-          </View>
-          <View style={styles.leftZone} />
-          <View style={styles.rightZone} />
-          <View style={styles.bottomZone} />
-          <View
+                    : nextStep === 'SCAN_ID_BACK'
+                      ? `${t('identityDocumentCamera.backSide')} • ${t('identityDocumentCamera.stepProgress', { current: 3, total: 3 })}`
+                      : ''}
+              </TextView>
+            )}
+
+          <AnimatedText
             style={[
-              styles.scanArea,
-              {
-                borderColor:
-                  nextStep === 'COMPLETED'
-                    ? '#4CAF50'
-                    : status === 'INCORRECT'
-                      ? '#f44336'
-                      : status === 'SCANNING'
-                        ? '#2196F3'
-                        : isBrightnessLow || isFrameBlurry
-                          ? '#FFC107'
-                          : 'white',
-                borderWidth: status === 'SCANNING' ? 3 : 2,
+              styles.topZoneText,
+              // Priority order for coloring (later styles override earlier ones)
+              // 1. Success (green) - scan completed
+              nextStep === 'COMPLETED' && styles.topZoneTextSuccess,
+              // 2. Error (red) - wrong side - with flash opacity
+              status === 'INCORRECT' && styles.topZoneTextError,
+              status === 'INCORRECT' && {
+                opacity: errorFlashAnim,
               },
+              // 3. Warning (yellow) - quality issues
+              (isBrightnessLow || isFrameBlurry) && styles.topZoneTextWarning,
+              // 4. Scanning (green) - all elements detected AND inside scan area
+              status === 'SCANNING' &&
+                allElementsDetected &&
+                elementsOutsideScanArea.length === 0 &&
+                !isBrightnessLow &&
+                !isFrameBlurry &&
+                styles.topZoneTextScanning,
+              // 5. Default (white) - aligning (not all detected OR elements outside scan area)
             ]}
           >
-            {nextStep === 'COMPLETED' ? (
-              <LottieView
-                source={require('../../Shared/Animations/success.json')}
-                style={styles.animation}
-                loop={false}
-                autoPlay
-              />
-            ) : isBrightnessLow ? (
-              <LottieView
-                source={require('../../Shared/Animations/light.json')}
-                style={styles.animation}
-                loop={true}
-                autoPlay
-              />
-            ) : nextStep === 'SCAN_HOLOGRAM' && isTorchOn ? (
-              <LottieView
-                source={require('../../Shared/Animations/hologram-scan.json')}
-                style={styles.animation}
-                loop={true}
-                autoPlay
-              />
-            ) : null}
-          </View>
-          {isDebugEnabled() && (
-            <DebugOverlay
-              nextStep={nextStep}
-              status={status}
-              detectedDocumentType={detectedDocumentType}
-              isBrightnessLow={isBrightnessLow}
-              isFrameBlurry={isFrameBlurry}
-              isTorchOn={isTorchOn}
-              documentPlaneBounds={documentPlaneBounds}
-              secondaryFaceBounds={secondaryFaceBounds}
-              barcodeBounds={barcodeBounds}
-              mrzBounds={mrzBounds}
-              signatureBounds={signatureBounds}
-              currentFaceImage={currentFaceImage}
-              currentSecondaryFaceImage={currentSecondaryFaceImage}
-              currentHologramImage={currentHologramImage}
-              currentHologramMaskImage={_currentHologramMaskImage}
-              latestHologramFaceImage={latestHologramFaceImage}
-              hologramImageCount={hologramImageCount}
-              allElementsDetected={allElementsDetected}
-              elementsOutsideScanArea={elementsOutsideScanArea}
+            {getStatusMessage(
+              nextStep,
+              status,
+              detectedDocumentType,
+              isBrightnessLow,
+              isFrameBlurry,
+              allElementsDetected,
+              elementsOutsideScanArea,
+              t
+            )}
+          </AnimatedText>
+        </View>
+        <View style={styles.leftZone} />
+        <View style={styles.rightZone} />
+        <View style={styles.bottomZone} />
+        <View
+          style={[
+            styles.scanArea,
+            {
+              borderColor:
+                nextStep === 'COMPLETED'
+                  ? '#4CAF50'
+                  : status === 'INCORRECT'
+                    ? '#f44336'
+                    : status === 'SCANNING'
+                      ? '#2196F3'
+                      : isBrightnessLow || isFrameBlurry
+                        ? '#FFC107'
+                        : 'white',
+              borderWidth: status === 'SCANNING' ? 3 : 2,
+            },
+          ]}
+        >
+          {nextStep === 'COMPLETED' ? (
+            <LottieView
+              source={require('../../Shared/Animations/success.json')}
+              style={styles.animation}
+              loop={false}
+              autoPlay
+            />
+          ) : isBrightnessLow ? (
+            <LottieView
+              source={require('../../Shared/Animations/light.json')}
+              style={styles.animation}
+              loop={true}
+              autoPlay
             />
-          )}
-          {testMode && testModeData && (
-            <TestModePanel mrzText={testModeData.mrzText} />
-          )}
-        </>
-      )}
+          ) : nextStep === 'SCAN_HOLOGRAM' && isTorchOn ? (
+            <LottieView
+              source={require('../../Shared/Animations/hologram-scan.json')}
+              style={styles.animation}
+              loop={true}
+              autoPlay
+            />
+          ) : null}
+        </View>
+        {isDebugEnabled() && (
+          <DebugOverlay
+            nextStep={nextStep}
+            status={status}
+            detectedDocumentType={detectedDocumentType}
+            isBrightnessLow={isBrightnessLow}
+            isFrameBlurry={isFrameBlurry}
+            isTorchOn={isTorchOn}
+            documentPlaneBounds={documentPlaneBounds}
+            secondaryFaceBounds={secondaryFaceBounds}
+            barcodeBounds={barcodeBounds}
+            mrzBounds={mrzBounds}
+            signatureBounds={signatureBounds}
+            currentFaceImage={currentFaceImage}
+            currentSecondaryFaceImage={currentSecondaryFaceImage}
+            currentHologramImage={currentHologramImage}
+            currentHologramMaskImage={_currentHologramMaskImage}
+            latestHologramFaceImage={latestHologramFaceImage}
+            hologramImageCount={hologramImageCount}
+            allElementsDetected={allElementsDetected}
+            elementsOutsideScanArea={elementsOutsideScanArea}
+          />
+        )}
+        {testMode && testModeData && (
+          <TestModePanel mrzText={testModeData.mrzText} />
+        )}
+      </>
     </View>
   );
 };

package/src/Shared/Components/IdentityDocumentCamera.utils.ts

@@ -12,6 +12,15 @@ import {
 } from './IdentityDocumentCamera.constants';
 import { debugLog, isDebugEnabled } from '../Libs/debug.utils';
 
+/**
+ * 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: string | null | undefined): boolean {
+  if (!code) return false;
+  return code.startsWith('I') || code.startsWith('A') || code.startsWith('C');
+}
+
 /**
  * Frame-to-screen coordinate transform using FILL_CENTER scaling
  */
@@ -225,8 +234,8 @@ export function detectDocumentType(
     });
   }
 
-  // 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';
   }
 
@@ -265,8 +274,8 @@ export function detectDocumentType(
       : 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';
       }
 

package/src/Shared/Components/NavigationManager.tsx

@@ -18,9 +18,10 @@ import i18n from '../../Translation';
 import StyledButton from './StyledButton';
 import { analyticsService } from '../Services/AnalyticsService';
 
-// Simple global navigation lock
-let isNavigating = false;
-let lastNavigationTime = 0;
+// Navigation lock - use a ref-like pattern so unmounting resets state.
+// The module-level object is shared across all instances but the
+// cleanup effect in the component resets it on unmount.
+const navigationLock = { isNavigating: false, lastNavigationTime: 0 };
 
 export type NavigationManagerRef = {
   navigateToNextStep: () => void;
@@ -45,6 +46,7 @@ const NavigationManager = forwardRef(
         IDENTITY_DOCUMENT_SCAN: 'IdentityDocumentScanningScreen',
         IDENTITY_DOCUMENT_EID_SCAN: 'IdentityDocumentEIDScanningScreen',
         LIVENESS_CHECK: 'LivenessDetectionScreen',
+        VERBAL_CONSENT: 'VerbalConsentScreen',
         VIDEO_CALL: 'VideoCallScreen',
       },
       RESULT: 'ResultScreen',
@@ -52,14 +54,14 @@ const NavigationManager = forwardRef(
 
     React.useEffect(() => {
       const handleFocus = () => {
-        isNavigating = false;
+        navigationLock.isNavigating = false;
       };
 
       navigation.addListener('focus', handleFocus);
 
       return () => {
         navigation.removeListener('focus', handleFocus);
-        isNavigating = false;
+        navigationLock.isNavigating = false;
       };
     }, [navigation]);
 
@@ -114,16 +116,22 @@ const NavigationManager = forwardRef(
           return routes.DYNAMIC_ROUTES.VIDEO_CALL;
         }
 
+        if (nextStep.type === 'VERBAL_CONSENT') {
+          return routes.DYNAMIC_ROUTES.VERBAL_CONSENT;
+        }
+
         return routes.VERIFICATION_SESSION_CHECK;
       },
       [
         appContext,
         routes.VERIFICATION_SESSION_CHECK,
+        routes.RESULT,
         routes.DYNAMIC_ROUTES.CONTRACT_ACCEPTANCE,
-        routes.DYNAMIC_ROUTES.IDENTITY_DOCUMENT_EID_SCAN,
         routes.DYNAMIC_ROUTES.IDENTITY_DOCUMENT_SCAN,
+        routes.DYNAMIC_ROUTES.IDENTITY_DOCUMENT_EID_SCAN,
         routes.DYNAMIC_ROUTES.LIVENESS_CHECK,
-        routes.RESULT,
+        routes.DYNAMIC_ROUTES.VIDEO_CALL,
+        routes.DYNAMIC_ROUTES.VERBAL_CONSENT,
       ]
     );
 
@@ -132,14 +140,15 @@ const NavigationManager = forwardRef(
       const minTimeBetweenNavigation = 1000;
 
       if (
-        isNavigating ||
-        currentTime - lastNavigationTime < minTimeBetweenNavigation
+        navigationLock.isNavigating ||
+        currentTime - navigationLock.lastNavigationTime <
+          minTimeBetweenNavigation
       ) {
         return;
       }
 
-      isNavigating = true;
-      lastNavigationTime = currentTime;
+      navigationLock.isNavigating = true;
+      navigationLock.lastNavigationTime = currentTime;
 
       try {
         const nextRoute = getNextRoute(
@@ -156,12 +165,12 @@ const NavigationManager = forwardRef(
           })
         );
       } catch (error) {
-        isNavigating = false;
+        navigationLock.isNavigating = false;
         throw error;
       }
 
       setTimeout(() => {
-        isNavigating = false;
+        navigationLock.isNavigating = false;
       }, 1000);
     }, [
       getNextRoute,
@@ -171,7 +180,7 @@ const NavigationManager = forwardRef(
     ]);
 
     const goToNextRouteWithAlert = useCallback(() => {
-      if (isNavigating) {
+      if (navigationLock.isNavigating) {
         return;
       }
 
@@ -192,11 +201,11 @@ const NavigationManager = forwardRef(
     }, [goToNextRoute, t]);
 
     const reset = useCallback(() => {
-      if (isNavigating) {
+      if (navigationLock.isNavigating) {
         return;
       }
 
-      isNavigating = true;
+      navigationLock.isNavigating = true;
 
       try {
         // Preserve demo session state when resetting
@@ -241,12 +250,12 @@ const NavigationManager = forwardRef(
           })
         );
       } catch (error) {
-        isNavigating = false;
+        navigationLock.isNavigating = false;
         throw error;
       }
 
       setTimeout(() => {
-        isNavigating = false;
+        navigationLock.isNavigating = false;
       }, 1000);
     }, [appContext, navigation, routes.VERIFICATION_SESSION_CHECK]);