@trustchex/react-native-sdk 1.495.12 → 1.497.0

package/android/src/main/java/com/trustchex/reactnativesdk/camera/TrustchexCameraView.kt

@@ -106,9 +106,12 @@ class TrustchexCameraView(context: ThemedReactContext) : FrameLayout(context) {
     private val barcodeScanner by lazy {
         BarcodeScanning.getClient(
             BarcodeScannerOptions.Builder()
+                // CODE_128 (Turkish e-ID), QR, and PDF417 (US/EU driver-licenses
+                // and many national IDs carry the back-side data as PDF417).
                 .setBarcodeFormats(
                     Barcode.FORMAT_CODE_128,
-                    Barcode.FORMAT_QR_CODE
+                    Barcode.FORMAT_QR_CODE,
+                    Barcode.FORMAT_PDF417
                 )
                 .build()
         )

package/android/src/main/java/com/trustchex/reactnativesdk/mlkit/MLKitModule.kt

@@ -30,7 +30,11 @@ class MLKitModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaM
     )
     private val barcodeScanner = BarcodeScanning.getClient(
         BarcodeScannerOptions.Builder()
-            .setBarcodeFormats(Barcode.FORMAT_CODE_128, Barcode.FORMAT_QR_CODE)
+            .setBarcodeFormats(
+                Barcode.FORMAT_CODE_128,
+                Barcode.FORMAT_QR_CODE,
+                Barcode.FORMAT_PDF417
+            )
             .build()
     )
 

package/ios/Camera/TrustchexCameraView.swift

@@ -220,6 +220,9 @@ class TrustchexCameraView: UIView {
 
             if supportedTypes.contains(.code128) { typesToEnable.append(.code128) }
             if supportedTypes.contains(.qr) { typesToEnable.append(.qr) }
+            // PDF417: US/EU driver-licenses and many national IDs carry the
+            // back-side data as PDF417 (already mapped to BarcodeFormat below).
+            if supportedTypes.contains(.pdf417) { typesToEnable.append(.pdf417) }
 
             metadataOutput.metadataObjectTypes = typesToEnable
         }

package/ios/MLKit/MLKitModule.swift

@@ -19,7 +19,7 @@ class MLKitModule: NSObject {
         return FaceDetector.faceDetector(options: options)
     }()
     private lazy var barcodeScanner: BarcodeScanner = {
-        let formats: BarcodeFormat = [.code128, .qrCode]
+        let formats: BarcodeFormat = [.code128, .qrCode, .PDF417]
         let options = BarcodeScannerOptions(formats: formats)
         return BarcodeScanner.barcodeScanner(options: options)
     }()

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

@@ -1,7 +1,7 @@
 "use strict";
 
 import React, { useState, useEffect, useCallback, useRef } from 'react';
-import { Alert, View, Text, Image, StyleSheet, Animated } from 'react-native';
+import { Alert, View, Text, Image, StyleSheet, Animated, Vibration } from 'react-native';
 import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import NFCManager from 'react-native-nfc-manager';
 import DeviceInfo from 'react-native-device-info';
@@ -186,15 +186,27 @@ const EIDScanner = ({
         // "reading document" spinner never clears and the user is stuck with no
         // error. Cap the whole read; on timeout we throw a categorized error so
         // the catch below surfaces a retry prompt and finally resets the UI.
+        // Fire a "chip detected" haptic exactly once, the moment progress first
+        // moves off 0 (the chip connected and the read began). Confirms contact
+        // to a user who can't see the screen while holding the phone to the doc.
+        let chipDetectedHapticFired = false;
         const readPromise = eidReader(documentNumber, dateOfBirth, dateOfExpiry, progressValue => {
+          if (progressValue > 0 && !chipDetectedHapticFired) {
+            chipDetectedHapticFired = true;
+            Vibration.vibrate(40);
+          }
           setProgress(progressValue);
           // Update stage message based on progress
           if (progressValue <= 20) {
             setProgressStage(t('eidScannerScreen.connecting'));
           } else if (progressValue <= 30) {
             setProgressStage(t('eidScannerScreen.readingMRZ'));
-          } else if (progressValue < 100) {
+          } else if (progressValue < 95) {
             setProgressStage(t('eidScannerScreen.readingFaceImage'));
+          } else if (progressValue < 100) {
+            // 95→100 is the (possibly slow) photo decode — give it its own
+            // stage so the bar doesn't look frozen at "Finalizing".
+            setProgressStage(t('eidScannerScreen.decodingFaceImage'));
           } else {
             setProgressStage(t('eidScannerScreen.completing'));
           }
@@ -217,6 +229,11 @@ const EIDScanner = ({
           }
         }
         if (passportData) {
+          // Success haptic: the phone is pressed against the document, so the
+          // user often can't see the screen — a buzz confirms the chip read
+          // finished. (The NFC step previously had no haptics at all, unlike the
+          // camera/liveness screens.)
+          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);
@@ -299,7 +316,11 @@ const EIDScanner = ({
         auth_failed: 'eidScannerScreen.nfcAuthFailed',
         tag_lost: 'eidScannerScreen.nfcTagLost',
         timeout: 'eidScannerScreen.nfcTimeout',
-        not_enabled: 'eidScannerScreen.nfcNotEnabled'
+        not_enabled: 'eidScannerScreen.nfcNotEnabled',
+        // The default/most-common "chip just wouldn't read" bucket. Show the
+        // actionable hold-flat-and-retry guidance rather than the generic
+        // "contact support" message — re-placing the phone usually fixes it.
+        reading_error: 'eidScannerScreen.nfcReadFailed'
       };
       if (category !== 'user_cancelled') {
         const actionableKey = ACTIONABLE[category];
@@ -569,7 +590,10 @@ const EIDScanner = ({
       }) || documentType === 'UNKNOWN' && /*#__PURE__*/_jsx(Text, {
         style: styles.mainText,
         children: t('eidScannerScreen.placeDocumentOnNFC')
-      })), hasNfc && isEnabled && !isScanning && !isScanned && /*#__PURE__*/_jsx(View, {
+      })), hasNfc && isEnabled && isScanning && progress === 0 && /*#__PURE__*/_jsx(Text, {
+        style: styles.keepStillHint,
+        children: t('eidScannerScreen.keepStill')
+      }), hasNfc && isEnabled && !isScanning && !isScanned && /*#__PURE__*/_jsx(View, {
         style: styles.buttonsContainer,
         children: /*#__PURE__*/_jsx(StyledButton, {
           mode: "contained",
@@ -661,6 +685,13 @@ const styles = StyleSheet.create({
     color: 'black',
     textAlign: 'center'
   },
+  keepStillHint: {
+    fontSize: 15,
+    color: '#666',
+    textAlign: 'center',
+    marginTop: 12,
+    paddingHorizontal: 24
+  },
   // ── ID Card result layout ──────────────────────────────────────────────
   idCardWrapper: {
     gap: 10

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

@@ -71,6 +71,11 @@ const IdentityDocumentCamera = ({
   const [currentSecondaryFaceImage, setCurrentSecondaryFaceImage] = useState(undefined);
   const [isBrightnessLow, setIsBrightnessLow] = useState(false);
   const [isFrameBlurry, setIsFrameBlurry] = useState(false);
+  // Glare was being silently rejected (frames dropped with no user feedback), so
+  // a user fighting reflections just saw the scan hang. Surface it so we can show
+  // an actionable "move away from glare" hint. Set at each glare rejection;
+  // cleared when a frame passes the brightness check (a fresh, glare-free frame).
+  const [isGlareDetected, setIsGlareDetected] = useState(false);
   const [hasGuideShown, setHasGuideShown] = useState(false);
   const [status, setStatus] = useState('SEARCHING');
   // True once the multi-frame voted MRZ consensus is STABLE + valid (the same
@@ -153,7 +158,8 @@ const IdentityDocumentCamera = ({
     frameW: 0,
     frameH: 0,
     hadLowBrightness: false,
-    hadBlurryFrames: false
+    hadBlurryFrames: false,
+    hadGlare: false
   });
   const [faceDetectionEnabled, setFaceDetectionEnabled] = useState(true);
   const faceImages = useRef([]);
@@ -219,7 +225,8 @@ const IdentityDocumentCamera = ({
         frameW: 0,
         frameH: 0,
         hadLowBrightness: false,
-        hadBlurryFrames: false
+        hadBlurryFrames: false,
+        hadGlare: false
       };
       cachedBarcode.current = null;
       isCompletionCallbackInvoked.current = false;
@@ -255,7 +262,7 @@ const IdentityDocumentCamera = ({
   }, [isFocused, hasPermission, hasGuideShown]);
   useEffect(() => {
     if (!hasGuideShown || !appContext.currentWorkflowStep?.data?.voiceGuidanceActive) return;
-    const message = getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, allElementsDetected, elementsOutsideScanArea, t);
+    const message = getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, isGlareDetected, allElementsDetected, elementsOutsideScanArea, t);
     if (message) {
       if (nextStep === 'COMPLETED') {
         if (isCompletionAnnouncementSpoken.current) {
@@ -268,7 +275,7 @@ const IdentityDocumentCamera = ({
       const shouldBypassInterval = nextStep !== 'COMPLETED';
       speak(message, shouldBypassInterval);
     }
-  }, [appContext.currentWorkflowStep?.data?.voiceGuidanceActive, hasGuideShown, isBrightnessLow, isFrameBlurry, nextStep, status, detectedDocumentType, allElementsDetected, elementsOutsideScanArea, t]);
+  }, [appContext.currentWorkflowStep?.data?.voiceGuidanceActive, hasGuideShown, isBrightnessLow, isFrameBlurry, isGlareDetected, nextStep, status, detectedDocumentType, allElementsDetected, elementsOutsideScanArea, t]);
   useEffect(() => {
     if (status === 'INCORRECT') {
       const timeout = setTimeout(() => {
@@ -377,7 +384,9 @@ const IdentityDocumentCamera = ({
     }
   };
 
-  // Check if face image has glare (brightness exceeds threshold)
+  // Check if face image has glare (brightness exceeds threshold). Also surfaces
+  // the result to `isGlareDetected` so the user gets an actionable hint instead
+  // of a silently-stalled scan.
   const checkFaceGlare = async faceImage => {
     try {
       // Check entire face region for glare
@@ -386,6 +395,8 @@ const IdentityDocumentCamera = ({
       100,
       // Full face height
       MAX_BRIGHTNESS_THRESHOLD);
+      setIsGlareDetected(hasGlare);
+      if (hasGlare) diagStats.current.hadGlare = true;
       return hasGlare;
     } catch (error) {
       return false; // Assume no glare on error
@@ -404,6 +415,8 @@ const IdentityDocumentCamera = ({
     try {
       // Check center 80% region for glare (document area)
       const hasGlare = await OpenCVModule.isRectangularRegionBright(image, Math.round(width * 0.1), Math.round(height * 0.1), Math.round(width * 0.8), Math.round(height * 0.8), MAX_BRIGHTNESS_THRESHOLD);
+      setIsGlareDetected(hasGlare);
+      if (hasGlare) diagStats.current.hadGlare = true;
       return hasGlare;
     } catch (error) {
       return false;
@@ -1370,6 +1383,15 @@ const IdentityDocumentCamera = ({
     setIsBrightnessLow(!isRegionBright);
     if (!isRegionBright) diagStats.current.hadLowBrightness = true;
 
+    // Reset glare to false at the start of every frame. The glare helpers
+    // (checkDocumentGlare/checkFaceGlare) only run at accept-time and set it
+    // true when they find glare; without this per-frame clear the flag would
+    // latch — a "Glare detected" warning would stick over a now-clean view
+    // (and, once a face is locked, the face-glare site never runs again so it
+    // could never clear at all). The accept-time checks run later in this same
+    // frame's handlers and re-assert true if glare is still present.
+    setIsGlareDetected(false);
+
     // Check blur only in center region (area of interest) to avoid false positives
     // from iOS depth-of-field background blur
     let isNotBlurry = true;
@@ -1854,12 +1876,12 @@ const IdentityDocumentCamera = ({
             opacity: errorFlashAnim
           },
           // 3. Warning (yellow) - quality issues
-          (isBrightnessLow || isFrameBlurry) && styles.topZoneTextWarning,
+          (isBrightnessLow || isFrameBlurry || isGlareDetected) && styles.topZoneTextWarning,
           // 4. Scanning (green) - all elements detected AND inside scan area
-          status === 'SCANNING' && allElementsDetected && elementsOutsideScanArea.length === 0 && !isBrightnessLow && !isFrameBlurry && styles.topZoneTextScanning
+          status === 'SCANNING' && allElementsDetected && elementsOutsideScanArea.length === 0 && !isBrightnessLow && !isFrameBlurry && !isGlareDetected && styles.topZoneTextScanning
           // 5. Default (white) - aligning (not all detected OR elements outside scan area)
           ],
-          children: getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, allElementsDetected, elementsOutsideScanArea, t)
+          children: getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, isGlareDetected, allElementsDetected, elementsOutsideScanArea, t)
         })]
       }), /*#__PURE__*/_jsx(View, {
         style: styles.leftZone

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

@@ -100,7 +100,7 @@ export function transformBoundsToScreen(bounds, scale, offsetX, offsetY) {
  * Unified status message logic used by both voice guidance and render text.
  * Returns the appropriate i18n key arguments for the current scan state.
  */
-export function getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, allElementsDetected, elementsOutsideScanArea, t) {
+export function getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, isGlareDetected, allElementsDetected, elementsOutsideScanArea, t) {
   if (nextStep === 'COMPLETED') {
     return t('identityDocumentCamera.scanCompleted');
   }
@@ -126,6 +126,14 @@ export function getStatusMessage(nextStep, status, detectedDocumentType, isBrigh
   if (isBrightnessLow) {
     return t('identityDocumentCamera.lowBrightness');
   }
+
+  // Glare is a primary failure mode (reflections off the laminate/photo). It was
+  // previously detected but never communicated, so the scan just appeared to
+  // hang. Tell the user how to fix it. Ranked above blur because a glare hotspot
+  // both blocks acceptance and often reads as a "sharp" (non-blurry) frame.
+  if (isGlareDetected) {
+    return t('identityDocumentCamera.reduceGlare');
+  }
   if (isFrameBlurry) {
     return t('identityDocumentCamera.avoidBlur');
   }

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

@@ -633,8 +633,12 @@ const eidReader = async (documentNumber, dateOfBirth, dateOfExpiry, progressCall
       // step (it was previously outside, so an early DG2 failure went unlabelled).
       const dg2InputStream = passportService.getInputStream(EIDService.EF_DG2);
       await dg2InputStream.init();
+      // Map the DG2 byte stream to 30→95 (not →100): the JPEG2000 decode that
+      // follows can take a noticeable beat (esp. large passport portraits), and
+      // jumping to 100 before it made the UI sit at "100% Finalizing" looking
+      // frozen during the decode. We reserve 95→100 for the decode step below.
       InputStream.onRead((totalBytesRead, fileLength) => {
-        progress = 30 + totalBytesRead / fileLength * 70;
+        progress = 30 + totalBytesRead / fileLength * 65;
         if (progressCallback) {
           progressCallback(progress);
         }
@@ -656,6 +660,12 @@ const eidReader = async (documentNumber, dateOfBirth, dateOfExpiry, progressCall
       const buffer = Buffer.alloc(imageLength);
       await imageInputStream.readBytesWithOffset(buffer, 0, imageLength);
       const rawMimeType = faceImageInfo.getMimeType();
+      // Signal the (potentially slow) photo decode so the UI shows a distinct
+      // "decoding photo" stage at 95% rather than appearing frozen at 100%.
+      progress = 95;
+      if (progressCallback) {
+        progressCallback(progress);
+      }
       const converted = await convertJP2IfNeeded(buffer, rawMimeType);
       imageAsBase64 = converted.base64;
       mimeType = converted.mimeType;

package/lib/module/Translation/Resources/en.js

@@ -113,11 +113,13 @@ export default {
   'eidScannerScreen.placePassportOnNFC': 'Place your passport near the NFC reader',
   'eidScannerScreen.placeDocumentOnNFC': 'Place your document near the NFC reader',
   'eidScannerScreen.readingDocument': 'Hold steady - Reading document',
+  'eidScannerScreen.keepStill': 'Keep the document and phone still until the read completes.',
   'eidScannerScreen.checkYourInformation': 'Review your information carefully',
   'eidScannerScreen.approveAndContinue': 'Approve and Continue',
   'eidScannerScreen.connecting': 'Establishing secure connection...',
   'eidScannerScreen.readingMRZ': 'Reading document information...',
   'eidScannerScreen.readingFaceImage': 'Reading photo data...',
+  'eidScannerScreen.decodingFaceImage': 'Decoding photo...',
   'eidScannerScreen.completing': 'Finalizing verification...',
   'eidScannerScreen.progress': 'Progress',
   'identityDocumentCamera.guideHeader': 'Document Scan',
@@ -142,6 +144,7 @@ export default {
   'identityDocumentCamera.hologramCheck': 'Hologram',
   'identityDocumentCamera.keepSteady': 'Keep device steady',
   'identityDocumentCamera.avoidBlur': 'Keep device steady',
+  'identityDocumentCamera.reduceGlare': 'Glare detected. Tilt the document or move away from direct light.',
   'identityDocumentCamera.wrongSideFront': 'Show the front side of your document',
   'identityDocumentCamera.wrongSideBack': 'Show the back side of your document',
   'identityDocumentCamera.idCardDetected': 'ID detected',

package/lib/module/Translation/Resources/tr.js

@@ -113,11 +113,13 @@ export default {
   'eidScannerScreen.placePassportOnNFC': 'Pasaportunuzu NFC okuyucuya yaklaştırın',
   'eidScannerScreen.placeDocumentOnNFC': 'Belgenizi NFC okuyucuya yaklaştırın',
   'eidScannerScreen.readingDocument': 'Sabit tutun - Belge okunuyor',
+  'eidScannerScreen.keepStill': 'Okuma tamamlanana kadar belgeyi ve telefonu sabit tutun.',
   'eidScannerScreen.checkYourInformation': 'Bilgilerinizi dikkatle kontrol edin',
   'eidScannerScreen.approveAndContinue': 'Onayla ve Devam Et',
   'eidScannerScreen.connecting': 'Güvenli bağlantı kuruluyor...',
   'eidScannerScreen.readingMRZ': 'Belge bilgileri okunuyor...',
   'eidScannerScreen.readingFaceImage': 'Fotoğraf verisi okunuyor...',
+  'eidScannerScreen.decodingFaceImage': 'Fotoğraf çözümleniyor...',
   'eidScannerScreen.completing': 'Doğrulama tamamlanıyor...',
   'eidScannerScreen.progress': 'İlerleme',
   'identityDocumentCamera.guideHeader': 'Belge Taraması',
@@ -142,6 +144,7 @@ export default {
   'identityDocumentCamera.hologramCheck': 'Hologram',
   'identityDocumentCamera.keepSteady': 'Cihazı sabit tutun',
   'identityDocumentCamera.avoidBlur': 'Cihazı sabit tutun',
+  'identityDocumentCamera.reduceGlare': 'Parlama algılandı. Belgeyi hafifçe eğin veya doğrudan ışıktan uzaklaşın.',
   'identityDocumentCamera.wrongSideFront': 'Belgenizin ön yüzünü gösterin',
   'identityDocumentCamera.wrongSideBack': 'Belgenizin arka yüzünü gösterin',
   'identityDocumentCamera.idCardDetected': 'Kimlik kartı algılandı',

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

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":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAwBpD,UAAU,eAAe;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,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,6FAOjB,eAAe,4CA8yBjB,CAAC;AA4NF,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;AAwBpD,UAAU,eAAe;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,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,6FAOjB,eAAe,4CA80BjB,CAAC;AAmOF,eAAe,UAAU,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentCamera.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.tsx"],"names":[],"mappings":"AAyEA,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,2BAA2B,EAK5B,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAMnE,QAAA,MAAM,sBAAsB,GAAI,uDAI7B,2BAA2B,4CA+mF7B,CAAC;AAiIF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"IdentityDocumentCamera.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.tsx"],"names":[],"mappings":"AAyEA,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,2BAA2B,EAK5B,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAMnE,QAAA,MAAM,sBAAsB,GAAI,uDAI7B,2BAA2B,4CA0oF7B,CAAC;AAiIF,eAAe,sBAAsB,CAAC"}

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

@@ -57,7 +57,7 @@ export declare function transformBoundsToScreen(bounds: {
  * Unified status message logic used by both voice guidance and render text.
  * Returns the appropriate i18n key arguments for the current scan state.
  */
-export declare function getStatusMessage(nextStep: ScanStep, status: ScanStatus, detectedDocumentType: DocumentType, isBrightnessLow: boolean, isFrameBlurry: boolean, allElementsDetected: boolean, elementsOutsideScanArea: string[], t: (key: string, params?: Record<string, unknown>) => string): string;
+export declare function getStatusMessage(nextStep: ScanStep, status: ScanStatus, detectedDocumentType: DocumentType, isBrightnessLow: boolean, isFrameBlurry: boolean, isGlareDetected: boolean, allElementsDetected: boolean, elementsOutsideScanArea: string[], t: (key: string, params?: Record<string, unknown>) => string): string;
 /**
  * Calculate angle from two points in degrees
  */

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentCamera.utils.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"IdentityDocumentCamera.utils.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,IAAI,EACL,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQpD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAG7E;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,OAAO,CAGT;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM;;;;;EAmBpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;;;;;sBAW9C,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM;EAIjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC/D,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM;;;;;EAQhB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,UAAU,EAClB,oBAAoB,EAAE,YAAY,EAClC,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,OAAO,EACtB,eAAe,EAAE,OAAO,EACxB,mBAAmB,EAAE,OAAO,EAC5B,uBAAuB,EAAE,MAAM,EAAE,EACjC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAC3D,MAAM,CAsGR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5B,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5B,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,SAAS,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,YAAY,CA6Ed;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,IAAI,EAAE,EACtB,eAAe,CAAC,EAAE,SAAS,EAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,YAAY,CAcd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAWrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAOzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACtE,eAAe,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACxE,cAAc,EAAE,OAAO,GACtB,OAAO,CAkBT"}

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":"AAUA,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,KAC5C,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;CAC7B,GACD,SAAS,CA+XZ,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"eidReader.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/EIDReader/eidReader.ts"],"names":[],"mappings":"AAUA,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,KAC5C,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;CAC7B,GACD,SAAS,CAyYZ,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/lib/typescript/src/Translation/Resources/en.d.ts

@@ -111,11 +111,13 @@ declare const _default: {
     'eidScannerScreen.placePassportOnNFC': string;
     'eidScannerScreen.placeDocumentOnNFC': string;
     'eidScannerScreen.readingDocument': string;
+    'eidScannerScreen.keepStill': string;
     'eidScannerScreen.checkYourInformation': string;
     'eidScannerScreen.approveAndContinue': string;
     'eidScannerScreen.connecting': string;
     'eidScannerScreen.readingMRZ': string;
     'eidScannerScreen.readingFaceImage': string;
+    'eidScannerScreen.decodingFaceImage': string;
     'eidScannerScreen.completing': string;
     'eidScannerScreen.progress': string;
     'identityDocumentCamera.guideHeader': string;
@@ -140,6 +142,7 @@ declare const _default: {
     'identityDocumentCamera.hologramCheck': string;
     'identityDocumentCamera.keepSteady': string;
     'identityDocumentCamera.avoidBlur': string;
+    'identityDocumentCamera.reduceGlare': string;
     'identityDocumentCamera.wrongSideFront': string;
     'identityDocumentCamera.wrongSideBack': string;
     'identityDocumentCamera.idCardDetected': string;

package/lib/typescript/src/Translation/Resources/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../../../src/Translation/Resources/en.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAoRE"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../../../src/Translation/Resources/en.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAyRE"}

package/lib/typescript/src/Translation/Resources/tr.d.ts

@@ -111,11 +111,13 @@ declare const _default: {
     'eidScannerScreen.placePassportOnNFC': string;
     'eidScannerScreen.placeDocumentOnNFC': string;
     'eidScannerScreen.readingDocument': string;
+    'eidScannerScreen.keepStill': string;
     'eidScannerScreen.checkYourInformation': string;
     'eidScannerScreen.approveAndContinue': string;
     'eidScannerScreen.connecting': string;
     'eidScannerScreen.readingMRZ': string;
     'eidScannerScreen.readingFaceImage': string;
+    'eidScannerScreen.decodingFaceImage': string;
     'eidScannerScreen.completing': string;
     'eidScannerScreen.progress': string;
     'identityDocumentCamera.guideHeader': string;
@@ -140,6 +142,7 @@ declare const _default: {
     'identityDocumentCamera.hologramCheck': string;
     'identityDocumentCamera.keepSteady': string;
     'identityDocumentCamera.avoidBlur': string;
+    'identityDocumentCamera.reduceGlare': string;
     'identityDocumentCamera.wrongSideFront': string;
     'identityDocumentCamera.wrongSideBack': string;
     'identityDocumentCamera.idCardDetected': string;

package/lib/typescript/src/Translation/Resources/tr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["../../../../../src/Translation/Resources/tr.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAuRE"}
+{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["../../../../../src/Translation/Resources/tr.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBA4RE"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,aAAa,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustchex/react-native-sdk",
-  "version": "1.495.12",
+  "version": "1.497.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/Shared/Components/EIDScanner.tsx

@@ -1,5 +1,13 @@
 import React, { useState, useEffect, useCallback, useRef } from 'react';
-import { Alert, View, Text, Image, StyleSheet, Animated } from 'react-native';
+import {
+  Alert,
+  View,
+  Text,
+  Image,
+  StyleSheet,
+  Animated,
+  Vibration,
+} from 'react-native';
 import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import NFCManager from 'react-native-nfc-manager';
 import DeviceInfo from 'react-native-device-info';
@@ -254,19 +262,31 @@ const EIDScanner = ({
         // "reading document" spinner never clears and the user is stuck with no
         // error. Cap the whole read; on timeout we throw a categorized error so
         // the catch below surfaces a retry prompt and finally resets the UI.
+        // Fire a "chip detected" haptic exactly once, the moment progress first
+        // moves off 0 (the chip connected and the read began). Confirms contact
+        // to a user who can't see the screen while holding the phone to the doc.
+        let chipDetectedHapticFired = false;
         const readPromise = eidReader(
           documentNumber,
           dateOfBirth,
           dateOfExpiry,
           (progressValue) => {
+            if (progressValue > 0 && !chipDetectedHapticFired) {
+              chipDetectedHapticFired = true;
+              Vibration.vibrate(40);
+            }
             setProgress(progressValue);
             // Update stage message based on progress
             if (progressValue <= 20) {
               setProgressStage(t('eidScannerScreen.connecting'));
             } else if (progressValue <= 30) {
               setProgressStage(t('eidScannerScreen.readingMRZ'));
-            } else if (progressValue < 100) {
+            } else if (progressValue < 95) {
               setProgressStage(t('eidScannerScreen.readingFaceImage'));
+            } else if (progressValue < 100) {
+              // 95→100 is the (possibly slow) photo decode — give it its own
+              // stage so the bar doesn't look frozen at "Finalizing".
+              setProgressStage(t('eidScannerScreen.decodingFaceImage'));
             } else {
               setProgressStage(t('eidScannerScreen.completing'));
             }
@@ -292,6 +312,11 @@ const EIDScanner = ({
           }
         }
         if (passportData) {
+          // Success haptic: the phone is pressed against the document, so the
+          // user often can't see the screen — a buzz confirms the chip read
+          // finished. (The NFC step previously had no haptics at all, unlike the
+          // camera/liveness screens.)
+          Vibration.vibrate(120);
           const scanDuration = Date.now() - startTime;
           const documentData = normalizeFromMRZInfo(passportData.mrz);
           const builtName = buildDocumentName(
@@ -429,6 +454,10 @@ const EIDScanner = ({
         tag_lost: 'eidScannerScreen.nfcTagLost',
         timeout: 'eidScannerScreen.nfcTimeout',
         not_enabled: 'eidScannerScreen.nfcNotEnabled',
+        // The default/most-common "chip just wouldn't read" bucket. Show the
+        // actionable hold-flat-and-retry guidance rather than the generic
+        // "contact support" message — re-placing the phone usually fixes it.
+        reading_error: 'eidScannerScreen.nfcReadFailed',
       };
 
       if (category !== 'user_cancelled') {
@@ -831,6 +860,17 @@ const EIDScanner = ({
                 </Text>
               )))}
 
+          {/* The connect/auth phase (progress still 0) is the most fragile part
+              of the read — the many PACE/BAC round-trips drop if the phone
+              moves. Tell the user to hold still here, not only once the bar
+              starts moving (the progress UI's "Hold steady" is gated on
+              progress > 0). */}
+          {hasNfc && isEnabled && isScanning && progress === 0 && (
+            <Text style={styles.keepStillHint}>
+              {t('eidScannerScreen.keepStill')}
+            </Text>
+          )}
+
           {hasNfc && isEnabled && !isScanning && !isScanned && (
             <View style={styles.buttonsContainer}>
               <StyledButton mode="contained" onPress={readNFC}>
@@ -938,6 +978,13 @@ const styles = StyleSheet.create({
     color: 'black',
     textAlign: 'center',
   },
+  keepStillHint: {
+    fontSize: 15,
+    color: '#666',
+    textAlign: 'center',
+    marginTop: 12,
+    paddingHorizontal: 24,
+  },
   // ── ID Card result layout ──────────────────────────────────────────────
   idCardWrapper: {
     gap: 10,

package/src/Shared/Components/IdentityDocumentCamera.tsx

@@ -137,6 +137,11 @@ const IdentityDocumentCamera = ({
   >(undefined);
   const [isBrightnessLow, setIsBrightnessLow] = useState(false);
   const [isFrameBlurry, setIsFrameBlurry] = useState(false);
+  // Glare was being silently rejected (frames dropped with no user feedback), so
+  // a user fighting reflections just saw the scan hang. Surface it so we can show
+  // an actionable "move away from glare" hint. Set at each glare rejection;
+  // cleared when a frame passes the brightness check (a fresh, glare-free frame).
+  const [isGlareDetected, setIsGlareDetected] = useState(false);
   const [hasGuideShown, setHasGuideShown] = useState(false);
   const [status, setStatus] = useState<
     'SEARCHING' | 'SCANNING' | 'SCANNED' | 'INCORRECT'
@@ -234,6 +239,7 @@ const IdentityDocumentCamera = ({
     frameH: 0,
     hadLowBrightness: false,
     hadBlurryFrames: false,
+    hadGlare: false,
   });
   const [faceDetectionEnabled, setFaceDetectionEnabled] = useState(true);
   const faceImages = useRef<string[]>([]);
@@ -348,6 +354,7 @@ const IdentityDocumentCamera = ({
         frameH: 0,
         hadLowBrightness: false,
         hadBlurryFrames: false,
+        hadGlare: false,
       };
       cachedBarcode.current = null;
       isCompletionCallbackInvoked.current = false;
@@ -396,6 +403,7 @@ const IdentityDocumentCamera = ({
       detectedDocumentType,
       isBrightnessLow,
       isFrameBlurry,
+      isGlareDetected,
       allElementsDetected,
       elementsOutsideScanArea,
       t
@@ -418,6 +426,7 @@ const IdentityDocumentCamera = ({
     hasGuideShown,
     isBrightnessLow,
     isFrameBlurry,
+    isGlareDetected,
     nextStep,
     status,
     detectedDocumentType,
@@ -566,7 +575,9 @@ const IdentityDocumentCamera = ({
     }
   };
 
-  // Check if face image has glare (brightness exceeds threshold)
+  // Check if face image has glare (brightness exceeds threshold). Also surfaces
+  // the result to `isGlareDetected` so the user gets an actionable hint instead
+  // of a silently-stalled scan.
   const checkFaceGlare = async (faceImage: string): Promise<boolean> => {
     try {
       // Check entire face region for glare
@@ -578,6 +589,8 @@ const IdentityDocumentCamera = ({
         100, // Full face height
         MAX_BRIGHTNESS_THRESHOLD
       );
+      setIsGlareDetected(hasGlare);
+      if (hasGlare) diagStats.current.hadGlare = true;
       return hasGlare;
     } catch (error) {
       return false; // Assume no glare on error
@@ -616,6 +629,8 @@ const IdentityDocumentCamera = ({
         Math.round(height * 0.8),
         MAX_BRIGHTNESS_THRESHOLD
       );
+      setIsGlareDetected(hasGlare);
+      if (hasGlare) diagStats.current.hadGlare = true;
       return hasGlare;
     } catch (error) {
       return false;
@@ -2041,6 +2056,15 @@ const IdentityDocumentCamera = ({
       setIsBrightnessLow(!isRegionBright);
       if (!isRegionBright) diagStats.current.hadLowBrightness = true;
 
+      // Reset glare to false at the start of every frame. The glare helpers
+      // (checkDocumentGlare/checkFaceGlare) only run at accept-time and set it
+      // true when they find glare; without this per-frame clear the flag would
+      // latch — a "Glare detected" warning would stick over a now-clean view
+      // (and, once a face is locked, the face-glare site never runs again so it
+      // could never clear at all). The accept-time checks run later in this same
+      // frame's handlers and re-assert true if glare is still present.
+      setIsGlareDetected(false);
+
       // Check blur only in center region (area of interest) to avoid false positives
       // from iOS depth-of-field background blur
       let isNotBlurry = true;
@@ -2666,13 +2690,15 @@ const IdentityDocumentCamera = ({
                 opacity: errorFlashAnim,
               },
               // 3. Warning (yellow) - quality issues
-              (isBrightnessLow || isFrameBlurry) && styles.topZoneTextWarning,
+              (isBrightnessLow || isFrameBlurry || isGlareDetected) &&
+                styles.topZoneTextWarning,
               // 4. Scanning (green) - all elements detected AND inside scan area
               status === 'SCANNING' &&
                 allElementsDetected &&
                 elementsOutsideScanArea.length === 0 &&
                 !isBrightnessLow &&
                 !isFrameBlurry &&
+                !isGlareDetected &&
                 styles.topZoneTextScanning,
               // 5. Default (white) - aligning (not all detected OR elements outside scan area)
             ]}
@@ -2683,6 +2709,7 @@ const IdentityDocumentCamera = ({
               detectedDocumentType,
               isBrightnessLow,
               isFrameBlurry,
+              isGlareDetected,
               allElementsDetected,
               elementsOutsideScanArea,
               t

package/src/Shared/Components/IdentityDocumentCamera.utils.ts

@@ -119,6 +119,7 @@ export function getStatusMessage(
   detectedDocumentType: DocumentType,
   isBrightnessLow: boolean,
   isFrameBlurry: boolean,
+  isGlareDetected: boolean,
   allElementsDetected: boolean,
   elementsOutsideScanArea: string[],
   t: (key: string, params?: Record<string, unknown>) => string
@@ -150,6 +151,14 @@ export function getStatusMessage(
     return t('identityDocumentCamera.lowBrightness');
   }
 
+  // Glare is a primary failure mode (reflections off the laminate/photo). It was
+  // previously detected but never communicated, so the scan just appeared to
+  // hang. Tell the user how to fix it. Ranked above blur because a glare hotspot
+  // both blocks acceptance and often reads as a "sharp" (non-blurry) frame.
+  if (isGlareDetected) {
+    return t('identityDocumentCamera.reduceGlare');
+  }
+
   if (isFrameBlurry) {
     return t('identityDocumentCamera.avoidBlur');
   }

package/src/Shared/EIDReader/eidReader.ts

@@ -732,8 +732,12 @@ const eidReader = async (
       // step (it was previously outside, so an early DG2 failure went unlabelled).
       const dg2InputStream = passportService.getInputStream(EIDService.EF_DG2);
       await dg2InputStream.init();
+      // Map the DG2 byte stream to 30→95 (not →100): the JPEG2000 decode that
+      // follows can take a noticeable beat (esp. large passport portraits), and
+      // jumping to 100 before it made the UI sit at "100% Finalizing" looking
+      // frozen during the decode. We reserve 95→100 for the decode step below.
       InputStream.onRead((totalBytesRead, fileLength) => {
-        progress = 30 + (totalBytesRead / fileLength) * 70;
+        progress = 30 + (totalBytesRead / fileLength) * 65;
         if (progressCallback) {
           progressCallback(progress);
         }
@@ -756,6 +760,12 @@ const eidReader = async (
       const buffer = Buffer.alloc(imageLength);
       await imageInputStream.readBytesWithOffset(buffer, 0, imageLength);
       const rawMimeType = faceImageInfo.getMimeType();
+      // Signal the (potentially slow) photo decode so the UI shows a distinct
+      // "decoding photo" stage at 95% rather than appearing frozen at 100%.
+      progress = 95;
+      if (progressCallback) {
+        progressCallback(progress);
+      }
       const converted = await convertJP2IfNeeded(buffer, rawMimeType);
       imageAsBase64 = converted.base64;
       mimeType = converted.mimeType;

package/src/Translation/Resources/en.ts

@@ -143,11 +143,14 @@ export default {
   'eidScannerScreen.placeDocumentOnNFC':
     'Place your document near the NFC reader',
   'eidScannerScreen.readingDocument': 'Hold steady - Reading document',
+  'eidScannerScreen.keepStill':
+    'Keep the document and phone still until the read completes.',
   'eidScannerScreen.checkYourInformation': 'Review your information carefully',
   'eidScannerScreen.approveAndContinue': 'Approve and Continue',
   'eidScannerScreen.connecting': 'Establishing secure connection...',
   'eidScannerScreen.readingMRZ': 'Reading document information...',
   'eidScannerScreen.readingFaceImage': 'Reading photo data...',
+  'eidScannerScreen.decodingFaceImage': 'Decoding photo...',
   'eidScannerScreen.completing': 'Finalizing verification...',
   'eidScannerScreen.progress': 'Progress',
   'identityDocumentCamera.guideHeader': 'Document Scan',
@@ -178,6 +181,8 @@ export default {
   'identityDocumentCamera.hologramCheck': 'Hologram',
   'identityDocumentCamera.keepSteady': 'Keep device steady',
   'identityDocumentCamera.avoidBlur': 'Keep device steady',
+  'identityDocumentCamera.reduceGlare':
+    'Glare detected. Tilt the document or move away from direct light.',
   'identityDocumentCamera.wrongSideFront':
     'Show the front side of your document',
   'identityDocumentCamera.wrongSideBack': 'Show the back side of your document',

package/src/Translation/Resources/tr.ts

@@ -143,12 +143,15 @@ export default {
     'Pasaportunuzu NFC okuyucuya yaklaştırın',
   'eidScannerScreen.placeDocumentOnNFC': 'Belgenizi NFC okuyucuya yaklaştırın',
   'eidScannerScreen.readingDocument': 'Sabit tutun - Belge okunuyor',
+  'eidScannerScreen.keepStill':
+    'Okuma tamamlanana kadar belgeyi ve telefonu sabit tutun.',
   'eidScannerScreen.checkYourInformation':
     'Bilgilerinizi dikkatle kontrol edin',
   'eidScannerScreen.approveAndContinue': 'Onayla ve Devam Et',
   'eidScannerScreen.connecting': 'Güvenli bağlantı kuruluyor...',
   'eidScannerScreen.readingMRZ': 'Belge bilgileri okunuyor...',
   'eidScannerScreen.readingFaceImage': 'Fotoğraf verisi okunuyor...',
+  'eidScannerScreen.decodingFaceImage': 'Fotoğraf çözümleniyor...',
   'eidScannerScreen.completing': 'Doğrulama tamamlanıyor...',
   'eidScannerScreen.progress': 'İlerleme',
   'identityDocumentCamera.guideHeader': 'Belge Taraması',
@@ -179,6 +182,8 @@ export default {
   'identityDocumentCamera.hologramCheck': 'Hologram',
   'identityDocumentCamera.keepSteady': 'Cihazı sabit tutun',
   'identityDocumentCamera.avoidBlur': 'Cihazı sabit tutun',
+  'identityDocumentCamera.reduceGlare':
+    'Parlama algılandı. Belgeyi hafifçe eğin veya doğrudan ışıktan uzaklaşın.',
   'identityDocumentCamera.wrongSideFront': 'Belgenizin ön yüzünü gösterin',
   'identityDocumentCamera.wrongSideBack': 'Belgenizin arka yüzünü gösterin',
   'identityDocumentCamera.idCardDetected': 'Kimlik kartı algılandı',

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