@finos_sdk/sdk-ekyc 0.0.31 → 0.0.33

package/dist/EKYCModule.d.ts

@@ -5,10 +5,22 @@ import { C06Config } from './src/types/ekycC06Type';
 import { OcrConfig } from './src/types/ekycOCRType';
 import { LivenessConfig } from './src/types/ekycLivenessType';
 import { FaceServiceConfig } from './src/types/ekycFaceType';
+export declare const SDK_VERSION = "0.0.31";
+export declare const SDK_NAME = "@finos_sdk/sdk-ekyc";
 declare class SDKeKYC {
     private eventEmitter;
     private listeners;
+    private isInitialized;
     constructor();
+    getVersion(): Promise<string>;
+    getSDKInfo(): Promise<{
+        name: string;
+        version: string;
+        buildNumber: string;
+    }>;
+    initSdkEkyc(): Promise<string>;
+    isSDKInitialized(): boolean;
+    private validateConfig;
     startOcr(config: OcrConfig): Promise<SDKEkycResultStringWithEvent>;
     startNfcScan(config: NfcConfig): Promise<SDKEkycResultStringWithEvent>;
     checkC06(config: C06Config): Promise<SDKEkycResultStringWithEvent>;
@@ -28,6 +40,54 @@ declare class SDKeKYC {
     onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void): EmitterSubscription | null;
     onFaceCompareError(callback: (error: any) => void): EmitterSubscription | null;
     removeAllListeners(): void;
+    startEkycUI(appKey: string, flowSDK: string[], language: string, transactionId: string, appKeyConfig: {
+        appKey: string;
+        appKeyNfc: string;
+        appKeyOcr: string;
+        appKeyLiveness: string;
+        appKeyC06: string;
+        appKeyFaceService: string;
+    }, optionConfig?: {
+        baseUrl?: string;
+        countMaxRetry?: number;
+        language?: string;
+    }, styleConfig?: {
+        textSize?: number;
+        textFont?: string;
+        textColor?: number;
+        statusBarBackground?: number;
+        backIcon?: number;
+        titleStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        toolbarStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        instructionStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        errorStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        successStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        warningStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+    }): Promise<any>;
 }
 declare const sdkEKYC: SDKeKYC;
 export { SDKeKYC };

package/dist/EKYCModule.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SDKeKYC = void 0;
+exports.SDKeKYC = exports.SDK_NAME = exports.SDK_VERSION = void 0;
 const react_native_1 = require("react-native");
+// Version information
+exports.SDK_VERSION = '0.0.31';
+exports.SDK_NAME = '@finos_sdk/sdk-ekyc';
 const EKYCNativeModule = react_native_1.NativeModules.EKYCModule;
 // Validate that the module is available
 if (!EKYCNativeModule) {
@@ -13,40 +16,145 @@ if (!EKYCNativeModule) {
         '   - rm -rf android/app/build\n' +
         '   - cd android && ./gradlew clean');
 }
-// Initialize the module
+// Initialize the module with Koin error handling
 try {
     EKYCNativeModule.initSdkEkyc()
         .then(() => console.log("✅ EKYCModule.initSdkEkyc called successfully"))
-        .catch(e => console.warn("❌ Failed to initialize SDK EKYC:", e));
+        .catch(e => {
+        if (e && e.toString().includes('Koin Application has already been started')) {
+            console.log("✅ SDK already initialized (Koin Application started)");
+        }
+        else {
+            console.warn("❌ Failed to initialize SDK EKYC:", e);
+        }
+    });
 }
 catch (e) {
-    console.warn("❌ Exception when calling initSdkEkyc:", e);
+    if (e && e.toString().includes('Koin Application has already been started')) {
+        console.log("✅ SDK already initialized (Koin Application started)");
+    }
+    else {
+        console.warn("❌ Exception when calling initSdkEkyc:", e);
+    }
 }
 class SDKeKYC {
     constructor() {
         this.listeners = [];
+        this.isInitialized = false;
         this.eventEmitter = new react_native_1.NativeEventEmitter(EKYCNativeModule);
     }
+    // SDK Information methods
+    async getVersion() {
+        try {
+            return await EKYCNativeModule.getVersion();
+        }
+        catch (error) {
+            console.warn('Failed to get SDK version:', error);
+            return exports.SDK_VERSION;
+        }
+    }
+    async getSDKInfo() {
+        try {
+            return await EKYCNativeModule.getSDKInfo();
+        }
+        catch (error) {
+            console.warn('Failed to get SDK info:', error);
+            return {
+                name: exports.SDK_NAME,
+                version: exports.SDK_VERSION,
+                buildNumber: '1'
+            };
+        }
+    }
+    // Initialize SDK with better error handling
+    async initSdkEkyc() {
+        try {
+            const result = await EKYCNativeModule.initSdkEkyc();
+            this.isInitialized = true;
+            console.log('✅ SDK EKYC initialized successfully');
+            return result;
+        }
+        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;
+                return 'SDK already initialized (Koin Application started)';
+            }
+            console.error('❌ Failed to initialize SDK EKYC:', error);
+            throw error;
+        }
+    }
+    // Check if SDK is initialized
+    isSDKInitialized() {
+        return this.isInitialized;
+    }
+    // Validate configuration before calling native methods
+    validateConfig(config, requiredFields) {
+        if (!this.isInitialized) {
+            throw new Error('SDK is not initialized. Please call initSdkEkyc() first.');
+        }
+        for (const field of requiredFields) {
+            if (!config[field]) {
+                throw new Error(`Required field '${field}' is missing in configuration`);
+            }
+        }
+    }
     async startOcr(config) {
         var _a;
-        return EKYCNativeModule.startOcr(config.appKey, config.idImagePath, config.expectedDocumentSide, (_a = config.transactionId) !== null && _a !== void 0 ? _a : '');
+        this.validateConfig(config, ['appKey', 'idImagePath', 'expectedDocumentSide', 'transactionId']);
+        try {
+            return await EKYCNativeModule.startOcr(config.appKey, config.idImagePath, config.expectedDocumentSide, (_a = config.transactionId) !== null && _a !== void 0 ? _a : '');
+        }
+        catch (error) {
+            console.error('OCR Error:', error);
+            throw error;
+        }
     }
     // Start NFC scanning
     async startNfcScan(config) {
-        return EKYCNativeModule.startNfcScan(config.appKey, config.documentNumber, config.birthDate, config.expireDate, config.transactionId, config.facePathStorage);
+        this.validateConfig(config, ['appKey', 'documentNumber', 'birthDate', 'expireDate']);
+        try {
+            return await EKYCNativeModule.startNfcScan(config.appKey, config.documentNumber, config.birthDate, config.expireDate, config.transactionId, config.facePathStorage);
+        }
+        catch (error) {
+            console.error('NFC Scan Error:', error);
+            throw error;
+        }
     }
     // Check C06 residence verification
     async checkC06(config) {
         var _a, _b;
-        return EKYCNativeModule.checkC06(config.appKey, config.sod, config.idCardNumber, (_a = config.recentLocation) !== null && _a !== void 0 ? _a : '', (_b = config.transactionId) !== null && _b !== void 0 ? _b : '');
+        this.validateConfig(config, ['appKey', 'sod', 'idCardNumber', 'recentLocation']);
+        try {
+            return await EKYCNativeModule.checkC06(config.appKey, config.sod, config.idCardNumber, (_a = config.recentLocation) !== null && _a !== void 0 ? _a : '', (_b = config.transactionId) !== null && _b !== void 0 ? _b : '');
+        }
+        catch (error) {
+            console.error('C06 Check Error:', error);
+            throw error;
+        }
     }
     async startLiveness(config) {
         var _a;
-        return EKYCNativeModule.startLiveness(config.appKey, config.selfieImage, config.usingRandomAction, (_a = config.transactionId) !== null && _a !== void 0 ? _a : '', config.isStraight);
+        this.validateConfig(config, ['appKey', 'selfieImage', 'transactionId']);
+        try {
+            return await EKYCNativeModule.startLiveness(config.appKey, config.selfieImage, config.usingRandomAction, (_a = config.transactionId) !== null && _a !== void 0 ? _a : '', config.isStraight);
+        }
+        catch (error) {
+            console.error('Liveness Error:', error);
+            throw error;
+        }
     }
     async startFaceCompare(config) {
         var _a;
-        return EKYCNativeModule.startFaceCompare(config.appKey, (_a = config.transactionId) !== null && _a !== void 0 ? _a : '', config.selfieImage, config.idImage);
+        this.validateConfig(config, ['appKey', 'selfieImage', 'idImage']);
+        try {
+            return await EKYCNativeModule.startFaceCompare(config.appKey, (_a = config.transactionId) !== null && _a !== void 0 ? _a : '', config.selfieImage, config.idImage);
+        }
+        catch (error) {
+            console.error('Face Compare Error:', error);
+            throw error;
+        }
     }
     // Lifecycle methods
     onResume() {
@@ -138,6 +246,29 @@ class SDKeKYC {
         this.listeners.forEach(listener => listener.remove());
         this.listeners = [];
     }
+    // SdkEkycUI method
+    async startEkycUI(appKey, flowSDK, language, transactionId, appKeyConfig, optionConfig, styleConfig) {
+        if (!this.isInitialized) {
+            throw new Error('SDK is not initialized. Please call initSdkEkyc() first.');
+        }
+        try {
+            console.log('🚀 Starting SdkEkycUI with flow:', flowSDK);
+            console.log('🔧 OptionConfig:', optionConfig);
+            console.log('🔑 AppKeyConfig:', appKeyConfig);
+            console.log('🎨 StyleConfig:', styleConfig);
+            const flowSDKJson = JSON.stringify(flowSDK);
+            const optionConfigJson = optionConfig ? JSON.stringify(optionConfig) : '{}';
+            const appKeyConfigJson = JSON.stringify(appKeyConfig);
+            const styleConfigJson = styleConfig ? JSON.stringify(styleConfig) : '{}';
+            const result = await EKYCNativeModule.startEkycUI(appKey, flowSDKJson, language, transactionId, optionConfigJson, appKeyConfigJson, styleConfigJson);
+            console.log('✅ SdkEkycUI started successfully');
+            return result;
+        }
+        catch (error) {
+            console.error('❌ SdkEkycUI failed:', error);
+            throw error;
+        }
+    }
 }
 exports.SDKeKYC = SDKeKYC;
 // Create a singleton instance

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-import sdkEKYC, { SDKeKYC } from './EKYCModule';
+import sdkEKYC, { SDKeKYC, SDK_VERSION, SDK_NAME } from './EKYCModule';
+import finosEKYC, { FinosEKYCModule } from './src/modules/FinosEKYCModule';
 export default sdkEKYC;
 export { sdkEKYC, SDKeKYC };
+export { finosEKYC, FinosEKYCModule };
 export type { NfcConfig, NFCData } from './src/types/ekycNFCType';
 export type { C06Config } from './src/types/ekycC06Type';
 export type { OcrConfig } from './src/types/ekycOCRType';
@@ -9,3 +11,4 @@ export type { FaceServiceConfig } from './src/types/ekycFaceType';
 export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent } from './src/types/ekycType';
 export type { NfcError } from './src/types/ekycNFCType';
 export { parseNfcResponse } from './src/utils/utils';
+export { SDK_VERSION, SDK_NAME };

package/dist/index.js

@@ -23,11 +23,16 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseNfcResponse = exports.SDKeKYC = exports.sdkEKYC = void 0;
+exports.SDK_NAME = exports.SDK_VERSION = exports.parseNfcResponse = exports.FinosEKYCModule = exports.finosEKYC = exports.SDKeKYC = exports.sdkEKYC = 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; } });
-// Export main SDK instance and class
+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 FinosEKYCModule_1 = __importStar(require("./src/modules/FinosEKYCModule"));
+exports.finosEKYC = FinosEKYCModule_1.default;
+Object.defineProperty(exports, "FinosEKYCModule", { enumerable: true, get: function () { return FinosEKYCModule_1.FinosEKYCModule; } });
+// Export main SDK instance and class (legacy)
 exports.default = EKYCModule_1.default;
 // Export utility functions
 var utils_1 = require("./src/utils/utils");

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

@@ -0,0 +1,206 @@
+import { SDK_VERSION, SDK_NAME } from '../../EKYCModule';
+import { NfcConfig, NfcError } from '../types/ekycNFCType';
+import { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent } from '../types/ekycType';
+import { C06Config } from '../types/ekycC06Type';
+import { OcrConfig } from '../types/ekycOCRType';
+import { LivenessConfig } from '../types/ekycLivenessType';
+import { FaceServiceConfig } from '../types/ekycFaceType';
+/**
+ * Finos eKYC SDK Module v0.0.31
+ *
+ * A comprehensive React Native module for electronic Know Your Customer (eKYC) operations
+ * including Vietnamese CCCD NFC reading, OCR, Liveness detection, Face matching, and C06 residence verification.
+ *
+ * @version 0.0.31
+ * @author FinOS
+ * @license MIT
+ */
+export declare class FinosEKYCModule {
+    private static instance;
+    private sdk;
+    private isInitialized;
+    private platform;
+    private constructor();
+    /**
+     * Get singleton instance of FinosEKYCModule
+     */
+    static getInstance(): FinosEKYCModule;
+    /**
+     * Get SDK information
+     */
+    getSDKInfo(): Promise<{
+        name: string;
+        version: string;
+        buildNumber: string;
+        platform: string;
+        isInitialized: boolean;
+    }>;
+    /**
+     * Initialize the eKYC SDK
+     * Must be called before using any other methods
+     */
+    initialize(): Promise<string>;
+    /**
+     * Check if SDK is initialized
+     */
+    isSDKReady(): boolean;
+    /**
+     * Start NFC scanning for Vietnamese CCCD
+     * @param config NFC configuration
+     */
+    startNfcScan(config: NfcConfig): Promise<SDKEkycResultStringWithEvent>;
+    /**
+     * Check C06 residence verification
+     * @param config C06 configuration
+     */
+    checkC06(config: C06Config): Promise<SDKEkycResultStringWithEvent>;
+    /**
+     * Start OCR document scanning
+     * @param config OCR configuration
+     */
+    startOCR(config: OcrConfig): Promise<SDKEkycResultStringWithEvent>;
+    /**
+     * Start liveness detection
+     * @param config Liveness configuration
+     */
+    startLiveness(config: LivenessConfig): Promise<SDKEkycResultStringWithEvent>;
+    /**
+     * Start face comparison
+     * @param config Face service configuration
+     */
+    startFaceCompare(config: FaceServiceConfig): Promise<SDKEkycResultStringWithEvent>;
+    /**
+     * Extract NFC data for C06 verification
+     * @param nfcResultJson NFC result JSON string
+     */
+    extractNfcDataForC06(nfcResultJson: string): Promise<any>;
+    /**
+     * Handle app lifecycle - Resume
+     */
+    onResume(): void;
+    /**
+     * Handle app lifecycle - Pause
+     */
+    onPause(): void;
+    /**
+     * Handle new intent (Android)
+     */
+    handleNewIntent(): void;
+    /**
+     * Listen for NFC scan start events
+     */
+    onNfcScanStart(callback: (data: SDKEkycResultWithEvent) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for NFC scan success events
+     */
+    onNfcScanSuccess(callback: (data: SDKEkycResultStringWithEvent) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for NFC error events
+     */
+    onNfcError(callback: (error: NfcError) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for C06 success events
+     */
+    onC06Success(callback: (data: SDKEkycResultWithEvent) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for C06 error events
+     */
+    onC06Error(callback: (error: NfcError) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for OCR success events
+     */
+    onOCRSuccess(callback: (data: SDKEkycResultStringWithEvent) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for OCR error events
+     */
+    onOCRError(callback: (error: any) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for liveness success events
+     */
+    onLivenessSuccess(callback: (data: SDKEkycResultStringWithEvent) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for liveness error events
+     */
+    onLivenessError(callback: (error: any) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for face compare success events
+     */
+    onFaceCompareSuccess(callback: (data: SDKEkycResultWithEvent) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Listen for face compare error events
+     */
+    onFaceCompareError(callback: (error: any) => void): import("react-native").EmitterSubscription | null;
+    /**
+     * Remove all event listeners
+     */
+    removeAllListeners(): void;
+    /**
+     * Start eKYC UI with flow (like MainActivity.kt)
+     * @param appKey Main app key
+     * @param flowSDK Array of SDK types
+     * @param language Language code (vi/en)
+     * @param transactionId Transaction ID
+     * @param optionConfig Optional configuration settings
+     * @param appKeyConfig Optional app key configuration
+     * @param styleConfig Optional style configuration
+     */
+    startEkycUI(appKey: string, flowSDK: string[], language: string, transactionId: string, appKeyConfig: {
+        appKey: string;
+        appKeyNfc: string;
+        appKeyOcr: string;
+        appKeyLiveness: string;
+        appKeyC06: string;
+        appKeyFaceService: string;
+    }, optionConfig?: {
+        baseUrl?: string;
+        countMaxRetry?: number;
+        language?: string;
+    }, styleConfig?: {
+        textSize?: number;
+        textFont?: string;
+        textColor?: number;
+        statusBarBackground?: number;
+        backIcon?: number;
+        titleStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        toolbarStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        instructionStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        errorStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        successStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+        warningStyle?: {
+            textSize?: number;
+            textFont?: string;
+            textColor?: number;
+        };
+    }): Promise<any>;
+    private validateSDKReady;
+    private validatePlatform;
+}
+export declare const FinosEKYC: FinosEKYCModule;
+export type { NfcConfig, NfcError } from '../types/ekycNFCType';
+export type { C06Config } from '../types/ekycC06Type';
+export type { OcrConfig } from '../types/ekycOCRType';
+export type { LivenessConfig } from '../types/ekycLivenessType';
+export type { FaceServiceConfig } from '../types/ekycFaceType';
+export type { SDKEkycResultWithEvent, SDKEkycResultStringWithEvent } from '../types/ekycType';
+export { SDK_VERSION, SDK_NAME };
+export default FinosEKYC;