@trustchex/react-native-sdk 1.513.2 → 1.513.3

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

@@ -15,6 +15,15 @@ export const MIN_MLI_FACE_SIZE_PERCENT = 0.01; // MLI (Multi Layer Image): min 1
 export const REQUIRED_CONSISTENT_MRZ_READS = 2;
 export const REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS = 3;
 
+// Frames a check-digit-VALID MRZ consensus must stay UNCHANGED before it is
+// accepted regardless of the per-cell vote-margin ("confident") gate. This
+// unblocks a dense passport MRZ where one stubborn OCR-B look-alike keeps a
+// single cell below the margin threshold forever — the scan would otherwise
+// wedge on "hold steady". Set well above the aggregator's stabilityTarget (3)
+// so the normal confident+stable path handles the common case and this only
+// rescues the persistent-look-alike tail (~1.5s at ~8fps).
+export const MRZ_STREAK_ACCEPT_OVERRIDE = 12;
+
 // After this long on a single scan step without completing it, surface the
 // "Having trouble?" prompt so the user isn't stranded on a live camera with no
 // timeout, retry, or help. Per-step (re-armed on each step transition).

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

@@ -24,7 +24,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, StableFlag } 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, FACE_EDGE_MARGIN_PERCENT, MAX_CONSECUTIVE_QUALITY_FAILURES, REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS, HELP_PROMPT_DELAY_MS, SIGNATURE_TEXT_REGEX, MRZ_BLOCK_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, FACE_EDGE_MARGIN_PERCENT, MAX_CONSECUTIVE_QUALITY_FAILURES, REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS, MRZ_STREAK_ACCEPT_OVERRIDE, HELP_PROMPT_DELAY_MS, 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";
@@ -810,7 +810,19 @@ const IdentityDocumentCamera = ({
     // vote must be unchanged across `stabilityTarget` consecutive contributing
     // frames, which is exactly the "only accept once stable" guarantee.
     // `addFrame` runs for every frame above, so the consensus is always current.
-    const mrzStableAndValid = consensus.stable && parsedMRZData?.valid === true;
+    // `consensus.stable` also requires a "confident" vote — every contested
+    // cell's winner must lead by a margin. On a dense TD3 passport MRZ (88
+    // cells) a single stubborn OCR-B look-alike (A↔4, S↔5) can keep one cell
+    // at a 1-vote margin indefinitely, so `stable` never flips and the scan
+    // wedges on "hold steady" — even though the check-digit-VALID consensus
+    // has been UNCHANGED for many frames. Check digits are the real correctness
+    // guarantee; a long unchanged, valid streak is conclusive. So also accept
+    // once a valid consensus has held unchanged for MRZ_STREAK_ACCEPT_OVERRIDE
+    // frames (well above `stabilityTarget`), independent of the margin gate.
+    // Short streaks still require the full confident+stable gate, preserving
+    // the early-misread protection.
+    const mrzValidStreakSettled = parsedMRZData?.valid === true && consensus.stableStreak >= MRZ_STREAK_ACCEPT_OVERRIDE;
+    const mrzStableAndValid = (consensus.stable || mrzValidStreakSettled) && parsedMRZData?.valid === true;
 
     // 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.
@@ -1484,6 +1496,24 @@ const IdentityDocumentCamera = ({
         }))
       };
 
+      // Isolate the MRZ text (bottom-of-document blocks matching the MRZ
+      // pattern) and feed ONLY that to the multi-frame consensus. CRITICAL:
+      // this must run for EVERY build, not just debug — the identical logic
+      // used to live only inside an `if (isDebugEnabled())` overlay block, so
+      // in release `mrzOnlyText` was never set and the aggregator fell back to
+      // the FULL OCR text (including the passport header "PASSPORT / TÜR /
+      // REPUBLIC OF…"). That header noise kept the per-character consensus from
+      // ever stabilizing, so a passport wedged on "hold steady" forever in
+      // release while working in debug/example. Passport MRZ sits low on the
+      // page; the `y > bottom-half` filter drops the header/photo-area text.
+      if (textBlocks.length > 0) {
+        const bottomHalf = frame.height * 0.5;
+        const mrzBlocks = textBlocks.filter(block => block.blockFrame && block.blockFrame.y > bottomHalf && MRZ_BLOCK_PATTERN.test(block.text));
+        if (mrzBlocks.length > 0) {
+          scannedText.mrzOnlyText = [...mrzBlocks].sort((a, b) => (a.blockFrame?.y || 0) - (b.blockFrame?.y || 0)).map(b => b.text).join('\n');
+        }
+      }
+
       // Read barcodes directly from native ML Kit results
       let barcodes = [];
       if (frame.barcodes) {

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.513.2';
+export const SDK_VERSION = '1.513.3';

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

@@ -11,6 +11,7 @@ export declare const MIN_CARD_FACE_SIZE_PERCENT = 0.05;
 export declare const MIN_MLI_FACE_SIZE_PERCENT = 0.01;
 export declare const REQUIRED_CONSISTENT_MRZ_READS = 2;
 export declare const REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS = 3;
+export declare const MRZ_STREAK_ACCEPT_OVERRIDE = 12;
 export declare const HELP_PROMPT_DELAY_MS = 25000;
 export declare const SIGNATURE_REGEX: RegExp;
 export declare const SIGNATURE_TEXT_REGEX: RegExp;

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;AAKxD,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,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"}
+{"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;AASxD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAK7C,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAE1C,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":"AA4EA,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,4CAksF7B,CAAC;AAmLF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"IdentityDocumentCamera.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.tsx"],"names":[],"mappings":"AA6EA,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,4CA2uF7B,CAAC;AAmLF,eAAe,sBAAsB,CAAC"}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustchex/react-native-sdk",
-  "version": "1.513.2",
+  "version": "1.513.3",
   "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

@@ -14,6 +14,15 @@ export const MIN_MLI_FACE_SIZE_PERCENT = 0.01; // MLI (Multi Layer Image): min 1
 export const REQUIRED_CONSISTENT_MRZ_READS = 2;
 export const REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS = 3;
 
+// Frames a check-digit-VALID MRZ consensus must stay UNCHANGED before it is
+// accepted regardless of the per-cell vote-margin ("confident") gate. This
+// unblocks a dense passport MRZ where one stubborn OCR-B look-alike keeps a
+// single cell below the margin threshold forever — the scan would otherwise
+// wedge on "hold steady". Set well above the aggregator's stabilityTarget (3)
+// so the normal confident+stable path handles the common case and this only
+// rescues the persistent-look-alike tail (~1.5s at ~8fps).
+export const MRZ_STREAK_ACCEPT_OVERRIDE = 12;
+
 // After this long on a single scan step without completing it, surface the
 // "Having trouble?" prompt so the user isn't stranded on a live camera with no
 // timeout, retry, or help. Per-step (re-armed on each step transition).

package/src/Shared/Components/IdentityDocumentCamera.tsx

@@ -69,6 +69,7 @@ import {
   MAX_CONSECUTIVE_QUALITY_FAILURES,
   REQUIRED_CONSISTENT_MRZ_READS,
   REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS,
+  MRZ_STREAK_ACCEPT_OVERRIDE,
   HELP_PROMPT_DELAY_MS,
   SIGNATURE_TEXT_REGEX,
   MRZ_BLOCK_PATTERN,
@@ -1173,8 +1174,23 @@ const IdentityDocumentCamera = ({
       // vote must be unchanged across `stabilityTarget` consecutive contributing
       // frames, which is exactly the "only accept once stable" guarantee.
       // `addFrame` runs for every frame above, so the consensus is always current.
+      // `consensus.stable` also requires a "confident" vote — every contested
+      // cell's winner must lead by a margin. On a dense TD3 passport MRZ (88
+      // cells) a single stubborn OCR-B look-alike (A↔4, S↔5) can keep one cell
+      // at a 1-vote margin indefinitely, so `stable` never flips and the scan
+      // wedges on "hold steady" — even though the check-digit-VALID consensus
+      // has been UNCHANGED for many frames. Check digits are the real correctness
+      // guarantee; a long unchanged, valid streak is conclusive. So also accept
+      // once a valid consensus has held unchanged for MRZ_STREAK_ACCEPT_OVERRIDE
+      // frames (well above `stabilityTarget`), independent of the margin gate.
+      // Short streaks still require the full confident+stable gate, preserving
+      // the early-misread protection.
+      const mrzValidStreakSettled =
+        parsedMRZData?.valid === true &&
+        consensus.stableStreak >= MRZ_STREAK_ACCEPT_OVERRIDE;
       const mrzStableAndValid =
-        consensus.stable && parsedMRZData?.valid === true;
+        (consensus.stable || mrzValidStreakSettled) &&
+        parsedMRZData?.valid === true;
 
       // 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.
@@ -2127,6 +2143,32 @@ const IdentityDocumentCamera = ({
           })),
         };
 
+        // Isolate the MRZ text (bottom-of-document blocks matching the MRZ
+        // pattern) and feed ONLY that to the multi-frame consensus. CRITICAL:
+        // this must run for EVERY build, not just debug — the identical logic
+        // used to live only inside an `if (isDebugEnabled())` overlay block, so
+        // in release `mrzOnlyText` was never set and the aggregator fell back to
+        // the FULL OCR text (including the passport header "PASSPORT / TÜR /
+        // REPUBLIC OF…"). That header noise kept the per-character consensus from
+        // ever stabilizing, so a passport wedged on "hold steady" forever in
+        // release while working in debug/example. Passport MRZ sits low on the
+        // page; the `y > bottom-half` filter drops the header/photo-area text.
+        if (textBlocks.length > 0) {
+          const bottomHalf = frame.height * 0.5;
+          const mrzBlocks = textBlocks.filter(
+            (block) =>
+              block.blockFrame &&
+              block.blockFrame.y > bottomHalf &&
+              MRZ_BLOCK_PATTERN.test(block.text)
+          );
+          if (mrzBlocks.length > 0) {
+            scannedText.mrzOnlyText = [...mrzBlocks]
+              .sort((a, b) => (a.blockFrame?.y || 0) - (b.blockFrame?.y || 0))
+              .map((b) => b.text)
+              .join('\n');
+          }
+        }
+
         // Read barcodes directly from native ML Kit results
         let barcodes: Barcode[] = [];
         if (frame.barcodes) {

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.513.2';
+export const SDK_VERSION = '1.513.3';