@trustchex/react-native-sdk 1.495.11 → 1.495.12

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

@@ -17,6 +17,15 @@ export const REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS = 3;
 export const SIGNATURE_REGEX = /s[gi]g?n[au]?t[u]?r|imz[a]s?/i;
 export const SIGNATURE_TEXT_REGEX = /signature|imza|İmza/i;
 export const MRZ_BLOCK_PATTERN = /[A-Z0-9<]{8,}.*</i;
+// A DENSE MRZ run — a contiguous block of MRZ characters that contains a chevron
+// FILLER pair (`<<`). Real machine-readable zones are padded with `<<…`; a card
+// FACE (ID front) has no MRZ, and the occasional stray single `<` OCR'd from a
+// guilloche/chevron glyph will NOT contain a `<<` filler run. Used to decide
+// "is a real MRZ visible on this front?" without the false positives of
+// MRZ_BLOCK_PATTERN (whose `.*<` lets a lone detached `<` anywhere in the frame
+// match) — that looseness could otherwise wedge a legitimate ID front that
+// happens to OCR a stray `<`.
+export const MRZ_DENSE_PATTERN = /[A-Z0-9<]{6,}<<[A-Z0-9<]*/i;
 // Matches the line-1 start of ANY ICAO TD3 passport MRZ, so the camera routes
 // every passport variant into the passport flow (not the ID-card back-side
 // flow). Per ICAO 9303 Part 4: `P` + a type char (filler `<` or a subtype

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

@@ -30,7 +30,7 @@
  *   - No face, has MRZ with code 'I'
  */
 
-import { PASSPORT_MRZ_PATTERN } from "./IdentityDocumentCamera.constants.js";
+import { PASSPORT_MRZ_PATTERN, MRZ_DENSE_PATTERN } from "./IdentityDocumentCamera.constants.js";
 import { isIDCardDocumentCode, isPassportDocumentCode, documentHasBackSide } from "./IdentityDocumentCamera.utils.js";
 
 /**
@@ -142,8 +142,15 @@ export function handleIDFrontFlow(faces, text, mrzText, mrzFields, retryCount) {
       nextAction: 'REJECT_AS_PASSPORT'
     };
   }
-  if (mrzText && PASSPORT_MRZ_PATTERN.test(mrzText)) {
-    // Passport MRZ pattern visible even if not fully parsed
+
+  // Passport MRZ pattern visible even if not fully parsed. Check BOTH the
+  // parsed `mrzText` (null until the MRZ validates) AND the raw OCR `text` — a
+  // passport's MRZ is dense and frequently OCRs a few frames after its face +
+  // signature, so on the accepting frame `mrzText` is often still null while the
+  // raw `P<XXX...` run is already visible. Testing only `mrzText` (the old bug)
+  // let such a passport pass as an ID front and get routed to a back side that
+  // does not exist.
+  if (mrzText && PASSPORT_MRZ_PATTERN.test(mrzText) || PASSPORT_MRZ_PATTERN.test(text)) {
     return {
       shouldProceed: false,
       reason: 'Passport MRZ pattern visible - not an ID card',
@@ -163,6 +170,34 @@ export function handleIDFrontFlow(faces, text, mrzText, mrzFields, retryCount) {
     };
   }
 
+  // ============================================================================
+  // STEP 2b: An ID-card FRONT has NO MRZ (the MRZ is on the back). So if a real
+  // MRZ is currently visible on this "front", it is almost certainly a passport
+  // data page whose 'P' code we just haven't parsed yet — do NOT accept it as an
+  // ID front; wait for the MRZ to resolve (→ a 'P' code routes it to the
+  // passport flow). This is the guard that stops a passport (face + signature +
+  // not-yet-parsed MRZ) being accepted as ID_FRONT and then getting stuck at
+  // SCAN_ID_BACK, which rejects the passport's photo page because it has a face.
+  //
+  // We use MRZ_DENSE_PATTERN (requires a `<<` filler run), NOT the loose
+  // MRZ_BLOCK_PATTERN — a card face has no MRZ, but a stray single `<` OCR'd
+  // from a guilloche could match the loose pattern and wedge a real ID front.
+  // We ALSO honor the signature retry threshold: a real ID front genuinely has
+  // no MRZ, so if a "dense MRZ" keeps matching frame after frame past the
+  // threshold it is OCR noise, not a passport — fall through and let STEP 3's
+  // face-only acceptance proceed rather than waiting forever.
+  const mrzVisibleOnFront = !!mrzText || MRZ_DENSE_PATTERN.test(text);
+  const stillWaitingForMrz = retryCount <= SIGNATURE_RETRY_THRESHOLD;
+  if (mrzVisibleOnFront && stillWaitingForMrz && !isIDCardDocumentCode(mrzFields?.documentCode)) {
+    // An ID-card MRZ code (I/A/C) is allowed to proceed (handled in STEP 4); any
+    // other visible MRZ → keep waiting for it to parse and reveal a 'P' code.
+    return {
+      shouldProceed: false,
+      reason: 'MRZ block visible on front - waiting to confirm it is not a passport',
+      nextAction: 'WAIT_FOR_MRZ'
+    };
+  }
+
   // ============================================================================
   // STEP 3: Check for signature (optional front side confirmation)
   // ============================================================================

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

@@ -23,7 +23,7 @@ import { useTheme } from "../Contexts/ThemeContext.js";
 import DebugOverlay, { TestModePanel } from "./DebugOverlay.js";
 import { getStatusMessage, getFrameToScreenTransform, transformBoundsToScreen, getScanAreaBounds, angleBetweenPoints, detectDocumentType, determineDocumentTypeToSet, areMRZFieldsEqual, hasRequiredMRZFields, validateFacePosition, isPassportDocumentCode } from "./IdentityDocumentCamera.utils.js";
 import { handlePassportFlow, handleIDFrontFlow, handleIDBackFlow, getNextStepAfterHologram } from "./IdentityDocumentCamera.flows.js";
-import { HOLOGRAM_IMAGE_COUNT, HOLOGRAM_DETECTION_THRESHOLD, HOLOGRAM_DETECTION_RETRY_COUNT, HOLOGRAM_CAPTURE_INTERVAL, HOLOGRAM_MAX_FRAMES_WITHOUT_FACE, MIN_BRIGHTNESS_THRESHOLD, MAX_BRIGHTNESS_THRESHOLD, FACE_EDGE_MARGIN_PERCENT, MAX_CONSECUTIVE_QUALITY_FAILURES, REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS, SIGNATURE_TEXT_REGEX, MRZ_BLOCK_PATTERN, PASSPORT_MRZ_PATTERN, MIN_CARD_FACE_SIZE_PERCENT } from "./IdentityDocumentCamera.constants.js";
+import { HOLOGRAM_IMAGE_COUNT, HOLOGRAM_DETECTION_THRESHOLD, HOLOGRAM_DETECTION_RETRY_COUNT, HOLOGRAM_CAPTURE_INTERVAL, HOLOGRAM_MAX_FRAMES_WITHOUT_FACE, MIN_BRIGHTNESS_THRESHOLD, MAX_BRIGHTNESS_THRESHOLD, FACE_EDGE_MARGIN_PERCENT, MAX_CONSECUTIVE_QUALITY_FAILURES, REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS, SIGNATURE_TEXT_REGEX, MRZ_BLOCK_PATTERN, MIN_CARD_FACE_SIZE_PERCENT } from "./IdentityDocumentCamera.constants.js";
 
 // Re-export types for backward compatibility
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
@@ -817,22 +817,38 @@ const IdentityDocumentCamera = ({
         const hasFaces = primaryFaces.length > 0;
         const hasSignature = /signature|imza|İmza/i.test(text);
         const hasPassportMRZ = parsedMRZData?.fields?.documentCode === 'P';
-        const hasPassportMRZPattern = mrzText && PASSPORT_MRZ_PATTERN.test(mrzText);
-        if (hasFaces || hasSignature || hasPassportMRZ || hasPassportMRZPattern) {
-          setStatus('INCORRECT');
-          return;
-        }
 
-        // Safety: passport somehow reached ID_BACK step
-        if (detectedDocumentType === 'PASSPORT') {
+        // RECOVERY (must run BEFORE the wrong-side guard below): a passport was
+        // misrouted to SCAN_ID_BACK. A passport has only its data page, which
+        // carries a face + MRZ — exactly what the wrong-side guard treats as
+        // "wrong side", so without this it would loop on INCORRECT forever
+        // (the reported "stuck asking for ID back" case). If we have positive
+        // passport evidence here, the front was already captured, so complete
+        // as a passport instead of waiting for a back that does not exist.
+        //
+        // We deliberately gate ONLY on authoritative signals: a locked PASSPORT
+        // classification, or a PARSED MRZ document code of 'P'. We do NOT test
+        // the raw OCR `text` against PASSPORT_MRZ_PATTERN here — an ID card's
+        // BACK legitimately carries an MRZ whose name line ("PAPPAS<<MARIA…",
+        // "…<<PHILIPP…") can false-match the unanchored pattern and would then
+        // wrongly complete a real ID card as a passport, skipping the back-side
+        // MRZ + barcode validation entirely.
+        if (detectedDocumentType === 'PASSPORT' || hasPassportMRZ) {
           transitionStepWithCallback('COMPLETED', 'SCAN_ID_BACK', {
             image,
             documentType: 'PASSPORT',
-            mrzText: mrzText ?? undefined,
-            mrzFields: parsedMRZData?.fields
+            mrzText: mrzText ?? lastValidMRZText.current ?? undefined,
+            mrzFields: parsedMRZData?.fields ?? lastValidMRZFields.current ?? undefined
           });
           return;
         }
+
+        // Wrong-side detection: a face or signature means we're looking at a
+        // front, not an ID-card back (which has neither).
+        if (hasFaces || hasSignature) {
+          setStatus('INCORRECT');
+          return;
+        }
         setElementsOutsideScanArea([]);
         const flowResult = handleIDBackFlow(mrzText, parsedMRZData?.fields, parsedMRZData?.valid === true, mrzStableAndValid, hasRequiredMRZFields(parsedMRZData?.fields), barcodeToUse?.rawValue, onlyMRZScan);
         if (!flowResult.shouldProceed) {

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

@@ -1,7 +1,7 @@
 "use strict";
 
 import { Dimensions } from 'react-native';
-import { SIGNATURE_REGEX, PASSPORT_MRZ_PATTERN } from "./IdentityDocumentCamera.constants.js";
+import { SIGNATURE_REGEX, PASSPORT_MRZ_PATTERN, MRZ_DENSE_PATTERN } from "./IdentityDocumentCamera.constants.js";
 import { debugLog, isDebugEnabled } from "../Libs/debug.utils.js";
 
 /**
@@ -248,10 +248,17 @@ export function detectDocumentType(faces, ocrText, mrzFields, frameWidth, mrzTex
         return 'ID_FRONT';
       }
 
-      // If signature present and NO passport MRZ pattern, likely ID_FRONT
-      // But we can't be 100% sure yet - passport MRZ might appear in next frames
+      // If signature present and NO passport MRZ pattern, likely ID_FRONT —
+      // BUT an ID-card front has no MRZ, so if a real (dense) MRZ is visible here
+      // (and it is not a confirmed ID code — that returned above) this is almost
+      // certainly a passport data page whose 'P' code just hasn't OCR'd yet.
+      // Stay UNKNOWN and let later frames resolve it, rather than locking
+      // ID_FRONT and routing a passport to a back side it does not have. We use
+      // MRZ_DENSE_PATTERN (needs a `<<` filler run) so a stray single `<` OCR'd
+      // from a card-face guilloche cannot wedge a genuine ID front at UNKNOWN.
+      const hasUnresolvedMrzBlock = !!mrzText || MRZ_DENSE_PATTERN.test(ocrText);
       const hasSignature = hasSignatureMatch;
-      if (hasSignature && !hasPassportMRZPattern) {
+      if (hasSignature && !hasPassportMRZPattern && !hasUnresolvedMrzBlock) {
         return 'ID_FRONT';
       }
     }

package/lib/module/version.js

@@ -2,4 +2,4 @@
 
 // This file is auto-generated. Do not edit manually.
 // Version is synced from package.json during build.
-export const SDK_VERSION = '1.495.11';
+export const SDK_VERSION = '1.495.12';

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.constants.d.ts

@@ -14,6 +14,7 @@ export declare const REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS = 3;
 export declare const SIGNATURE_REGEX: RegExp;
 export declare const SIGNATURE_TEXT_REGEX: RegExp;
 export declare const MRZ_BLOCK_PATTERN: RegExp;
+export declare const MRZ_DENSE_PATTERN: RegExp;
 export declare const PASSPORT_MRZ_PATTERN: RegExp;
 export declare const MIN_SECURITY_FEATURES_REQUIRED = 4;
 export declare const SECURITY_FEATURE_NAMES: {

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentCamera.constants.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,sCAAsC,IAAI,CAAC;AAExD,eAAO,MAAM,eAAe,QAAkC,CAAC;AAC/D,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAC3D,eAAO,MAAM,iBAAiB,QAAsB,CAAC;AASrD,eAAO,MAAM,oBAAoB,QAAyC,CAAC;AAI3E,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,sBAAsB;;;;;;;;;;CAUzB,CAAC;AAKX,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAChD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC"}
+{"version":3,"file":"IdentityDocumentCamera.constants.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,sCAAsC,IAAI,CAAC;AAExD,eAAO,MAAM,eAAe,QAAkC,CAAC;AAC/D,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAC3D,eAAO,MAAM,iBAAiB,QAAsB,CAAC;AASrD,eAAO,MAAM,iBAAiB,QAA+B,CAAC;AAS9D,eAAO,MAAM,oBAAoB,QAAyC,CAAC;AAI3E,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,sBAAsB;;;;;;;;;;CAUzB,CAAC;AAKX,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAChD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC"}

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentCamera.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.tsx"],"names":[],"mappings":"AA0EA,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,2BAA2B,EAK5B,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAMnE,QAAA,MAAM,sBAAsB,GAAI,uDAI7B,2BAA2B,4CAmmF7B,CAAC;AAiIF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"IdentityDocumentCamera.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.tsx"],"names":[],"mappings":"AAyEA,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,2BAA2B,EAK5B,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAMnE,QAAA,MAAM,sBAAsB,GAAI,uDAI7B,2BAA2B,4CA+mF7B,CAAC;AAiIF,eAAe,sBAAsB,CAAC"}

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.flows.d.ts

@@ -37,7 +37,7 @@ export interface PassportFlowResult {
 export interface IDFrontFlowResult {
     shouldProceed: boolean;
     reason?: string;
-    nextAction?: 'WAIT_FOR_ELEMENTS' | 'REJECT_AS_PASSPORT' | 'PROCEED_TO_HOLOGRAM';
+    nextAction?: 'WAIT_FOR_ELEMENTS' | 'WAIT_FOR_MRZ' | 'REJECT_AS_PASSPORT' | 'PROCEED_TO_HOLOGRAM';
 }
 export interface IDBackFlowResult {
     shouldProceed: boolean;

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.flows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentCamera.flows.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.flows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAcpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,cAAc,GACd,qBAAqB,GACrB,sBAAsB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;CAC3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,iBAAiB,EAAE,OAAO,EAC1B,WAAW,EAAE,OAAO,EACpB,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,OAAO,GACpB,kBAAkB,CAgEpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM,GACjB,iBAAiB,CA0EnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,QAAQ,EAAE,OAAO,EACjB,iBAAiB,EAAE,OAAO,EAC1B,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,WAAW,EAAE,OAAO,GACnB,gBAAgB,CA2DlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,wBAAwB,CACtC,oBAAoB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACrE,mBAAmB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACpE,UAAU,EAAE,MAAM,GAAG,SAAS,EAM9B,iBAAiB,GAAE,OAAe,GACjC,WAAW,GAAG,cAAc,CAuB9B"}
+{"version":3,"file":"IdentityDocumentCamera.flows.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.flows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAgB,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAiBpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,cAAc,GACd,qBAAqB,GACrB,sBAAsB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,cAAc,GACd,oBAAoB,GACpB,qBAAqB,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;CAC3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,iBAAiB,EAAE,OAAO,EAC1B,WAAW,EAAE,OAAO,EACpB,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,OAAO,GACpB,kBAAkB,CAgEpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAoHnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,QAAQ,EAAE,OAAO,EACjB,iBAAiB,EAAE,OAAO,EAC1B,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,WAAW,EAAE,OAAO,GACnB,gBAAgB,CA2DlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,wBAAwB,CACtC,oBAAoB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACrE,mBAAmB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACpE,UAAU,EAAE,MAAM,GAAG,SAAS,EAM9B,iBAAiB,GAAE,OAAe,GACjC,WAAW,GAAG,cAAc,CAuB9B"}

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentCamera.utils.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"IdentityDocumentCamera.utils.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.utils.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "1.495.11";
+export declare const SDK_VERSION = "1.495.12";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustchex/react-native-sdk",
-  "version": "1.495.11",
+  "version": "1.495.12",
   "description": "Trustchex mobile app react native SDK for android or ios devices",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

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

@@ -17,6 +17,15 @@ export const REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS = 3;
 export const SIGNATURE_REGEX = /s[gi]g?n[au]?t[u]?r|imz[a]s?/i;
 export const SIGNATURE_TEXT_REGEX = /signature|imza|İmza/i;
 export const MRZ_BLOCK_PATTERN = /[A-Z0-9<]{8,}.*</i;
+// A DENSE MRZ run — a contiguous block of MRZ characters that contains a chevron
+// FILLER pair (`<<`). Real machine-readable zones are padded with `<<…`; a card
+// FACE (ID front) has no MRZ, and the occasional stray single `<` OCR'd from a
+// guilloche/chevron glyph will NOT contain a `<<` filler run. Used to decide
+// "is a real MRZ visible on this front?" without the false positives of
+// MRZ_BLOCK_PATTERN (whose `.*<` lets a lone detached `<` anywhere in the frame
+// match) — that looseness could otherwise wedge a legitimate ID front that
+// happens to OCR a stray `<`.
+export const MRZ_DENSE_PATTERN = /[A-Z0-9<]{6,}<<[A-Z0-9<]*/i;
 // Matches the line-1 start of ANY ICAO TD3 passport MRZ, so the camera routes
 // every passport variant into the passport flow (not the ID-card back-side
 // flow). Per ICAO 9303 Part 4: `P` + a type char (filler `<` or a subtype

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

@@ -30,7 +30,10 @@
 
 import type { Face, DocumentType } from './IdentityDocumentCamera.types';
 import type { MRZFields } from '../Types/mrzFields';
-import { PASSPORT_MRZ_PATTERN } from './IdentityDocumentCamera.constants';
+import {
+  PASSPORT_MRZ_PATTERN,
+  MRZ_DENSE_PATTERN,
+} from './IdentityDocumentCamera.constants';
 import {
   isIDCardDocumentCode,
   isPassportDocumentCode,
@@ -58,6 +61,7 @@ export interface IDFrontFlowResult {
   reason?: string;
   nextAction?:
     | 'WAIT_FOR_ELEMENTS'
+    | 'WAIT_FOR_MRZ'
     | 'REJECT_AS_PASSPORT'
     | 'PROCEED_TO_HOLOGRAM';
 }
@@ -187,8 +191,17 @@ export function handleIDFrontFlow(
     };
   }
 
-  if (mrzText && PASSPORT_MRZ_PATTERN.test(mrzText)) {
-    // Passport MRZ pattern visible even if not fully parsed
+  // Passport MRZ pattern visible even if not fully parsed. Check BOTH the
+  // parsed `mrzText` (null until the MRZ validates) AND the raw OCR `text` — a
+  // passport's MRZ is dense and frequently OCRs a few frames after its face +
+  // signature, so on the accepting frame `mrzText` is often still null while the
+  // raw `P<XXX...` run is already visible. Testing only `mrzText` (the old bug)
+  // let such a passport pass as an ID front and get routed to a back side that
+  // does not exist.
+  if (
+    (mrzText && PASSPORT_MRZ_PATTERN.test(mrzText)) ||
+    PASSPORT_MRZ_PATTERN.test(text)
+  ) {
     return {
       shouldProceed: false,
       reason: 'Passport MRZ pattern visible - not an ID card',
@@ -208,6 +221,39 @@ export function handleIDFrontFlow(
     };
   }
 
+  // ============================================================================
+  // STEP 2b: An ID-card FRONT has NO MRZ (the MRZ is on the back). So if a real
+  // MRZ is currently visible on this "front", it is almost certainly a passport
+  // data page whose 'P' code we just haven't parsed yet — do NOT accept it as an
+  // ID front; wait for the MRZ to resolve (→ a 'P' code routes it to the
+  // passport flow). This is the guard that stops a passport (face + signature +
+  // not-yet-parsed MRZ) being accepted as ID_FRONT and then getting stuck at
+  // SCAN_ID_BACK, which rejects the passport's photo page because it has a face.
+  //
+  // We use MRZ_DENSE_PATTERN (requires a `<<` filler run), NOT the loose
+  // MRZ_BLOCK_PATTERN — a card face has no MRZ, but a stray single `<` OCR'd
+  // from a guilloche could match the loose pattern and wedge a real ID front.
+  // We ALSO honor the signature retry threshold: a real ID front genuinely has
+  // no MRZ, so if a "dense MRZ" keeps matching frame after frame past the
+  // threshold it is OCR noise, not a passport — fall through and let STEP 3's
+  // face-only acceptance proceed rather than waiting forever.
+  const mrzVisibleOnFront = !!mrzText || MRZ_DENSE_PATTERN.test(text);
+  const stillWaitingForMrz = retryCount <= SIGNATURE_RETRY_THRESHOLD;
+  if (
+    mrzVisibleOnFront &&
+    stillWaitingForMrz &&
+    !isIDCardDocumentCode(mrzFields?.documentCode)
+  ) {
+    // An ID-card MRZ code (I/A/C) is allowed to proceed (handled in STEP 4); any
+    // other visible MRZ → keep waiting for it to parse and reveal a 'P' code.
+    return {
+      shouldProceed: false,
+      reason:
+        'MRZ block visible on front - waiting to confirm it is not a passport',
+      nextAction: 'WAIT_FOR_MRZ',
+    };
+  }
+
   // ============================================================================
   // STEP 3: Check for signature (optional front side confirmation)
   // ============================================================================

package/src/Shared/Components/IdentityDocumentCamera.tsx

@@ -69,7 +69,6 @@ import {
   REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS,
   SIGNATURE_TEXT_REGEX,
   MRZ_BLOCK_PATTERN,
-  PASSPORT_MRZ_PATTERN,
   MIN_CARD_FACE_SIZE_PERCENT,
 } from './IdentityDocumentCamera.constants';
 import type {
@@ -1169,7 +1168,9 @@ const IdentityDocumentCamera = ({
       // Surface the reliable-detection signal to the render so the UI can show a
       // green "GO" the moment (and only once) the consensus is stable + valid.
       // Never flips green on an early/transient valid read.
-      setMrzReliable((prev) => (prev === mrzStableAndValid ? prev : mrzStableAndValid));
+      setMrzReliable((prev) =>
+        prev === mrzStableAndValid ? prev : mrzStableAndValid
+      );
 
       // Test-mode panel: show the MRZ ONLY once it is stable + valid (the same
       // consensus matched across `stabilityTarget` consecutive frames). Showing
@@ -1179,9 +1180,7 @@ const IdentityDocumentCamera = ({
       // check-digit-valid consensus and never an unstable intermediate.
       if (testMode && mrzStableAndValid && mrzText) {
         setTestModeData((prev) =>
-          prev?.mrzText === mrzText
-            ? prev
-            : { mrzText, timestamp: Date.now() }
+          prev?.mrzText === mrzText ? prev : { mrzText, timestamp: Date.now() }
         );
       }
 
@@ -1194,30 +1193,42 @@ const IdentityDocumentCamera = ({
           const hasFaces = primaryFaces.length > 0;
           const hasSignature = /signature|imza|İmza/i.test(text);
           const hasPassportMRZ = parsedMRZData?.fields?.documentCode === 'P';
-          const hasPassportMRZPattern =
-            mrzText && PASSPORT_MRZ_PATTERN.test(mrzText);
 
-          if (
-            hasFaces ||
-            hasSignature ||
-            hasPassportMRZ ||
-            hasPassportMRZPattern
-          ) {
-            setStatus('INCORRECT');
-            return;
-          }
-
-          // Safety: passport somehow reached ID_BACK step
-          if (detectedDocumentType === 'PASSPORT') {
+          // RECOVERY (must run BEFORE the wrong-side guard below): a passport was
+          // misrouted to SCAN_ID_BACK. A passport has only its data page, which
+          // carries a face + MRZ — exactly what the wrong-side guard treats as
+          // "wrong side", so without this it would loop on INCORRECT forever
+          // (the reported "stuck asking for ID back" case). If we have positive
+          // passport evidence here, the front was already captured, so complete
+          // as a passport instead of waiting for a back that does not exist.
+          //
+          // We deliberately gate ONLY on authoritative signals: a locked PASSPORT
+          // classification, or a PARSED MRZ document code of 'P'. We do NOT test
+          // the raw OCR `text` against PASSPORT_MRZ_PATTERN here — an ID card's
+          // BACK legitimately carries an MRZ whose name line ("PAPPAS<<MARIA…",
+          // "…<<PHILIPP…") can false-match the unanchored pattern and would then
+          // wrongly complete a real ID card as a passport, skipping the back-side
+          // MRZ + barcode validation entirely.
+          if (detectedDocumentType === 'PASSPORT' || hasPassportMRZ) {
             transitionStepWithCallback('COMPLETED', 'SCAN_ID_BACK', {
               image,
               documentType: 'PASSPORT',
-              mrzText: mrzText ?? undefined,
-              mrzFields: parsedMRZData?.fields,
+              mrzText: mrzText ?? lastValidMRZText.current ?? undefined,
+              mrzFields:
+                parsedMRZData?.fields ??
+                lastValidMRZFields.current ??
+                undefined,
             });
             return;
           }
 
+          // Wrong-side detection: a face or signature means we're looking at a
+          // front, not an ID-card back (which has neither).
+          if (hasFaces || hasSignature) {
+            setStatus('INCORRECT');
+            return;
+          }
+
           setElementsOutsideScanArea([]);
 
           const flowResult = handleIDBackFlow(
@@ -2060,7 +2071,8 @@ const IdentityDocumentCamera = ({
         frameH: ds.frameH,
         avgBrightness:
           ds.frames > 0 ? Math.round(ds.brightnessSum / ds.frames) : 0,
-        minBrightness: ds.minBrightness === 255 && ds.frames === 0 ? 0 : ds.minBrightness,
+        minBrightness:
+          ds.minBrightness === 255 && ds.frames === 0 ? 0 : ds.minBrightness,
         maxBrightness: ds.maxBrightness,
         hadLowBrightness: ds.hadLowBrightness,
         hadBlurryFrames: ds.hadBlurryFrames,
@@ -2696,8 +2708,7 @@ const IdentityDocumentCamera = ({
                       : isBrightnessLow || isFrameBlurry
                         ? '#FFC107'
                         : 'white',
-              borderWidth:
-                mrzReliable || status === 'SCANNING' ? 3 : 2,
+              borderWidth: mrzReliable || status === 'SCANNING' ? 3 : 2,
             },
           ]}
         >

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

@@ -9,6 +9,7 @@ import type { MRZFields } from '../Types/mrzFields';
 import {
   SIGNATURE_REGEX,
   PASSPORT_MRZ_PATTERN,
+  MRZ_DENSE_PATTERN,
 } from './IdentityDocumentCamera.constants';
 import { debugLog, isDebugEnabled } from '../Libs/debug.utils';
 
@@ -309,10 +310,18 @@ export function detectDocumentType(
         return 'ID_FRONT';
       }
 
-      // If signature present and NO passport MRZ pattern, likely ID_FRONT
-      // But we can't be 100% sure yet - passport MRZ might appear in next frames
+      // If signature present and NO passport MRZ pattern, likely ID_FRONT —
+      // BUT an ID-card front has no MRZ, so if a real (dense) MRZ is visible here
+      // (and it is not a confirmed ID code — that returned above) this is almost
+      // certainly a passport data page whose 'P' code just hasn't OCR'd yet.
+      // Stay UNKNOWN and let later frames resolve it, rather than locking
+      // ID_FRONT and routing a passport to a back side it does not have. We use
+      // MRZ_DENSE_PATTERN (needs a `<<` filler run) so a stray single `<` OCR'd
+      // from a card-face guilloche cannot wedge a genuine ID front at UNKNOWN.
+      const hasUnresolvedMrzBlock =
+        !!mrzText || MRZ_DENSE_PATTERN.test(ocrText);
       const hasSignature = hasSignatureMatch;
-      if (hasSignature && !hasPassportMRZPattern) {
+      if (hasSignature && !hasPassportMRZPattern && !hasUnresolvedMrzBlock) {
         return 'ID_FRONT';
       }
     }

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is auto-generated. Do not edit manually.
 // Version is synced from package.json during build.
-export const SDK_VERSION = '1.495.11';
+export const SDK_VERSION = '1.495.12';