@trustchex/react-native-sdk 1.488.0 → 1.489.0

package/ios/ImageDecoder/ImageDecoderModule.m

@@ -0,0 +1,12 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE(ImageDecoderModule, NSObject)
+
+// Decode a JPEG2000 (JP2) base64 string and re-encode it as JPEG base64.
+// iOS's <Image> cannot render an image/jp2 data URI, but ImageIO/UIImage
+// decodes JPEG2000 natively, so we round-trip it to JPEG here.
+RCT_EXTERN_METHOD(decodeJp2ToJpeg:(NSString *)base64Jp2
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
+@end

package/ios/ImageDecoder/ImageDecoderModule.swift

@@ -0,0 +1,43 @@
+import Foundation
+import React
+import UIKit
+import ImageIO
+
+/// Decodes images that React Native's <Image> cannot render directly on iOS.
+///
+/// The driving case is the passport chip portrait (DG2), which is frequently
+/// stored as JPEG2000 (image/jp2). Android's image pipeline decodes JP2 data
+/// URIs natively, but iOS's <Image> does not — so the chip photo shows as a
+/// placeholder on iOS. iOS's ImageIO *can* decode JPEG2000, so we round-trip
+/// the JP2 to JPEG here and hand back base64 the JS <Image> can render.
+@objc(ImageDecoderModule)
+class ImageDecoderModule: NSObject {
+
+    @objc
+    static func requiresMainQueueSetup() -> Bool {
+        return false
+    }
+
+    @objc
+    func decodeJp2ToJpeg(_ base64Jp2: String,
+                         resolver resolve: @escaping RCTPromiseResolveBlock,
+                         rejecter reject: @escaping RCTPromiseRejectBlock) {
+        guard let jp2Data = Data(base64Encoded: base64Jp2) else {
+            reject("INVALID_BASE64", "Could not decode base64 JP2 input", nil)
+            return
+        }
+
+        // ImageIO decodes JPEG2000 on iOS even though <Image> won't render it.
+        guard let image = UIImage(data: jp2Data) else {
+            reject("DECODE_FAILED", "ImageIO could not decode the JP2 data", nil)
+            return
+        }
+
+        guard let jpegData = image.jpegData(compressionQuality: 0.95) else {
+            reject("ENCODE_FAILED", "Could not re-encode decoded image as JPEG", nil)
+            return
+        }
+
+        resolve(jpegData.base64EncodedString())
+    }
+}

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

@@ -418,7 +418,11 @@ const EIDScanner = ({
               style: styles.idCardPhotoContainer,
               children: /*#__PURE__*/_jsx(View, {
                 style: styles.idCardPhotoFrame,
-                children: documentFaceImage && (documentFaceImageMimeType === 'image/jpeg' || documentFaceImageMimeType === 'image/png') ? /*#__PURE__*/_jsx(Image, {
+                children: documentFaceImage && (documentFaceImageMimeType === 'image/jpeg' || documentFaceImageMimeType === 'image/png' ||
+                // Android's <Image> decodes a raw JP2 data URI; on iOS
+                // the chip JP2 is converted to JPEG before this point
+                // (native ImageIO), so iOS never reaches here as jp2.
+                documentFaceImageMimeType === 'image/jp2') ? /*#__PURE__*/_jsx(Image, {
                   source: {
                     uri: `data:${documentFaceImageMimeType};base64,${documentFaceImage}`
                   },

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

@@ -261,12 +261,32 @@ export function handleIDBackFlow(mrzText, mrzFields, mrzValid, mrzStableAndValid
  *
  * PASSPORT: → COMPLETED (no back side)
  * ID CARD: → SCAN_ID_BACK
+ *
+ * Routing is PASSPORT-BIASED on purpose: a passport has no back side, so if we
+ * route it to SCAN_ID_BACK it deadlocks forever waiting for a back that will
+ * never appear. We therefore only go to SCAN_ID_BACK when there is POSITIVE
+ * evidence the document is an ID card (a parsed MRZ document code that is
+ * present and not 'P'). When the type is ambiguous — e.g. the passport MRZ was
+ * never read as 'P' so the front step locked `detectedDocumentType` as
+ * 'ID_FRONT' (the torch/tilt during hologram capture makes the MRZ unreadable),
+ * or no MRZ code survived at all — we COMPLETE rather than wait for a
+ * non-existent back side. A two-sided ID card always yields an 'I'/'A'/'C'
+ * (non-'P') MRZ code, so genuine ID cards still route to SCAN_ID_BACK.
  */
 export function getNextStepAfterHologram(detectedDocumentType, currentFrameDocType, mrzDocCode) {
-  // Check multiple sources to determine if it's a passport
+  // Any positive passport signal → done (no back side).
   const isPassport = detectedDocumentType === 'PASSPORT' || currentFrameDocType === 'PASSPORT' || mrzDocCode === 'P';
   if (isPassport) {
     return 'COMPLETED';
   }
-  return 'SCAN_ID_BACK';
+
+  // Only continue to the back side when we have POSITIVE proof it's an ID card:
+  // a real MRZ document code that is present and not a passport. Without that
+  // proof, default to COMPLETED so a misclassified passport can't hang waiting
+  // for a back side that doesn't exist.
+  const hasIdCardMrzCode = !!mrzDocCode && mrzDocCode !== 'P';
+  if (hasIdCardMrzCode) {
+    return 'SCAN_ID_BACK';
+  }
+  return 'COMPLETED';
 }

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

@@ -1799,7 +1799,7 @@ const IdentityDocumentCamera = ({
           status === 'SCANNING' && allElementsDetected && elementsOutsideScanArea.length === 0 && !isBrightnessLow && !isFrameBlurry && styles.topZoneTextScanning
           // 5. Default (white) - aligning (not all detected OR elements outside scan area)
           ],
-          children: getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, allElementsDetected, elementsOutsideScanArea, t, mrzReliable)
+          children: getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, allElementsDetected, elementsOutsideScanArea, t)
         })]
       }), /*#__PURE__*/_jsx(View, {
         style: styles.leftZone

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

@@ -78,17 +78,17 @@ 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, mrzReliable = false) {
+export function getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, allElementsDetected, elementsOutsideScanArea, t) {
   if (nextStep === 'COMPLETED') {
     return t('identityDocumentCamera.scanCompleted');
   }
 
-  // MRZ reliably detected (stable consensus) — the green "GO" message. Ranks
-  // above the in-progress states so the user gets a clear positive signal the
-  // moment the reading has settled, but never on an early/transient valid read.
-  if (mrzReliable) {
-    return t('identityDocumentCamera.mrzDetected');
-  }
+  // NOTE: the "MRZ detected — hold steady" message was intentionally removed
+  // (along with its former `mrzReliable` parameter). User-facing guidance
+  // should only describe the SCAN STEP (front side, back side, hologram, etc.),
+  // not low-level MRZ-detection state. We fall through to the step-specific
+  // messages below.
+
   if (status === 'INCORRECT') {
     if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT') {
       return t('identityDocumentCamera.alignIDFront');

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

@@ -12,6 +12,7 @@ import { Buffer } from 'buffer';
 import { InputStream } from "./java/inputStream.js";
 import { debugLog } from "../Libs/debug.utils.js";
 import { diagnostics } from "../Libs/diagnostics.js";
+import { decodeJp2ToJpeg } from "../Libs/jp2Decode.js";
 
 /**
  * Extract an APDU status word (hex, e.g. "6982") from an error message if the
@@ -220,7 +221,7 @@ function pixelsToPng(pixels, width, height, channels) {
 // conversion" hang. A JS timeout cannot interrupt a synchronous call, so we must
 // gate BEFORE decoding. ~12 KB decodes fast; beyond that we keep the raw JP2.
 const MAX_JP2_DECODE_BYTES = 12 * 1024;
-function convertJP2IfNeeded(imageBuffer, mimeType) {
+async function convertJP2IfNeeded(imageBuffer, mimeType) {
   if (mimeType !== 'image/jp2') {
     return {
       base64: imageBuffer.toString('base64'),
@@ -228,10 +229,21 @@ function convertJP2IfNeeded(imageBuffer, mimeType) {
     };
   }
 
+  // Prefer the native decoder (iOS ImageIO). It decodes JPEG2000 of any size
+  // without blocking the JS thread, so it both fixes the iOS preview (RN's
+  // <Image> can't render a raw image/jp2 data URI) and avoids the slow pure-JS
+  // decoder entirely. Returns null on Android / when unavailable → fall through.
+  const native = await decodeJp2ToJpeg(imageBuffer);
+  if (native) {
+    debugLog('EID', `[EID] JP2 decoded natively → ${native.mimeType} (${native.base64.length} base64 chars)`);
+    return native;
+  }
+
   // Too large to decode synchronously without freezing the UI — keep the raw
   // JP2. The face image is still captured (the verification backend / face-match
   // accept JPEG2000); only the on-screen preview can't render it. This lets the
-  // NFC read COMPLETE instead of hanging.
+  // NFC read COMPLETE instead of hanging. (On Android the raw JP2 still renders
+  // in <Image>; on iOS the native path above normally handles it.)
   if (imageBuffer.length > MAX_JP2_DECODE_BYTES) {
     debugLog('EID', `[EID] JP2 face image is ${imageBuffer.length} bytes (> ${MAX_JP2_DECODE_BYTES}); skipping in-JS decode to avoid blocking, keeping raw JP2`);
     return {
@@ -642,7 +654,7 @@ const eidReader = async (documentNumber, dateOfBirth, dateOfExpiry, progressCall
       const buffer = Buffer.alloc(imageLength);
       await imageInputStream.readBytesWithOffset(buffer, 0, imageLength);
       const rawMimeType = faceImageInfo.getMimeType();
-      const converted = convertJP2IfNeeded(buffer, rawMimeType);
+      const converted = await convertJP2IfNeeded(buffer, rawMimeType);
       imageAsBase64 = converted.base64;
       mimeType = converted.mimeType;
     }

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

@@ -0,0 +1,43 @@
+"use strict";
+
+import { NativeModules, Platform } from 'react-native';
+
+/**
+ * Native JPEG2000 decoder bridge.
+ *
+ * The passport chip portrait (DG2) is frequently stored as JPEG2000
+ * (image/jp2). React Native's <Image> renders a JP2 data URI on Android (its
+ * Fresco/Skia pipeline decodes it) but NOT on iOS (UIImage-backed <Image>
+ * refuses the data URI), so the chip photo showed as a placeholder on iOS.
+ *
+ * iOS's ImageIO *can* decode JPEG2000, so the native `ImageDecoderModule`
+ * round-trips the JP2 to JPEG. We only need this on iOS; on Android the raw
+ * JP2 already renders, so there is no native counterpart and we no-op.
+ */
+
+const ImageDecoder = NativeModules.ImageDecoderModule;
+
+/**
+ * Decode a JPEG2000 buffer to JPEG using the native iOS decoder.
+ *
+ * Returns the JPEG bytes + mime type on success, or null when native decode is
+ * unavailable (Android, or the module isn't linked) or fails — callers should
+ * fall back to their existing behaviour (keep raw JP2).
+ */
+export async function decodeJp2ToJpeg(jp2Buffer) {
+  if (Platform.OS !== 'ios' || !ImageDecoder?.decodeJp2ToJpeg) {
+    return null;
+  }
+  try {
+    const jpegBase64 = await ImageDecoder.decodeJp2ToJpeg(jp2Buffer.toString('base64'));
+    if (!jpegBase64) {
+      return null;
+    }
+    return {
+      base64: jpegBase64,
+      mimeType: 'image/jpeg'
+    };
+  } catch {
+    return null;
+  }
+}

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.488.0';
+export const SDK_VERSION = '1.489.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;AAiBpD,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,4CAqwBjB,CAAC;AA4NF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"EIDScanner.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/EIDScanner.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAiBpD,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,4CAywBjB,CAAC;AA4NF,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,4CAojF7B,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,4CAmjF7B,CAAC;AAiIF,eAAe,sBAAsB,CAAC"}

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

@@ -83,6 +83,17 @@ export declare function handleIDBackFlow(mrzText: string | null, mrzFields: MRZF
  *
  * PASSPORT: → COMPLETED (no back side)
  * ID CARD: → SCAN_ID_BACK
+ *
+ * Routing is PASSPORT-BIASED on purpose: a passport has no back side, so if we
+ * route it to SCAN_ID_BACK it deadlocks forever waiting for a back that will
+ * never appear. We therefore only go to SCAN_ID_BACK when there is POSITIVE
+ * evidence the document is an ID card (a parsed MRZ document code that is
+ * present and not 'P'). When the type is ambiguous — e.g. the passport MRZ was
+ * never read as 'P' so the front step locked `detectedDocumentType` as
+ * 'ID_FRONT' (the torch/tilt during hologram capture makes the MRZ unreadable),
+ * or no MRZ code survived at all — we COMPLETE rather than wait for a
+ * non-existent back side. A two-sided ID card always yields an 'I'/'A'/'C'
+ * (non-'P') MRZ code, so genuine ID cards still route to SCAN_ID_BACK.
  */
 export declare function getNextStepAfterHologram(detectedDocumentType: 'ID_FRONT' | 'ID_BACK' | 'PASSPORT' | 'UNKNOWN', currentFrameDocType: 'ID_FRONT' | 'ID_BACK' | 'PASSPORT' | 'UNKNOWN', mrzDocCode: string | undefined): 'COMPLETED' | 'SCAN_ID_BACK';
 //# sourceMappingURL=IdentityDocumentCamera.flows.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentCamera.flows.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.flows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAUpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,cAAc,GACd,qBAAqB,GACrB,sBAAsB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;CAC3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,iBAAiB,EAAE,OAAO,EAC1B,WAAW,EAAE,OAAO,EACpB,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,OAAO,GACpB,kBAAkB,CAgEpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM,GACjB,iBAAiB,CA0EnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,QAAQ,EAAE,OAAO,EACjB,iBAAiB,EAAE,OAAO,EAC1B,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,WAAW,EAAE,OAAO,GACnB,gBAAgB,CA2DlB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,oBAAoB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACrE,mBAAmB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACpE,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,WAAW,GAAG,cAAc,CAY9B"}
+{"version":3,"file":"IdentityDocumentCamera.flows.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.flows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAUpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,cAAc,GACd,qBAAqB,GACrB,sBAAsB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;CAC3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,iBAAiB,EAAE,OAAO,EAC1B,WAAW,EAAE,OAAO,EACpB,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,OAAO,GACpB,kBAAkB,CAgEpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM,GACjB,iBAAiB,CA0EnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,QAAQ,EAAE,OAAO,EACjB,iBAAiB,EAAE,OAAO,EAC1B,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,WAAW,EAAE,OAAO,GACnB,gBAAgB,CA2DlB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,oBAAoB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACrE,mBAAmB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACpE,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,WAAW,GAAG,cAAc,CAqB9B"}

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

@@ -42,7 +42,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, mrzReliable?: boolean): string;
+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;
 /**
  * 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":"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"}

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;AA0X7C,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;AAyY7C,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"}

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

@@ -0,0 +1,13 @@
+import { Buffer } from 'buffer';
+/**
+ * Decode a JPEG2000 buffer to JPEG using the native iOS decoder.
+ *
+ * Returns the JPEG bytes + mime type on success, or null when native decode is
+ * unavailable (Android, or the module isn't linked) or fails — callers should
+ * fall back to their existing behaviour (keep raw JP2).
+ */
+export declare function decodeJp2ToJpeg(jp2Buffer: Buffer): Promise<{
+    base64: string;
+    mimeType: string;
+} | null>;
+//# sourceMappingURL=jp2Decode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jp2Decode.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/jp2Decode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAsBhC;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAetD"}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustchex/react-native-sdk",
-  "version": "1.488.0",
+  "version": "1.489.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

@@ -602,7 +602,11 @@ const EIDScanner = ({
                     <View style={styles.idCardPhotoFrame}>
                       {documentFaceImage &&
                       (documentFaceImageMimeType === 'image/jpeg' ||
-                        documentFaceImageMimeType === 'image/png') ? (
+                        documentFaceImageMimeType === 'image/png' ||
+                        // Android's <Image> decodes a raw JP2 data URI; on iOS
+                        // the chip JP2 is converted to JPEG before this point
+                        // (native ImageIO), so iOS never reaches here as jp2.
+                        documentFaceImageMimeType === 'image/jp2') ? (
                         <Image
                           source={{
                             uri: `data:${documentFaceImageMimeType};base64,${documentFaceImage}`,

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

@@ -325,13 +325,24 @@ export function handleIDBackFlow(
  *
  * PASSPORT: → COMPLETED (no back side)
  * ID CARD: → SCAN_ID_BACK
+ *
+ * Routing is PASSPORT-BIASED on purpose: a passport has no back side, so if we
+ * route it to SCAN_ID_BACK it deadlocks forever waiting for a back that will
+ * never appear. We therefore only go to SCAN_ID_BACK when there is POSITIVE
+ * evidence the document is an ID card (a parsed MRZ document code that is
+ * present and not 'P'). When the type is ambiguous — e.g. the passport MRZ was
+ * never read as 'P' so the front step locked `detectedDocumentType` as
+ * 'ID_FRONT' (the torch/tilt during hologram capture makes the MRZ unreadable),
+ * or no MRZ code survived at all — we COMPLETE rather than wait for a
+ * non-existent back side. A two-sided ID card always yields an 'I'/'A'/'C'
+ * (non-'P') MRZ code, so genuine ID cards still route to SCAN_ID_BACK.
  */
 export function getNextStepAfterHologram(
   detectedDocumentType: 'ID_FRONT' | 'ID_BACK' | 'PASSPORT' | 'UNKNOWN',
   currentFrameDocType: 'ID_FRONT' | 'ID_BACK' | 'PASSPORT' | 'UNKNOWN',
   mrzDocCode: string | undefined
 ): 'COMPLETED' | 'SCAN_ID_BACK' {
-  // Check multiple sources to determine if it's a passport
+  // Any positive passport signal → done (no back side).
   const isPassport =
     detectedDocumentType === 'PASSPORT' ||
     currentFrameDocType === 'PASSPORT' ||
@@ -341,5 +352,14 @@ export function getNextStepAfterHologram(
     return 'COMPLETED';
   }
 
-  return 'SCAN_ID_BACK';
+  // Only continue to the back side when we have POSITIVE proof it's an ID card:
+  // a real MRZ document code that is present and not a passport. Without that
+  // proof, default to COMPLETED so a misclassified passport can't hang waiting
+  // for a back side that doesn't exist.
+  const hasIdCardMrzCode = !!mrzDocCode && mrzDocCode !== 'P';
+  if (hasIdCardMrzCode) {
+    return 'SCAN_ID_BACK';
+  }
+
+  return 'COMPLETED';
 }

package/src/Shared/Components/IdentityDocumentCamera.tsx

@@ -2624,8 +2624,7 @@ const IdentityDocumentCamera = ({
               isFrameBlurry,
               allElementsDetected,
               elementsOutsideScanArea,
-              t,
-              mrzReliable
+              t
             )}
           </AnimatedText>
         </View>

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

@@ -96,19 +96,17 @@ export function getStatusMessage(
   isFrameBlurry: boolean,
   allElementsDetected: boolean,
   elementsOutsideScanArea: string[],
-  t: (key: string, params?: Record<string, unknown>) => string,
-  mrzReliable: boolean = false
+  t: (key: string, params?: Record<string, unknown>) => string
 ): string {
   if (nextStep === 'COMPLETED') {
     return t('identityDocumentCamera.scanCompleted');
   }
 
-  // MRZ reliably detected (stable consensus) — the green "GO" message. Ranks
-  // above the in-progress states so the user gets a clear positive signal the
-  // moment the reading has settled, but never on an early/transient valid read.
-  if (mrzReliable) {
-    return t('identityDocumentCamera.mrzDetected');
-  }
+  // NOTE: the "MRZ detected — hold steady" message was intentionally removed
+  // (along with its former `mrzReliable` parameter). User-facing guidance
+  // should only describe the SCAN STEP (front side, back side, hologram, etc.),
+  // not low-level MRZ-detection state. We fall through to the step-specific
+  // messages below.
 
   if (status === 'INCORRECT') {
     if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT') {

package/src/Shared/EIDReader/eidReader.ts

@@ -12,6 +12,7 @@ import { MRZInfo } from './lds/icao/mrzInfo';
 import { InputStream } from './java/inputStream';
 import { debugLog } from '../Libs/debug.utils';
 import { diagnostics } from '../Libs/diagnostics';
+import { decodeJp2ToJpeg } from '../Libs/jp2Decode';
 
 /**
  * Extract an APDU status word (hex, e.g. "6982") from an error message if the
@@ -239,18 +240,32 @@ function pixelsToPng(
 // gate BEFORE decoding. ~12 KB decodes fast; beyond that we keep the raw JP2.
 const MAX_JP2_DECODE_BYTES = 12 * 1024;
 
-function convertJP2IfNeeded(
+async function convertJP2IfNeeded(
   imageBuffer: Buffer,
   mimeType: string
-): { base64: string; mimeType: string } {
+): Promise<{ base64: string; mimeType: string }> {
   if (mimeType !== 'image/jp2') {
     return { base64: imageBuffer.toString('base64'), mimeType };
   }
 
+  // Prefer the native decoder (iOS ImageIO). It decodes JPEG2000 of any size
+  // without blocking the JS thread, so it both fixes the iOS preview (RN's
+  // <Image> can't render a raw image/jp2 data URI) and avoids the slow pure-JS
+  // decoder entirely. Returns null on Android / when unavailable → fall through.
+  const native = await decodeJp2ToJpeg(imageBuffer);
+  if (native) {
+    debugLog(
+      'EID',
+      `[EID] JP2 decoded natively → ${native.mimeType} (${native.base64.length} base64 chars)`
+    );
+    return native;
+  }
+
   // Too large to decode synchronously without freezing the UI — keep the raw
   // JP2. The face image is still captured (the verification backend / face-match
   // accept JPEG2000); only the on-screen preview can't render it. This lets the
-  // NFC read COMPLETE instead of hanging.
+  // NFC read COMPLETE instead of hanging. (On Android the raw JP2 still renders
+  // in <Image>; on iOS the native path above normally handles it.)
   if (imageBuffer.length > MAX_JP2_DECODE_BYTES) {
     debugLog(
       'EID',
@@ -739,7 +754,7 @@ const eidReader = async (
       const buffer = Buffer.alloc(imageLength);
       await imageInputStream.readBytesWithOffset(buffer, 0, imageLength);
       const rawMimeType = faceImageInfo.getMimeType();
-      const converted = convertJP2IfNeeded(buffer, rawMimeType);
+      const converted = await convertJP2IfNeeded(buffer, rawMimeType);
       imageAsBase64 = converted.base64;
       mimeType = converted.mimeType;
     }

package/src/Shared/Libs/jp2Decode.ts

@@ -0,0 +1,48 @@
+import { NativeModules, Platform } from 'react-native';
+import { Buffer } from 'buffer';
+
+/**
+ * Native JPEG2000 decoder bridge.
+ *
+ * The passport chip portrait (DG2) is frequently stored as JPEG2000
+ * (image/jp2). React Native's <Image> renders a JP2 data URI on Android (its
+ * Fresco/Skia pipeline decodes it) but NOT on iOS (UIImage-backed <Image>
+ * refuses the data URI), so the chip photo showed as a placeholder on iOS.
+ *
+ * iOS's ImageIO *can* decode JPEG2000, so the native `ImageDecoderModule`
+ * round-trips the JP2 to JPEG. We only need this on iOS; on Android the raw
+ * JP2 already renders, so there is no native counterpart and we no-op.
+ */
+interface ImageDecoderNativeModule {
+  decodeJp2ToJpeg(base64Jp2: string): Promise<string>;
+}
+
+const ImageDecoder = (
+  NativeModules as { ImageDecoderModule?: ImageDecoderNativeModule }
+).ImageDecoderModule;
+
+/**
+ * Decode a JPEG2000 buffer to JPEG using the native iOS decoder.
+ *
+ * Returns the JPEG bytes + mime type on success, or null when native decode is
+ * unavailable (Android, or the module isn't linked) or fails — callers should
+ * fall back to their existing behaviour (keep raw JP2).
+ */
+export async function decodeJp2ToJpeg(
+  jp2Buffer: Buffer
+): Promise<{ base64: string; mimeType: string } | null> {
+  if (Platform.OS !== 'ios' || !ImageDecoder?.decodeJp2ToJpeg) {
+    return null;
+  }
+  try {
+    const jpegBase64 = await ImageDecoder.decodeJp2ToJpeg(
+      jp2Buffer.toString('base64')
+    );
+    if (!jpegBase64) {
+      return null;
+    }
+    return { base64: jpegBase64, mimeType: 'image/jpeg' };
+  } catch {
+    return null;
+  }
+}

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