@finos_sdk/sdk-ekyc 1.4.8 → 1.5.0

package/android/src/main/java/finos/sdk/ekyc/EKYCModule.kt

@@ -92,97 +92,154 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
     private var exitSheetResolvedViaButton = false
 
     private fun getTrueCurrentActivity(): Activity? {
-        // Try React Native's currentActivity first
+        // Try React Native's currentActivity first as a baseline
         val rnActivity = currentActivity
-        if (rnActivity != null && rnActivity.javaClass.simpleName != "MainActivity") {
+        
+        Log.d(TAG, "🔍 getTrueCurrentActivity check: rnActivity=${rnActivity?.javaClass?.simpleName}")
+
+        // If rnActivity is already an SDK activity, we can likely trust it
+        if (rnActivity != null && rnActivity.javaClass.name.startsWith("finos.sdk.")) {
+            Log.d(TAG, "✅ Current activity is already an SDK activity: ${rnActivity.javaClass.simpleName}")
             return rnActivity
         }
 
-        // If RN gives us MainActivity or null, but we know an SDK is showing, 
-        // we must find the actual top activity via reflection or ActivityThread
+        // Use reflection to find the absolute top resumed activity.
+        // This is crucial when the SDK is running in a native Activity on top of the RN Activity,
+        // and currentActivity might still point to the background Activity.
+        try {
+            val topActivity = findTopActivityViaReflection()
+            if (topActivity != null) {
+                Log.d(TAG, "✅ Found top activity via reflection: ${topActivity.javaClass.simpleName}")
+                return topActivity
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to find top activity via reflection", e)
+        }
+        
+        Log.d(TAG, "⚠️ Fallback to rnActivity: ${rnActivity?.javaClass?.simpleName}")
+        return rnActivity
+    }
+
+    /**
+     * Finds the top-most resumed activity using ActivityThread's internal records.
+     */
+    private fun findTopActivityViaReflection(): Activity? {
         try {
             val activityThreadClass = Class.forName("android.app.ActivityThread")
-            val activityThread = activityThreadClass.getMethod("currentActivityThread").invoke(null)
+            val activityThread = activityThreadClass.getMethod("currentActivityThread").invoke(null) ?: return null
             val activitiesField = activityThreadClass.getDeclaredField("mActivities")
             activitiesField.isAccessible = true
             
-            val activities = activitiesField.get(activityThread) as Map<Any, Any>
-            Log.d(TAG, "🔍 Scanning ${activities.size} activities...")
-            
-            var topActivity: Activity? = null
+            val activities = activitiesField.get(activityThread) as? Map<*, *> ?: return null
+            Log.d(TAG, "🔍 Scanning ${activities.size} activities via reflection...")
             
+            var bestCandidate: Activity? = null
+            var highestPriority = -1
+
             for (activityRecord in activities.values) {
-                val activityRecordClass = activityRecord.javaClass
-                
-                val activityField = activityRecordClass.getDeclaredField("activity")
-                activityField.isAccessible = true
-                val activity = activityField.get(activityRecord) as Activity
-                
-                val pausedField = activityRecordClass.getDeclaredField("paused")
-                pausedField.isAccessible = true
-                val isPaused = pausedField.get(activityRecord) as Boolean
-                
-                val stoppedField = activityRecordClass.getDeclaredField("stopped")
-                stoppedField.isAccessible = true
-                val isStopped = stoppedField.get(activityRecord) as Boolean
-                
-                Log.d(TAG, "   - Found: ${activity.javaClass.simpleName} (Paused: $isPaused, Stopped: $isStopped, Finishing: ${activity.isFinishing})")
-                
-                if (!activity.isFinishing && !isStopped) {
-                    topActivity = activity
-                    if (!isPaused) break // Found the resumed one
+                if (activityRecord == null) continue
+                try {
+                    val activityRecordClass = activityRecord.javaClass
+                    val activityField = activityRecordClass.getDeclaredField("activity")
+                    activityField.isAccessible = true
+                    val activity = activityField.get(activityRecord) as? Activity ?: continue
+
+                    if (activity.isFinishing) continue
+
+                    val pausedField = activityRecordClass.getDeclaredField("paused")
+                    pausedField.isAccessible = true
+                    val isPaused = pausedField.get(activityRecord) as Boolean
+
+                    val stoppedField = activityRecordClass.getDeclaredField("stopped")
+                    stoppedField.isAccessible = true
+                    val isStopped = stoppedField.get(activityRecord) as Boolean
+
+                    if (isStopped) continue
+
+                    // Identity check: prioritize known SDK activity patterns
+                    val className = activity.javaClass.name
+                    val isSDK = className.startsWith("finos.sdk.") || 
+                               className.contains("EKYC", ignoreCase = true) ||
+                               className.contains("Liveness", ignoreCase = true) ||
+                               className.contains("OCR", ignoreCase = true) ||
+                               className.contains("NFC", ignoreCase = true)
+
+                    // Priority scoring:
+                    // 3: Resumed SDK Activity
+                    // 2: Resumed App Activity
+                    // 1: Paused SDK Activity
+                    // 0: Paused App Activity
+                    val currentPriority = (if (isSDK) 1 else 0) + (if (!isPaused) 2 else 0)
+
+                    Log.v(TAG, "   [Audit] ${activity.javaClass.simpleName} -> Prio: $currentPriority (SDK=$isSDK, Paused=$isPaused)")
+
+                    if (currentPriority > highestPriority) {
+                        highestPriority = currentPriority
+                        bestCandidate = activity
+                    }
+
+                    // Optimization: Found the absolute best target
+                    if (highestPriority == 3) break
+
+                } catch (e: Exception) {
+                    // Silently continue for individual activity record failures
                 }
             }
-            return topActivity ?: rnActivity
+            
+            if (bestCandidate != null) {
+                Log.d(TAG, "✅ Best candidate found: ${bestCandidate.javaClass.simpleName} (Prio: $highestPriority)")
+            }
+            
+            return bestCandidate
         } catch (e: Exception) {
-            Log.e(TAG, "Error finding true current activity", e)
+            Log.e(TAG, "❌ Critical error in findTopActivityViaReflection", e)
+            return null
         }
-        
-        return rnActivity
     }
 
     @ReactMethod
     fun showRNExitSheet(bundleName: String, initialProps: ReadableMap, promise: Promise) {
-        val activity = getTrueCurrentActivity() ?: run {
-            Log.e(TAG, "❌ showRNExitSheet failed: No visible activity found")
-            promise.reject("NO_ACTIVITY", "No visible activity found")
-            return
-        }
-
-        if (activity.isFinishing || activity.isDestroyed) {
-            Log.e(TAG, "❌ showRNExitSheet failed: Activity is finishing/destroyed")
-            promise.reject("ACTIVITY_INVALID", "Activity is finishing or destroyed")
-            return
-        }
+        // Fix: Move activity detection to UI thread to avoid race conditions and ensure correct window attachment
+        Handler(Looper.getMainLooper()).post {
+            val activity = getTrueCurrentActivity() ?: run {
+                Log.e(TAG, "❌ showRNExitSheet failed: No visible activity found")
+                promise.reject("NO_ACTIVITY", "No visible activity found")
+                return@post
+            }
 
-        // Guard chống double-resolve/reject promise (vì có nhiều entry point: sync error, async listener, exception)
-        val promiseSettled = java.util.concurrent.atomic.AtomicBoolean(false)
-        fun safeResolve(value: Any?) {
-            if (promiseSettled.compareAndSet(false, true)) promise.resolve(value)
-        }
-        fun safeReject(code: String, msg: String, e: Throwable? = null) {
-            if (promiseSettled.compareAndSet(false, true)) {
-                if (e != null) promise.reject(code, msg, e) else promise.reject(code, msg)
+            if (activity.isFinishing || (android.os.Build.VERSION.SDK_INT >= 17 && activity.isDestroyed)) {
+                Log.e(TAG, "❌ showRNExitSheet failed: Activity is finishing or destroyed")
+                promise.reject("ACTIVITY_INVALID", "Activity is finishing or destroyed")
+                return@post
             }
-        }
 
-        activity.runOnUiThread {
+            // Guard chống double-resolve/reject promise
+            val promiseSettled = java.util.concurrent.atomic.AtomicBoolean(false)
+            fun safeResolve(value: Any?) {
+                if (promiseSettled.compareAndSet(false, true)) promise.resolve(value)
+            }
+            fun safeReject(code: String, msg: String, e: Throwable? = null) {
+                if (promiseSettled.compareAndSet(false, true)) {
+                    if (e != null) promise.reject(code, msg, e) else promise.reject(code, msg)
+                }
+            }
             try {
                 val activityName = activity.javaClass.simpleName
                 Log.d(TAG, "▶️ showRNExitSheet: Top Activity=$activityName, bundle=$bundleName")
 
                 val reactApplication = activity.application as? ReactApplication
                 if (reactApplication == null) {
-                    Log.e(TAG, "❌ Application does not implement ReactApplication")
+                    Log.e(TAG, "❌ showRNExitSheet failed: Application class (${activity.application.javaClass.name}) does not implement ReactApplication. Please ensure your Application class implements ReactApplication or provide a way for the SDK to access the ReactInstanceManager.")
                     safeReject("NO_REACT_APP", "Application does not implement ReactApplication")
-                    return@runOnUiThread
+                    return@post
                 }
                 val reactInstanceManager = reactApplication.reactNativeHost.reactInstanceManager
 
                 if (reactInstanceManager.currentReactContext != null) {
+                    Log.d(TAG, "✅ ReactContext is ready, presenting sheet...")
                     presentRNBottomSheet(activity, reactInstanceManager, bundleName, initialProps,
                         ::safeResolve, ::safeReject)
-                    return@runOnUiThread
+                    return@post
                 }
 
                 // Context chưa sẵn sàng: chờ listener
@@ -212,7 +269,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     Log.d(TAG, "✅ ReactContext init xong giữa lúc add listener — present luôn")
                     presentRNBottomSheet(activity, reactInstanceManager, bundleName, initialProps,
                         ::safeResolve, ::safeReject)
-                    return@runOnUiThread
+                    return@post
                 }
 
                 // Chỉ trigger background create nếu chưa start (tránh IllegalStateException)
@@ -250,12 +307,17 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         safeReject: (String, String, Throwable?) -> Unit
     ) {
         try {
+            val minHeightPx = (400 * activity.resources.displayMetrics.density).toInt()
             val container = LinearLayout(activity).apply {
                 orientation = LinearLayout.VERTICAL
                 setBackgroundColor(Color.TRANSPARENT)
+                minimumHeight = minHeightPx
             }
 
             val rootView = ReactRootView(activity)
+            // Hardening: Set a minimum height to ensure the sheet is visible even before RN finishes layout
+            rootView.minimumHeight = minHeightPx
+            
             rootView.layoutParams = LinearLayout.LayoutParams(
                 LinearLayout.LayoutParams.MATCH_PARENT,
                 LinearLayout.LayoutParams.WRAP_CONTENT
@@ -328,7 +390,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
 
             bottomSheetDialog.show()
 
-            Log.d(TAG, "✅ showRNExitSheet: BottomSheetDialog shown (wrap content), bundle=$bundleName")
+            Log.d(TAG, "✅ showRNExitSheet: BottomSheetDialog shown on ${activity.javaClass.simpleName}, bundle=$bundleName")
             safeResolve(true)
         } catch (e: Exception) {
             Log.e(TAG, "❌ Exception in presentRNBottomSheet", e)
@@ -903,12 +965,7 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
                     isActiveLiveness = isActiveLiveness ?: false,
                     isActiveLivenessColor = isActiveLivenessColor ?: false,
                     isShowCameraFont = isShowCameraFont ?: true,
-                    // Custom actions từ checkboxes (nếu có chọn)
-                    // Nếu có actions được chọn → sử dụng customActions
-                    // Nếu không có actions nào được chọn → sử dụng random actions với activeActionCount
                     customActions = customActions,
-                    // Number of random actions (1-10), only used when customActions = null
-                    // activeActionCount = 2 → 2 random actions + STRAIGHT
                     activeActionCount = activeActionCount ?: 2,
                     forceCaptureTimeout = (forceCaptureTimeout ?: 0.0).toLong(),
                     selfieImage = imageFile,
@@ -2645,15 +2702,16 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
 
     @ReactMethod
     fun setExitSheetHeight(heightDp: Float) {
-        val activity = getTrueCurrentActivity() ?: return
-        val heightPx = (heightDp * activity.resources.displayMetrics.density).toInt()
-        Log.d(TAG, "▶️ setExitSheetHeight: ${heightDp}dp → ${heightPx}px")
-        activity.runOnUiThread {
-            val sheet = currentExitSheet ?: return@runOnUiThread
-            if (!sheet.isShowing) return@runOnUiThread
+        Handler(Looper.getMainLooper()).post {
+            val activity = getTrueCurrentActivity() ?: return@post
+            val heightPx = (heightDp * activity.resources.displayMetrics.density).toInt()
+            Log.d(TAG, "▶️ setExitSheetHeight: ${heightDp}dp → ${heightPx}px")
+            
+            val sheet = currentExitSheet ?: return@post
+            if (!sheet.isShowing) return@post
             val bs = sheet.findViewById<View>(com.google.android.material.R.id.design_bottom_sheet)
-                ?: return@runOnUiThread
-            val lp = bs.layoutParams ?: return@runOnUiThread
+                ?: return@post
+            val lp = bs.layoutParams ?: return@post
             lp.height = heightPx
             bs.layoutParams = lp
             val behavior = com.google.android.material.bottomsheet.BottomSheetBehavior.from(bs)

package/dist/index.js

@@ -32,10 +32,14 @@ var __importStar = (this && this.__importStar) || (function () {
         return result;
     };
 })();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OCR_USE_NEW_ID_DOCUMENT_2 = exports.OCR_USE_NEW_ID_DOCUMENT_1 = exports.OCR_FAKE_MRZ = exports.OCR_INVALID_GENDER_CODE = exports.OCR_INVALID_ID_CARD = exports.OCR_GLARE_ID_CARD = exports.OCR_BLURRY_ID_CARD = exports.OCR_CUT_CORNER_ID_CARD = exports.OCR_CANNOT_RECOGNIZE_PORTRAIT = exports.OCR_ID_CARD_FROM_OTHER_DEVICE = exports.OCR_NOT_ORIGINAL_ID_CARD = exports.OCR_MISSING_ID_CARD_PART = exports.OCR_CANNOT_GET_ISSUE_PLACE = exports.OCR_CANNOT_GET_GENDER = exports.OCR_CANNOT_GET_HOMETOWN = exports.OCR_CANNOT_GET_RESIDENCE = exports.OCR_CANNOT_GET_ISSUE_DATE = exports.OCR_CANNOT_GET_EXPIRY_DATE = exports.OCR_CANNOT_GET_BIRTH_YEAR = exports.OCR_CANNOT_GET_NAME = exports.OCR_CANNOT_GET_ID_NUMBER = exports.OCR_WRONG_ID_CARD_SIDE = exports.OCR_UNRECOGNIZED_ID_CARD = exports.SDK_MISS_KEY = exports.ERROR_UNKNOWN = exports.SDK_START_ERROR = exports.SDK_START_FLOW_ERROR = exports.getMessage = exports.getErrorResultFromDetails = exports.createCustom = exports.fromCode = exports.getLocalizedMessage = exports.parseNfcResponse = exports.AuthorizationStatus = exports.AppIDType = exports.getEkycError = exports.EKYCErrorEvent = exports.EKYCEvent = exports.customActionsToStrings = exports.SDK_LIVENESS_ACTIONS = exports.SDKFaceDetectStatus = exports.flowToStrings = exports.SDK_FLOW_OPTIONS = exports.SDKFlowType = exports.FinosESignModule = exports.FinosESign = exports.FinosEKYCModule = exports.FinosEKYC = exports.SDKeKYC = exports.sdkEKYC = void 0;
 exports.ESIGN_INVALID_USER_ACCOUNT = exports.ESIGN_APP_LIMITED = exports.ESIGN_DEVICE_NOT_INIT = exports.ESIGN_INVALID_LICENSE_CONTENT = exports.ESIGN_INVALID_LICENSE = exports.ESIGN_DEVICE_ALREADY_INIT = exports.ESIGN_SESSION_INVALID = exports.FETCH_HISTORY_ERROR = exports.QRCODE_ERROR = exports.SMS_OTP_RATE_LIMIT = exports.SMS_OTP_NOT_FOUND = exports.SMS_OTP_MAX_ATTEMPTS = exports.SMS_OTP_INVALID_PHONE = exports.SMS_OTP_ERROR = exports.NFC_CHIP_AUTH_FAILED = exports.NFC_USER_CANCEL = exports.NFC_UNKNOWN_ERROR = exports.NFC_IO_ERROR = exports.NFC_INVALID_MRZ_KEY = exports.NFC_CONNECTION_LOST = exports.NFC_MUTUAL_AUTH_FAILED = exports.C06_ERROR = exports.SCAN_NFC_ENABLE = exports.SCAN_NFC_CHECK = exports.SCAN_NFC_ERROR = exports.HEAD_IS_TURNED_IN_SELFIE = exports.NUDITY_DETECTED_IN_SELFIE = exports.READING_GLASSES_DETECTED_IN_SELFIE = exports.EYEWEAR_DETECTED_IN_SELFIE = exports.FACE_OCCLUDED_IN_SELFIE = exports.FACE_IS_BLURRED = exports.MASK_PRESENT_IN_SELFIE = exports.EYES_CLOSED_IN_SELFIE = exports.MULTIPLE_FACES_IN_SELFIE = exports.LIVENESS_FAIL = exports.LIVENESS_ERROR = exports.FACE_ERROR = exports.FACE_HAT_ERROR = exports.OCR_ERROR = exports.OCR_FONT_BACK_NOT_MATCH = exports.OCR_PHOTOCOPY_ID_CARD = exports.OCR_FAKE_PORTRAIT_DETECTED = exports.OCR_FAKE_CHARACTERS_DETECTED_2 = exports.OCR_FAKE_CHARACTERS_DETECTED_1 = exports.OCR_UNKNOWN_ID_NUMBER_LENGTH = exports.OCR_MODIFIED_BIRTH_DATE_DETECTED_CMND = exports.OCR_MODIFIED_SYMBOL_DETECTED_CMND = exports.OCR_FAKE_BIRTH_DATE_DETECTED_CMND = exports.OCR_FAKE_PORTRAIT_DETECTED_CMND = exports.OCR_FAKE_CHARACTERS_DETECTED_CMND = void 0;
 exports.SDK_NAME = exports.SDK_VERSION = exports.USER_CANCEL = exports.ESIGN_INVALID_PIN_CODE = exports.ESIGN_INVALID_RECOVERY_CODE = exports.ESIGN_INVALID_LICENSE_CODE = exports.ESIGN_INVALID_CONTEXT = exports.ESIGN_MISSING_REQUEST_ID = exports.ESIGN_MISSING_SERIAL = exports.ESIGN_MISSING_IDENTITY = exports.ESIGN_MISSING_ACCESS_TOKEN = exports.ESIGN_NO_SESSION_ID = exports.ESIGN_MISSING_CONFIRMATION_DOC = exports.ESIGN_MISSING_REQUEST_JSON = exports.ESIGN_MISSING_CCCD = exports.ESIGN_MISSING_TOKEN = exports.ESIGN_ERROR_UNKNOWN = exports.ESIGN_AUTH_REQUEST_EXISTS = exports.ESIGN_INVALID_CERT_FOR_AUTH = exports.ESIGN_INVALID_SIGN_COUNT_OR_TIME = exports.ESIGN_AUTH_EXISTS = exports.ESIGN_SESSION_INVALID_LIST_CERT = exports.ESIGN_INVALID_RECOVERY_OR_PIN = exports.ESIGN_SESSION_INVALID_REGISTER = void 0;
+const react_native_1 = require("react-native");
 const EKYCModule_1 = __importStar(require("./EKYCModule"));
 exports.sdkEKYC = EKYCModule_1.default;
 Object.defineProperty(exports, "SDKeKYC", { enumerable: true, get: function () { return EKYCModule_1.SDKeKYC; } });
@@ -47,6 +51,9 @@ Object.defineProperty(exports, "FinosEKYCModule", { enumerable: true, get: funct
 const FinosESignModule_1 = require("./src/modules/FinosESignModule");
 Object.defineProperty(exports, "FinosESign", { enumerable: true, get: function () { return FinosESignModule_1.FinosESign; } });
 Object.defineProperty(exports, "FinosESignModule", { enumerable: true, get: function () { return FinosESignModule_1.FinosESignModule; } });
+const ExitSheetWrapper_1 = __importDefault(require("./src/components/ExitSheetWrapper"));
+// Auto-register exit sheet wrapper — khách hàng không cần khai báo AppRegistry
+react_native_1.AppRegistry.registerComponent('SDKExitSheetWrapper', () => ExitSheetWrapper_1.default);
 console.log('✅ SDK modules loaded successfully');
 // Export main SDK instance and class (legacy)
 exports.default = EKYCModule_1.default;

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.8",
+  "version": "1.5.0",
   "description": "React Native SDK for eKYC - Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, and C06, eSign, SmsOTP residence verification",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/src/components/ExitConfirmSheet.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const ExitConfirmSheet: (props: any) => React.JSX.Element;
+export default ExitConfirmSheet;

package/dist/src/components/ExitConfirmSheet.js

@@ -0,0 +1,164 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const react_1 = __importDefault(require("react"));
+const react_native_1 = require("react-native");
+const FinosEKYCModule_1 = require("../modules/FinosEKYCModule");
+const BellIcon = () => (<react_native_1.View style={styles.bellWrapper}>
+    <react_native_1.View style={styles.bellMount}/>
+    <react_native_1.View style={styles.bellBody}/>
+    <react_native_1.View style={styles.bellSkirt}/>
+    <react_native_1.View style={styles.bellClapper}/>
+  </react_native_1.View>);
+const ExitConfirmSheet = (props) => {
+    const message = props.message || 'Giao dịch bị hủy khi điều hướng sang tính năng tiếp theo. Quý khách có chắc chắn hủy giao dịch?';
+    const confirmText = props.confirmText || 'Đồng ý';
+    const cancelText = props.cancelText || 'Ở lại';
+    const handleConfirm = async () => {
+        await FinosEKYCModule_1.FinosEKYC.resolveExit('CONFIRM');
+    };
+    const handleCancel = async () => {
+        await FinosEKYCModule_1.FinosEKYC.resolveExit('CANCEL');
+    };
+    return (<react_native_1.View style={styles.container} onLayout={(e) => {
+            var _a, _b;
+            const h = e.nativeEvent.layout.height;
+            if (h > 0)
+                (_b = (_a = react_native_1.NativeModules.EKYCModule) === null || _a === void 0 ? void 0 : _a.setExitSheetHeight) === null || _b === void 0 ? void 0 : _b.call(_a, h);
+        }}>
+      <react_native_1.View style={styles.handle}/>
+
+      <react_native_1.View style={styles.content}>
+        <BellIcon />
+        <react_native_1.Text style={styles.message}>{message}</react_native_1.Text>
+      </react_native_1.View>
+
+      <react_native_1.View style={styles.footer}>
+        <react_native_1.TouchableOpacity style={styles.confirmButton} onPress={handleConfirm} activeOpacity={0.8}>
+          <react_native_1.View style={styles.gradientContainer}>
+            <react_native_1.View style={[styles.gradientStep, { backgroundColor: '#E53935' }]}/>
+            <react_native_1.View style={[styles.gradientStep, { backgroundColor: '#EA4F28' }]}/>
+            <react_native_1.View style={[styles.gradientStep, { backgroundColor: '#EF6519' }]}/>
+            <react_native_1.View style={[styles.gradientStep, { backgroundColor: '#F47A0B' }]}/>
+            <react_native_1.View style={[styles.gradientStep, { backgroundColor: '#F98F00' }]}/>
+            <react_native_1.View style={[styles.gradientStep, { backgroundColor: '#FCA300' }]}/>
+            <react_native_1.View style={[styles.gradientStep, { backgroundColor: '#FFB800' }]}/>
+            <react_native_1.View style={[styles.gradientStep, { backgroundColor: '#FFCC00' }]}/>
+            <react_native_1.View style={[styles.gradientStep, { backgroundColor: '#FFD600' }]}/>
+          </react_native_1.View>
+          <react_native_1.Text style={styles.confirmText}>{confirmText}</react_native_1.Text>
+        </react_native_1.TouchableOpacity>
+
+        <react_native_1.TouchableOpacity style={styles.cancelButton} onPress={handleCancel} activeOpacity={0.7}>
+          <react_native_1.Text style={styles.cancelText}>{cancelText}</react_native_1.Text>
+        </react_native_1.TouchableOpacity>
+      </react_native_1.View>
+    </react_native_1.View>);
+};
+const styles = react_native_1.StyleSheet.create({
+    container: {
+        backgroundColor: 'white',
+        paddingHorizontal: 24,
+        paddingBottom: 32,
+        borderTopLeftRadius: 32,
+        borderTopRightRadius: 32,
+    },
+    handle: {
+        width: 40,
+        height: 4,
+        backgroundColor: '#CCCCCC',
+        borderRadius: 2,
+        alignSelf: 'center',
+        marginTop: 12,
+        marginBottom: 20,
+    },
+    content: {
+        alignItems: 'center',
+        marginBottom: 28,
+    },
+    bellWrapper: {
+        alignItems: 'center',
+        width: 72,
+        height: 72,
+        marginBottom: 20,
+    },
+    bellMount: {
+        width: 9,
+        height: 7,
+        borderRadius: 4,
+        backgroundColor: '#E53935',
+        marginTop: 7,
+    },
+    bellBody: {
+        width: 36,
+        height: 34,
+        borderTopLeftRadius: 18,
+        borderTopRightRadius: 18,
+        backgroundColor: '#E53935',
+        marginTop: -1,
+    },
+    bellSkirt: {
+        width: 48,
+        height: 9,
+        borderBottomLeftRadius: 5,
+        borderBottomRightRadius: 5,
+        backgroundColor: '#E53935',
+    },
+    bellClapper: {
+        width: 12,
+        height: 7,
+        borderBottomLeftRadius: 6,
+        borderBottomRightRadius: 6,
+        backgroundColor: '#E53935',
+        marginTop: 2,
+    },
+    message: {
+        fontSize: 15,
+        color: '#1A1A1A',
+        textAlign: 'center',
+        lineHeight: 19.5,
+    },
+    footer: {
+        width: '100%',
+        gap: 12,
+    },
+    confirmButton: {
+        width: '100%',
+        height: 52,
+        borderRadius: 24,
+        alignItems: 'center',
+        justifyContent: 'center',
+        overflow: 'hidden',
+        elevation: 4,
+        shadowColor: '#E53935',
+        shadowOffset: { width: 0, height: 4 },
+        shadowOpacity: 0.3,
+        shadowRadius: 8,
+    },
+    gradientContainer: Object.assign(Object.assign({}, react_native_1.StyleSheet.absoluteFillObject), { flexDirection: 'row' }),
+    gradientStep: {
+        flex: 1,
+    },
+    confirmText: {
+        fontSize: 16,
+        fontWeight: '700',
+        color: '#fff',
+    },
+    cancelButton: {
+        width: '100%',
+        height: 52,
+        borderRadius: 24,
+        borderWidth: 1.5,
+        borderColor: '#CCCCCC',
+        alignItems: 'center',
+        justifyContent: 'center',
+    },
+    cancelText: {
+        fontSize: 16,
+        fontWeight: '600',
+        color: '#555555',
+    },
+});
+exports.default = ExitConfirmSheet;

package/dist/src/components/ExitSheetWrapper.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+/**
+ * Set custom exit sheet component.
+ * Gọi trước khi showRNExitSheet để override default ExitConfirmSheet.
+ */
+export declare function setCustomExitComponent(component: React.ComponentType<any> | null): void;
+/**
+ * Wrapper component được SDK auto-register với tên 'SDKExitSheetWrapper'.
+ * Render custom component nếu được set, fallback về ExitConfirmSheet mặc định.
+ */
+declare const ExitSheetWrapper: (props: any) => React.JSX.Element;
+export default ExitSheetWrapper;

package/dist/src/components/ExitSheetWrapper.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCustomExitComponent = setCustomExitComponent;
+const react_1 = __importDefault(require("react"));
+const ExitConfirmSheet_1 = __importDefault(require("./ExitConfirmSheet"));
+// Module-level variable — set bởi FinosEKYC.setExitSheetComponent()
+let _customComponent = null;
+/**
+ * Set custom exit sheet component.
+ * Gọi trước khi showRNExitSheet để override default ExitConfirmSheet.
+ */
+function setCustomExitComponent(component) {
+    _customComponent = component;
+}
+/**
+ * Wrapper component được SDK auto-register với tên 'SDKExitSheetWrapper'.
+ * Render custom component nếu được set, fallback về ExitConfirmSheet mặc định.
+ */
+const ExitSheetWrapper = (props) => {
+    const Component = _customComponent || ExitConfirmSheet_1.default;
+    return <Component {...props}/>;
+};
+exports.default = ExitSheetWrapper;

package/dist/src/modules/FinosEKYCModule.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { SDK_VERSION, SDK_NAME } from '../../EKYCModule';
 import { NfcConfig } from '../types/ekycNFCType';
 import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError, AppIDType } from '../types/ekycType';
@@ -110,13 +111,31 @@ export declare class FinosEKYCModule {
      */
     resolveExit(action: 'CONFIRM' | 'CANCEL' | 'CLOSE'): Promise<boolean>;
     /**
-     * Show a React Native component as a Bottom Sheet on top of the current activity.
-     * Use this to show a custom RN UI over SDK screens.
+     * Set custom component to render inside the exit bottom sheet.
+     * Thay thế ExitConfirmSheet mặc định bằng component tùy chỉnh.
+     * Không cần AppRegistry — SDK tự lo phần registration.
      *
-     * @param componentName The name registered with AppRegistry.registerComponent
-     * @param props Initial props to pass to the component
+     * @param component React component để hiển thị, hoặc null để về default
+     *
+     * @example
+     * FinosEKYC.setExitSheetComponent(WarningBottomSheet);
+     */
+    setExitSheetComponent(component: React.ComponentType<any> | null): void;
+    /**
+     * Show the exit bottom sheet on top of the current SDK screen.
+     * Mặc định dùng 'SDKExitSheetWrapper' (đã register sẵn trong SDK).
+     *
+     * @param props Props truyền vào component (optional)
+     *
+     * @example
+     * // Dùng default ExitConfirmSheet
+     * FinosEKYC.showRNExitSheet();
+     *
+     * // Dùng custom component (set trước bằng setExitSheetComponent)
+     * FinosEKYC.setExitSheetComponent(WarningBottomSheet);
+     * FinosEKYC.showRNExitSheet();
      */
-    showRNExitSheet(componentName: string, props?: any): Promise<boolean>;
+    showRNExitSheet(props?: any): Promise<boolean>;
     /**
      * Show a native alert dialog on top of the current activity (useful for SDK screens)
      * @param config Dialog configuration { title, message, confirmText, cancelText }

package/dist/src/modules/FinosEKYCModule.js

@@ -38,6 +38,7 @@ const react_native_1 = require("react-native");
 const EKYCModule_1 = __importStar(require("../../EKYCModule"));
 Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return EKYCModule_1.SDK_VERSION; } });
 Object.defineProperty(exports, "SDK_NAME", { enumerable: true, get: function () { return EKYCModule_1.SDK_NAME; } });
+const ExitSheetWrapper_1 = require("../components/ExitSheetWrapper");
 const ekycFlowType_1 = require("../types/ekycFlowType");
 /**
  * Finos eKYC SDK Module
@@ -313,16 +314,36 @@ class FinosEKYCModule {
         }
     }
     /**
-     * Show a React Native component as a Bottom Sheet on top of the current activity.
-     * Use this to show a custom RN UI over SDK screens.
+     * Set custom component to render inside the exit bottom sheet.
+     * Thay thế ExitConfirmSheet mặc định bằng component tùy chỉnh.
+     * Không cần AppRegistry — SDK tự lo phần registration.
      *
-     * @param componentName The name registered with AppRegistry.registerComponent
-     * @param props Initial props to pass to the component
+     * @param component React component để hiển thị, hoặc null để về default
+     *
+     * @example
+     * FinosEKYC.setExitSheetComponent(WarningBottomSheet);
+     */
+    setExitSheetComponent(component) {
+        (0, ExitSheetWrapper_1.setCustomExitComponent)(component);
+    }
+    /**
+     * Show the exit bottom sheet on top of the current SDK screen.
+     * Mặc định dùng 'SDKExitSheetWrapper' (đã register sẵn trong SDK).
+     *
+     * @param props Props truyền vào component (optional)
+     *
+     * @example
+     * // Dùng default ExitConfirmSheet
+     * FinosEKYC.showRNExitSheet();
+     *
+     * // Dùng custom component (set trước bằng setExitSheetComponent)
+     * FinosEKYC.setExitSheetComponent(WarningBottomSheet);
+     * FinosEKYC.showRNExitSheet();
      */
-    async showRNExitSheet(componentName, props = {}) {
+    async showRNExitSheet(props = {}) {
         this.validateSDKReady();
         try {
-            return await this.sdk.showRNExitSheet(componentName, props);
+            return await this.sdk.showRNExitSheet('SDKExitSheetWrapper', props);
         }
         catch (error) {
             console.error('❌ Failed to show RN exit sheet:', error);
@@ -805,7 +826,11 @@ const isMethod = (prop) => {
         prop === 'checkC06' ||
         prop === 'startOcr' ||
         prop === 'startLiveness' ||
-        prop === 'startFaceCompare';
+        prop === 'startFaceCompare' ||
+        prop === 'registerExitHandler' ||
+        prop === 'resolveExit' ||
+        prop === 'showRNExitSheet' ||
+        prop === 'setExitSheetComponent';
 };
 // Create a comprehensive stub object with all methods to prevent undefined errors
 const createFinosEKYCStub = () => {
@@ -835,6 +860,7 @@ const createFinosEKYCStub = () => {
         'startEkycUI', 'sendOtp', 'verifyOtp', 'resendOtp', 'initializeESign', 'openSessionId',
         'registerDevice', 'listCerts', 'verifyCert', 'listSignRequest', 'confirmSign',
         'registerRemoteSigning', 'signPdf', 'sendConfirmationDocument',
+        'registerExitHandler', 'resolveExit', 'showRNExitSheet', 'setExitSheetComponent',
         'onResume', 'onPause', 'isSDKReady', 'getSDKInfo'
     ];
     otherMethods.forEach(method => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.4.8",
+  "version": "1.5.0",
   "description": "React Native SDK for eKYC - Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, and C06, eSign, SmsOTP residence verification",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/components/ExitConfirmSheet.tsx

@@ -0,0 +1,180 @@
+import React from 'react';
+import {
+  View,
+  Text,
+  StyleSheet,
+  TouchableOpacity,
+  NativeModules,
+} from 'react-native';
+import { FinosEKYC } from '../modules/FinosEKYCModule';
+
+const BellIcon = () => (
+  <View style={styles.bellWrapper}>
+    <View style={styles.bellMount} />
+    <View style={styles.bellBody} />
+    <View style={styles.bellSkirt} />
+    <View style={styles.bellClapper} />
+  </View>
+);
+
+const ExitConfirmSheet = (props: any) => {
+  const message = props.message || 'Giao dịch bị hủy khi điều hướng sang tính năng tiếp theo. Quý khách có chắc chắn hủy giao dịch?';
+  const confirmText = props.confirmText || 'Đồng ý';
+  const cancelText = props.cancelText || 'Ở lại';
+
+  const handleConfirm = async () => {
+    await FinosEKYC.resolveExit('CONFIRM');
+  };
+
+  const handleCancel = async () => {
+    await FinosEKYC.resolveExit('CANCEL');
+  };
+
+  return (
+    <View
+      style={styles.container}
+      onLayout={(e) => {
+        const h = e.nativeEvent.layout.height;
+        if (h > 0) NativeModules.EKYCModule?.setExitSheetHeight?.(h);
+      }}
+    >
+      <View style={styles.handle} />
+
+      <View style={styles.content}>
+        <BellIcon />
+        <Text style={styles.message}>{message}</Text>
+      </View>
+
+      <View style={styles.footer}>
+        <TouchableOpacity style={styles.confirmButton} onPress={handleConfirm} activeOpacity={0.8}>
+          <View style={styles.gradientContainer}>
+            <View style={[styles.gradientStep, { backgroundColor: '#E53935' }]} />
+            <View style={[styles.gradientStep, { backgroundColor: '#EA4F28' }]} />
+            <View style={[styles.gradientStep, { backgroundColor: '#EF6519' }]} />
+            <View style={[styles.gradientStep, { backgroundColor: '#F47A0B' }]} />
+            <View style={[styles.gradientStep, { backgroundColor: '#F98F00' }]} />
+            <View style={[styles.gradientStep, { backgroundColor: '#FCA300' }]} />
+            <View style={[styles.gradientStep, { backgroundColor: '#FFB800' }]} />
+            <View style={[styles.gradientStep, { backgroundColor: '#FFCC00' }]} />
+            <View style={[styles.gradientStep, { backgroundColor: '#FFD600' }]} />
+          </View>
+          <Text style={styles.confirmText}>{confirmText}</Text>
+        </TouchableOpacity>
+
+        <TouchableOpacity style={styles.cancelButton} onPress={handleCancel} activeOpacity={0.7}>
+          <Text style={styles.cancelText}>{cancelText}</Text>
+        </TouchableOpacity>
+      </View>
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    backgroundColor: 'white',
+    paddingHorizontal: 24,
+    paddingBottom: 32,
+    borderTopLeftRadius: 32,
+    borderTopRightRadius: 32,
+  },
+  handle: {
+    width: 40,
+    height: 4,
+    backgroundColor: '#CCCCCC',
+    borderRadius: 2,
+    alignSelf: 'center',
+    marginTop: 12,
+    marginBottom: 20,
+  },
+  content: {
+    alignItems: 'center',
+    marginBottom: 28,
+  },
+  bellWrapper: {
+    alignItems: 'center',
+    width: 72,
+    height: 72,
+    marginBottom: 20,
+  },
+  bellMount: {
+    width: 9,
+    height: 7,
+    borderRadius: 4,
+    backgroundColor: '#E53935',
+    marginTop: 7,
+  },
+  bellBody: {
+    width: 36,
+    height: 34,
+    borderTopLeftRadius: 18,
+    borderTopRightRadius: 18,
+    backgroundColor: '#E53935',
+    marginTop: -1,
+  },
+  bellSkirt: {
+    width: 48,
+    height: 9,
+    borderBottomLeftRadius: 5,
+    borderBottomRightRadius: 5,
+    backgroundColor: '#E53935',
+  },
+  bellClapper: {
+    width: 12,
+    height: 7,
+    borderBottomLeftRadius: 6,
+    borderBottomRightRadius: 6,
+    backgroundColor: '#E53935',
+    marginTop: 2,
+  },
+  message: {
+    fontSize: 15,
+    color: '#1A1A1A',
+    textAlign: 'center',
+    lineHeight: 19.5,
+  },
+  footer: {
+    width: '100%',
+    gap: 12,
+  },
+  confirmButton: {
+    width: '100%',
+    height: 52,
+    borderRadius: 24,
+    alignItems: 'center',
+    justifyContent: 'center',
+    overflow: 'hidden',
+    elevation: 4,
+    shadowColor: '#E53935',
+    shadowOffset: { width: 0, height: 4 },
+    shadowOpacity: 0.3,
+    shadowRadius: 8,
+  },
+  gradientContainer: {
+    ...StyleSheet.absoluteFillObject,
+    flexDirection: 'row',
+  },
+  gradientStep: {
+    flex: 1,
+  },
+  confirmText: {
+    fontSize: 16,
+    fontWeight: '700',
+    color: '#fff',
+  },
+  cancelButton: {
+    width: '100%',
+    height: 52,
+    borderRadius: 24,
+    borderWidth: 1.5,
+    borderColor: '#CCCCCC',
+    alignItems: 'center',
+    justifyContent: 'center',
+  },
+  cancelText: {
+    fontSize: 16,
+    fontWeight: '600',
+    color: '#555555',
+  },
+});
+
+export default ExitConfirmSheet;

package/src/components/ExitSheetWrapper.tsx

@@ -0,0 +1,24 @@
+import React from 'react';
+import ExitConfirmSheet from './ExitConfirmSheet';
+
+// Module-level variable — set bởi FinosEKYC.setExitSheetComponent()
+let _customComponent: React.ComponentType<any> | null = null;
+
+/**
+ * Set custom exit sheet component.
+ * Gọi trước khi showRNExitSheet để override default ExitConfirmSheet.
+ */
+export function setCustomExitComponent(component: React.ComponentType<any> | null) {
+  _customComponent = component;
+}
+
+/**
+ * Wrapper component được SDK auto-register với tên 'SDKExitSheetWrapper'.
+ * Render custom component nếu được set, fallback về ExitConfirmSheet mặc định.
+ */
+const ExitSheetWrapper = (props: any) => {
+  const Component = _customComponent || ExitConfirmSheet;
+  return <Component {...props} />;
+};
+
+export default ExitSheetWrapper;

package/src/modules/FinosEKYCModule.ts

@@ -1,5 +1,7 @@
+import React from 'react';
 import { Platform, DeviceEventEmitter } from 'react-native';
 import sdkEKYC, { SDKeKYC, SDK_VERSION, SDK_NAME } from '../../EKYCModule';
+import { setCustomExitComponent } from '../components/ExitSheetWrapper';
 import { NfcConfig, NfcError } from '../types/ekycNFCType';
 import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError, getEkycError, AppIDType } from '../types/ekycType';
 import { C06Config } from '../types/ekycC06Type';
@@ -321,16 +323,37 @@ export class FinosEKYCModule {
     }
 
     /**
-     * Show a React Native component as a Bottom Sheet on top of the current activity.
-     * Use this to show a custom RN UI over SDK screens.
-     * 
-     * @param componentName The name registered with AppRegistry.registerComponent
-     * @param props Initial props to pass to the component
+     * Set custom component to render inside the exit bottom sheet.
+     * Thay thế ExitConfirmSheet mặc định bằng component tùy chỉnh.
+     * Không cần AppRegistry — SDK tự lo phần registration.
+     *
+     * @param component React component để hiển thị, hoặc null để về default
+     *
+     * @example
+     * FinosEKYC.setExitSheetComponent(WarningBottomSheet);
      */
-    public async showRNExitSheet(componentName: string, props: any = {}): Promise<boolean> {
+    public setExitSheetComponent(component: React.ComponentType<any> | null): void {
+        setCustomExitComponent(component);
+    }
+
+    /**
+     * Show the exit bottom sheet on top of the current SDK screen.
+     * Mặc định dùng 'SDKExitSheetWrapper' (đã register sẵn trong SDK).
+     *
+     * @param props Props truyền vào component (optional)
+     *
+     * @example
+     * // Dùng default ExitConfirmSheet
+     * FinosEKYC.showRNExitSheet();
+     *
+     * // Dùng custom component (set trước bằng setExitSheetComponent)
+     * FinosEKYC.setExitSheetComponent(WarningBottomSheet);
+     * FinosEKYC.showRNExitSheet();
+     */
+    public async showRNExitSheet(props: any = {}): Promise<boolean> {
         this.validateSDKReady();
         try {
-            return await this.sdk.showRNExitSheet(componentName, props);
+            return await this.sdk.showRNExitSheet('SDKExitSheetWrapper', props);
         } catch (error) {
             console.error('❌ Failed to show RN exit sheet:', error);
             throw error;
@@ -978,7 +1001,11 @@ const isMethod = (prop: string | symbol): boolean => {
         prop === 'checkC06' ||
         prop === 'startOcr' ||
         prop === 'startLiveness' ||
-        prop === 'startFaceCompare';
+        prop === 'startFaceCompare' ||
+        prop === 'registerExitHandler' ||
+        prop === 'resolveExit' ||
+        prop === 'showRNExitSheet' ||
+        prop === 'setExitSheetComponent';
 };
 
 // Create a comprehensive stub object with all methods to prevent undefined errors
@@ -1012,6 +1039,7 @@ const createFinosEKYCStub = (): FinosEKYCModule => {
         'startEkycUI', 'sendOtp', 'verifyOtp', 'resendOtp', 'initializeESign', 'openSessionId',
         'registerDevice', 'listCerts', 'verifyCert', 'listSignRequest', 'confirmSign',
         'registerRemoteSigning', 'signPdf', 'sendConfirmationDocument',
+        'registerExitHandler', 'resolveExit', 'showRNExitSheet', 'setExitSheetComponent',
         'onResume', 'onPause', 'isSDKReady', 'getSDKInfo'
     ];