@trustchex/react-native-sdk 1.503.2 → 1.505.0

package/lib/module/Screens/Dynamic/IdentityDocumentEIDScanningScreen.js

@@ -86,6 +86,13 @@ const IdentityDocumentEIDScanningScreen = () => {
         // the MRZ is on the BACK (idBackSideData), so it must be included
         // — without it, ID-card scans had no VIZ source and hard-blocked.
         passportData?.mrzFields ?? idBackSideData?.mrzFields ?? idFrontSideData?.mrzFields ?? appContext.identificationInfo.scannedDocument?.mrzFields,
+        vizImage:
+        // Full data-page image from the EID step's camera scan. EIDScanner
+        // runs a one-shot OCR pass over it to recover the diacritic printed
+        // name when the chip's DG11 is absent or one-sided (e.g. Turkish
+        // passports). The live camera only OCRs a cropped MRZ region, so the
+        // printed name must be recovered from the full image here.
+        passportData?.image ?? idFrontSideData?.image ?? idBackSideData?.image,
         onScanSuccess: (mrzFields, faceImage, mimeType) => {
           if (mrzFields && faceImage && mimeType) {
             if (!appContext.identificationInfo.scannedDocument) {

package/lib/module/Screens/Dynamic/IdentityDocumentScanningScreen.js

@@ -2,6 +2,8 @@
 
 import React, { useContext, useEffect, useState } from 'react';
 import { buildDocumentName } from "../../Shared/Libs/mrzTransliteration.js";
+import { recoverVizName, recognizeVizBlocks } from "../../Shared/Libs/vizName.js";
+import { debugLog } from "../../Shared/Libs/debug.utils.js";
 import { isCountryAllowed } from "../../Shared/Libs/country-allow.js";
 import { normalizeFromMRZFields } from "../../Shared/Libs/documentDataNormalizer.js";
 import { Alert, SafeAreaView, StyleSheet, View } from 'react-native';
@@ -90,10 +92,25 @@ const IdentityDocumentScanningScreen = () => {
 
       // Track successful document scan completion as funnel step
       trackFunnelStep('Document Scan Completed', 2, 5, 'contract_acceptance', true);
-      {
+      void (async () => {
         const documentData = normalizeFromMRZFields(mrzFields);
         const faceImg = idFrontSideData?.faceImage || passportData?.faceImage;
-        const builtName = buildDocumentName(documentData.firstName, documentData.lastName, documentData.issuingCountry);
+        // Recover the printed (VIZ) name with diacritics the MRZ cannot carry.
+        // The live camera OCRs only a cropped MRZ region, so the printed name was
+        // never recognised there — run a one-shot full-frame OCR pass on the
+        // captured data-page image to surface it. The MRZ sits at the bottom, so
+        // restrict the name search to blocks above it.
+        const docImage = idFrontSideData?.image || passportData?.image;
+        const vizBlocks = await recognizeVizBlocks(docImage);
+        const mrzTop = vizBlocks.length ? Math.max(...vizBlocks.map(b => b.top)) : undefined;
+        const viz = vizBlocks.length ? recoverVizName(vizBlocks, documentData.firstName, documentData.lastName, mrzTop) : null;
+        debugLog('VIZName', 'ocr recovery', {
+          vizBlockCount: vizBlocks.length,
+          matchedFirst: !!viz?.vizFirst,
+          matchedLast: !!viz?.vizLast,
+          mismatch: viz?.mismatch ?? false
+        });
+        const builtName = buildDocumentName(documentData.firstName, documentData.lastName, documentData.issuingCountry, undefined, undefined, viz);
         const documentReadResult = {
           document: {
             ...documentData,
@@ -108,7 +125,7 @@ const IdentityDocumentScanningScreen = () => {
         };
         appContext.setLastDocumentRead?.(documentReadResult);
         appContext.onDocumentRead?.(documentReadResult);
-      }
+      })();
       setTimeout(() => navigationManagerRef.current?.navigateToNextStep(), 1000);
     }
   }, [idFrontSideData, idBackSideData, passportData, appContext.identificationInfo, allowedCountries, allowedDocumentTypes, t, appContext]);

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

@@ -7,10 +7,11 @@ import NFCManager from 'react-native-nfc-manager';
 import DeviceInfo from 'react-native-device-info';
 import PermissionManager from "../Libs/permissions.utils.js";
 import mrzUtils from "../Libs/mrz.utils.js";
-import { debugError } from "../Libs/debug.utils.js";
+import { debugError, debugLog } from "../Libs/debug.utils.js";
 import { eidReader } from "../EIDReader/eidReader.js";
 import NativeProgressBar from "./NativeProgressBar.js";
 import { buildDocumentName } from "../Libs/mrzTransliteration.js";
+import { recoverVizName, recognizeVizBlocks } from "../Libs/vizName.js";
 import { normalizeFromMRZInfo, normalizeFromMRZFields } from "../Libs/documentDataNormalizer.js";
 import { compareChipToViz } from "../Libs/chipVizMatch.js";
 import { useTranslation } from 'react-i18next';
@@ -36,6 +37,7 @@ const EIDScanner = ({
   dateOfExpiry,
   documentType,
   vizMrzFields,
+  vizImage,
   onScanSuccess,
   isNFCSupported
 }) => {
@@ -246,7 +248,24 @@ const EIDScanner = ({
           Vibration.vibrate(120);
           const scanDuration = Date.now() - startTime;
           const documentData = normalizeFromMRZInfo(passportData.mrz);
-          const builtName = buildDocumentName(documentData.firstName, documentData.lastName, documentData.issuingCountry, passportData.dg11FirstName, passportData.dg11LastName);
+          // DG11 (the authenticated chip's own printed name) is the preferred
+          // correction. When it is absent or one-sided, fall back to recovering
+          // the diacritic printed name from the EID step's VIZ camera blocks —
+          // this is what fixes e.g. Turkish passports whose DG11 has no usable
+          // name. buildDocumentName ranks viz_ocr above dg11, so only pass the
+          // VIZ candidate when DG11 did NOT provide a clean two-part name.
+          const dg11HasBothNames = !!passportData.dg11FirstName && !!passportData.dg11LastName;
+          // Only OCR the VIZ when DG11 didn't already provide a clean name.
+          const vizBlocks = !dg11HasBothNames ? await recognizeVizBlocks(vizImage) : [];
+          const viz = vizBlocks.length ? recoverVizName(vizBlocks, documentData.firstName, documentData.lastName, Math.max(...vizBlocks.map(b => b.top))) : null;
+          debugLog('VIZName', 'eid recovery', {
+            dg11HasBothNames,
+            vizBlockCount: vizBlocks.length,
+            matchedFirst: !!viz?.vizFirst,
+            matchedLast: !!viz?.vizLast,
+            mismatch: viz?.mismatch ?? false
+          });
+          const builtName = buildDocumentName(documentData.firstName, documentData.lastName, documentData.issuingCountry, passportData.dg11FirstName, passportData.dg11LastName, viz);
           // MASAK Tebliğ No. 32 Article 4/C(1)(b): the chip identity data must
           // match the data printed on the passport. The printed/VIZ MRZ is the
           // camera scan the EID step itself runs to obtain the BAC/PACE key,

package/lib/module/Shared/EIDReader/eidReader.js

@@ -621,8 +621,16 @@ const eidReader = async (documentNumber, dateOfBirth, dateOfExpiry, progressCall
       dg11FirstName = dg11File.getFirstName();
       dg11LastName = dg11File.getLastName();
       dg11Address = dg11File.getAddress();
-    } catch {
+      debugLog('EIDReader', 'DG11 read', {
+        firstName: dg11FirstName,
+        lastName: dg11LastName,
+        hasAddress: !!dg11Address
+      });
+    } catch (e) {
       // DG11 is optional — not all chips have it, and access may be denied
+      debugLog('EIDReader', 'DG11 not available', {
+        error: e instanceof Error ? e.message : String(e)
+      });
     }
 
     // Read DG2 (Face Image)

package/lib/module/Shared/Libs/mrzTransliteration.js

@@ -10,17 +10,32 @@ const DANISH = [['AA', 'Å'], ['AE', 'Æ'], ['OE', 'Ø']];
 const NORWEGIAN = [['AA', 'Å'], ['AE', 'Æ'], ['OE', 'Ø']];
 const FRENCH = [['OE', 'Œ'], ['AE', 'Æ']];
 const ICELANDIC = [['AE', 'Æ'], ['OE', 'Ö'], ['TH', 'Þ'], ['D', 'Ð']];
+
+// Finnish/Estonian share the Swedish-style AE→Ä, OE→Ö pair (no Å in names is
+// common, but AA→Å is safe to include for Finnish-Swedish surnames).
+const FINNISH = [['AE', 'Ä'], ['OE', 'Ö'], ['AA', 'Å']];
+const ESTONIAN = [['AE', 'Ä'], ['OE', 'Ö'], ['UE', 'Ü']];
 const COUNTRY_MAP = {
   DEU: GERMAN,
   AUT: GERMAN,
   CHE: GERMAN,
+  LIE: GERMAN,
   SWE: SWEDISH,
   DNK: DANISH,
   NOR: NORWEGIAN,
   FRA: FRENCH,
   LUX: FRENCH,
-  ISL: ICELANDIC
+  BEL: FRENCH,
+  ISL: ICELANDIC,
+  FIN: FINNISH,
+  EST: ESTONIAN
 };
+// NOTE: Turkish (TUR), Hungarian, Polish, Czech, Slovak, etc. are intentionally
+// absent. Their diacritics (Ş Ğ İ Ç, ő ű, ł, ř ž, ą ę) collapse to bare ASCII in
+// the MRZ with NO digraph, so they cannot be reconstructed from the MRZ at all.
+// For those documents the only correct source is the printed VIZ (viz_ocr) or
+// the chip's DG11 — see buildDocumentName's priority order.
+
 function applyDigraphMap(token, map) {
   let result = '';
   let i = 0;
@@ -44,7 +59,30 @@ function applyDigraphMap(token, map) {
 function convertName(rawName, map) {
   return rawName.split(' ').map(word => applyDigraphMap(word, map)).join(' ');
 }
-export function buildDocumentName(rawFirst, rawLast, issuingState, dg11First, dg11Last) {
+export function buildDocumentName(rawFirst, rawLast, issuingState, dg11First, dg11Last, viz) {
+  // Highest priority: the printed VIZ name recovered via OCR. This is the only
+  // source that can restore diacritics the MRZ cannot represent (e.g. Turkish
+  // Ş Ğ İ Ç) when the chip's DG11 is absent. `recoverVizName` only returns a
+  // candidate that folds to the SAME ASCII as the MRZ name, so accepting it
+  // restores diacritics without changing the letters. A letter-level
+  // discrepancy comes back as `mismatch` (no candidate applied) and is surfaced
+  // via `nameMismatch` for operator review — the MRZ name stays authoritative.
+  if (viz && (viz.vizFirst || viz.vizLast)) {
+    return {
+      rawFirst,
+      rawLast,
+      displayFirst: viz.vizFirst ?? rawFirst,
+      displayLast: viz.vizLast ?? rawLast,
+      source: 'viz_ocr',
+      nameMismatch: viz.mismatch || undefined
+    };
+  }
+
+  // A VIZ name was detected but disagreed with the MRZ at the letter level and
+  // could not be applied. The MRZ stays authoritative through the branches
+  // below, but we carry the review flag through so the discrepancy is recorded.
+  const nameMismatch = viz?.mismatch ? true : undefined;
+
   // Prefer DG11 (the chip's printed name in UTF-8) ONLY when it carries a proper
   // two-part split — both a surname AND a given name. That is the authoritative
   // correction for chips whose DG1 MRZ name lacks a `<<` separator (e.g. Turkish
@@ -64,7 +102,8 @@ export function buildDocumentName(rawFirst, rawLast, issuingState, dg11First, dg
       rawLast,
       displayFirst: dg11First,
       displayLast: dg11Last,
-      source: 'dg11'
+      source: 'dg11',
+      nameMismatch
     };
   }
   const country = (issuingState ?? '').toUpperCase().trim();
@@ -75,7 +114,8 @@ export function buildDocumentName(rawFirst, rawLast, issuingState, dg11First, dg
       rawLast,
       displayFirst: convertName(rawFirst, map),
       displayLast: convertName(rawLast, map),
-      source: 'reverse_table'
+      source: 'reverse_table',
+      nameMismatch
     };
   }
 
@@ -88,6 +128,7 @@ export function buildDocumentName(rawFirst, rawLast, issuingState, dg11First, dg
     rawLast,
     displayFirst,
     displayLast,
-    source: changed ? 'reverse_table' : 'raw'
+    source: changed ? 'reverse_table' : 'raw',
+    nameMismatch
   };
 }

package/lib/module/Shared/Libs/vizName.js

@@ -0,0 +1,140 @@
+"use strict";
+
+/**
+ * Visual Inspection Zone (VIZ) printed-name recovery.
+ *
+ * The MRZ stores names in ASCII OCR-B with no diacritics, and for some scripts
+ * the diacritics are unrecoverable from the MRZ alone — Turkish in particular
+ * collapses Ş→S, Ğ→G, İ→I, Ç→C, Ö→O, Ü→U with no ICAO digraph, so "ŞİMŞEK"
+ * reads as "SIMSEK" and the true form is lost. The chip's DG11 carries the
+ * printed name in UTF-8, but it is optional and often absent.
+ *
+ * The printed name IS, however, on the document's data page in its native form.
+ * ML Kit already recognises every text block on the page (with bounding boxes)
+ * for MRZ parsing; this module reuses those blocks to recover the diacritic
+ * printed name and reconcile it against the MRZ.
+ *
+ * Conflict policy (per product decision): the MRZ name stays authoritative. We
+ * accept a VIZ candidate ONLY when it folds to the same ASCII as the MRZ name
+ * (i.e. it is the same name, just with diacritics restored). When the VIZ name
+ * differs at the letter level — a possible OCR misread or a genuine discrepancy
+ * — we keep the MRZ value and raise a `nameMismatch` flag for operator review
+ * rather than silently overwriting the machine-read name.
+ */
+
+import { NativeModules } from 'react-native';
+
+/** One recognised text block, in the shape ML Kit returns to JS. */
+
+/**
+ * Run a single full-frame OCR pass over the captured document image and return
+ * its text blocks.
+ *
+ * The live camera path OCRs only a cropped MRZ region (tuned for MRZ sharpness),
+ * so the printed name above it is never recognised there. This one-shot pass on
+ * the FULL captured image surfaces the printed VIZ name for {@link recoverVizName}.
+ * It is best-effort: returns [] when the native module is missing, the image is
+ * absent, or OCR throws — the caller then simply falls back to DG11/MRZ.
+ *
+ * @param base64Image Full document image (no data-URI prefix), or null/undefined.
+ */
+export async function recognizeVizBlocks(base64Image) {
+  // Resolved per-call (not captured at import) so module-load ordering can't
+  // null it out, and so it is mockable in tests.
+  const mlkit = NativeModules.MLKitModule;
+  if (!base64Image || !mlkit?.recognizeText) return [];
+  try {
+    const blocks = await mlkit.recognizeText(base64Image);
+    return (blocks ?? []).filter(b => !!b?.text).map(b => ({
+      text: b.text,
+      top: b.boundingBox?.top ?? 0
+    }));
+  } catch {
+    return [];
+  }
+}
+/**
+ * Fold a string to bare ASCII upper-case letters for comparison: strip
+ * combining marks via NFD, map the handful of letters that have no combining
+ * decomposition (ı, ł, ø, đ, ð, ß, æ, œ, þ), drop everything that is not A–Z.
+ * This is the canonical form in which an MRZ name and its printed counterpart
+ * become directly comparable.
+ */
+export function foldAscii(value) {
+  if (!value) return '';
+  return value.normalize('NFD').replace(/[̀-ͯ]/g, '') // combining diacritical marks
+  .replace(/ı/g, 'i').replace(/İ/g, 'I').replace(/ø/gi, 'O').replace(/ł/gi, 'L').replace(/đ/gi, 'D').replace(/ð/gi, 'D').replace(/þ/gi, 'TH').replace(/ß/g, 'SS').replace(/æ/gi, 'AE').replace(/œ/gi, 'OE').toUpperCase().replace(/[^A-Z]/g, '');
+}
+
+/** Split a printed-name line into upper-case word tokens (letters + marks). */
+function tokenize(line) {
+  return line.split(/[\s,]+/).map(w => w.trim()).filter(w => w.length > 0 && /\p{L}/u.test(w)).map(w => w.toUpperCase());
+}
+
+/**
+ * Find the printed token sequence whose folded ASCII equals the folded MRZ name.
+ * Returns the diacritic-preserving printed form when found, else null.
+ *
+ * The candidate lines are searched in document order; the matched window is the
+ * shortest run of consecutive tokens whose concatenated fold equals the target.
+ * Because the comparison is on the FOLDED form, only an exact same-name match
+ * succeeds — a different printed name will not fold-match and yields null.
+ */
+function recoverPrintedName(lines, mrzName) {
+  const target = foldAscii(mrzName);
+  if (!target) return null;
+  for (const line of lines) {
+    const tokens = tokenize(line);
+    // Slide a window over the tokens; the printed name may sit among other
+    // label text on the same block ("Surname / Nom  ÖZTÜRK").
+    for (let start = 0; start < tokens.length; start++) {
+      let acc = '';
+      const picked = [];
+      for (let end = start; end < tokens.length; end++) {
+        acc += foldAscii(tokens[end]);
+        picked.push(tokens[end]);
+        if (acc.length > target.length) break;
+        if (acc === target) {
+          return picked.join(' ');
+        }
+      }
+    }
+  }
+  return null;
+}
+
+/**
+ * Recover the diacritic printed name from VIZ text blocks and reconcile it with
+ * the MRZ-derived raw names.
+ *
+ * @param blocks   Recognised text blocks (text + vertical position).
+ * @param mrzFirst Raw MRZ given name (ASCII, may be empty).
+ * @param mrzLast  Raw MRZ surname (ASCII, may be empty).
+ * @param mrzTop   Vertical position of the MRZ block, when known. Name fields
+ *                 sit ABOVE the MRZ on the data page; passing this restricts the
+ *                 search to blocks above it, avoiding false matches in the MRZ
+ *                 itself. When undefined, all blocks are searched.
+ */
+export function recoverVizName(blocks, mrzFirst, mrzLast, mrzTop) {
+  const above = typeof mrzTop === 'number' ? blocks.filter(b => b.top < mrzTop) : blocks;
+  // Each block's text may hold several printed lines.
+  const lines = above.flatMap(b => b.text.split(/\r?\n/));
+  const vizFirst = mrzFirst ? recoverPrintedName(lines, mrzFirst) : null;
+  const vizLast = mrzLast ? recoverPrintedName(lines, mrzLast) : null;
+
+  // Detect a letter-level discrepancy: a printed line clearly carries the name
+  // field but its fold does not equal the MRZ name. We approximate this by
+  // checking whether ANY line fold-matches; if the MRZ name is non-trivial and
+  // nothing matched, the printed name on the page disagrees with the MRZ.
+  const lastMissing = !!mrzLast && vizLast === null;
+  const firstMissing = !!mrzFirst && vizFirst === null;
+  // Only call it a mismatch when there is printed name-like text to compare
+  // against — otherwise the VIZ simply was not captured (not a conflict).
+  const hasPrintedNameText = lines.some(l => tokenize(l).length > 0);
+  const mismatch = hasPrintedNameText && (lastMissing || firstMissing);
+  return {
+    vizFirst,
+    vizLast,
+    mismatch
+  };
+}

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

package/lib/typescript/src/Screens/Dynamic/IdentityDocumentEIDScanningScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentEIDScanningScreen.d.ts","sourceRoot":"","sources":["../../../../../src/Screens/Dynamic/IdentityDocumentEIDScanningScreen.tsx"],"names":[],"mappings":"AAsBA,QAAA,MAAM,iCAAiC,+CA0PtC,CAAC;AAoBF,eAAe,iCAAiC,CAAC"}
+{"version":3,"file":"IdentityDocumentEIDScanningScreen.d.ts","sourceRoot":"","sources":["../../../../../src/Screens/Dynamic/IdentityDocumentEIDScanningScreen.tsx"],"names":[],"mappings":"AAsBA,QAAA,MAAM,iCAAiC,+CAoQtC,CAAC;AAoBF,eAAe,iCAAiC,CAAC"}

package/lib/typescript/src/Screens/Dynamic/IdentityDocumentScanningScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentScanningScreen.d.ts","sourceRoot":"","sources":["../../../../../src/Screens/Dynamic/IdentityDocumentScanningScreen.tsx"],"names":[],"mappings":"AAwBA,QAAA,MAAM,8BAA8B,+CAqLnC,CAAC;AAgBF,eAAe,8BAA8B,CAAC"}
+{"version":3,"file":"IdentityDocumentScanningScreen.d.ts","sourceRoot":"","sources":["../../../../../src/Screens/Dynamic/IdentityDocumentScanningScreen.tsx"],"names":[],"mappings":"AA0BA,QAAA,MAAM,8BAA8B,+CAiNnC,CAAC;AAgBF,eAAe,8BAA8B,CAAC"}

package/lib/typescript/src/Shared/Components/EIDScanner.d.ts

@@ -10,9 +10,15 @@ interface eIDScannerProps {
      * because scannedDocument.mrzFields is only persisted after the chip read.
      */
     vizMrzFields?: MRZFields;
+    /**
+     * Full data-page image from the EID step's camera scan. A one-shot OCR pass
+     * recovers the diacritic printed name when the chip's DG11 is absent or
+     * one-sided — DG11 (the authenticated chip's own name) still takes precedence.
+     */
+    vizImage?: string;
     onScanSuccess?: (mrzInfo: MRZFields, faceImage: string, faceImageMimeType: string) => void;
     isNFCSupported?: (supported: boolean) => void;
 }
-declare const EIDScanner: ({ documentNumber, dateOfBirth, dateOfExpiry, documentType, vizMrzFields, onScanSuccess, isNFCSupported, }: eIDScannerProps) => import("react/jsx-runtime").JSX.Element;
+declare const EIDScanner: ({ documentNumber, dateOfBirth, dateOfExpiry, documentType, vizMrzFields, vizImage, onScanSuccess, isNFCSupported, }: eIDScannerProps) => import("react/jsx-runtime").JSX.Element;
 export default EIDScanner;
 //# sourceMappingURL=EIDScanner.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"EIDScanner.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/EIDScanner.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA6BpD,UAAU,eAAe;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,SAAS,EAClB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,KACtB,IAAI,CAAC;IACV,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C;AAED,QAAA,MAAM,UAAU,GAAI,2GAQjB,eAAe,4CAi6BjB,CAAC;AAsOF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"EIDScanner.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/EIDScanner.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA8BpD,UAAU,eAAe;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,SAAS,EAClB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,KACtB,IAAI,CAAC;IACV,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C;AAED,QAAA,MAAM,UAAU,GAAI,qHASjB,eAAe,4CA67BjB,CAAC;AAsOF,eAAe,UAAU,CAAC"}

package/lib/typescript/src/Shared/EIDReader/eidReader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eidReader.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/EIDReader/eidReader.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA2Y7C,QAAA,MAAM,SAAS,GACb,gBAAgB,MAAM,EACtB,aAAa,MAAM,EACnB,cAAc,MAAM,EACpB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EAC7C,UAAU;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,KAClC,OAAO,CACN;IACE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE;QACZ,SAAS,EAAE,OAAO,yBAAyB,EAAE,eAAe,GAAG,IAAI,CAAC;QACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,GACD,SAAS,CAocZ,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"eidReader.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/EIDReader/eidReader.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AA2Y7C,QAAA,MAAM,SAAS,GACb,gBAAgB,MAAM,EACtB,aAAa,MAAM,EACnB,cAAc,MAAM,EACpB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EAC7C,UAAU;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,KAClC,OAAO,CACN;IACE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE;QACZ,SAAS,EAAE,OAAO,yBAAyB,EAAE,eAAe,GAAG,IAAI,CAAC;QACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,GACD,SAAS,CA4cZ,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/lib/typescript/src/Shared/Libs/mrzTransliteration.d.ts

@@ -1,3 +1,4 @@
 import type { DocumentName } from '../Types/documentReadResult';
-export declare function buildDocumentName(rawFirst: string, rawLast: string, issuingState: string | null | undefined, dg11First?: string | null, dg11Last?: string | null): DocumentName;
+import type { VizNameCandidate } from './vizName';
+export declare function buildDocumentName(rawFirst: string, rawLast: string, issuingState: string | null | undefined, dg11First?: string | null, dg11Last?: string | null, viz?: VizNameCandidate | null): DocumentName;
 //# sourceMappingURL=mrzTransliteration.d.ts.map

package/lib/typescript/src/Shared/Libs/mrzTransliteration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mrzTransliteration.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/mrzTransliteration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAyFhE,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACvC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,YAAY,CAgDd"}
+{"version":3,"file":"mrzTransliteration.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/mrzTransliteration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAgHlD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACvC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,GAAG,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAC5B,YAAY,CA0Ed"}

package/lib/typescript/src/Shared/Libs/vizName.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Visual Inspection Zone (VIZ) printed-name recovery.
+ *
+ * The MRZ stores names in ASCII OCR-B with no diacritics, and for some scripts
+ * the diacritics are unrecoverable from the MRZ alone — Turkish in particular
+ * collapses Ş→S, Ğ→G, İ→I, Ç→C, Ö→O, Ü→U with no ICAO digraph, so "ŞİMŞEK"
+ * reads as "SIMSEK" and the true form is lost. The chip's DG11 carries the
+ * printed name in UTF-8, but it is optional and often absent.
+ *
+ * The printed name IS, however, on the document's data page in its native form.
+ * ML Kit already recognises every text block on the page (with bounding boxes)
+ * for MRZ parsing; this module reuses those blocks to recover the diacritic
+ * printed name and reconcile it against the MRZ.
+ *
+ * Conflict policy (per product decision): the MRZ name stays authoritative. We
+ * accept a VIZ candidate ONLY when it folds to the same ASCII as the MRZ name
+ * (i.e. it is the same name, just with diacritics restored). When the VIZ name
+ * differs at the letter level — a possible OCR misread or a genuine discrepancy
+ * — we keep the MRZ value and raise a `nameMismatch` flag for operator review
+ * rather than silently overwriting the machine-read name.
+ */
+/** One recognised text block, in the shape ML Kit returns to JS. */
+export interface VizTextBlock {
+    /** Full recognised text of the block (may contain multiple lines). */
+    text: string;
+    /** Vertical position of the block's top edge, in image pixels. */
+    top: number;
+}
+/**
+ * Run a single full-frame OCR pass over the captured document image and return
+ * its text blocks.
+ *
+ * The live camera path OCRs only a cropped MRZ region (tuned for MRZ sharpness),
+ * so the printed name above it is never recognised there. This one-shot pass on
+ * the FULL captured image surfaces the printed VIZ name for {@link recoverVizName}.
+ * It is best-effort: returns [] when the native module is missing, the image is
+ * absent, or OCR throws — the caller then simply falls back to DG11/MRZ.
+ *
+ * @param base64Image Full document image (no data-URI prefix), or null/undefined.
+ */
+export declare function recognizeVizBlocks(base64Image: string | null | undefined): Promise<VizTextBlock[]>;
+export interface VizNameCandidate {
+    /** Diacritic given name recovered from the VIZ, or null when none matched. */
+    vizFirst: string | null;
+    /** Diacritic surname recovered from the VIZ, or null when none matched. */
+    vizLast: string | null;
+    /**
+     * True when a printed name line was found but its folded ASCII does not match
+     * the MRZ name — the candidate is NOT applied; the caller should flag review.
+     */
+    mismatch: boolean;
+}
+/**
+ * Fold a string to bare ASCII upper-case letters for comparison: strip
+ * combining marks via NFD, map the handful of letters that have no combining
+ * decomposition (ı, ł, ø, đ, ð, ß, æ, œ, þ), drop everything that is not A–Z.
+ * This is the canonical form in which an MRZ name and its printed counterpart
+ * become directly comparable.
+ */
+export declare function foldAscii(value: string | null | undefined): string;
+/**
+ * Recover the diacritic printed name from VIZ text blocks and reconcile it with
+ * the MRZ-derived raw names.
+ *
+ * @param blocks   Recognised text blocks (text + vertical position).
+ * @param mrzFirst Raw MRZ given name (ASCII, may be empty).
+ * @param mrzLast  Raw MRZ surname (ASCII, may be empty).
+ * @param mrzTop   Vertical position of the MRZ block, when known. Name fields
+ *                 sit ABOVE the MRZ on the data page; passing this restricts the
+ *                 search to blocks above it, avoiding false matches in the MRZ
+ *                 itself. When undefined, all blocks are searched.
+ */
+export declare function recoverVizName(blocks: VizTextBlock[], mrzFirst: string, mrzLast: string, mrzTop?: number): VizNameCandidate;
+//# sourceMappingURL=vizName.d.ts.map

package/lib/typescript/src/Shared/Libs/vizName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vizName.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/vizName.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,oEAAoE;AACpE,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;CACb;AAWD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,OAAO,CAAC,YAAY,EAAE,CAAC,CAczB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAiBlE;AA4CD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EAAE,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB,CAuBlB"}

package/lib/typescript/src/Shared/Types/documentReadResult.d.ts

@@ -3,11 +3,12 @@ import type { ChipVizMatchResult } from '../Libs/chipVizMatch';
 /**
  * How the display name was derived from the raw MRZ ASCII name.
  *
+ * - `viz_ocr`       — recovered from the printed VIZ via OCR (exact printed name with diacritics)
  * - `dg11`          — read from the chip's DG11 supplemental data file (exact printed name)
  * - `reverse_table` — reconstructed via country-aware ICAO 9303 reverse transliteration table
  * - `raw`           — no conversion applied; display equals the raw MRZ value
  */
-export type DocumentNameSource = 'dg11' | 'reverse_table' | 'raw';
+export type DocumentNameSource = 'viz_ocr' | 'dg11' | 'reverse_table' | 'raw';
 export interface DocumentName {
     /** First name exactly as stored in the MRZ (ASCII, OCR-B, e.g. "GOEKHAN"). */
     rawFirst: string;
@@ -19,6 +20,12 @@ export interface DocumentName {
     displayLast: string;
     /** How displayFirst / displayLast were derived. */
     source: DocumentNameSource;
+    /**
+     * True when a printed VIZ name was detected but disagreed with the MRZ name
+     * at the letter level (beyond diacritics). The MRZ value is kept as the
+     * display name; this flag signals the discrepancy for operator review.
+     */
+    nameMismatch?: boolean;
 }
 export interface DocumentFaceImage {
     /** Base64-encoded image data (no data-URI prefix). */

package/lib/typescript/src/Shared/Types/documentReadResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documentReadResult.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Types/documentReadResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,eAAe,GAAG,KAAK,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,QAAQ,EAAE,YAAY,CAAC;IACvB;;;;OAIG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QACZ,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,IAAI,CAAC;QAC5D,qEAAqE;QACrE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}
+{"version":3,"file":"documentReadResult.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Types/documentReadResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,GAAG,eAAe,GAAG,KAAK,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,kBAAkB,CAAC;IAC3B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,QAAQ,EAAE,YAAY,CAAC;IACvB;;;;OAIG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC;;;;;OAKG;IACH,WAAW,CAAC,EAAE;QACZ,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,YAAY,GAAG,IAAI,CAAC;QAC5D,qEAAqE;QACrE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustchex/react-native-sdk",
-  "version": "1.503.2",
+  "version": "1.505.0",
   "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/Screens/Dynamic/IdentityDocumentEIDScanningScreen.tsx

@@ -116,6 +116,16 @@ const IdentityDocumentEIDScanningScreen = () => {
               idFrontSideData?.mrzFields ??
               appContext.identificationInfo.scannedDocument?.mrzFields
             }
+            vizImage={
+              // Full data-page image from the EID step's camera scan. EIDScanner
+              // runs a one-shot OCR pass over it to recover the diacritic printed
+              // name when the chip's DG11 is absent or one-sided (e.g. Turkish
+              // passports). The live camera only OCRs a cropped MRZ region, so the
+              // printed name must be recovered from the full image here.
+              passportData?.image ??
+              idFrontSideData?.image ??
+              idBackSideData?.image
+            }
             onScanSuccess={(mrzFields, faceImage, mimeType) => {
               if (mrzFields && faceImage && mimeType) {
                 if (!appContext.identificationInfo.scannedDocument) {

package/src/Screens/Dynamic/IdentityDocumentScanningScreen.tsx

@@ -2,6 +2,8 @@ import React, { useContext, useEffect, useState } from 'react';
 
 import type { MRZFields } from '../../Shared/Types/mrzFields';
 import { buildDocumentName } from '../../Shared/Libs/mrzTransliteration';
+import { recoverVizName, recognizeVizBlocks } from '../../Shared/Libs/vizName';
+import { debugLog } from '../../Shared/Libs/debug.utils';
 import { isCountryAllowed } from '../../Shared/Libs/country-allow';
 import { normalizeFromMRZFields } from '../../Shared/Libs/documentDataNormalizer';
 import { Alert, SafeAreaView, StyleSheet, View } from 'react-native';
@@ -134,13 +136,41 @@ const IdentityDocumentScanningScreen = () => {
         true
       );
 
-      {
+      void (async () => {
         const documentData = normalizeFromMRZFields(mrzFields);
         const faceImg = idFrontSideData?.faceImage || passportData?.faceImage;
+        // Recover the printed (VIZ) name with diacritics the MRZ cannot carry.
+        // The live camera OCRs only a cropped MRZ region, so the printed name was
+        // never recognised there — run a one-shot full-frame OCR pass on the
+        // captured data-page image to surface it. The MRZ sits at the bottom, so
+        // restrict the name search to blocks above it.
+        const docImage = (idFrontSideData?.image ||
+          passportData?.image) as string | undefined;
+        const vizBlocks = await recognizeVizBlocks(docImage);
+        const mrzTop = vizBlocks.length
+          ? Math.max(...vizBlocks.map((b) => b.top))
+          : undefined;
+        const viz = vizBlocks.length
+          ? recoverVizName(
+              vizBlocks,
+              documentData.firstName,
+              documentData.lastName,
+              mrzTop
+            )
+          : null;
+        debugLog('VIZName', 'ocr recovery', {
+          vizBlockCount: vizBlocks.length,
+          matchedFirst: !!viz?.vizFirst,
+          matchedLast: !!viz?.vizLast,
+          mismatch: viz?.mismatch ?? false,
+        });
         const builtName = buildDocumentName(
           documentData.firstName,
           documentData.lastName,
-          documentData.issuingCountry
+          documentData.issuingCountry,
+          undefined,
+          undefined,
+          viz
         );
         const documentReadResult = {
           document: {
@@ -153,7 +183,7 @@ const IdentityDocumentScanningScreen = () => {
         };
         appContext.setLastDocumentRead?.(documentReadResult);
         appContext.onDocumentRead?.(documentReadResult);
-      }
+      })();
 
       setTimeout(
         () => navigationManagerRef.current?.navigateToNextStep(),

package/src/Shared/Components/EIDScanner.tsx

@@ -13,12 +13,13 @@ import NFCManager from 'react-native-nfc-manager';
 import DeviceInfo from 'react-native-device-info';
 import PermissionManager from '../Libs/permissions.utils';
 import mrzUtils from '../Libs/mrz.utils';
-import { debugError } from '../Libs/debug.utils';
+import { debugError, debugLog } from '../Libs/debug.utils';
 import { MRZInfo } from '../EIDReader/lds/icao/mrzInfo';
 import { eidReader } from '../EIDReader/eidReader';
 import NativeProgressBar from './NativeProgressBar';
 import type { MRZFields } from '../Types/mrzFields';
 import { buildDocumentName } from '../Libs/mrzTransliteration';
+import { recoverVizName, recognizeVizBlocks } from '../Libs/vizName';
 import type { DocumentName } from '../Types/documentReadResult';
 import {
   normalizeFromMRZInfo,
@@ -57,6 +58,12 @@ interface eIDScannerProps {
    * because scannedDocument.mrzFields is only persisted after the chip read.
    */
   vizMrzFields?: MRZFields;
+  /**
+   * Full data-page image from the EID step's camera scan. A one-shot OCR pass
+   * recovers the diacritic printed name when the chip's DG11 is absent or
+   * one-sided — DG11 (the authenticated chip's own name) still takes precedence.
+   */
+  vizImage?: string;
   onScanSuccess?: (
     mrzInfo: MRZFields,
     faceImage: string,
@@ -71,6 +78,7 @@ const EIDScanner = ({
   dateOfExpiry,
   documentType,
   vizMrzFields,
+  vizImage,
   onScanSuccess,
   isNFCSupported,
 }: eIDScannerProps) => {
@@ -337,12 +345,40 @@ const EIDScanner = ({
           Vibration.vibrate(120);
           const scanDuration = Date.now() - startTime;
           const documentData = normalizeFromMRZInfo(passportData.mrz);
+          // DG11 (the authenticated chip's own printed name) is the preferred
+          // correction. When it is absent or one-sided, fall back to recovering
+          // the diacritic printed name from the EID step's VIZ camera blocks —
+          // this is what fixes e.g. Turkish passports whose DG11 has no usable
+          // name. buildDocumentName ranks viz_ocr above dg11, so only pass the
+          // VIZ candidate when DG11 did NOT provide a clean two-part name.
+          const dg11HasBothNames =
+            !!passportData.dg11FirstName && !!passportData.dg11LastName;
+          // Only OCR the VIZ when DG11 didn't already provide a clean name.
+          const vizBlocks = !dg11HasBothNames
+            ? await recognizeVizBlocks(vizImage)
+            : [];
+          const viz = vizBlocks.length
+            ? recoverVizName(
+                vizBlocks,
+                documentData.firstName,
+                documentData.lastName,
+                Math.max(...vizBlocks.map((b) => b.top))
+              )
+            : null;
+          debugLog('VIZName', 'eid recovery', {
+            dg11HasBothNames,
+            vizBlockCount: vizBlocks.length,
+            matchedFirst: !!viz?.vizFirst,
+            matchedLast: !!viz?.vizLast,
+            mismatch: viz?.mismatch ?? false,
+          });
           const builtName = buildDocumentName(
             documentData.firstName,
             documentData.lastName,
             documentData.issuingCountry,
             passportData.dg11FirstName,
-            passportData.dg11LastName
+            passportData.dg11LastName,
+            viz
           );
           // MASAK Tebliğ No. 32 Article 4/C(1)(b): the chip identity data must
           // match the data printed on the passport. The printed/VIZ MRZ is the

package/src/Shared/EIDReader/eidReader.ts

@@ -732,8 +732,16 @@ const eidReader = async (
       dg11FirstName = dg11File.getFirstName();
       dg11LastName = dg11File.getLastName();
       dg11Address = dg11File.getAddress();
-    } catch {
+      debugLog('EIDReader', 'DG11 read', {
+        firstName: dg11FirstName,
+        lastName: dg11LastName,
+        hasAddress: !!dg11Address,
+      });
+    } catch (e) {
       // DG11 is optional — not all chips have it, and access may be denied
+      debugLog('EIDReader', 'DG11 not available', {
+        error: e instanceof Error ? e.message : String(e),
+      });
     }
 
     // Read DG2 (Face Image)

package/src/Shared/Libs/mrzTransliteration.ts

@@ -1,4 +1,5 @@
 import type { DocumentName } from '../Types/documentReadResult';
+import type { VizNameCandidate } from './vizName';
 
 type DigraphMap = [string, string][];
 
@@ -47,17 +48,40 @@ const ICELANDIC: DigraphMap = [
   ['D', 'Ð'],
 ];
 
+// Finnish/Estonian share the Swedish-style AE→Ä, OE→Ö pair (no Å in names is
+// common, but AA→Å is safe to include for Finnish-Swedish surnames).
+const FINNISH: DigraphMap = [
+  ['AE', 'Ä'],
+  ['OE', 'Ö'],
+  ['AA', 'Å'],
+];
+
+const ESTONIAN: DigraphMap = [
+  ['AE', 'Ä'],
+  ['OE', 'Ö'],
+  ['UE', 'Ü'],
+];
+
 const COUNTRY_MAP: Record<string, DigraphMap> = {
   DEU: GERMAN,
   AUT: GERMAN,
   CHE: GERMAN,
+  LIE: GERMAN,
   SWE: SWEDISH,
   DNK: DANISH,
   NOR: NORWEGIAN,
   FRA: FRENCH,
   LUX: FRENCH,
+  BEL: FRENCH,
   ISL: ICELANDIC,
+  FIN: FINNISH,
+  EST: ESTONIAN,
 };
+// NOTE: Turkish (TUR), Hungarian, Polish, Czech, Slovak, etc. are intentionally
+// absent. Their diacritics (Ş Ğ İ Ç, ő ű, ł, ř ž, ą ę) collapse to bare ASCII in
+// the MRZ with NO digraph, so they cannot be reconstructed from the MRZ at all.
+// For those documents the only correct source is the printed VIZ (viz_ocr) or
+// the chip's DG11 — see buildDocumentName's priority order.
 
 function applyDigraphMap(token: string, map: DigraphMap): string {
   let result = '';
@@ -92,8 +116,32 @@ export function buildDocumentName(
   rawLast: string,
   issuingState: string | null | undefined,
   dg11First?: string | null,
-  dg11Last?: string | null
+  dg11Last?: string | null,
+  viz?: VizNameCandidate | null
 ): DocumentName {
+  // Highest priority: the printed VIZ name recovered via OCR. This is the only
+  // source that can restore diacritics the MRZ cannot represent (e.g. Turkish
+  // Ş Ğ İ Ç) when the chip's DG11 is absent. `recoverVizName` only returns a
+  // candidate that folds to the SAME ASCII as the MRZ name, so accepting it
+  // restores diacritics without changing the letters. A letter-level
+  // discrepancy comes back as `mismatch` (no candidate applied) and is surfaced
+  // via `nameMismatch` for operator review — the MRZ name stays authoritative.
+  if (viz && (viz.vizFirst || viz.vizLast)) {
+    return {
+      rawFirst,
+      rawLast,
+      displayFirst: viz.vizFirst ?? rawFirst,
+      displayLast: viz.vizLast ?? rawLast,
+      source: 'viz_ocr',
+      nameMismatch: viz.mismatch || undefined,
+    };
+  }
+
+  // A VIZ name was detected but disagreed with the MRZ at the letter level and
+  // could not be applied. The MRZ stays authoritative through the branches
+  // below, but we carry the review flag through so the discrepancy is recorded.
+  const nameMismatch = viz?.mismatch ? true : undefined;
+
   // Prefer DG11 (the chip's printed name in UTF-8) ONLY when it carries a proper
   // two-part split — both a surname AND a given name. That is the authoritative
   // correction for chips whose DG1 MRZ name lacks a `<<` separator (e.g. Turkish
@@ -114,6 +162,7 @@ export function buildDocumentName(
       displayFirst: dg11First as string,
       displayLast: dg11Last as string,
       source: 'dg11',
+      nameMismatch,
     };
   }
 
@@ -127,6 +176,7 @@ export function buildDocumentName(
       displayFirst: convertName(rawFirst, map),
       displayLast: convertName(rawLast, map),
       source: 'reverse_table',
+      nameMismatch,
     };
   }
 
@@ -140,5 +190,6 @@ export function buildDocumentName(
     displayFirst,
     displayLast,
     source: changed ? 'reverse_table' : 'raw',
+    nameMismatch,
   };
 }

package/src/Shared/Libs/vizName.ts

@@ -0,0 +1,192 @@
+/**
+ * Visual Inspection Zone (VIZ) printed-name recovery.
+ *
+ * The MRZ stores names in ASCII OCR-B with no diacritics, and for some scripts
+ * the diacritics are unrecoverable from the MRZ alone — Turkish in particular
+ * collapses Ş→S, Ğ→G, İ→I, Ç→C, Ö→O, Ü→U with no ICAO digraph, so "ŞİMŞEK"
+ * reads as "SIMSEK" and the true form is lost. The chip's DG11 carries the
+ * printed name in UTF-8, but it is optional and often absent.
+ *
+ * The printed name IS, however, on the document's data page in its native form.
+ * ML Kit already recognises every text block on the page (with bounding boxes)
+ * for MRZ parsing; this module reuses those blocks to recover the diacritic
+ * printed name and reconcile it against the MRZ.
+ *
+ * Conflict policy (per product decision): the MRZ name stays authoritative. We
+ * accept a VIZ candidate ONLY when it folds to the same ASCII as the MRZ name
+ * (i.e. it is the same name, just with diacritics restored). When the VIZ name
+ * differs at the letter level — a possible OCR misread or a genuine discrepancy
+ * — we keep the MRZ value and raise a `nameMismatch` flag for operator review
+ * rather than silently overwriting the machine-read name.
+ */
+
+import { NativeModules } from 'react-native';
+
+/** One recognised text block, in the shape ML Kit returns to JS. */
+export interface VizTextBlock {
+  /** Full recognised text of the block (may contain multiple lines). */
+  text: string;
+  /** Vertical position of the block's top edge, in image pixels. */
+  top: number;
+}
+
+interface NativeTextBlock {
+  text?: string;
+  boundingBox?: { left: number; top: number; right: number; bottom: number };
+}
+
+interface MLKitNativeModule {
+  recognizeText: (base64Image: string) => Promise<NativeTextBlock[]>;
+}
+
+/**
+ * Run a single full-frame OCR pass over the captured document image and return
+ * its text blocks.
+ *
+ * The live camera path OCRs only a cropped MRZ region (tuned for MRZ sharpness),
+ * so the printed name above it is never recognised there. This one-shot pass on
+ * the FULL captured image surfaces the printed VIZ name for {@link recoverVizName}.
+ * It is best-effort: returns [] when the native module is missing, the image is
+ * absent, or OCR throws — the caller then simply falls back to DG11/MRZ.
+ *
+ * @param base64Image Full document image (no data-URI prefix), or null/undefined.
+ */
+export async function recognizeVizBlocks(
+  base64Image: string | null | undefined
+): Promise<VizTextBlock[]> {
+  // Resolved per-call (not captured at import) so module-load ordering can't
+  // null it out, and so it is mockable in tests.
+  const mlkit = (NativeModules as { MLKitModule?: MLKitNativeModule })
+    .MLKitModule;
+  if (!base64Image || !mlkit?.recognizeText) return [];
+  try {
+    const blocks = await mlkit.recognizeText(base64Image);
+    return (blocks ?? [])
+      .filter((b): b is NativeTextBlock & { text: string } => !!b?.text)
+      .map((b) => ({ text: b.text, top: b.boundingBox?.top ?? 0 }));
+  } catch {
+    return [];
+  }
+}
+
+export interface VizNameCandidate {
+  /** Diacritic given name recovered from the VIZ, or null when none matched. */
+  vizFirst: string | null;
+  /** Diacritic surname recovered from the VIZ, or null when none matched. */
+  vizLast: string | null;
+  /**
+   * True when a printed name line was found but its folded ASCII does not match
+   * the MRZ name — the candidate is NOT applied; the caller should flag review.
+   */
+  mismatch: boolean;
+}
+
+/**
+ * Fold a string to bare ASCII upper-case letters for comparison: strip
+ * combining marks via NFD, map the handful of letters that have no combining
+ * decomposition (ı, ł, ø, đ, ð, ß, æ, œ, þ), drop everything that is not A–Z.
+ * This is the canonical form in which an MRZ name and its printed counterpart
+ * become directly comparable.
+ */
+export function foldAscii(value: string | null | undefined): string {
+  if (!value) return '';
+  return value
+    .normalize('NFD')
+    .replace(/[̀-ͯ]/g, '') // combining diacritical marks
+    .replace(/ı/g, 'i')
+    .replace(/İ/g, 'I')
+    .replace(/ø/gi, 'O')
+    .replace(/ł/gi, 'L')
+    .replace(/đ/gi, 'D')
+    .replace(/ð/gi, 'D')
+    .replace(/þ/gi, 'TH')
+    .replace(/ß/g, 'SS')
+    .replace(/æ/gi, 'AE')
+    .replace(/œ/gi, 'OE')
+    .toUpperCase()
+    .replace(/[^A-Z]/g, '');
+}
+
+/** Split a printed-name line into upper-case word tokens (letters + marks). */
+function tokenize(line: string): string[] {
+  return line
+    .split(/[\s,]+/)
+    .map((w) => w.trim())
+    .filter((w) => w.length > 0 && /\p{L}/u.test(w))
+    .map((w) => w.toUpperCase());
+}
+
+/**
+ * Find the printed token sequence whose folded ASCII equals the folded MRZ name.
+ * Returns the diacritic-preserving printed form when found, else null.
+ *
+ * The candidate lines are searched in document order; the matched window is the
+ * shortest run of consecutive tokens whose concatenated fold equals the target.
+ * Because the comparison is on the FOLDED form, only an exact same-name match
+ * succeeds — a different printed name will not fold-match and yields null.
+ */
+function recoverPrintedName(lines: string[], mrzName: string): string | null {
+  const target = foldAscii(mrzName);
+  if (!target) return null;
+
+  for (const line of lines) {
+    const tokens = tokenize(line);
+    // Slide a window over the tokens; the printed name may sit among other
+    // label text on the same block ("Surname / Nom  ÖZTÜRK").
+    for (let start = 0; start < tokens.length; start++) {
+      let acc = '';
+      const picked: string[] = [];
+      for (let end = start; end < tokens.length; end++) {
+        acc += foldAscii(tokens[end]);
+        picked.push(tokens[end]);
+        if (acc.length > target.length) break;
+        if (acc === target) {
+          return picked.join(' ');
+        }
+      }
+    }
+  }
+  return null;
+}
+
+/**
+ * Recover the diacritic printed name from VIZ text blocks and reconcile it with
+ * the MRZ-derived raw names.
+ *
+ * @param blocks   Recognised text blocks (text + vertical position).
+ * @param mrzFirst Raw MRZ given name (ASCII, may be empty).
+ * @param mrzLast  Raw MRZ surname (ASCII, may be empty).
+ * @param mrzTop   Vertical position of the MRZ block, when known. Name fields
+ *                 sit ABOVE the MRZ on the data page; passing this restricts the
+ *                 search to blocks above it, avoiding false matches in the MRZ
+ *                 itself. When undefined, all blocks are searched.
+ */
+export function recoverVizName(
+  blocks: VizTextBlock[],
+  mrzFirst: string,
+  mrzLast: string,
+  mrzTop?: number
+): VizNameCandidate {
+  const above =
+    typeof mrzTop === 'number'
+      ? blocks.filter((b) => b.top < mrzTop)
+      : blocks;
+  // Each block's text may hold several printed lines.
+  const lines = above.flatMap((b) => b.text.split(/\r?\n/));
+
+  const vizFirst = mrzFirst ? recoverPrintedName(lines, mrzFirst) : null;
+  const vizLast = mrzLast ? recoverPrintedName(lines, mrzLast) : null;
+
+  // Detect a letter-level discrepancy: a printed line clearly carries the name
+  // field but its fold does not equal the MRZ name. We approximate this by
+  // checking whether ANY line fold-matches; if the MRZ name is non-trivial and
+  // nothing matched, the printed name on the page disagrees with the MRZ.
+  const lastMissing = !!mrzLast && vizLast === null;
+  const firstMissing = !!mrzFirst && vizFirst === null;
+  // Only call it a mismatch when there is printed name-like text to compare
+  // against — otherwise the VIZ simply was not captured (not a conflict).
+  const hasPrintedNameText = lines.some((l) => tokenize(l).length > 0);
+  const mismatch = hasPrintedNameText && (lastMissing || firstMissing);
+
+  return { vizFirst, vizLast, mismatch };
+}

package/src/Shared/Types/documentReadResult.ts

@@ -4,11 +4,12 @@ import type { ChipVizMatchResult } from '../Libs/chipVizMatch';
 /**
  * How the display name was derived from the raw MRZ ASCII name.
  *
+ * - `viz_ocr`       — recovered from the printed VIZ via OCR (exact printed name with diacritics)
  * - `dg11`          — read from the chip's DG11 supplemental data file (exact printed name)
  * - `reverse_table` — reconstructed via country-aware ICAO 9303 reverse transliteration table
  * - `raw`           — no conversion applied; display equals the raw MRZ value
  */
-export type DocumentNameSource = 'dg11' | 'reverse_table' | 'raw';
+export type DocumentNameSource = 'viz_ocr' | 'dg11' | 'reverse_table' | 'raw';
 
 export interface DocumentName {
   /** First name exactly as stored in the MRZ (ASCII, OCR-B, e.g. "GOEKHAN"). */
@@ -21,6 +22,12 @@ export interface DocumentName {
   displayLast: string;
   /** How displayFirst / displayLast were derived. */
   source: DocumentNameSource;
+  /**
+   * True when a printed VIZ name was detected but disagreed with the MRZ name
+   * at the letter level (beyond diacritics). The MRZ value is kept as the
+   * display name; this flag signals the discrepancy for operator review.
+   */
+  nameMismatch?: boolean;
 }
 
 export interface DocumentFaceImage {

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