@trustchex/react-native-sdk 1.409.0 → 1.472.0

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

@@ -56,7 +56,7 @@ export class SecureMessagingWrapper {
       const dataOutputStream = Array.from(this.getEncodedSendSequenceCounter());
       const paddedData = cryptoUtils.pad(Buffer.from(rapdu), 0, rapdu.length - 2 - 8 - 2, this.getPadLength());
       dataOutputStream.push(...paddedData);
-      let cc2 = Uint8Array.from(Buffer.from(cryptoUtils.computeMac(Buffer.from(dataOutputStream).toString('hex'), this.ksMac), 'hex'));
+      let cc2 = Uint8Array.from(Buffer.from(this.computeMAC(Buffer.from(dataOutputStream).toString('hex'), this.ksMac), 'hex'));
       if (cc2.length > 8 && cc.length === 8) {
         const newCC2 = new Uint8Array(8);
         for (let i = 0; i < 8; i++) {
@@ -70,6 +70,29 @@ export class SecureMessagingWrapper {
       return false;
     }
   }
+  /**
+   * Encrypt data using the session encryption key.
+   * Subclasses override for AES vs 3DES.
+   */
+  encrypt(dataHex, keyHex) {
+    return cryptoUtils.encryptWith3DES(dataHex, keyHex);
+  }
+
+  /**
+   * Decrypt data using the session encryption key.
+   * Subclasses override for AES vs 3DES.
+   */
+  decrypt(dataHex, keyHex) {
+    return cryptoUtils.decryptWith3DES(dataHex, keyHex);
+  }
+
+  /**
+   * Compute MAC over data using the session MAC key.
+   * Subclasses override for AES-CMAC vs 3DES MAC.
+   */
+  computeMAC(dataHex, keyHex) {
+    return cryptoUtils.computeMac(dataHex, keyHex);
+  }
   wrapCommandAPDU(commandAPDU) {
     const cla = commandAPDU.getCLA();
     const ins = commandAPDU.getINS();
@@ -88,7 +111,7 @@ export class SecureMessagingWrapper {
     }
     if (lc > 0) {
       const data = cryptoUtils.pad(Buffer.from(commandAPDU.getData()), 0, commandAPDU.getData().length, this.getPadLength());
-      const ciphertext = Buffer.from(cryptoUtils.encryptWith3DES(Buffer.from(data).toString('hex'), this.ksEnc), 'hex');
+      const ciphertext = Buffer.from(this.encrypt(Buffer.from(data).toString('hex'), this.ksEnc), 'hex');
       output.push(hasDO85 ? 0x85 : 0x87);
       output.push(...TLVUtil.getLengthAsBytes(ciphertext.length + (hasDO85 ? 0 : 1)));
       if (!hasDO85) {
@@ -99,7 +122,7 @@ export class SecureMessagingWrapper {
     }
     output = [...this.getEncodedSendSequenceCounter(), ...paddedMaskedHeader, ...do8587, ...do97];
     const n = cryptoUtils.pad(Buffer.from(output), 0, output.length, this.getPadLength());
-    const cc = Buffer.from(cryptoUtils.computeMac(Buffer.from(n).toString('hex'), this.ksMac), 'hex');
+    const cc = Buffer.from(this.computeMAC(Buffer.from(n).toString('hex'), this.ksMac), 'hex');
     let ccLength = cc.length;
     if (ccLength !== 8) {
       ccLength = 8;
@@ -194,7 +217,7 @@ export class SecureMessagingWrapper {
     }
     const ciphertext = Buffer.alloc(length);
     inputStream.readFully(ciphertext);
-    const paddedData = Array.from(Buffer.from(cryptoUtils.decryptWith3DES(Buffer.from(ciphertext).toString('hex'), this.ksEnc), 'hex'));
+    const paddedData = Array.from(Buffer.from(this.decrypt(Buffer.from(ciphertext).toString('hex'), this.ksEnc), 'hex'));
     return cryptoUtils.unpad(paddedData);
   }
   async readDO99(inputStream) {

package/lib/module/Shared/EIDReader/smartcards/commandAPDU.js

@@ -8,7 +8,8 @@ export class CommandAPDU {
   dataOffset = 0;
   constructor(cla, ins, p1, p2, data, dataOffset, dataLength, ne) {
     this.nc = dataLength || 0;
-    this.ne = ne || 0;
+    // Java JMRTD uses -1 to mean "no Le field" (ne=0). Guard against negatives.
+    this.ne = ne == null || ne < 0 ? 0 : ne;
     this.apdu = this.buildAPDU(cla, ins, p1, p2, data, dataOffset || 0, this.nc, this.ne);
   }
   buildAPDU(cla, ins, p1, p2, data, dataOffset = 0, dataLength = 0, ne = 0) {

package/lib/module/Shared/EIDReader/tlv/tlv.helpers.js

@@ -83,7 +83,7 @@ export class TLVHelpers extends ASN1Constants {
   static log(n, base) {
     let result = 0;
     while (n > 0) {
-      n = n / base;
+      n = Math.floor(n / base);
       result++;
     }
     return result;

package/lib/module/Shared/EIDReader/tlv/tlv.utils.js

@@ -39,7 +39,7 @@ class TLVUtil extends TLVHelpers {
     try {
       const actualTag = await tlvInputStream.readTag();
       if (actualTag !== expectedTag) {
-        throw new Error(`Expected tag ${expectedTag.toString(16)}, found tag ${actualTag.toString(16)}`);
+        throw new Error(`Expected TLV tag 0x${expectedTag.toString(16)}, found 0x${actualTag.toString(16)} in data: ${Buffer.from(wrappedData.slice(0, 16)).toString('hex')}`);
       }
       const length = await tlvInputStream.readLength();
       const value = await tlvInputStream.readValue();
@@ -49,8 +49,11 @@ class TLVUtil extends TLVHelpers {
       }
       return result;
     } catch (ioe) {
-      // Never happens.
-      throw new Error('Error reading from stream');
+      // Re-throw original error with context rather than masking it
+      if (ioe instanceof Error && ioe.message.includes('Expected TLV tag')) {
+        throw ioe;
+      }
+      throw new Error(`TLV unwrap error (expected tag 0x${expectedTag.toString(16)}): ${ioe instanceof Error ? ioe.message : String(ioe)}`);
     } finally {
       try {
         tlvInputStream.close();

package/lib/module/Shared/EIDReader/utils/aesCrypto.utils.js

@@ -0,0 +1,189 @@
+"use strict";
+
+import CryptoJS from 'crypto-js';
+import { Buffer } from 'buffer';
+import 'react-native-get-random-values';
+
+/**
+ * AES cryptographic utilities for PACE protocol.
+ */
+
+/**
+ * Encrypt data using AES in CBC mode with zero IV.
+ */
+export const aesEncryptCBC = (dataHex, keyHex, ivHex = '00000000000000000000000000000000') => {
+  const data = CryptoJS.enc.Hex.parse(dataHex);
+  const key = CryptoJS.enc.Hex.parse(keyHex);
+  const iv = CryptoJS.enc.Hex.parse(ivHex);
+  const encrypted = CryptoJS.AES.encrypt(data, key, {
+    mode: CryptoJS.mode.CBC,
+    padding: CryptoJS.pad.NoPadding,
+    iv
+  });
+  return encrypted.ciphertext.toString(CryptoJS.enc.Hex);
+};
+
+/**
+ * Decrypt data using AES in CBC mode with zero IV.
+ */
+export const aesDecryptCBC = (dataHex, keyHex, ivHex = '00000000000000000000000000000000') => {
+  const data = CryptoJS.enc.Hex.parse(dataHex);
+  const key = CryptoJS.enc.Hex.parse(keyHex);
+  const iv = CryptoJS.enc.Hex.parse(ivHex);
+  const cipherParams = CryptoJS.lib.CipherParams.create({
+    ciphertext: data
+  });
+  const decrypted = CryptoJS.AES.decrypt(cipherParams, key, {
+    mode: CryptoJS.mode.CBC,
+    padding: CryptoJS.pad.NoPadding,
+    iv
+  });
+  return decrypted.toString(CryptoJS.enc.Hex);
+};
+
+/**
+ * Encrypt a single block with AES in ECB mode (for SSC encryption).
+ */
+export const aesEncryptECB = (dataHex, keyHex) => {
+  const data = CryptoJS.enc.Hex.parse(dataHex);
+  const key = CryptoJS.enc.Hex.parse(keyHex);
+  const encrypted = CryptoJS.AES.encrypt(data, key, {
+    mode: CryptoJS.mode.ECB,
+    padding: CryptoJS.pad.NoPadding
+  });
+  return encrypted.ciphertext.toString(CryptoJS.enc.Hex);
+};
+
+/**
+ * Compute AES CMAC (OMAC1) as defined in RFC 4493.
+ */
+export const aesCMAC = (dataHex, keyHex) => {
+  const key = Buffer.from(keyHex, 'hex');
+  const data = Buffer.from(dataHex, 'hex');
+  const blockSize = 16;
+
+  // Step 1: Generate subkeys
+  const zeroBlock = '00000000000000000000000000000000';
+  const L = Buffer.from(aesEncryptECB(zeroBlock, keyHex), 'hex');
+  const K1 = generateSubkey(L);
+  const K2 = generateSubkey(K1);
+
+  // Step 2: Determine if we need to pad
+  const n = data.length === 0 ? 1 : Math.ceil(data.length / blockSize);
+  const lastBlockComplete = data.length > 0 && data.length % blockSize === 0;
+
+  // Step 3: Process last block
+  const lastBlock = Buffer.alloc(blockSize);
+  if (lastBlockComplete) {
+    const start = (n - 1) * blockSize;
+    for (let i = 0; i < blockSize; i++) {
+      lastBlock[i] = data[start + i] ^ K1[i];
+    }
+  } else {
+    // Pad with 10*
+    const start = (n - 1) * blockSize;
+    const remaining = data.length - start;
+    const padded = Buffer.alloc(blockSize);
+    for (let i = 0; i < remaining; i++) {
+      padded[i] = data[start + i];
+    }
+    padded[remaining] = 0x80;
+    for (let i = 0; i < blockSize; i++) {
+      lastBlock[i] = padded[i] ^ K2[i];
+    }
+  }
+
+  // Step 4: CBC-MAC
+  let X = Buffer.alloc(blockSize);
+  for (let i = 0; i < n - 1; i++) {
+    const block = data.subarray(i * blockSize, (i + 1) * blockSize);
+    const Y = Buffer.alloc(blockSize);
+    for (let j = 0; j < blockSize; j++) {
+      Y[j] = X[j] ^ block[j];
+    }
+    X = Buffer.from(aesEncryptECB(Y.toString('hex'), keyHex), 'hex');
+  }
+
+  // Process last block
+  const Y = Buffer.alloc(blockSize);
+  for (let j = 0; j < blockSize; j++) {
+    Y[j] = X[j] ^ lastBlock[j];
+  }
+  const T = aesEncryptECB(Y.toString('hex'), keyHex);
+  return T;
+};
+function generateSubkey(input) {
+  const blockSize = 16;
+  const Rb = Buffer.alloc(blockSize);
+  Rb[blockSize - 1] = 0x87;
+
+  // Left shift by 1
+  const output = Buffer.alloc(blockSize);
+  const msb = (input[0] & 0x80) !== 0;
+  for (let i = 0; i < blockSize - 1; i++) {
+    output[i] = (input[i] << 1 | input[i + 1] >> 7) & 0xff;
+  }
+  output[blockSize - 1] = input[blockSize - 1] << 1 & 0xff;
+  if (msb) {
+    for (let i = 0; i < blockSize; i++) {
+      output[i] ^= Rb[i];
+    }
+  }
+  return output;
+}
+
+/**
+ * Derive AES key from shared secret using KDF as per TR-SAC.
+ *
+ * @param sharedSecretHex the shared secret bytes as hex
+ * @param cipherAlg 'AES' or 'DESede'
+ * @param keyLength 128, 192, or 256
+ * @param mode 1 = ENC, 2 = MAC, 3 = PACE
+ */
+export const deriveKey = (sharedSecretHex, cipherAlg, keyLength, mode) => {
+  const input = sharedSecretHex + '000000' + mode.toString(16).padStart(2, '0');
+  let hash;
+  if (cipherAlg === 'AES' && keyLength > 128) {
+    // Use SHA-256 for AES-192 and AES-256
+    hash = CryptoJS.SHA256(CryptoJS.enc.Hex.parse(input)).toString(CryptoJS.enc.Hex);
+  } else {
+    // Use SHA-1 for DESede and AES-128
+    hash = CryptoJS.SHA1(CryptoJS.enc.Hex.parse(input)).toString(CryptoJS.enc.Hex);
+  }
+  if (cipherAlg === 'DESede') {
+    // 3DES: 24-byte key (K1 || K2 || K1)
+    const ka = hash.substring(0, 16);
+    const kb = hash.substring(16, 32);
+    return ka + kb + ka;
+  } else {
+    // AES: return first keyLength/8 bytes
+    const keyBytes = keyLength / 4; // hex chars = keyLength / 8 * 2
+    return hash.substring(0, keyBytes);
+  }
+};
+
+/**
+ * Pad data using ISO 9797-1 method 2 with given block size.
+ */
+export const padISO9797 = (data, blockSize = 16) => {
+  const n = data.length;
+  const padLength = blockSize - n % blockSize;
+  const out = Buffer.alloc(n + padLength);
+  data.copy(out);
+  out[n] = 0x80;
+  return out;
+};
+
+/**
+ * Unpad ISO 9797-1 method 2.
+ */
+export const unpadISO9797 = data => {
+  let i = data.length - 1;
+  while (i >= 0 && data[i] === 0x00) {
+    i--;
+  }
+  if (i >= 0 && data[i] === 0x80) {
+    return data.subarray(0, i);
+  }
+  return data;
+};

package/lib/module/Shared/Libs/PERMISSIONS_MANAGER.md

@@ -0,0 +1,268 @@
+# PermissionManager Documentation
+
+## Overview
+
+`PermissionManager` is a centralized utility for handling all platform-specific permission requests (camera, microphone, NFC, etc.) in the React Native SDK. It abstracts away platform differences (iOS vs Android) and provides a clean, consistent API.
+
+## Location
+
+- **File**: `src/Shared/Libs/permissions.utils.ts`
+- **Export**: Can be imported from `src/Shared/Libs/index.ts`
+
+## Supported Permissions
+
+```typescript
+type PermissionType = 'camera' | 'microphone' | 'nfc';
+```
+
+| Permission   | iOS | Android | Notes                                    |
+| ------------ | --- | ------- | ---------------------------------------- |
+| `camera`     | ✅  | ✅      | Camera access for video recording        |
+| `microphone` | ✅  | ✅      | Microphone access for audio recording    |
+| `nfc`        | ✅  | ✅      | NFC chip reading (document verification) |
+
+## API Reference
+
+### Request Methods
+
+#### `requestPermission(permission: PermissionType): Promise<boolean>`
+
+Request a single permission. Returns `true` if granted, `false` if denied.
+
+```typescript
+import PermissionManager from '../../Shared/Libs/permissions.utils';
+
+const hasCamera = await PermissionManager.requestPermission('camera');
+if (!hasCamera) {
+  console.log('Camera permission denied');
+}
+```
+
+#### `requestPermissions(permissions: PermissionType[]): Promise<Map<PermissionType, boolean>>`
+
+Request multiple permissions at once. Returns a Map with permission status for each.
+
+```typescript
+const results = await PermissionManager.requestPermissions([
+  'camera',
+  'microphone',
+]);
+const hasCamera = results.get('camera') ?? false;
+const hasMicrophone = results.get('microphone') ?? false;
+```
+
+#### `requestCameraAndMicrophone(): Promise<boolean>`
+
+**⭐ Convenience method** — Request camera and microphone together (common for video recording). Returns `true` only if BOTH are granted.
+
+```typescript
+const hasBothPermissions = await PermissionManager.requestCameraAndMicrophone();
+if (!hasBothPermissions) {
+  showError('Camera and microphone access required for video call');
+}
+```
+
+#### `requestCamera(): Promise<boolean>`
+
+Request camera permission only.
+
+```typescript
+const hasCamera = await PermissionManager.requestCamera();
+```
+
+#### `requestMicrophone(): Promise<boolean>`
+
+Request microphone permission only.
+
+```typescript
+const hasMicrophone = await PermissionManager.requestMicrophone();
+```
+
+#### `requestNFC(): Promise<boolean>`
+
+Request NFC permission for document verification.
+
+```typescript
+const hasNFC = await PermissionManager.requestNFC();
+```
+
+#### `requestWithFallback(permission: PermissionType, onDenied?: () => void): Promise<boolean>`
+
+Request permission with custom callback when denied.
+
+```typescript
+const granted = await PermissionManager.requestWithFallback('camera', () => {
+  showAlert('Camera access is required for verification');
+});
+```
+
+### Check Methods (Non-requesting)
+
+Check if a permission is already granted without requesting.
+
+#### `checkPermission(permission: PermissionType): Promise<boolean>`
+
+Check a single permission status.
+
+```typescript
+const hasCamera = await PermissionManager.checkPermission('camera');
+```
+
+#### `hasCameraAndMicrophone(): Promise<boolean>`
+
+Check if both camera and microphone are granted.
+
+```typescript
+const ready = await PermissionManager.hasCameraAndMicrophone();
+```
+
+#### `hasCamera(): Promise<boolean>`
+
+Check if camera is granted.
+
+```typescript
+const hasCamera = await PermissionManager.hasCamera();
+```
+
+#### `hasMicrophone(): Promise<boolean>`
+
+Check if microphone is granted.
+
+```typescript
+const hasMicrophone = await PermissionManager.hasMicrophone();
+```
+
+#### `hasNFC(): Promise<boolean>`
+
+Check if NFC is granted.
+
+```typescript
+const hasNFC = await PermissionManager.hasNFC();
+```
+
+## Common Patterns
+
+### Pattern 1: Video Call Setup (Camera + Microphone)
+
+```typescript
+import PermissionManager from '../../Shared/Libs/permissions.utils';
+
+async function initializeVideoCall() {
+  const hasBothPermissions =
+    await PermissionManager.requestCameraAndMicrophone();
+
+  if (!hasBothPermissions) {
+    setConnectionState('permissions_denied');
+    return;
+  }
+
+  // Proceed with video call initialization
+  const stream = await service.initialize();
+  setLocalStream(stream);
+}
+```
+
+### Pattern 2: Document Verification (NFC)
+
+```typescript
+const hasNFC = await PermissionManager.requestNFC();
+
+if (!hasNFC) {
+  showError('NFC access required to read document');
+  return;
+}
+
+const result = await readNFCChip();
+```
+
+### Pattern 3: Check Before Requesting
+
+```typescript
+// First check if permission is already granted
+const alreadyHasCamera = await PermissionManager.checkPermission('camera');
+
+if (alreadyHasCamera) {
+  // Skip request dialog
+  startCamera();
+} else {
+  // Request permission (shows OS dialog)
+  const granted = await PermissionManager.requestCamera();
+  if (granted) {
+    startCamera();
+  } else {
+    showErrorMessage('Camera access required');
+  }
+}
+```
+
+## Platform Implementation Details
+
+### iOS
+
+Uses the `react-native-permissions` library with `RNPermissions` module.
+
+**Permissions layout location**: `ios/App.xcodeproj/Info.plist`
+
+Required Info.plist keys:
+
+- `NSCameraUsageDescription` — Camera access explanation
+- `NSMicrophoneUsageDescription` — Microphone access explanation
+- `NFCReaderUsageDescription` — NFC access explanation
+
+### Android
+
+Uses built-in `PermissionsAndroid` from React Native core.
+
+**Permissions manifest location**: `android/app/src/main/AndroidManifest.xml`
+
+Required manifest permissions:
+
+- `android.permission.CAMERA` — Camera access
+- `android.permission.RECORD_AUDIO` — Microphone access
+- `android.permission.NFC` — NFC chip reading
+
+## Error Handling
+
+The PermissionManager handles errors internally and logs them using the debug utility. All methods return clear boolean or Map results so you can check status directly:
+
+```typescript
+const granted = await PermissionManager.requestCamera();
+
+// Simple check
+if (!granted) {
+  // Handle permission denied
+}
+```
+
+## Best Practices
+
+1. ✅ **Use convenience methods** — `requestCameraAndMicrophone()` instead of manually requesting both
+2. ✅ **Request at the right time** — Request permissions when the feature is about to be used
+3. ✅ **Check before requesting** — Use `checkPermission()` if you want to skip the OS dialog
+4. ✅ **Handle denial gracefully** — Always provide clear error messages when permissions are denied
+5. ✅ **Use the centralized manager** — Never import React Native permissions directly; always use PermissionManager
+
+## Troubleshooting
+
+### Permission request dialog not appearing
+
+- Check that you're using `request*` methods, not `check*` methods
+- Verify the permission is in the app's manifest (Android) or Info.plist (iOS)
+- Test on a device where the permission hasn't been granted yet
+
+### Camera/Microphone not working after permission granted
+
+- Check that you're handling successful permission grant and initializing the feature
+- Verify other features aren't holding exclusive access to the device
+
+### NFC not working on iOS
+
+- Ensure `NFCReaderUsageDescription` is set in Info.plist
+- The app must be signed with proper entitlements for NFC
+- NFC requires iPhone XS or later
+
+## Related Files
+
+- `src/Screens/Dynamic/VideoCallScreen.tsx` — Example usage with video calls
+- `src/Shared/Libs/index.ts` — Exported for easy importing
+- `src/Shared/Libs/debug.utils.ts` — Used internally for debug logging

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

@@ -189,6 +189,10 @@ const STEP_EVENT_MAP = {
     started: AnalyticsEventName.LIVENESS_CHECK_STARTED,
     completed: AnalyticsEventName.LIVENESS_CHECK_COMPLETED
   },
+  verbal_consent: {
+    started: AnalyticsEventName.VERBAL_CONSENT_VIDEO_STARTED,
+    completed: AnalyticsEventName.VERBAL_CONSENT_VIDEO_COMPLETED
+  },
   video_call: {
     started: AnalyticsEventName.VIDEO_CALL_STARTED,
     completed: AnalyticsEventName.VIDEO_CALL_COMPLETED

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

@@ -1,40 +1 @@
-"use strict";
-
-export function contains({
-  outside,
-  inside
-}) {
-  const outsideMaxX = outside.minX + outside.width;
-  const insideMaxX = inside.minX + inside.width;
-  const outsideMaxY = outside.minY + outside.height;
-  const insideMaxY = inside.minY + inside.height;
-  if (inside.minX < outside.minX) {
-    return false;
-  }
-  if (insideMaxX > outsideMaxX) {
-    return false;
-  }
-  if (inside.minY < outside.minY) {
-    return false;
-  }
-  if (insideMaxY > outsideMaxY) {
-    return false;
-  }
-  return true;
-}
-export function contains2({
-  outside,
-  inside
-}) {
-  const outsideMaxX = outside.minX + outside.width;
-  const insideMaxX = inside.minX + inside.width;
-  const outsideMaxY = outside.minY + outside.height;
-  const insideMaxY = inside.minY + inside.height;
-  const xIntersect = Math.max(0, Math.min(insideMaxX, outsideMaxX) - Math.max(inside.minX, outside.minX));
-  const yIntersect = Math.max(0, Math.min(insideMaxY, outsideMaxY) - Math.max(inside.minY, outside.minY));
-  const intersectArea = xIntersect * yIntersect;
-  const insideArea = inside.width * inside.height;
-  const outsideArea = outside.width * outside.height;
-  const unionArea = insideArea + outsideArea - intersectArea;
-  return unionArea === outsideArea;
-}
+"use strict";

package/lib/module/Shared/Libs/country-display.utils.js

@@ -0,0 +1,34 @@
+"use strict";
+
+import { ISOCountry } from "../EIDReader/data/isoCountry.js";
+import { UnicodeCountry } from "../EIDReader/data/unicodeCountry.js";
+const COUNTRY_NAME_OVERRIDES = {
+  TUR: 'Türkiye'
+};
+const findCountryByAlpha3 = alpha3Code => {
+  return [...UnicodeCountry.VALUES, ...ISOCountry.VALUES].find(country => country.toAlpha3Code() === alpha3Code);
+};
+export const getLocalizedCountryName = (alpha3Code, _language) => {
+  if (!alpha3Code) return '';
+  const normalizedCode = alpha3Code.trim().toUpperCase();
+  const overrideName = COUNTRY_NAME_OVERRIDES[normalizedCode];
+  if (overrideName) {
+    return overrideName;
+  }
+  const country = findCountryByAlpha3(normalizedCode);
+  if (!country) {
+    return normalizedCode;
+  }
+  if (typeof Intl !== 'undefined' && 'Locale' in Intl && typeof Intl.Locale === 'function' && 'DisplayNames' in Intl && typeof Intl.DisplayNames === 'function') {
+    const nativeLanguage = new Intl.Locale(`und-${country.toAlpha2Code()}`).maximize().language;
+    if (nativeLanguage) {
+      const nativeName = new Intl.DisplayNames([nativeLanguage], {
+        type: 'region'
+      }).of(country.toAlpha2Code());
+      if (nativeName) {
+        return nativeName;
+      }
+    }
+  }
+  return country.getName();
+};

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

@@ -28,6 +28,14 @@ const demoSession = {
         }
       }
     }
+  }, {
+    type: 'VERBAL_CONSENT',
+    required: false,
+    data: {
+      voiceGuidanceActive: true,
+      verbalConsentTitle: 'Verbal Consent',
+      verbalConsentText: 'I hereby provide my verbal consent for identity verification purposes. I confirm that all information provided is accurate and complete.'
+    }
   }, {
     type: 'IDENTITY_DOCUMENT_SCAN',
     required: false,

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

@@ -0,0 +1,20 @@
+"use strict";
+
+// Export utility modules with validated symbols only.
+export { default as PermissionManager } from "./permissions.utils.js";
+export { SignalingClient } from "./SignalingClient.js";
+export { setDebugMode, setLogLevel, isDebugEnabled, getLogLevel, traceLog, debugLog, infoLog, debugWarn, debugError, logError, logWarn } from "./debug.utils.js";
+export { default as HTTPClient, HttpClientError, UnauthorizedError, ForbiddenError, NotFoundError, BadRequestError, TooManyRequestsError, InternalServerError } from "./http-client.js";
+export * from "./analytics.utils.js";
+export { getLocalizedCountryName } from "./country-display.utils.js";
+export { getSessionKey, encryptWithAes, decryptWithAes } from "./crypto.utils.js";
+export { default as debounce } from "./debounce.utils.js";
+export { handleDeepLink } from "./deeplink.utils.js";
+export { getSimulatedDemoData, isDemoSession } from "./demo.utils.js";
+export { default as MRZUtils } from "./mrz.utils.js";
+export { NativeDeviceInfo } from "./native-device-info.utils.js";
+export { default as getDeviceInfo } from "./native-device-info.utils.js";
+export { useKeepAwake, enableKeepAwake, disableKeepAwake, isKeepAwakeCurrentlyActive, getKeepAwakeStats } from "./native-keep-awake.utils.js";
+export { runWithRetry } from "./promise.utils.js";
+export { configureStatusBarForWhiteBackground, useStatusBarWhiteBackground } from "./status-bar.utils.js";
+export { speak, speakWithDebounce, stopSpeaking, resetLastMessage, initializeTTS } from "./tts.utils.js";