@trustchex/react-native-sdk 1.481.1 → 1.484.0

package/README.md

@@ -151,11 +151,19 @@ module.exports = {
 ### Basic
 
 ```tsx
-import Trustchex from '@trustchex/react-native-sdk';
+import Trustchex, { type DocumentReadResult } from '@trustchex/react-native-sdk';
 
 <Trustchex
   baseUrl="https://your-server.com"
   sessionId="session-id"
+  onDocumentRead={(result: DocumentReadResult) => {
+    const { document } = result;
+    console.log(document.documentType);   // "P" | "I"
+    console.log(document.lastName);       // "MÜLLER"
+    console.log(document.firstName);      // "JÜRGEN KARL"
+    console.log(document.dateOfBirth);    // "1985-03-10" (ISO 8601)
+    console.log(document.dateOfExpiry);   // "2030-11-05" (ISO 8601)
+  }}
   onCompleted={() => console.log('Completed')}
   onError={(error) => console.error(error)}
 />
@@ -210,14 +218,15 @@ const [baseUrl, sessionId] = handleDeepLink({
 ## API
 
 | Prop | Type | Description |
-|------|------|-------------|
+| ---- | ---- | ----------- |
 | `baseUrl` | `string?` | Server URL |
 | `sessionId` | `string?` | Verification session ID |
 | `branding` | `object?` | Theme colors and logo |
 | `locale` | `'en' \| 'tr'?` | UI language |
 | `enableAnalytics` | `boolean?` | Enable analytics (default: `true`) |
-| `onCompleted` | `function?` | Success callback |
-| `onError` | `function?` | Error callback |
+| `onDocumentRead` | `(result: DocumentReadResult) => void` | Called when document is read via NFC or OCR |
+| `onCompleted` | `() => void` | Success callback |
+| `onError` | `(error) => void` | Error callback |
 
 ## Analytics
 
@@ -229,7 +238,7 @@ The SDK includes **privacy-compliant analytics** that respects GDPR, KVKK, and P
 - ✅ **Data anonymization** - Device identifiers excluded
 - ✅ **Right to deletion** - Users can clear their data
 
-### Usage
+### Analytics Configuration
 
 Analytics is enabled by default. To customize:
 

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

@@ -70,9 +70,6 @@ const IdentityDocumentEIDScanningScreen = () => {
     setAllowedDocumentTypes(appContext.currentWorkflowStep?.data?.allowedDocumentTypes ?? null);
     setAllowedCountries(appContext.currentWorkflowStep?.data?.allowedCountries ?? null);
   }, [appContext.currentWorkflowStep]);
-  if (!appContext.currentWorkflowStep) {
-    return null;
-  }
   return /*#__PURE__*/_jsxs(SafeAreaView, {
     style: styles.safeAreaContainer,
     children: [documentNumber && dateOfBirth && dateOfExpiry ? /*#__PURE__*/_jsx(View, {

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

@@ -1,6 +1,8 @@
 "use strict";
 
 import React, { useContext, useEffect, useState } from 'react';
+import { buildDocumentName } from "../../Shared/Libs/mrzTransliteration.js";
+import { normalizeFromMRZFields } from "../../Shared/Libs/documentDataNormalizer.js";
 import { Alert, SafeAreaView, StyleSheet, View } from 'react-native';
 import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import IdentityDocumentCamera from "../../Shared/Components/IdentityDocumentCamera.js";
@@ -78,6 +80,25 @@ const IdentityDocumentScanningScreen = () => {
 
       // Track successful document scan completion as funnel step
       trackFunnelStep('Document Scan Completed', 2, 5, 'contract_acceptance', true);
+      {
+        const documentData = normalizeFromMRZFields(mrzFields);
+        const faceImg = idFrontSideData?.faceImage || passportData?.faceImage;
+        const builtName = buildDocumentName(documentData.firstName, documentData.lastName, documentData.issuingCountry);
+        const documentReadResult = {
+          document: {
+            ...documentData,
+            firstName: builtName.displayFirst,
+            lastName: builtName.displayLast
+          },
+          name: builtName,
+          face: faceImg ? {
+            data: faceImg,
+            mimeType: 'image/jpeg'
+          } : undefined
+        };
+        appContext.setLastDocumentRead?.(documentReadResult);
+        appContext.onDocumentRead?.(documentReadResult);
+      }
       setTimeout(() => navigationManagerRef.current?.navigateToNextStep(), 1000);
     }
   }, [idFrontSideData, idBackSideData, passportData, appContext.identificationInfo, allowedCountries, allowedDocumentTypes, t, appContext]);

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

@@ -126,7 +126,7 @@ const VideoCallScreen = ({
             try {
               const uploadService = new DataUploadService(baseUrl);
               dataUploadServiceRef.current = uploadService;
-              const uploaded = await uploadService.uploadCollectedData(identificationInfo);
+              const uploaded = await uploadService.uploadCollectedData(identificationInfo, undefined, appContext.lastDocumentRead?.name);
               if (!uploaded) {
                 console.warn('[VideoCallScreen] Upload service returned false');
                 if (mounted) {

package/lib/module/Screens/Static/ResultScreen.js

@@ -178,14 +178,15 @@ const ResultScreen = () => {
     if (!scannedDocument.mrzFields) {
       throw new Error('MRZ fields not found');
     }
-
-    // Backend payload must contain raw MRZ data only.
-    // Human-friendly formatting is strictly for UI rendering paths.
     const rawMrzFields = scannedDocument.mrzFields;
+    const docName = appContext.lastDocumentRead?.name;
     const identificationDocument = {
       type: rawMrzFields.documentCode,
       name: rawMrzFields.firstName,
       surname: rawMrzFields.lastName,
+      displayName: docName?.source === 'dg11' ? docName.displayFirst : undefined,
+      displaySurname: docName?.source === 'dg11' ? docName.displayLast : undefined,
+      nameSource: docName?.source === 'dg11' ? docName.source : undefined,
       gender: getGenderEnumType(rawMrzFields.sex),
       number: rawMrzFields.documentNumber,
       country: rawMrzFields.issuingState,
@@ -204,7 +205,7 @@ const ResultScreen = () => {
       encryptedData,
       nonce
     });
-  }, [apiUrl, getGenderEnumType]);
+  }, [apiUrl, appContext.lastDocumentRead, getGenderEnumType]);
   const uploadIdentificationMedia = useCallback(async (identificationId, scannedIdentityDocument, livenessDetection, skipIfAlreadyUploaded) => {
     // Skip media upload if already uploaded during video call
     if (skipIfAlreadyUploaded) {
@@ -533,18 +534,30 @@ const ResultScreen = () => {
                   children: [/*#__PURE__*/_jsxs(Text, {
                     style: styles.mrzInfoLabel,
                     children: [t('eidScannerScreen.name'), ":"]
-                  }), /*#__PURE__*/_jsx(Text, {
-                    style: styles.mrzInfoText,
-                    children: appContext.identificationInfo.scannedDocument.mrzFields?.firstName
+                  }), /*#__PURE__*/_jsxs(View, {
+                    style: styles.mrzInfoValueGroup,
+                    children: [/*#__PURE__*/_jsx(Text, {
+                      style: styles.mrzInfoText,
+                      children: appContext.lastDocumentRead?.name.source === 'dg11' ? appContext.lastDocumentRead.name.displayFirst : appContext.identificationInfo.scannedDocument.mrzFields?.firstName
+                    }), appContext.lastDocumentRead?.name.source === 'dg11' && /*#__PURE__*/_jsx(Text, {
+                      style: styles.mrzInfoSubText,
+                      children: appContext.identificationInfo.scannedDocument.mrzFields?.firstName
+                    })]
                   })]
                 }), /*#__PURE__*/_jsxs(View, {
                   style: styles.mrzInfoItem,
                   children: [/*#__PURE__*/_jsxs(Text, {
                     style: styles.mrzInfoLabel,
                     children: [t('eidScannerScreen.surname'), ":"]
-                  }), /*#__PURE__*/_jsx(Text, {
-                    style: styles.mrzInfoText,
-                    children: appContext.identificationInfo.scannedDocument.mrzFields?.lastName
+                  }), /*#__PURE__*/_jsxs(View, {
+                    style: styles.mrzInfoValueGroup,
+                    children: [/*#__PURE__*/_jsx(Text, {
+                      style: styles.mrzInfoText,
+                      children: appContext.lastDocumentRead?.name.source === 'dg11' ? appContext.lastDocumentRead.name.displayLast : appContext.identificationInfo.scannedDocument.mrzFields?.lastName
+                    }), appContext.lastDocumentRead?.name.source === 'dg11' && /*#__PURE__*/_jsx(Text, {
+                      style: styles.mrzInfoSubText,
+                      children: appContext.identificationInfo.scannedDocument.mrzFields?.lastName
+                    })]
                   })]
                 }), /*#__PURE__*/_jsxs(View, {
                   style: styles.mrzInfoItem,
@@ -882,6 +895,16 @@ const styles = StyleSheet.create({
     fontSize: 10,
     fontFamily: Platform.OS === 'ios' ? 'Courier' : 'monospace'
   },
+  mrzInfoValueGroup: {
+    flexDirection: 'column',
+    alignItems: 'flex-end'
+  },
+  mrzInfoSubText: {
+    color: '#aaa',
+    fontSize: 9,
+    fontFamily: Platform.OS === 'ios' ? 'Courier' : 'monospace',
+    marginTop: 1
+  },
   mrzTextContainer: {
     padding: 12,
     backgroundColor: '#F3F4F6',

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

@@ -9,6 +9,8 @@ import PermissionManager from "../Libs/permissions.utils.js";
 import { debugError } from "../Libs/debug.utils.js";
 import { eidReader } from "../EIDReader/eidReader.js";
 import NativeProgressBar from "./NativeProgressBar.js";
+import { buildDocumentName } from "../Libs/mrzTransliteration.js";
+import { normalizeFromMRZInfo } from "../Libs/documentDataNormalizer.js";
 import { useTranslation } from 'react-i18next';
 import AppContext from "../Contexts/AppContext.js";
 import StyledButton from "./StyledButton.js";
@@ -34,6 +36,7 @@ const EIDScanner = ({
   const [documentFaceImage, setDocumentFaceImage] = React.useState();
   const [documentMRZInfo, setDocumentMRZInfo] = React.useState();
   const [documentFaceImageMimeType, setDocumentFaceImageMimeType] = React.useState();
+  const [documentName, setDocumentName] = React.useState();
   const [progress, setProgress] = React.useState(0);
   const [progressStage, setProgressStage] = React.useState('');
 
@@ -99,6 +102,20 @@ const EIDScanner = ({
   }, [i18n.language]);
   const [voiceGuidanceMessage, setVoiceGuidanceMessage] = useState();
   const [attemptNumber, setAttemptNumber] = useState(0);
+  const getFieldsFromMRZ = useCallback(mrz => {
+    return {
+      documentCode: mrz.getDocumentCode(),
+      personalNumber: mrz.getPersonalNumber() || mrz.getOptionalData1(),
+      documentNumber: mrz.getDocumentNumber(),
+      firstName: mrz.getSecondaryIdentifier(),
+      lastName: mrz.getPrimaryIdentifier(),
+      birthDate: mrz.getDateOfBirth(),
+      expirationDate: mrz.getDateOfExpiry(),
+      issuingState: mrz.getIssuingState(),
+      sex: mrz.getGender().getStrCode(),
+      nationality: mrz.getNationality()
+    };
+  }, []);
   const readNFC = useCallback(async () => {
     const startTime = Date.now();
     const currentAttempt = attemptNumber + 1;
@@ -160,6 +177,25 @@ const EIDScanner = ({
           setDocumentMRZInfo(passportData.mrz);
           setDocumentFaceImageMimeType(passportData.mimeType);
           setIsScanned(true);
+          {
+            const documentData = normalizeFromMRZInfo(passportData.mrz);
+            const builtName = buildDocumentName(documentData.firstName, documentData.lastName, documentData.issuingCountry, passportData.dg11FirstName, passportData.dg11LastName);
+            setDocumentName(builtName);
+            const documentReadResult = {
+              document: {
+                ...documentData,
+                firstName: builtName.displayFirst,
+                lastName: builtName.displayLast
+              },
+              name: builtName,
+              face: {
+                data: passportData.faceImage,
+                mimeType: passportData.mimeType
+              }
+            };
+            appContext.setLastDocumentRead?.(documentReadResult);
+            appContext.onDocumentRead?.(documentReadResult);
+          }
           await trackEIDScanComplete(docType, scanDuration, currentAttempt).catch(() => {});
         }
       } else {
@@ -196,21 +232,7 @@ const EIDScanner = ({
       setProgressStage('');
       setHasGuideShown(false);
     }
-  }, [documentNumber, dateOfBirth, dateOfExpiry, documentType, hasNfc, isEnabled, attemptNumber, t]);
-  const getFieldsFromMRZ = useCallback(mrz => {
-    return {
-      documentCode: mrz.getDocumentCode(),
-      personalNumber: mrz.getPersonalNumber() || mrz.getOptionalData1(),
-      documentNumber: mrz.getDocumentNumber(),
-      firstName: mrz.getSecondaryIdentifier(),
-      lastName: mrz.getPrimaryIdentifier(),
-      birthDate: mrz.getDateOfBirth(),
-      expirationDate: mrz.getDateOfExpiry(),
-      issuingState: mrz.getIssuingState(),
-      sex: mrz.getGender().getStrCode(),
-      nationality: mrz.getNationality()
-    };
-  }, []);
+  }, [documentNumber, dateOfBirth, dateOfExpiry, documentType, hasNfc, isEnabled, attemptNumber, t, getFieldsFromMRZ, appContext]);
   useEffect(() => {
     const checkIsSupported = async () => {
       const deviceIsSupported = await NFCManager.isSupported();
@@ -367,10 +389,12 @@ const EIDScanner = ({
               style: styles.idCardFields,
               children: [/*#__PURE__*/_jsx(IDCardField, {
                 label: t('eidScannerScreen.surname'),
-                value: documentMRZInfo.getPrimaryIdentifier()
+                value: documentName?.displayLast ?? documentMRZInfo.getPrimaryIdentifier(),
+                subValue: documentName?.source === 'dg11' ? documentMRZInfo.getPrimaryIdentifier() : undefined
               }), /*#__PURE__*/_jsx(IDCardField, {
                 label: t('eidScannerScreen.name'),
-                value: documentMRZInfo.getSecondaryIdentifier()
+                value: documentName?.displayFirst ?? documentMRZInfo.getSecondaryIdentifier(),
+                subValue: documentName?.source === 'dg11' ? documentMRZInfo.getSecondaryIdentifier() : undefined
               }), /*#__PURE__*/_jsx(IDCardField, {
                 label: t('eidScannerScreen.documentNumber'),
                 value: documentMRZInfo.getDocumentNumber()
@@ -627,6 +651,11 @@ const styles = StyleSheet.create({
     flexShrink: 1,
     flexWrap: 'wrap'
   },
+  idCardFieldSubValue: {
+    fontSize: 9,
+    color: '#aaa',
+    marginTop: 1
+  },
   guide: {
     flex: 1,
     display: 'flex',
@@ -658,7 +687,8 @@ const styles = StyleSheet.create({
 });
 const IDCardField = ({
   label,
-  value
+  value,
+  subValue
 }) => /*#__PURE__*/_jsxs(View, {
   style: styles.idCardFieldItem,
   children: [/*#__PURE__*/_jsx(Text, {
@@ -668,6 +698,9 @@ const IDCardField = ({
   }), /*#__PURE__*/_jsx(Text, {
     style: styles.idCardFieldValue,
     children: value || '—'
-  })]
+  }), subValue ? /*#__PURE__*/_jsx(Text, {
+    style: styles.idCardFieldSubValue,
+    children: subValue
+  }) : null]
 });
 export default EIDScanner;

package/lib/module/Shared/Contexts/AppContext.js

@@ -24,8 +24,11 @@ export default /*#__PURE__*/createContext({
   currentWorkflowStep: undefined,
   isDebugNavigated: false,
   isTestVideoSession: false,
+  lastDocumentRead: undefined,
   onCompleted: undefined,
   onError: undefined,
+  onDocumentRead: undefined,
+  setLastDocumentRead: undefined,
   setSessionId: undefined,
   setBaseUrl: undefined
 });

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

@@ -6,6 +6,7 @@ import { NFCManagerCardService } from "./nfcManagerCardService.js";
 import { EIDService } from "./eidService.js";
 import { DG1File } from "./lds/icao/dg1File.js";
 import { DG2File } from "./lds/icao/dg2File.js";
+import { DG11File } from "./lds/icao/dg11File.js";
 import { Buffer } from 'buffer';
 import { InputStream } from "./java/inputStream.js";
 import { debugLog } from "../Libs/debug.utils.js";
@@ -495,6 +496,20 @@ const eidReader = async (documentNumber, dateOfBirth, dateOfExpiry, progressCall
       progressCallback(progress);
     }
 
+    // Read DG11 (Additional Personal Data — printed name in UTF-8, optional)
+    let dg11FirstName = null;
+    let dg11LastName = null;
+    try {
+      const dg11InputStream = passportService.getInputStream(EIDService.EF_DG11);
+      await dg11InputStream.init();
+      const dg11File = new DG11File(dg11InputStream);
+      await dg11File.read();
+      dg11FirstName = dg11File.getFirstName();
+      dg11LastName = dg11File.getLastName();
+    } catch {
+      // DG11 is optional — not all chips have it, and access may be denied
+    }
+
     // Read DG2 (Face Image)
     const dg2Done = stepTimer();
     const dg2InputStream = passportService.getInputStream(EIDService.EF_DG2);
@@ -539,7 +554,9 @@ const eidReader = async (documentNumber, dateOfBirth, dateOfExpiry, progressCall
     return {
       mrz: mrzInfo,
       faceImage: imageAsBase64,
-      mimeType: mimeType
+      mimeType: mimeType,
+      dg11FirstName,
+      dg11LastName
     };
   } catch (error) {
     const msg = error instanceof Error ? error.message : String(error);

package/lib/module/Shared/EIDReader/lds/icao/dg11File.js

@@ -0,0 +1,77 @@
+"use strict";
+
+import { Buffer } from 'buffer';
+import { TLVInputStream } from "../../tlv/tlvInputStream.js";
+import { DataGroup } from "../dataGroup.js";
+
+/**
+ * DG11 — Additional Personal Data (ICAO 9303-10 §4.6.6).
+ *
+ * We only extract tag 0x5F0E (Name of Holder), which contains the full name
+ * exactly as printed on the document, in UTF-8, using the same `<<` primary/
+ * secondary delimiter as the MRZ (but with native Unicode characters).
+ *
+ * Example: "ÖZTÜRK<<GÖKHAN MEHMET" → lastName="ÖZTÜRK", firstName="GÖKHAN MEHMET"
+ *
+ * The file is optional on the chip — if absent or unreadable we return null
+ * so the caller can fall back to reverse transliteration.
+ */
+export class DG11File extends DataGroup {
+  static DG11_TAG = 0x6b;
+  static TAG_LIST_TAG = 0x5c;
+  static NAME_OF_HOLDER_TAG = 0x5f0e;
+  firstName = null;
+  lastName = null;
+  constructor(is) {
+    super(DG11File.DG11_TAG, is);
+  }
+
+  /** Returns the first name from DG11, or null if not present. */
+  getFirstName() {
+    return this.firstName;
+  }
+
+  /** Returns the last name from DG11, or null if not present. */
+  getLastName() {
+    return this.lastName;
+  }
+  async read() {
+    await super.readObject();
+  }
+  async readContent(inputStream) {
+    const tlvIn = inputStream instanceof TLVInputStream ? inputStream : new TLVInputStream(inputStream);
+
+    // Skip the tag list (0x5C) — we only care about 0x5F0E
+    // The tag list tells us which optional tags are present; we probe directly.
+    try {
+      await tlvIn.skipToTag(DG11File.NAME_OF_HOLDER_TAG);
+    } catch {
+      // Tag not present in this chip's DG11
+      return;
+    }
+    const length = await tlvIn.readLength();
+    if (length <= 0) return;
+    const bytes = new Uint8Array(length);
+    await inputStream.readBytesWithOffset(bytes, 0, length);
+    const nameString = Buffer.from(bytes).toString('utf8').trim();
+    this.parseName(nameString);
+  }
+  writeContent() {
+    // Write not needed for reading
+  }
+
+  /**
+   * Split "PRIMARY<<SECONDARY" into last/first name components.
+   * Strips trailing filler `<` within each segment.
+   */
+  parseName(nameString) {
+    const delimIndex = nameString.indexOf('<<');
+    if (delimIndex < 0) {
+      this.lastName = nameString.replace(/<+$/, '').trim();
+      this.firstName = '';
+      return;
+    }
+    this.lastName = nameString.substring(0, delimIndex).replace(/<+$/, '').trim();
+    this.firstName = nameString.substring(delimIndex + 2).replace(/<$/, ' ').replace(/<+$/, '').trim();
+  }
+}

package/lib/module/Shared/EIDReader/lds/icao/mrzInfo.js

@@ -279,7 +279,7 @@ export class MRZInfo extends AbstractLDSInfo {
    * @deprecated Class will become immutable
    */
   setPrimaryIdentifier(primaryIdentifier) {
-    this.primaryIdentifier = MRZInfo.trimTrailingFillerChars(primaryIdentifier).replace('<', ' ');
+    this.primaryIdentifier = MRZInfo.trimTrailingFillerChars(primaryIdentifier).replace(/</g, ' ');
     this.checkDigit();
   }
 
@@ -772,11 +772,11 @@ export class MRZInfo extends AbstractLDSInfo {
     const delimIndex = mrzNameString.indexOf('<<');
     if (delimIndex < 0) {
       /* Only a primary identifier. */
-      this.primaryIdentifier = MRZInfo.trimTrailingFillerChars(mrzNameString).replace('<', ' ');
+      this.primaryIdentifier = MRZInfo.trimTrailingFillerChars(mrzNameString).replace(/</g, ' ');
       this.secondaryIdentifier = '';
       return;
     }
-    this.primaryIdentifier = MRZInfo.trimTrailingFillerChars(mrzNameString.substring(0, delimIndex)).replace('<', ' ');
+    this.primaryIdentifier = MRZInfo.trimTrailingFillerChars(mrzNameString.substring(0, delimIndex)).replace(/</g, ' ');
     const rest = mrzNameString.substring(delimIndex + 2);
     this.readSecondaryIdentifiers(rest);
   }
@@ -787,7 +787,7 @@ export class MRZInfo extends AbstractLDSInfo {
    * @param secondaryIdentifier the new secondary identifier
    */
   readSecondaryIdentifiers(secondaryIdentifier) {
-    this.secondaryIdentifier = MRZInfo.trimTrailingFillerChars(secondaryIdentifier).replace('<', ' ');
+    this.secondaryIdentifier = MRZInfo.trimTrailingFillerChars(secondaryIdentifier).replace(/</g, ' ');
   }
 
   /**

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

@@ -0,0 +1,104 @@
+"use strict";
+
+/**
+ * Expand a 2-digit MRZ year to a 4-digit calendar year.
+ * ICAO 9303: YY >= 30 → 19YY, YY < 30 → 20YY.
+ * (Threshold 30 keeps all current valid documents in range.)
+ */
+function expandYear(yy) {
+  const n = parseInt(yy, 10);
+  return n >= 30 ? `19${yy}` : `20${yy}`;
+}
+
+/**
+ * Convert a YYMMDD MRZ date string to ISO 8601 YYYY-MM-DD.
+ * Returns null for empty, null, or malformed input.
+ */
+function mrzDateToISO(raw) {
+  if (!raw || raw.length !== 6) return null;
+  const yy = raw.slice(0, 2);
+  const mm = raw.slice(2, 4);
+  const dd = raw.slice(4, 6);
+  if (!/^\d{6}$/.test(raw)) return null;
+  return `${expandYear(yy)}-${mm}-${dd}`;
+}
+
+/**
+ * Normalize the MRZ document-code field to a single-letter form.
+ * The `mrz` npm package returns "ID" for TD1, while the chip returns "I".
+ */
+function normalizeDocumentType(raw) {
+  if (!raw) return 'I';
+  const upper = raw.trim().toUpperCase();
+  if (upper === 'ID') return 'I';
+  // TD2 can be "IR", "AC", etc — take only the first character
+  return upper.charAt(0);
+}
+
+/**
+ * Normalize the sex field to a single uppercase letter.
+ * NFC chip: "M" | "F" | "U" | "X"
+ * mrz package: "male" | "female" | "" | null
+ */
+function normalizeSex(raw) {
+  if (!raw) return 'U';
+  switch (raw.trim().toLowerCase()) {
+    case 'm':
+    case 'male':
+      return 'M';
+    case 'f':
+    case 'female':
+      return 'F';
+    case 'x':
+    case 'unspecified':
+      return 'X';
+    default:
+      return 'U';
+  }
+}
+
+/**
+ * Trim a string and return null if empty or only filler chars.
+ */
+function clean(val) {
+  if (!val) return null;
+  const t = val.replace(/</g, '').trim();
+  return t.length > 0 ? t : null;
+}
+
+/**
+ * Build a DocumentData from a chip-read MRZInfo object (NFC path).
+ */
+export function normalizeFromMRZInfo(mrz) {
+  const rawPersonal = mrz.getPersonalNumber() ?? clean(mrz.getOptionalData1());
+  return {
+    documentType: normalizeDocumentType(mrz.getDocumentCode()),
+    issuingCountry: mrz.getIssuingState().replace(/<$/, '').trim(),
+    nationality: mrz.getNationality().replace(/<$/, '').trim(),
+    documentNumber: mrz.getDocumentNumber().trim(),
+    personalNumber: clean(rawPersonal),
+    lastName: mrz.getPrimaryIdentifier().trim(),
+    firstName: mrz.getSecondaryIdentifier().trim(),
+    sex: normalizeSex(mrz.getGender().getStrCode()),
+    dateOfBirth: mrzDateToISO(mrz.getDateOfBirth()),
+    dateOfExpiry: mrzDateToISO(mrz.getDateOfExpiry())
+  };
+}
+
+/**
+ * Build a DocumentData from an MRZFields object (camera OCR path).
+ */
+export function normalizeFromMRZFields(fields) {
+  return {
+    documentType: normalizeDocumentType(fields.documentCode),
+    issuingCountry: clean(fields.issuingState) ?? '',
+    nationality: clean(fields.nationality) ?? '',
+    documentNumber: clean(fields.documentNumber) ?? '',
+    personalNumber: clean(fields.personalNumber),
+    lastName: clean(fields.lastName) ?? '',
+    firstName: clean(fields.firstName) ?? '',
+    sex: normalizeSex(fields.sex),
+    dateOfBirth: mrzDateToISO(fields.birthDate),
+    dateOfExpiry: mrzDateToISO(fields.expirationDate)
+  };
+}

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

@@ -1134,18 +1134,13 @@ const validateMRZ = (mrzText, autocorrect = true) => {
       documentCode: result.fields.documentCode || null,
       issuingState: result.fields.issuingState || null,
       documentNumber: result.fields.documentNumber || null,
-      documentNumberCheckDigit: result.fields.documentNumberCheckDigit || null,
       nationality: result.fields.nationality || null,
       lastName: result.fields.lastName || null,
       firstName: result.fields.firstName || null,
       sex: result.fields.sex || null,
       birthDate: result.fields.birthDate || null,
-      birthDateCheckDigit: result.fields.birthDateCheckDigit || null,
       expirationDate: result.fields.expirationDate || null,
-      expirationDateCheckDigit: result.fields.expirationDateCheckDigit || null,
       personalNumber: result.fields.personalNumber || null,
-      personalNumberCheckDigit: result.fields.personalNumberCheckDigit || null,
-      compositeCheckDigit: result.fields.compositeCheckDigit || null,
       optional1: result.fields.optional1 || null,
       optional2: result.fields.optional2 || null
     };