@trustchex/react-native-sdk 1.475.0 → 1.475.1

package/lib/module/Shared/Libs/mrz.utils.js

@@ -297,10 +297,43 @@ const reconstructMRZCandidates = rawText => {
         const after = flat.indexOf(l1Source) + l1Source.length;
         l2 = pad(flat.slice(after, after + 30), 30);
       }
-      // Line 3 (name): the longest letter+filler OCR line that is NOT the doc or
-      // date line — exclude obvious front-of-card title words by requiring fillers.
-      const nameRuns = ocrLines.filter(l => l !== l1Source && l !== l2Line && /^[A-Z<]+$/.test(l) && /</.test(l) && l.length >= 5);
-      const l3 = pad(nameRuns.sort((a, b) => b.length - a.length)[0] ?? '', 30);
+      // Line 3 (name): the longest mostly-letters+filler OCR line that is NOT the
+      // doc or date line. OCR mangles the name line too — a leading "O" reads as
+      // "0", and the trailing "<" fillers read as K/C — so we DON'T require a
+      // pure [A-Z<] line (that wrongly drops "0ZCAN<<ERDAL…" entirely). Accept a
+      // line that is predominantly letters/fillers, then normalise it.
+      const isNameLike = l => {
+        if (l === l1Source || l === l2Line || l.length < 5) return false;
+        if (!/</.test(l)) return false; // must have at least one filler
+        // Must look like "SURNAME<<NAMES…": starts with a letter (or its digit
+        // look-alike) and is dominated by letters/fillers, not a numeric record.
+        if (!/^[A-Z0-9]/.test(l)) return false;
+        const letters = (l.match(/[A-Z]/g) || []).length;
+        const digits = (l.match(/[0-9]/g) || []).length;
+        // A date/doc record is digit-heavy; a name is letter-heavy.
+        return letters >= 3 && letters >= digits;
+      };
+      // Normalise a name line: digit look-alikes back to letters (O/I/S/B/Z/G),
+      // and the filler-letter run misreads (K/C/E/G adjacent to fillers) to "<".
+      const normaliseName = l => {
+        const digitToLetter = {
+          '0': 'O',
+          '1': 'I',
+          '5': 'S',
+          '8': 'B',
+          '2': 'Z',
+          '6': 'G'
+        };
+        return l
+        // digit look-alikes inside the name → letters
+        .replace(/[015862]/g, d => digitToLetter[d] ?? d)
+        // a run of filler-letters (K/C/E/G) flanked by fillers or at the tail
+        // is the trailing/internal filler region
+        .replace(/(?<=<)[KCEG]+(?=<|$)/g, m => '<'.repeat(m.length)).replace(/[KCEG]+$/g, m => '<'.repeat(m.length));
+      };
+      const nameRuns = ocrLines.filter(isNameLike);
+      const bestName = nameRuns.sort((a, b) => b.length - a.length)[0] ?? '';
+      const l3 = pad(normaliseName(bestName), 30);
       candidates.push([l1, l2, l3]);
     }
   }
@@ -798,6 +831,21 @@ const correctedMrzFromParse = result => {
   return buffers.map(b => b.join('')).join('\n');
 };
 
+/**
+ * Heuristic: does a parsed result's name look like it still carries OCR noise
+ * (a digit where a name letter belongs, or a run of filler-confusable letters
+ * that should have been "<")? Names are letters only, so any digit is noise; a
+ * 3+ run of K/C/E/G is very likely misread fillers leaking into the given names.
+ */
+const nameLooksNoisy = r => {
+  const name = `${r.fields?.lastName ?? ''} ${r.fields?.firstName ?? ''}`;
+  // A DIGIT in a name is unambiguous OCR noise (MRZ names are letters only).
+  // A 5+ run of filler-confusable letters is almost certainly misread padding —
+  // real given names like "ECE"/"GECE" are short, so keep the threshold high to
+  // avoid false positives on legitimate names.
+  return /[0-9]/.test(name) || /[KCEG]{5,}/.test(name);
+};
+
 /**
  * Validates MRZ text using the mrz npm package
  * @param mrzText Raw or cleaned MRZ text
@@ -822,6 +870,27 @@ const validateMRZ = (mrzText, autocorrect = true) => {
       result = null;
     }
 
+    // The direct parse can validate (the name field has no check digit) while the
+    // name line still carries OCR noise — a leading "O" read as "0", or trailing
+    // "<" fillers read as K/C/E/G that leak into the given names. The
+    // reconstruction path normalises the name line; when the direct result's name
+    // looks noisy, prefer a reconstructed candidate that validates with a cleaner
+    // name. This only ever swaps in another fully check-digit-valid reading.
+    if (result?.valid && nameLooksNoisy(result)) {
+      for (const reLines of reconstructMRZCandidates(mrzText)) {
+        let cand;
+        try {
+          cand = parse(reLines);
+        } catch {
+          continue;
+        }
+        if (cand.valid && !nameLooksNoisy(cand)) {
+          result = cand;
+          break;
+        }
+      }
+    }
+
     // Primary recovery: exhaustive, CHECK-DIGIT-DRIVEN correction scoped to the
     // fields whose check digit actually fails. It tries every OCR-ambiguous
     // permutation within those fields — ordered by how likely the OCR error is

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

package/lib/typescript/src/Shared/Libs/mrz.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mrz.utils.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/mrz.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAepD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;sBAOwB,MAAM,KAAG,MAAM;2BAs2B7B,MAAM,gBACF,OAAO,KACnB,mBAAmB;0CAwIuB,MAAM,KAAG,mBAAmB;wCA3yB9B,MAAM,KAAG,MAAM,EAAE,EAAE;wCAqzBnB,MAAM,KAAG,MAAM;gCAmDvB,MAAM;;;;;+BAnrBP,MAAM,KAAG,OAAO;iCA4Bd,MAAM,KAAG,MAAM;wCAqqBR,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,IAAI;;AAgBxE,wBAUE"}
+{"version":3,"file":"mrz.utils.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/mrz.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAepD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;;sBAOwB,MAAM,KAAG,MAAM;2BAk5B7B,MAAM,gBACF,OAAO,KACnB,mBAAmB;0CA6JuB,MAAM,KAAG,mBAAmB;wCA52B9B,MAAM,KAAG,MAAM,EAAE,EAAE;wCAs3BnB,MAAM,KAAG,MAAM;gCAmDvB,MAAM;;;;;+BAvtBP,MAAM,KAAG,OAAO;iCA4Bd,MAAM,KAAG,MAAM;wCAysBR,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,IAAI;;AAgBxE,wBAUE"}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustchex/react-native-sdk",
-  "version": "1.475.0",
+  "version": "1.475.1",
   "description": "Trustchex mobile app react native SDK for android or ios devices",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -69,7 +69,8 @@
     "uuid": "11.1.1",
     "yaml": "2.8.3",
     "fast-uri": "3.1.2",
-    "flatted": "3.4.2"
+    "flatted": "3.4.2",
+    "react-native-screens": "4.18.0"
   },
   "scripts": {
     "example": "yarn workspace @trustchex/react-native-sdk-example",

package/src/Shared/Libs/mrz.utils.ts

@@ -347,17 +347,46 @@ const reconstructMRZCandidates = (rawText: string): string[][] => {
         const after = flat.indexOf(l1Source) + l1Source.length;
         l2 = pad(flat.slice(after, after + 30), 30);
       }
-      // Line 3 (name): the longest letter+filler OCR line that is NOT the doc or
-      // date line — exclude obvious front-of-card title words by requiring fillers.
-      const nameRuns = ocrLines.filter(
-        (l) =>
-          l !== l1Source &&
-          l !== l2Line &&
-          /^[A-Z<]+$/.test(l) &&
-          /</.test(l) &&
-          l.length >= 5
-      );
-      const l3 = pad(nameRuns.sort((a, b) => b.length - a.length)[0] ?? '', 30);
+      // Line 3 (name): the longest mostly-letters+filler OCR line that is NOT the
+      // doc or date line. OCR mangles the name line too — a leading "O" reads as
+      // "0", and the trailing "<" fillers read as K/C — so we DON'T require a
+      // pure [A-Z<] line (that wrongly drops "0ZCAN<<ERDAL…" entirely). Accept a
+      // line that is predominantly letters/fillers, then normalise it.
+      const isNameLike = (l: string): boolean => {
+        if (l === l1Source || l === l2Line || l.length < 5) return false;
+        if (!/</.test(l)) return false; // must have at least one filler
+        // Must look like "SURNAME<<NAMES…": starts with a letter (or its digit
+        // look-alike) and is dominated by letters/fillers, not a numeric record.
+        if (!/^[A-Z0-9]/.test(l)) return false;
+        const letters = (l.match(/[A-Z]/g) || []).length;
+        const digits = (l.match(/[0-9]/g) || []).length;
+        // A date/doc record is digit-heavy; a name is letter-heavy.
+        return letters >= 3 && letters >= digits;
+      };
+      // Normalise a name line: digit look-alikes back to letters (O/I/S/B/Z/G),
+      // and the filler-letter run misreads (K/C/E/G adjacent to fillers) to "<".
+      const normaliseName = (l: string): string => {
+        const digitToLetter: Record<string, string> = {
+          '0': 'O',
+          '1': 'I',
+          '5': 'S',
+          '8': 'B',
+          '2': 'Z',
+          '6': 'G',
+        };
+        return (
+          l
+            // digit look-alikes inside the name → letters
+            .replace(/[015862]/g, (d) => digitToLetter[d] ?? d)
+            // a run of filler-letters (K/C/E/G) flanked by fillers or at the tail
+            // is the trailing/internal filler region
+            .replace(/(?<=<)[KCEG]+(?=<|$)/g, (m) => '<'.repeat(m.length))
+            .replace(/[KCEG]+$/g, (m) => '<'.repeat(m.length))
+        );
+      };
+      const nameRuns = ocrLines.filter(isNameLike);
+      const bestName = nameRuns.sort((a, b) => b.length - a.length)[0] ?? '';
+      const l3 = pad(normaliseName(bestName), 30);
       candidates.push([l1, l2, l3]);
     }
   }
@@ -904,6 +933,21 @@ const correctedMrzFromParse = (
   return buffers.map((b) => b.join('')).join('\n');
 };
 
+/**
+ * Heuristic: does a parsed result's name look like it still carries OCR noise
+ * (a digit where a name letter belongs, or a run of filler-confusable letters
+ * that should have been "<")? Names are letters only, so any digit is noise; a
+ * 3+ run of K/C/E/G is very likely misread fillers leaking into the given names.
+ */
+const nameLooksNoisy = (r: ReturnType<typeof parse>): boolean => {
+  const name = `${r.fields?.lastName ?? ''} ${r.fields?.firstName ?? ''}`;
+  // A DIGIT in a name is unambiguous OCR noise (MRZ names are letters only).
+  // A 5+ run of filler-confusable letters is almost certainly misread padding —
+  // real given names like "ECE"/"GECE" are short, so keep the threshold high to
+  // avoid false positives on legitimate names.
+  return /[0-9]/.test(name) || /[KCEG]{5,}/.test(name);
+};
+
 /**
  * Validates MRZ text using the mrz npm package
  * @param mrzText Raw or cleaned MRZ text
@@ -929,6 +973,27 @@ const validateMRZ = (
       result = null;
     }
 
+    // The direct parse can validate (the name field has no check digit) while the
+    // name line still carries OCR noise — a leading "O" read as "0", or trailing
+    // "<" fillers read as K/C/E/G that leak into the given names. The
+    // reconstruction path normalises the name line; when the direct result's name
+    // looks noisy, prefer a reconstructed candidate that validates with a cleaner
+    // name. This only ever swaps in another fully check-digit-valid reading.
+    if (result?.valid && nameLooksNoisy(result)) {
+      for (const reLines of reconstructMRZCandidates(mrzText)) {
+        let cand: ReturnType<typeof parse>;
+        try {
+          cand = parse(reLines);
+        } catch {
+          continue;
+        }
+        if (cand.valid && !nameLooksNoisy(cand)) {
+          result = cand;
+          break;
+        }
+      }
+    }
+
     // Primary recovery: exhaustive, CHECK-DIGIT-DRIVEN correction scoped to the
     // fields whose check digit actually fails. It tries every OCR-ambiguous
     // permutation within those fields — ordered by how likely the OCR error is

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