react-native-kalapa-ekyc 1.1.3 → 1.2.1

package/src/KalapaResult.ts

@@ -0,0 +1,326 @@
+/**
+ * KalapaResult - Simplified and standardized result parser for NFC-only mode
+ * Handles both Android and iOS response formats
+ */
+
+export interface SelfieData {
+  is_matched: boolean;
+  matching_score: number;
+}
+
+export interface NfcData {
+  // Personal Information
+  name: string;
+  id_number: string;
+  old_id_number: string;
+  date_of_birth: string;
+  date_of_expiry: string;
+  date_of_issuance: string;
+  gender: string;
+  nationality: string;
+  nation: string;
+  
+  // Address Information
+  address: string;
+  hometown: string;
+  
+  // Family Information
+  father_name: string;
+  mother_name: string;
+  spouse_name: string;
+  
+  // Additional Information
+  religion: string;
+  personal_identification: string;
+  
+  // Technical Data
+  face_image: string; // Base64 image from NFC chip
+  mrz: string;
+}
+
+export interface AddressEntities {
+  district: string;
+  ward: string;
+  province: string;
+  unknown: string;
+}
+
+export interface MrzDataFields {
+  birthday?: string;
+  doe?: string;
+  gender?: string;
+  id_number?: string;
+  name?: string;
+}
+
+export interface MrzDataError {
+  code: number;
+  message: string;
+}
+
+export interface MrzData {
+  data?: {
+    fields?: MrzDataFields;
+    raw_mrz?: string;
+  };
+  error?: MrzDataError;
+}
+
+export interface QrCodeData {
+  decoded_text?: string;
+  stage?: number;
+}
+
+export interface QrCode {
+  data?: QrCodeData;
+  error?: {
+    code: number;
+    message: string;
+  };
+}
+
+export type DecisionType = 'APPROVED' | 'MANUAL' | 'REJECTED' | 'UNKNOWN';
+
+export class KalapaResult {
+  // Root level common fields
+  public birthday!: string;
+  public country!: string;
+  public decision!: DecisionType;
+  public doe!: string; // Date of expiry
+  public doi!: string; // Date of issuance
+  public ethnicity!: string;
+  public features!: string;
+  public gender!: string;
+  public home!: string;
+  public home_entities!: AddressEntities;
+  public id_number!: string;
+  public mrz_data!: MrzData | null;
+  public name!: string;
+  public national!: string;
+  public nfc_data!: NfcData;
+  public poi!: string;
+  public qr_code!: QrCode | null;
+  public religion!: string;
+  public resident!: string;
+  public resident_entities!: AddressEntities;
+  public selfie_data!: SelfieData;
+  public session!: string;
+  public type!: string;
+  public rawResult: any;
+
+  constructor(rawResult: any) {
+    this.rawResult = rawResult;
+    this._parseResult();
+  }
+
+  private _parseResult(): void {
+    // Handle both wrapped (kalapa_result) and unwrapped responses
+    const kalapaData = this.rawResult?.kalapa_result || this.rawResult || {};
+    
+    // Parse root level common fields
+    this.birthday = kalapaData.birthday || '';
+    this.country = kalapaData.country || '';
+    this.decision = (kalapaData.decision || 'UNKNOWN') as DecisionType;
+    this.doe = kalapaData.doe || '';
+    this.doi = kalapaData.doi || '';
+    this.ethnicity = kalapaData.ethnicity || '';
+    this.features = kalapaData.features || '';
+    this.gender = kalapaData.gender || '';
+    this.home = kalapaData.home || '';
+    this.home_entities = {
+      district: kalapaData.home_entities?.district || '',
+      ward: kalapaData.home_entities?.ward || '',
+      province: kalapaData.home_entities?.province || '',
+      unknown: kalapaData.home_entities?.unknown || ''
+    };
+    // Handle both idNumber (Android) and id_number (iOS)
+    this.id_number = kalapaData.id_number || kalapaData.idNumber || '';
+    this.name = kalapaData.name || '';
+    this.national = kalapaData.national || '';
+    this.poi = kalapaData.poi || '';
+    this.religion = kalapaData.religion || '';
+    this.resident = kalapaData.resident || '';
+    this.resident_entities = {
+      district: kalapaData.resident_entities?.district || '',
+      ward: kalapaData.resident_entities?.ward || '',
+      province: kalapaData.resident_entities?.province || '',
+      unknown: kalapaData.resident_entities?.unknown || ''
+    };
+    this.session = kalapaData.session || '';
+    this.type = kalapaData.type || '';
+    
+    // Parse MRZ data (available on both platforms)
+    const mrzRaw = kalapaData.mrz_data;
+    if (mrzRaw && typeof mrzRaw === 'object' && mrzRaw !== null) {
+      this.mrz_data = {
+        data: mrzRaw.data ? {
+          fields: mrzRaw.data.fields || {},
+          raw_mrz: mrzRaw.data.raw_mrz || ''
+        } : undefined,
+        error: mrzRaw.error ? {
+          code: mrzRaw.error.code || 0,
+          message: mrzRaw.error.message || ''
+        } : undefined
+      };
+    } else {
+      this.mrz_data = null;
+    }
+    
+    // Parse QR code data (available on both platforms)
+    const qrRaw = kalapaData.qr_code;
+    if (qrRaw && typeof qrRaw === 'object' && qrRaw !== null) {
+      this.qr_code = {
+        data: qrRaw.data ? {
+          decoded_text: qrRaw.data.decoded_text || '',
+          stage: qrRaw.data.stage || undefined
+        } : undefined,
+        error: qrRaw.error ? {
+          code: qrRaw.error.code || 0,
+          message: qrRaw.error.message || ''
+        } : undefined
+      };
+    } else {
+      this.qr_code = null;
+    }
+    
+    // Parse selfie data (identical structure on both platforms)
+    const selfieRaw = kalapaData.selfie_data || {};
+    this.selfie_data = {
+      is_matched: selfieRaw.is_matched || false,
+      matching_score: selfieRaw.matching_score || 0
+    };
+    
+    // Parse NFC data (core fields available on both platforms)
+    const nfcRaw = kalapaData.nfc_data || {};
+    this.nfc_data = {
+      // Personal Information
+      name: nfcRaw.name || '',
+      id_number: nfcRaw.id_number || '',
+      old_id_number: nfcRaw.old_id_number || '',
+      date_of_birth: nfcRaw.date_of_birth || '',
+      date_of_expiry: nfcRaw.date_of_expiry || '',
+      date_of_issuance: nfcRaw.date_of_issuance || '',
+      gender: nfcRaw.gender || '',
+      nationality: nfcRaw.nationality || '',
+      nation: nfcRaw.nation || '',
+      
+      // Address Information
+      address: nfcRaw.address || '',
+      hometown: nfcRaw.hometown || '',
+      
+      // Family Information
+      father_name: nfcRaw.father_name || '',
+      mother_name: nfcRaw.mother_name || '',
+      spouse_name: nfcRaw.spouse_name || '',
+      
+      // Additional Information
+      religion: nfcRaw.religion || '',
+      personal_identification: nfcRaw.personal_identification || '',
+      
+      // Technical Data
+      face_image: nfcRaw.face_image || '', // Base64 image from NFC chip
+      mrz: nfcRaw.mrz || '',
+    };
+  }
+
+  // Convenience methods
+  public isApproved(): boolean {
+    return this.decision === 'APPROVED';
+  }
+
+  public isManualReview(): boolean {
+    return this.decision === 'MANUAL';
+  }
+
+  public isRejected(): boolean {
+    return this.decision === 'REJECTED';
+  }
+
+  public isFaceMatched(): boolean {
+    return this.selfie_data.is_matched === true;
+  }
+
+  public getFaceMatchingScore(): number {
+    return this.selfie_data.matching_score;
+  }
+
+  // Get formatted display name
+  public getDisplayName(): string {
+    return this.nfc_data.name || 'N/A';
+  }
+
+  // Get formatted ID number
+  public getIdNumber(): string {
+    return this.nfc_data.id_number || 'N/A';
+  }
+
+  // Get formatted date of birth
+  public getDateOfBirth(): string {
+    return this.nfc_data.date_of_birth || 'N/A';
+  }
+
+  // Get face image (Base64)
+  public getFaceImage(): string {
+    return this.nfc_data.face_image;
+  }
+
+  // Export essential data as plain object
+  public toJSON(): {
+    birthday: string;
+    country: string;
+    decision: DecisionType;
+    doe: string;
+    doi: string;
+    ethnicity: string;
+    features: string;
+    gender: string;
+    home: string;
+    home_entities: AddressEntities;
+    id_number: string;
+    mrz_data: MrzData | null;
+    name: string;
+    national: string;
+    nfc_data: NfcData;
+    poi: string;
+    qr_code: QrCode | null;
+    religion: string;
+    resident: string;
+    resident_entities: AddressEntities;
+    selfie_data: SelfieData;
+    session: string;
+    type: string;
+  } {
+    return {
+      birthday: this.birthday,
+      country: this.country,
+      decision: this.decision,
+      doe: this.doe,
+      doi: this.doi,
+      ethnicity: this.ethnicity,
+      features: this.features,
+      gender: this.gender,
+      home: this.home,
+      home_entities: this.home_entities,
+      id_number: this.id_number,
+      mrz_data: this.mrz_data,
+      name: this.name,
+      national: this.national,
+      nfc_data: this.nfc_data,
+      poi: this.poi,
+      qr_code: this.qr_code,
+      religion: this.religion,
+      resident: this.resident,
+      resident_entities: this.resident_entities,
+      selfie_data: this.selfie_data,
+      session: this.session,
+      type: this.type
+    };
+  }
+
+  // Static factory method to create from raw result
+  public static fromRawResult(rawResult: any): KalapaResult {
+    return new KalapaResult(rawResult);
+  }
+}
+
+export default KalapaResult;

package/src/index.tsx

@@ -1,4 +1,5 @@
 import { NativeModules } from 'react-native';
+import KalapaResult from './KalapaResult';
 
 const { KalapaEkyc } = NativeModules;
 
@@ -23,7 +24,7 @@ interface KalapaResult {
         // Parse the result
         const parsedResult = JSON.parse(result.kalapa_result);
   
-        // Return enhanced result with WebView capability
+        // Return enhanced result with parsed kalapa_result
         return {
           ...result,
           kalapa_result: parsedResult,
@@ -34,4 +35,6 @@ interface KalapaResult {
     }
   };
 
+// Export both the main module and KalapaResult class
+export { KalapaResult };
 export default ExtendedKalapaEkyc;