@finos_sdk/sdk-ekyc 1.5.1 → 1.5.3

package/dist/index.js

@@ -32,14 +32,10 @@ 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");
+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.ExitConfirmGradientOrientation = 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_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 = exports.OCR_USE_NEW_ID_DOCUMENT_2 = 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 = exports.ESIGN_INVALID_USER_ACCOUNT = void 0;
 const EKYCModule_1 = __importStar(require("./EKYCModule"));
 exports.sdkEKYC = EKYCModule_1.default;
 Object.defineProperty(exports, "SDKeKYC", { enumerable: true, get: function () { return EKYCModule_1.SDKeKYC; } });
@@ -51,9 +47,6 @@ 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;
@@ -73,6 +66,8 @@ Object.defineProperty(exports, "EKYCErrorEvent", { enumerable: true, get: functi
 var ekycType_1 = require("./src/types/ekycType");
 Object.defineProperty(exports, "getEkycError", { enumerable: true, get: function () { return ekycType_1.getEkycError; } });
 Object.defineProperty(exports, "AppIDType", { enumerable: true, get: function () { return ekycType_1.AppIDType; } });
+var ekycExitConfirmType_1 = require("./src/types/ekycExitConfirmType");
+Object.defineProperty(exports, "ExitConfirmGradientOrientation", { enumerable: true, get: function () { return ekycExitConfirmType_1.ExitConfirmGradientOrientation; } });
 var ekycESignType_1 = require("./src/types/ekycESignType");
 Object.defineProperty(exports, "AuthorizationStatus", { enumerable: true, get: function () { return ekycESignType_1.AuthorizationStatus; } });
 // Export utility functions

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "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/modules/FinosEKYCModule.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { SDK_VERSION, SDK_NAME } from '../../EKYCModule';
 import { NfcConfig } from '../types/ekycNFCType';
 import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError, AppIDType } from '../types/ekycType';
@@ -6,9 +5,10 @@ import { C06Config } from '../types/ekycC06Type';
 import { OcrConfig } from '../types/ekycOCRType';
 import { LivenessConfig, SDKFaceDetectStatus, LivenessSuccessEvent } from '../types/ekycLivenessType';
 import { FaceServiceConfig, FaceCompareSuccessEvent } from '../types/ekycFaceType';
-import { SmsOtpConfig, SmsOtpResult } from '../types/ekycSmsOtpType';
+import { SmsOtpConfig, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
 import { SDKFlowType } from '../types/ekycFlowType';
+import { ExitConfirmConfig } from '../types/ekycExitConfirmType';
 /**
  * Finos eKYC SDK Module
  *
@@ -77,8 +77,9 @@ export declare class FinosEKYCModule {
      * @param config.customActions - SDKFaceDetectStatus[] enum (LEFT, RIGHT, SMILE, BLINK, ...). Bên sử dụng truyền enum thay vì string
      * @param config.activeActionCount - Number of random actions (1-10), only used when customActions is null (default: 2)
      * @param config.switchFrontCamera - Use front camera (default: false)
+     * @param exitConfirmConfig - Optional config tuỳ chỉnh bottom sheet xác nhận thoát. null = mặc định SDK.
      */
-    startLiveness(config: LivenessConfig): Promise<LivenessSuccessEvent>;
+    startLiveness(config: LivenessConfig, exitConfirmConfig?: ExitConfirmConfig): Promise<LivenessSuccessEvent>;
     /**
      * Start face comparison (Face Service)
      * @param config Face service configuration
@@ -101,51 +102,6 @@ export declare class FinosEKYCModule {
      * Handle new intent (Android)
      */
     handleNewIntent(): void;
-    /**
-     * Register a custom exit confirmation handler to show UI in React Native instead of using native bottom sheet.
-     */
-    registerExitHandler(): Promise<boolean>;
-    /**
-     * Resolve the custom exit confirmation.
-     * @param action 'CONFIRM' (exit SDK), 'CANCEL' or 'CLOSE' (stay in SDK)
-     */
-    resolveExit(action: 'CONFIRM' | 'CANCEL' | 'CLOSE'): Promise<boolean>;
-    /**
-     * 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);
-     */
-    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(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 }
-     */
-    showNativeExitDialog(config: {
-        title?: string;
-        message?: string;
-        confirmText?: string;
-        cancelText?: string;
-    }): Promise<'CONFIRM' | 'CANCEL'>;
     /**
      * Listen for NFC scan start events
      */
@@ -200,11 +156,6 @@ export declare class FinosEKYCModule {
      * Listen for eKYC UI error events
      */
     onEkycUIError(callback: (error: any) => void): import("react-native").EmitterSubscription | null;
-    /**
-     * Listen for exit confirm events triggered by the SDK.
-     * Call resolveExit('CONFIRM' | 'CANCEL' | 'CLOSE') after user chooses an action.
-     */
-    onShowExitConfirm(callback: () => void): import("react-native").EmitterSubscription | null;
     /**
      * Remove all event listeners
      */
@@ -213,20 +164,20 @@ export declare class FinosEKYCModule {
      * Send SMS OTP
      * @param config SMS OTP configuration
      */
-    sendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
+    sendOtp(config: SmsOtpConfig): Promise<SendOtpResponse>;
     /**
      * Verify SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      * @param otpCode OTP code from SMS
      */
-    verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<SmsOtpResult>;
+    verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<VerifyOtpResponse>;
     /**
      * Resend SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      */
-    resendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
-    onSmsOtpSendSuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
-    onSmsOtpResendSuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
+    resendOtp(config: SmsOtpConfig): Promise<ResendOtpResponse>;
+    onSmsOtpSendSuccess(callback: (data: SendOtpResponse) => void): import("react-native").EmitterSubscription | null;
+    onSmsOtpResendSuccess(callback: (data: ResendOtpResponse) => void): import("react-native").EmitterSubscription | null;
     /** Payload là EKYCError: { event, code, message }. */
     onSmsOtpError(callback: (error: EKYCError) => void): import("react-native").EmitterSubscription | null;
     /**
@@ -347,6 +298,8 @@ export declare class FinosEKYCModule {
      * @param appKeyConfig Optional app key configuration
      * @param optionConfig Optional configuration settings (includes switchFrontCamera for camera control)
      * @param styleConfig Optional style configuration
+     * @param exitConfirmConfig Optional config tuỳ chỉnh bottom sheet xác nhận thoát (icon, title, content, buttons).
+     *                          null = giữ default SDK. Xem EXIT_CONFIRM_CONFIG.md.
      */
     startEkycUI(appKey: string, flowSDK: SDKFlowType[], language: string, transactionId: string, appKeyConfig: {
         appKey: string;
@@ -409,7 +362,7 @@ export declare class FinosEKYCModule {
         };
         captureButtonColor?: number;
         captureButtonDisabledColor?: number;
-    }): Promise<any>;
+    }, exitConfirmConfig?: ExitConfirmConfig): Promise<any>;
     private validateSDKReady;
     private validatePlatform;
 }
@@ -422,7 +375,7 @@ export { SDKFaceDetectStatus } from '../types/ekycLivenessType';
 export type { FaceServiceConfig, FaceCompareError } from '../types/ekycFaceType';
 export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError } from '../types/ekycType';
 export { getEkycError, AppIDType } from '../types/ekycType';
-export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
+export type { SmsOtpConfig, SmsOtpResult, SmsOtpError, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult } from '../types/ekycESignType';
 export { SDK_VERSION, SDK_NAME };
 export default FinosEKYC;

package/dist/src/modules/FinosEKYCModule.js

@@ -38,7 +38,6 @@ 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
@@ -199,8 +198,9 @@ class FinosEKYCModule {
      * @param config.customActions - SDKFaceDetectStatus[] enum (LEFT, RIGHT, SMILE, BLINK, ...). Bên sử dụng truyền enum thay vì string
      * @param config.activeActionCount - Number of random actions (1-10), only used when customActions is null (default: 2)
      * @param config.switchFrontCamera - Use front camera (default: false)
+     * @param exitConfirmConfig - Optional config tuỳ chỉnh bottom sheet xác nhận thoát. null = mặc định SDK.
      */
-    async startLiveness(config) {
+    async startLiveness(config, exitConfirmConfig) {
         this.validateSDKReady();
         try {
             console.log('👁️ Starting liveness detection...');
@@ -213,7 +213,10 @@ class FinosEKYCModule {
             else if (config.activeActionCount !== undefined) {
                 console.log('🎲 Random actions count:', config.activeActionCount);
             }
-            const result = await this.sdk.startLiveness(config);
+            if (exitConfirmConfig) {
+                console.log('🚪 ExitConfirmConfig:', exitConfirmConfig);
+            }
+            const result = await this.sdk.startLiveness(config, exitConfirmConfig);
             console.log('✅ Liveness detection completed:', result.event);
             react_native_1.DeviceEventEmitter.emit('onLivenessSuccess', {
                 event: 'LIVENESS_SUCCESS',
@@ -283,87 +286,6 @@ class FinosEKYCModule {
         // Note: This method needs to be implemented in the native module
         console.log('📱 New intent handled');
     }
-    // ==================== Exit Handler ====================
-    /**
-     * Register a custom exit confirmation handler to show UI in React Native instead of using native bottom sheet.
-     */
-    async registerExitHandler() {
-        this.validateSDKReady();
-        try {
-            console.log('🔗 Registering custom exit handler...');
-            return await this.sdk.registerExitHandler();
-        }
-        catch (error) {
-            console.error('❌ Failed to register exit handler:', error);
-            throw error;
-        }
-    }
-    /**
-     * Resolve the custom exit confirmation.
-     * @param action 'CONFIRM' (exit SDK), 'CANCEL' or 'CLOSE' (stay in SDK)
-     */
-    async resolveExit(action) {
-        this.validateSDKReady();
-        try {
-            console.log('🔙 Resolving exit action:', action);
-            return await this.sdk.resolveExit(action);
-        }
-        catch (error) {
-            console.error('❌ Failed to resolve exit:', error);
-            throw error;
-        }
-    }
-    /**
-     * 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);
-     */
-    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(props = {}) {
-        this.validateSDKReady();
-        try {
-            return await this.sdk.showRNExitSheet('SDKExitSheetWrapper', props);
-        }
-        catch (error) {
-            console.error('❌ Failed to show RN exit sheet:', error);
-            throw error;
-        }
-    }
-    /**
-     * Show a native alert dialog on top of the current activity (useful for SDK screens)
-     * @param config Dialog configuration { title, message, confirmText, cancelText }
-     */
-    async showNativeExitDialog(config) {
-        this.validateSDKReady();
-        try {
-            return await this.sdk.showNativeExitDialog(config);
-        }
-        catch (error) {
-            console.error('❌ Failed to show native exit dialog:', error);
-            throw error;
-        }
-    }
     // ==================== Event Listeners ====================
     /**
      * Listen for NFC scan start events
@@ -445,13 +367,6 @@ class FinosEKYCModule {
     onEkycUIError(callback) {
         return this.sdk.onEkycUIError(callback);
     }
-    /**
-     * Listen for exit confirm events triggered by the SDK.
-     * Call resolveExit('CONFIRM' | 'CANCEL' | 'CLOSE') after user chooses an action.
-     */
-    onShowExitConfirm(callback) {
-        return this.sdk.onShowExitConfirm(callback);
-    }
     /**
      * Remove all event listeners
      */
@@ -757,8 +672,10 @@ class FinosEKYCModule {
      * @param appKeyConfig Optional app key configuration
      * @param optionConfig Optional configuration settings (includes switchFrontCamera for camera control)
      * @param styleConfig Optional style configuration
+     * @param exitConfirmConfig Optional config tuỳ chỉnh bottom sheet xác nhận thoát (icon, title, content, buttons).
+     *                          null = giữ default SDK. Xem EXIT_CONFIRM_CONFIG.md.
      */
-    async startEkycUI(appKey, flowSDK, language, transactionId, appKeyConfig, optionConfig, styleConfig) {
+    async startEkycUI(appKey, flowSDK, language, transactionId, appKeyConfig, optionConfig, styleConfig, exitConfirmConfig) {
         this.validateSDKReady();
         try {
             console.log('🚀 Starting eKYC UI with flow:', flowSDK);
@@ -768,7 +685,10 @@ class FinosEKYCModule {
             }
             console.log('🔑 AppKeyConfig:', appKeyConfig);
             console.log('🎨 StyleConfig:', styleConfig);
-            const result = await this.sdk.startEkycUI(appKey, (0, ekycFlowType_1.flowToStrings)(flowSDK), language, transactionId, appKeyConfig, optionConfig, styleConfig);
+            if (exitConfirmConfig) {
+                console.log('🚪 ExitConfirmConfig:', exitConfirmConfig);
+            }
+            const result = await this.sdk.startEkycUI(appKey, (0, ekycFlowType_1.flowToStrings)(flowSDK), language, transactionId, appKeyConfig, optionConfig, styleConfig, exitConfirmConfig);
             console.log('✅ eKYC UI started successfully');
             return result;
         }
@@ -827,10 +747,7 @@ const isMethod = (prop) => {
         prop === 'startOcr' ||
         prop === 'startLiveness' ||
         prop === 'startFaceCompare' ||
-        prop === 'registerExitHandler' ||
-        prop === 'resolveExit' ||
-        prop === 'showRNExitSheet' ||
-        prop === 'setExitSheetComponent';
+        false;
 };
 // Create a comprehensive stub object with all methods to prevent undefined errors
 const createFinosEKYCStub = () => {
@@ -860,7 +777,6 @@ 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/dist/src/modules/FinosESignModule.d.ts

@@ -1,5 +1,5 @@
 import { SDK_VERSION, SDK_NAME } from '../../EKYCModule';
-import { SmsOtpConfig, SmsOtpResult } from '../types/ekycSmsOtpType';
+import { SmsOtpConfig, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 import { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, AuthorizeInfo, ESignPdfResult, ESignApiResponse } from '../types/ekycESignType';
 import { LivenessConfig, LivenessSuccessEvent } from '../types/ekycLivenessType';
 import { FaceServiceConfig, FaceCompareSuccessEvent } from '../types/ekycFaceType';
@@ -47,21 +47,21 @@ export declare class FinosESignModule {
      * Send SMS OTP
      * @param config SMS OTP configuration
      */
-    sendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
+    sendOtp(config: SmsOtpConfig): Promise<SendOtpResponse>;
     /**
      * Verify SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      * @param otpCode OTP code from SMS
      */
-    verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<SmsOtpResult>;
+    verifyOtp(config: SmsOtpConfig, otpCode: string): Promise<VerifyOtpResponse>;
     /**
      * Resend SMS OTP
      * @param config SMS OTP configuration (must include requestId)
      */
-    resendOtp(config: SmsOtpConfig): Promise<SmsOtpResult>;
-    onSmsOtpSendSuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
-    onSmsOtpVerifySuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
-    onSmsOtpResendSuccess(callback: (data: SmsOtpResult) => void): import("react-native").EmitterSubscription | null;
+    resendOtp(config: SmsOtpConfig): Promise<ResendOtpResponse>;
+    onSmsOtpSendSuccess(callback: (data: SendOtpResponse) => void): import("react-native").EmitterSubscription | null;
+    onSmsOtpVerifySuccess(callback: (data: VerifyOtpResponse) => void): import("react-native").EmitterSubscription | null;
+    onSmsOtpResendSuccess(callback: (data: ResendOtpResponse) => void): import("react-native").EmitterSubscription | null;
     /** Payload là EKYCError: { event, code, message }. */
     onSmsOtpError(callback: (error: EKYCError) => void): import("react-native").EmitterSubscription | null;
     /**
@@ -329,7 +329,7 @@ export declare class FinosESignModule {
     private validateSDKReady;
 }
 export declare const FinosESign: FinosESignModule;
-export type { SmsOtpConfig, SmsOtpResult, SmsOtpError } from '../types/ekycSmsOtpType';
+export type { SmsOtpConfig, SmsOtpResult, SmsOtpError, SendOtpResponse, VerifyOtpResponse, ResendOtpResponse } from '../types/ekycSmsOtpType';
 export type { ESignInitResult, ESignOpenSessionResult, ESignCertificate, ESignSignRequest, ESignError, ESignAuthenticateResult, AuthorizeInfo, ESignApiResponse } from '../types/ekycESignType';
 export type { LivenessConfig, LivenessError } from '../types/ekycLivenessType';
 export { SDKFaceDetectStatus } from '../types/ekycLivenessType';

package/dist/src/types/ekycExitConfirmType.d.ts

@@ -0,0 +1,115 @@
+/**
+ * ExitConfirmConfig — bottom sheet xác nhận thoát khi user nhấn back trong liveness.
+ * Map 1-1 với native ExitConfirmConfig (sdkcore 1.5.2+).
+ *
+ * Mọi field đều optional — null/undefined = giữ giá trị mặc định của SDK.
+ * Xem EXIT_CONFIRM_CONFIG.md để biết chi tiết và giá trị mặc định.
+ */
+/** Hướng gradient cho ViewStyle.backgroundGradient*. Map android.graphics.drawable.GradientDrawable.Orientation. */
+export declare enum ExitConfirmGradientOrientation {
+    LEFT_RIGHT = "LEFT_RIGHT",
+    RIGHT_LEFT = "RIGHT_LEFT",
+    TOP_BOTTOM = "TOP_BOTTOM",
+    BOTTOM_TOP = "BOTTOM_TOP",
+    TL_BR = "TL_BR",
+    TR_BL = "TR_BL",
+    BL_TR = "BL_TR",
+    BR_TL = "BR_TL"
+}
+/** Text style cho title/content/button label. */
+export interface ExitConfirmTextStyles {
+    /** Hex màu chữ, vd "#1A1A1A" hoặc "#FF1A1A1A". */
+    textColor?: string;
+    /** Cỡ chữ đơn vị sp. */
+    textSize?: number;
+    /** Tên font resource trong res/font/, vd "inter_medium". */
+    textFont?: string;
+    /** 0 Normal · 1 Bold · 2 Italic · 3 Bold+Italic. */
+    textStyle?: number;
+    /** android.view.Gravity flag, vd Gravity.CENTER = 17. */
+    textAlign?: number;
+}
+/** View style cho background, kích thước, margin, padding, bo góc của container/button. */
+export interface ExitConfirmViewStyle {
+    /** Hex màu nền. Bị bỏ qua nếu set gradient. */
+    backgroundColor?: string;
+    /** Tối thiểu 2 màu hex cho gradient. */
+    backgroundGradientColors?: string[];
+    /**
+     * Vị trí [0.0–1.0] tương ứng từng màu (Android 10+).
+     * null = phân bổ đều. Bắt buộc cùng size với backgroundGradientColors.
+     */
+    backgroundGradientPositions?: number[];
+    /** Hướng gradient. Mặc định LEFT_RIGHT. */
+    backgroundGradientOrientation?: ExitConfirmGradientOrientation;
+    /** dp — null = giữ constraint layout. */
+    width?: number;
+    /** dp. */
+    height?: number;
+    marginTop?: number;
+    marginBottom?: number;
+    marginStart?: number;
+    marginEnd?: number;
+    paddingTop?: number;
+    paddingBottom?: number;
+    paddingStart?: number;
+    paddingEnd?: number;
+    /** android.view.Gravity flag cho nội dung bên trong. */
+    gravity?: number;
+    /** Bo góc dp. 100f = pill shape. */
+    cornerRadius?: number;
+}
+/**
+ * Icon phía trên bottom sheet.
+ * Native field `icon: Int?` là R.drawable resource ID — RN không truy cập trực tiếp được.
+ * Truyền `iconResName` (vd "ic_warning") để native resolve qua getIdentifier().
+ * Bỏ qua / null = dùng icon mặc định SDK (ic_bell).
+ */
+export interface ExitConfirmIconProps {
+    /** Tên drawable resource trong res/drawable/. null/omitted = icon mặc định SDK. */
+    iconResName?: string;
+    iconViewStyle?: ExitConfirmViewStyle;
+}
+export interface ExitConfirmTitleProps {
+    title?: string;
+    titleStyles?: ExitConfirmTextStyles;
+}
+export interface ExitConfirmContentProps {
+    content?: string;
+    contentStyles?: ExitConfirmTextStyles;
+}
+export interface ExitConfirmButtonProps {
+    buttonTitle?: string;
+    buttonTextStyles?: ExitConfirmTextStyles;
+    buttonStyles?: ExitConfirmViewStyle;
+}
+/**
+ * Config bottom sheet xác nhận thoát. Truyền vào FinosEKYC.startEkycUI / startLiveness.
+ * Mọi field optional — null = SDK default.
+ *
+ * @example
+ * exitConfirmConfig: {
+ *   titleProps: { title: "Thông báo" },
+ *   contentProps: { content: "Quý khách muốn thoát?" },
+ *   confirmButtonProps: {
+ *     buttonTitle: "Có",
+ *     buttonStyles: {
+ *       backgroundGradientColors: ["#DA2128", "#F9A61C", "#FFDD00"],
+ *       cornerRadius: 100,
+ *     },
+ *   },
+ *   cancelButtonProps: {
+ *     buttonTitle: "Không",
+ *     buttonStyles: { backgroundColor: "#F3F4F6", cornerRadius: 100 },
+ *   },
+ * }
+ */
+export interface ExitConfirmConfig {
+    iconProps?: ExitConfirmIconProps;
+    titleProps?: ExitConfirmTitleProps;
+    contentProps?: ExitConfirmContentProps;
+    /** Nút xác nhận thoát (vd "Có") — chỉ nút này mới trigger callback thoát SDK. */
+    confirmButtonProps?: ExitConfirmButtonProps;
+    /** Nút huỷ (vd "Không") — đóng sheet, ở lại SDK. */
+    cancelButtonProps?: ExitConfirmButtonProps;
+}

package/dist/src/types/ekycExitConfirmType.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * ExitConfirmConfig — bottom sheet xác nhận thoát khi user nhấn back trong liveness.
+ * Map 1-1 với native ExitConfirmConfig (sdkcore 1.5.2+).
+ *
+ * Mọi field đều optional — null/undefined = giữ giá trị mặc định của SDK.
+ * Xem EXIT_CONFIRM_CONFIG.md để biết chi tiết và giá trị mặc định.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExitConfirmGradientOrientation = void 0;
+/** Hướng gradient cho ViewStyle.backgroundGradient*. Map android.graphics.drawable.GradientDrawable.Orientation. */
+var ExitConfirmGradientOrientation;
+(function (ExitConfirmGradientOrientation) {
+    ExitConfirmGradientOrientation["LEFT_RIGHT"] = "LEFT_RIGHT";
+    ExitConfirmGradientOrientation["RIGHT_LEFT"] = "RIGHT_LEFT";
+    ExitConfirmGradientOrientation["TOP_BOTTOM"] = "TOP_BOTTOM";
+    ExitConfirmGradientOrientation["BOTTOM_TOP"] = "BOTTOM_TOP";
+    ExitConfirmGradientOrientation["TL_BR"] = "TL_BR";
+    ExitConfirmGradientOrientation["TR_BL"] = "TR_BL";
+    ExitConfirmGradientOrientation["BL_TR"] = "BL_TR";
+    ExitConfirmGradientOrientation["BR_TL"] = "BR_TL";
+})(ExitConfirmGradientOrientation || (exports.ExitConfirmGradientOrientation = ExitConfirmGradientOrientation = {}));

package/dist/src/types/ekycSmsOtpType.d.ts

@@ -26,16 +26,10 @@ export interface SmsOtpConfig {
 /** SMS OTP error – dùng chung EKYCError (event, code, message). */
 export type SmsOtpError = import('./ekycType').EKYCError;
 /**
- * SMS OTP Success Result
+ * @deprecated Use SendOtpResponse, VerifyOtpResponse, or ResendOtpResponse instead.
  */
 export interface SmsOtpResult {
-    /**
-     * Event type
-     */
     event: string;
-    /**
-     * Response data
-     */
     data?: {
         requestId?: string;
         expiresIn?: string;
@@ -43,3 +37,30 @@ export interface SmsOtpResult {
         [key: string]: any;
     };
 }
+interface BaseOtpResponse {
+    success?: boolean;
+    requestId?: string;
+    expiresIn?: number;
+    resendAfter?: number;
+    error?: string;
+}
+export interface SendOtpResponse extends BaseOtpResponse {
+}
+export interface VerifyOtpResponse {
+    success?: boolean;
+    verified?: boolean;
+    verifiedAt?: string;
+    attemptsRemaining?: number;
+    error?: string;
+}
+export interface ResendOtpResponse extends BaseOtpResponse {
+    attemptsRemaining?: number;
+    statusCode?: number;
+    errorCode?: string;
+    message?: string;
+    retryAfter?: number;
+    retryAt?: string;
+    cooldownSeconds?: number;
+    elapsedSeconds?: number;
+}
+export {};

package/ios/.xcode.env.local

@@ -0,0 +1,2 @@
+export NODE_BINARY=/opt/homebrew/bin/node
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.5.1",
+  "version": "1.5.3",
   "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",