@finos_sdk/sdk-ekyc 1.5.3 → 1.5.4

package/android/build.gradle

@@ -65,7 +65,7 @@ dependencies {
     implementation 'com.facebook.react:react-android'
 
     // Finos eKYC SDK dependencies from GitHub Packages Maven repository
-    def sdkVersion = "1.5.3"
+    def sdkVersion = "1.5.4"
     implementation("finos.sdk.ekyc:ekyc:$sdkVersion")
     implementation("finos.sdk.ekyc:ekycui:$sdkVersion")
     implementation("finos.sdk.ekyc:nfc:$sdkVersion")

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

@@ -733,10 +733,10 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
 
     @ReactMethod
-    fun initSdkEkyc(promise: Promise) {
-        Log.d(TAG, "▶️ initSdkEkyc() called")
+    fun initSdkEkyc(isProd: Boolean, promise: Promise) {
+        Log.d(TAG, "▶️ initSdkEkyc() called, isProd: $isProd")
         try {
-            eKYCFinOS.initSDKEkyc(reactApplicationContext) {
+            eKYCFinOS.initSDKEkyc(reactApplicationContext, isProd) {
                 Log.d(TAG, "✅ initSdkEkyc() success")
                 val params =
                     Arguments.createMap().apply {
@@ -777,6 +777,36 @@ class EKYCModule(reactContext: ReactApplicationContext) : ReactContextBaseJavaMo
         }
     }
 
+    @ReactMethod
+    fun setEnv(env: String, promise: Promise) {
+        Log.d(TAG, "▶️ setEnv() called with: $env")
+        try {
+            val sdkEnv = when (env.uppercase()) {
+                "PROD" -> finos.sdk.core.constant.SDKEnv.PROD
+                else -> finos.sdk.core.constant.SDKEnv.DEV
+            }
+            eKYCFinOS.setEnv(sdkEnv)
+            Log.d(TAG, "✅ setEnv() success: $sdkEnv")
+            promise.resolve(sdkEnv.name)
+        } catch (e: Exception) {
+            Log.e(TAG, "❌ setEnv() failed: ${e.message}", e)
+            promise.reject("SET_ENV_ERROR", "Failed to set environment: ${e.message}")
+        }
+    }
+
+    @ReactMethod
+    fun getEnv(promise: Promise) {
+        Log.d(TAG, "▶️ getEnv() called")
+        try {
+            val env = eKYCFinOS.getEnv()
+            Log.d(TAG, "✅ getEnv() success: $env")
+            promise.resolve(env.name)
+        } catch (e: Exception) {
+            Log.e(TAG, "❌ getEnv() failed: ${e.message}", e)
+            promise.reject("GET_ENV_ERROR", "Failed to get environment: ${e.message}")
+        }
+    }
+
     @ReactMethod
     fun startNfcScan(
         appKey: String,

package/dist/EKYCModule.d.ts

@@ -22,8 +22,10 @@ declare class SDKeKYC {
         version: string;
         buildNumber: string;
     }>;
-    initSdkEkyc(): Promise<string>;
+    initSdkEkyc(isProd?: boolean): Promise<string>;
     setTransactionId(transactionId: string): Promise<boolean>;
+    setEnv(env: string): Promise<string>;
+    getEnv(): Promise<string>;
     isSDKInitialized(): boolean;
     private ensureNativeModule;
     private validateConfig;

package/dist/EKYCModule.js

@@ -26,29 +26,6 @@ if (!EKYCNativeModule) {
 }
 else {
     console.log('✅ Native module loaded');
-    // Initialize the module with Koin error handling
-    try {
-        EKYCNativeModule.initSdkEkyc()
-            .then(() => {
-            console.log("✅ SDK initialized");
-        })
-            .catch(e => {
-            if (e && e.toString().includes('Koin Application has already been started')) {
-                console.log("✅ SDK already initialized");
-            }
-            else {
-                console.warn("❌ Failed to initialize SDK:", e);
-            }
-        });
-    }
-    catch (e) {
-        if (e && e.toString().includes('Koin Application has already been started')) {
-            console.log("✅ SDK already initialized");
-        }
-        else {
-            console.warn("❌ Exception when initializing SDK:", e);
-        }
-    }
 }
 class SDKeKYC {
     constructor() {
@@ -110,14 +87,14 @@ class SDKeKYC {
         }
     }
     // Initialize SDK with better error handling
-    async initSdkEkyc() {
+    async initSdkEkyc(isProd = false) {
         if (!EKYCNativeModule) {
             const error = 'EKYCModule native module is not available. Please check autolinking.';
             console.error('❌', error);
             throw new Error(error);
         }
         try {
-            const result = await EKYCNativeModule.initSdkEkyc();
+            const result = await EKYCNativeModule.initSdkEkyc(isProd);
             this.isInitialized = true;
             console.log('✅ SDK EKYC initialized successfully');
             return result;
@@ -125,8 +102,13 @@ class SDKeKYC {
         catch (error) {
             // Handle Koin Application already started error
             if (error && error.toString().includes('Koin Application has already been started')) {
-                console.log('✅ SDK already initialized (Koin Application started)');
                 this.isInitialized = true;
+                // Koin can't restart — apply isProd via setEnv so interceptor picks up correct base URL
+                try {
+                    await EKYCNativeModule.setEnv(isProd ? 'PROD' : 'DEV');
+                }
+                catch (_) { }
+                console.log(`✅ SDK already initialized (Koin started) — env set to ${isProd ? 'PROD' : 'DEV'}`);
                 return 'SDK already initialized (Koin Application started)';
             }
             console.error('❌ Failed to initialize SDK EKYC:', error);
@@ -146,6 +128,28 @@ class SDKeKYC {
             throw error;
         }
     }
+    // Set SDK environment (DEV / PROD)
+    async setEnv(env) {
+        const nativeModule = this.ensureNativeModule();
+        try {
+            return await nativeModule.setEnv(env);
+        }
+        catch (error) {
+            console.error('setEnv Error:', error);
+            throw error;
+        }
+    }
+    // Get current SDK environment
+    async getEnv() {
+        const nativeModule = this.ensureNativeModule();
+        try {
+            return await nativeModule.getEnv();
+        }
+        catch (error) {
+            console.error('getEnv Error:', error);
+            throw error;
+        }
+    }
     // Check if SDK is initialized
     isSDKInitialized() {
         return this.isInitialized;

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { SDKFaceDetectStatus, SDK_LIVENESS_ACTIONS, customActionsToStrings } fro
 export type { FaceServiceConfig, FaceCompareSuccessEvent, CheckFaceResponse, FaceVerifyResult } from './src/types/ekycFaceType';
 export { EKYCEvent, EKYCErrorEvent } from './src/types/EKYCEvent';
 export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, StartEkycUIResult, EKYCError } from './src/types/ekycType';
-export { getEkycError, AppIDType } from './src/types/ekycType';
+export { getEkycError, AppIDType, SDKEnv } from './src/types/ekycType';
 export type { NfcError } from './src/types/ekycNFCType';
 export type { OcrError } from './src/types/ekycOCRType';
 export type { LivenessError } from './src/types/ekycLivenessType';

package/dist/index.js

@@ -33,9 +33,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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.SDKEnv = 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_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 = exports.OCR_USE_NEW_ID_DOCUMENT_1 = 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 = exports.ESIGN_APP_LIMITED = 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; } });
@@ -66,6 +66,7 @@ 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; } });
+Object.defineProperty(exports, "SDKEnv", { enumerable: true, get: function () { return ekycType_1.SDKEnv; } });
 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");

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finos_sdk/sdk-ekyc",
-  "version": "1.5.3",
+  "version": "1.5.4",
   "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,6 +1,6 @@
 import { SDK_VERSION, SDK_NAME } from '../../EKYCModule';
 import { NfcConfig } from '../types/ekycNFCType';
-import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError, AppIDType } from '../types/ekycType';
+import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError, AppIDType, SDKEnv } from '../types/ekycType';
 import { C06Config } from '../types/ekycC06Type';
 import { OcrConfig } from '../types/ekycOCRType';
 import { LivenessConfig, SDKFaceDetectStatus, LivenessSuccessEvent } from '../types/ekycLivenessType';
@@ -43,7 +43,7 @@ export declare class FinosEKYCModule {
      * Initialize the eKYC SDK
      * Must be called before using any other methods
      */
-    initialize(): Promise<string>;
+    initialize(isProd?: boolean): Promise<string>;
     /**
      * Check if SDK is initialized
      */
@@ -53,6 +53,16 @@ export declare class FinosEKYCModule {
      * @param transactionId Transaction ID string
      */
     setTransactionId(transactionId: string): Promise<boolean>;
+    /**
+     * Set SDK environment (1.5.4+).
+     * @param env SDKEnv.DEV | SDKEnv.PROD
+     */
+    setEnv(env: SDKEnv): Promise<string>;
+    /**
+     * Get current SDK environment (1.5.4+).
+     * @returns SDKEnv string ("DEV" | "PROD")
+     */
+    getEnv(): Promise<string>;
     /**
      * Start NFC scanning for Vietnamese CCCD
      * @param config NFC configuration
@@ -183,7 +193,7 @@ export declare class FinosEKYCModule {
     /**
      * Initialize eSign SDK
      */
-    initializeESign(): Promise<ESignInitResult>;
+    initializeESign(isProd?: boolean): Promise<ESignInitResult>;
     /**
      * Open eSign Session
      * @param accessToken Access token (JWT)

package/dist/src/modules/FinosEKYCModule.js

@@ -86,7 +86,7 @@ class FinosEKYCModule {
      * Initialize the eKYC SDK
      * Must be called before using any other methods
      */
-    async initialize() {
+    async initialize(isProd = false) {
         try {
             if (this.isInitialized) {
                 console.log('✅ SDK already initialized');
@@ -98,7 +98,7 @@ class FinosEKYCModule {
                 console.log('✅ SDK already initialized on native side');
                 return 'SDK already initialized on native side';
             }
-            const result = await this.sdk.initSdkEkyc();
+            const result = await this.sdk.initSdkEkyc(isProd);
             this.isInitialized = true;
             console.log(`✅ Finos eKYC SDK v${EKYCModule_1.SDK_VERSION} initialized successfully`);
             return result;
@@ -137,6 +137,32 @@ class FinosEKYCModule {
             throw error;
         }
     }
+    /**
+     * Set SDK environment (1.5.4+).
+     * @param env SDKEnv.DEV | SDKEnv.PROD
+     */
+    async setEnv(env) {
+        try {
+            return await this.sdk.setEnv(env);
+        }
+        catch (error) {
+            console.error('❌ setEnv failed:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get current SDK environment (1.5.4+).
+     * @returns SDKEnv string ("DEV" | "PROD")
+     */
+    async getEnv() {
+        try {
+            return await this.sdk.getEnv();
+        }
+        catch (error) {
+            console.error('❌ getEnv failed:', error);
+            throw error;
+        }
+    }
     /**
      * Start NFC scanning for Vietnamese CCCD
      * @param config NFC configuration
@@ -454,11 +480,11 @@ class FinosEKYCModule {
     /**
      * Initialize eSign SDK
      */
-    async initializeESign() {
+    async initializeESign(isProd = false) {
         this.validateSDKReady();
         try {
             console.log('🔐 Initializing eSign SDK...');
-            const result = await this.sdk.initializeESign();
+            const result = await this.sdk.initializeESign(undefined, isProd);
             console.log('✅ eSign SDK initialized successfully');
             return result;
         }
@@ -773,7 +799,7 @@ const createFinosEKYCStub = () => {
     });
     // Add all other methods
     const otherMethods = [
-        'initialize', 'startNfcScan', 'checkC06', 'startOcr', 'startLiveness', 'startFaceCompare',
+        'initialize', 'setEnv', 'getEnv', 'startNfcScan', 'checkC06', 'startOcr', 'startLiveness', 'startFaceCompare',
         'startEkycUI', 'sendOtp', 'verifyOtp', 'resendOtp', 'initializeESign', 'openSessionId',
         'registerDevice', 'listCerts', 'verifyCert', 'listSignRequest', 'confirmSign',
         'registerRemoteSigning', 'signPdf', 'sendConfirmationDocument',

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

@@ -38,7 +38,7 @@ export declare class FinosESignModule {
      * Initialize the eSign SDK
      * Must be called before using any other methods
      */
-    initialize(): Promise<string>;
+    initialize(isProd?: boolean): Promise<string>;
     /**
      * Check if SDK is initialized
      */

package/dist/src/modules/FinosESignModule.js

@@ -85,7 +85,7 @@ class FinosESignModule {
      * Initialize the eSign SDK
      * Must be called before using any other methods
      */
-    async initialize() {
+    async initialize(isProd = false) {
         try {
             if (this.isInitialized) {
                 console.log('✅ SDK already initialized');
@@ -97,7 +97,7 @@ class FinosESignModule {
                 console.log('✅ SDK already initialized on native side');
                 return 'SDK already initialized on native side';
             }
-            const result = await this.sdk.initSdkEkyc();
+            const result = await this.sdk.initSdkEkyc(isProd);
             this.isInitialized = true;
             console.log(`✅ Finos eSign SDK v${EKYCModule_1.SDK_VERSION} initialized successfully`);
             return result;

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

@@ -3,6 +3,14 @@ import { CheckFaceResponse } from "./ekycFaceType";
 import { CheckLivenessResponse } from "./ekycLivenessType";
 import { CheckOcrResponse } from "./ekycOCRType";
 import { SDKTransactionResponse } from "./ekycTransactionType";
+/**
+ * SDKEnv – môi trường hoạt động của SDK (1.5.4+).
+ * Map native: Android SDKEnv.DEV / PROD.
+ */
+export declare enum SDKEnv {
+    DEV = "DEV",
+    PROD = "PROD"
+}
 /**
  * AppIDType – loại app ID truyền vào SDK.
  * Map native: Android AppIDType.NONE / AppIDType.HD_BANK / AppIDType.VIKKI,

package/dist/src/types/ekycType.js

@@ -1,7 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppIDType = void 0;
+exports.AppIDType = exports.SDKEnv = void 0;
 exports.getEkycError = getEkycError;
+/**
+ * SDKEnv – môi trường hoạt động của SDK (1.5.4+).
+ * Map native: Android SDKEnv.DEV / PROD.
+ */
+var SDKEnv;
+(function (SDKEnv) {
+    SDKEnv["DEV"] = "DEV";
+    SDKEnv["PROD"] = "PROD";
+})(SDKEnv || (exports.SDKEnv = SDKEnv = {}));
 /**
  * AppIDType – loại app ID truyền vào SDK.
  * Map native: Android AppIDType.NONE / AppIDType.HD_BANK / AppIDType.VIKKI,

package/package.json

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

@@ -2,7 +2,7 @@ import React from 'react';
 import { Platform, DeviceEventEmitter } from 'react-native';
 import sdkEKYC, { SDKeKYC, SDK_VERSION, SDK_NAME } from '../../EKYCModule';
 import { NfcConfig, NfcError } from '../types/ekycNFCType';
-import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError, getEkycError, AppIDType } from '../types/ekycType';
+import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent, EKYCError, getEkycError, AppIDType, SDKEnv } from '../types/ekycType';
 import { C06Config } from '../types/ekycC06Type';
 import { OcrConfig, OcrError } from '../types/ekycOCRType';
 import { LivenessConfig, SDKFaceDetectStatus, LivenessError, LivenessSuccessEvent } from '../types/ekycLivenessType';
@@ -75,7 +75,7 @@ export class FinosEKYCModule {
      * Initialize the eKYC SDK
      * Must be called before using any other methods
      */
-    public async initialize(): Promise<string> {
+    public async initialize(isProd: boolean = false): Promise<string> {
         try {
             if (this.isInitialized) {
                 console.log('✅ SDK already initialized');
@@ -89,7 +89,7 @@ export class FinosEKYCModule {
                 return 'SDK already initialized on native side';
             }
 
-            const result = await this.sdk.initSdkEkyc();
+            const result = await this.sdk.initSdkEkyc(isProd);
             this.isInitialized = true;
             console.log(`✅ Finos eKYC SDK v${SDK_VERSION} initialized successfully`);
             return result;
@@ -131,6 +131,32 @@ export class FinosEKYCModule {
         }
     }
 
+    /**
+     * Set SDK environment (1.5.4+).
+     * @param env SDKEnv.DEV | SDKEnv.PROD
+     */
+    public async setEnv(env: SDKEnv): Promise<string> {
+        try {
+            return await this.sdk.setEnv(env);
+        } catch (error) {
+            console.error('❌ setEnv failed:', error);
+            throw error;
+        }
+    }
+
+    /**
+     * Get current SDK environment (1.5.4+).
+     * @returns SDKEnv string ("DEV" | "PROD")
+     */
+    public async getEnv(): Promise<string> {
+        try {
+            return await this.sdk.getEnv();
+        } catch (error) {
+            console.error('❌ getEnv failed:', error);
+            throw error;
+        }
+    }
+
     /**
      * Start NFC scanning for Vietnamese CCCD
      * @param config NFC configuration
@@ -486,12 +512,12 @@ export class FinosEKYCModule {
     /**
      * Initialize eSign SDK
      */
-    public async initializeESign(): Promise<ESignInitResult> {
+    public async initializeESign(isProd: boolean = false): Promise<ESignInitResult> {
         this.validateSDKReady();
 
         try {
             console.log('🔐 Initializing eSign SDK...');
-            const result = await this.sdk.initializeESign();
+            const result = await this.sdk.initializeESign(undefined, isProd);
             console.log('✅ eSign SDK initialized successfully');
             return result;
         } catch (error) {
@@ -948,7 +974,7 @@ const createFinosEKYCStub = (): FinosEKYCModule => {
 
     // Add all other methods
     const otherMethods = [
-        'initialize', 'startNfcScan', 'checkC06', 'startOcr', 'startLiveness', 'startFaceCompare',
+        'initialize', 'setEnv', 'getEnv', 'startNfcScan', 'checkC06', 'startOcr', 'startLiveness', 'startFaceCompare',
         'startEkycUI', 'sendOtp', 'verifyOtp', 'resendOtp', 'initializeESign', 'openSessionId',
         'registerDevice', 'listCerts', 'verifyCert', 'listSignRequest', 'confirmSign',
         'registerRemoteSigning', 'signPdf', 'sendConfirmationDocument',

package/src/modules/FinosESignModule.ts

@@ -69,7 +69,7 @@ export class FinosESignModule {
      * Initialize the eSign SDK
      * Must be called before using any other methods
      */
-    public async initialize(): Promise<string> {
+    public async initialize(isProd: boolean = false): Promise<string> {
         try {
             if (this.isInitialized) {
                 console.log('✅ SDK already initialized');
@@ -83,7 +83,7 @@ export class FinosESignModule {
                 return 'SDK already initialized on native side';
             }
 
-            const result = await this.sdk.initSdkEkyc();
+            const result = await this.sdk.initSdkEkyc(isProd);
             this.isInitialized = true;
             console.log(`✅ Finos eSign SDK v${SDK_VERSION} initialized successfully`);
             return result;

package/src/types/ekycType.ts

@@ -4,6 +4,15 @@ import { CheckLivenessResponse } from "./ekycLivenessType";
 import { CheckOcrResponse } from "./ekycOCRType";
 import { SDKTransactionResponse } from "./ekycTransactionType";
 
+/**
+ * SDKEnv – môi trường hoạt động của SDK (1.5.4+).
+ * Map native: Android SDKEnv.DEV / PROD.
+ */
+export enum SDKEnv {
+    DEV = "DEV",
+    PROD = "PROD",
+}
+
 /**
  * AppIDType – loại app ID truyền vào SDK.
  * Map native: Android AppIDType.NONE / AppIDType.HD_BANK / AppIDType.VIKKI,

package/dist/dist/package.json

@@ -1,86 +0,0 @@
-{
-    "name": "@finos_sdk/sdk-ekyc",
-    "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",
-    "files": [
-        "dist",
-        "react-native.config.js",
-        "android/src/main/java",
-        "android/build.gradle",
-        "android/settings.gradle",
-        "android/gradle.properties",
-        "android/gradle/wrapper/**",
-        "android/gradlew",
-        "android/gradlew.bat",
-        "android/consumer-rules.pro",
-        "ios/**",
-        "finos-ekyc-sdk.podspec",
-        "src/**"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/finosvn/finos.ekyc.sdk.git"
-    },
-    "author": "FinOS",
-    "license": "MIT",
-    "bugs": {
-        "url": "https://github.com/finosvn/finos.ekyc.sdk/issues"
-    },
-    "homepage": "https://github.com/finosvn/finos.ekyc.sdk#readme",
-    "keywords": [
-        "react-native",
-        "ekyc",
-        "nfc",
-        "ocr",
-        "liveness",
-        "face-matching",
-        "vietnamese",
-        "cccd",
-        "identity-verification",
-        "finos-sdk",
-        "android",
-        "typescript"
-    ],
-    "scripts": {
-        "clear": "rm -rf node_modules dist package-lock.json && npm cache clean --force && (cd android && ./gradlew clean 2>/dev/null) || true",
-        "npm-install": "npm install",
-        "npm-install-legacy": "npm install --legacy-peer-deps",
-        "build": "tsc && mkdir -p dist && cp package.json dist/",
-        "publish-sdk-local": "npm run build && npm pack",
-        "publish-sdk": "npm run build && npm publish --access public",
-        "publish-sdk-version": "npm run build && npm version patch --force && npm publish --access public"
-    },
-    "peerDependencies": {
-        "react": ">=18.0.0",
-        "react-native": ">=0.70.0"
-    },
-    "dependencies": {
-        "reflect-metadata": "^0.2.1",
-        "tsyringe": "^4.10.0"
-    },
-    "devDependencies": {
-        "@babel/core": "^7.25.2",
-        "@babel/preset-env": "^7.25.3",
-        "@babel/runtime": "^7.25.0",
-        "@react-native-community/cli": "16.0.3",
-        "@react-native/babel-preset": "0.77.0",
-        "@react-native/eslint-config": "0.77.0",
-        "@react-native/metro-config": "0.77.0",
-        "@react-native/typescript-config": "0.77.0",
-        "@types/react": "18.2.6",
-        "@types/react-test-renderer": "18.0.0",
-        "babel-jest": "^29.6.3",
-        "eslint": "^8.19.0",
-        "jest": "^29.6.3",
-        "prettier": "2.8.8",
-        "react": "18.2.0",
-        "react-native": "0.73.0",
-        "react-test-renderer": "18.2.0",
-        "typescript": "^5.0.4"
-    },
-    "engines": {
-        "node": ">=18"
-    }
-}