@sanctum-key/react-native-sdk 1.0.23 → 1.0.25

package/src/modules/api/KYCService.ts

@@ -1,7 +1,7 @@
 import axios from 'axios';
 import { GovernmentDocumentType, GovernmentDocumentTypeShorted, OrientationVideoResponse } from '../../types/KYC.types';
 import { CheckTemplateTypeResponse } from '../../components/OverLay/type';
-import { SessionResponse, VerificationResult, VerificationSessionRequest } from './types';
+import { SessionResponse, VerificationSessionRequest } from './types';
 import { KycEnvironment } from '../../types/env.types';
 import { logger } from '../../utils/logger';
 import { Platform } from 'react-native';
@@ -17,6 +17,22 @@ const appendFileToFormData = async (formData: FormData, key: string, uri: string
   }
 };
 
+const documentTypeMap: Record<string, string> = {
+  passport: "passport",
+  driversLicense: "driving_licence",
+  healthInsuranceCard: "health_insurance_card",
+  residencePermit: "permanent_residence_card",
+  identityCard: "identity_card",
+
+  nationalId: "identity_card",          // We saw this in your earlier logs!
+  national_id: "identity_card",
+  
+  drivers_licence: "driving_licence",   // Plural 'drivers' to singular 'driving'
+  drivers_license: "driving_licence",   // American spelling 'license'
+  driving_license: "driving_licence",   // American spelling 'license'
+  permanent_residence: "permanent_residence_card", // Missing the word 'card'
+};
+
 let cachedToken: string | null = null;
 let tokenExpiryTime: number | null = null;
 let activeAuthRequest: Promise<string> | null = null; 
@@ -63,15 +79,9 @@ export class KYCService {
   private faceServiceURL = 'https://face-infera.sanctumkey.com';
   private textExtractionServiceURL = 'https://text-infera.sanctumkey.com';
   private mrzServiceURL = 'https://mrz-infera.sanctumkey.com';
-  private barcodeServiceURL = 'https://kyc-engine.SanctumKey.net';
+  private barcodeServiceURL = 'https://face-infera.sanctumkey.com';
   private orientationServiceURL = 'http://18.188.180.154:8080';
 
-  // private faceServiceURL = 'https://kyc-engine.transfergratis.net:8000';
-  // private textExtractionServiceURL = 'https://kyc-engine.transfergratis.net:8006';
-  // private mrzServiceURL = 'https://kyc-engine.transfergratis.net:8002';
-  // private barcodeServiceURL = 'https://kyc-engine.transfergratis.net:8000';
-  // private orientationServiceURL = 'http://18.188.180.154:8080';
-
   constructor(baseURL: string, apiKey: string) {
     this.baseURL = baseURL;
     this.apiKey = apiKey;
@@ -288,7 +298,7 @@ export class KYCService {
       docRegion: string; 
       token: string; 
       postfix: string;
-      issuingSubdivision?: string; // 🚨 Added parameter
+      issuingSubdivision?: string; 
     }, 
     env: KycEnvironment = 'PRODUCTION'
   ): Promise<any> {
@@ -304,7 +314,6 @@ export class KYCService {
       };
     }
 
-    // 🚨 Destructure issuingSubdivision
     const { fileUri, docType, docRegion, token, postfix, issuingSubdivision } = params;
     const formData = new FormData();
     
@@ -315,7 +324,6 @@ export class KYCService {
     // Build the base URL
     let url = `${this.mrzServiceURL}/get_template_version/?doc_type=${encodeURIComponent(docTypeShorted)}&doc_region=${encodeURIComponent(docRegion)}&postfix=${postfix}`;
 
-    // 🚨 Append the subdivision strictly for Canada/regional docs
     if (issuingSubdivision) {
       url += `&issuing_subdivision=${encodeURIComponent(issuingSubdivision)}`;
     }
@@ -339,8 +347,8 @@ export class KYCService {
     fileUri: string; 
     docType: string; 
     docRegion: string; 
-    templatePath: string; // 🚨 Required by API
-    issuingSubdivision?: string; // 🚨 Required for non-passports
+    templatePath: string; 
+    issuingSubdivision?: string;
     token: string; 
     postfix?: string 
   }): Promise<any> {
@@ -348,19 +356,18 @@ export class KYCService {
     
     // 1. Prepare Form Data
     const formData = new FormData();
-    // Prefixing with 'front' or 'back' as strictly required by the docs
     await appendFileToFormData(formData, 'file', fileUri, `id_card_${postfix}.jpg`, 'image/jpeg');
 
-    // 2. Build the URL with ALL required parameters
-    let queryParams = `doc_type=${encodeURIComponent(docType)}&doc_region=${encodeURIComponent(docRegion)}&template_path=${encodeURIComponent(templatePath)}`;
+    let queryParams = `doc_type=${encodeURIComponent(docType)}&doc_region=${encodeURIComponent(docRegion)}&template_path=${encodeURIComponent(templatePath)}&postfix=${postfix}&cleaned=true`;
+    
     if (issuingSubdivision) {
       queryParams += `&issuing_subdivision=${encodeURIComponent(issuingSubdivision)}`;
     }
+    logger.log(`URL PARAMS: ${queryParams}`)
     
     const url = `${this.textExtractionServiceURL}/extract_doc_information/?${queryParams}`;
 
     try {
-      // 3. Start the Job
       const startRes = await axios.post(url, formData, {
         headers: { 'Content-Type': 'multipart/form-data', 'Authorization': `Bearer ${token}` },
         timeout: 60000,
@@ -388,14 +395,13 @@ export class KYCService {
 
         if (statusData.status === 'completed') {
           logger.log('Extraction completed successfully', JSON.stringify(truncateFields(statusData.result)));
-          return statusData.result; // 👈 Returns the actual extracted data
+          return statusData.result; 
         }
 
         if (statusData.status === 'failed') {
           throw new Error(statusData.error || "Document extraction failed during processing.");
         }
 
-        // If 'processing', loop continues...
       }
 
       throw new Error("Document extraction timed out waiting for results.");
@@ -407,8 +413,7 @@ export class KYCService {
     }
   }
 
-  // STEP 2 - barcode extraction
-  async extractBarcode(params: { fileUri: string; token: string; postfix?: string }, env: KycEnvironment = 'PRODUCTION'): Promise<any> {
+  async extractBarcode(params: { fileUri: string; token: string; docType: string; postfix?: string }, env: KycEnvironment = 'PRODUCTION'): Promise<any> {
     // SANDBOX mode
     if (env === 'SANDBOX') {
       console.log("SANDBOX mode: Skipping AI barcode extraction");
@@ -419,35 +424,85 @@ export class KYCService {
       };
     }
 
-    const { fileUri, token, postfix = 'back' } = params;
+    const { fileUri, token, docType, postfix = 'back' } = params;
+    logger.log(docType)
     const formData = new FormData();
     
-    // ✅ FIX: Dynamic filename
-    await appendFileToFormData(formData, 'file', fileUri, `id_card_${postfix}.jpg`, 'image/jpeg');
+    await appendFileToFormData(formData, 'file', fileUri, `id_${postfix}_photo.jpg`, 'image/jpeg');
+
+    const url = `${this.barcodeServiceURL}/decode_barcode/?doc_type=${encodeURIComponent(docType)}`;
 
-    const url = `${this.barcodeServiceURL}/decode_barcode/`;
     const attempt = async () => {
       try {
         const res = await axios.post(url, formData, {
-          headers: { 'Content-Type': 'multipart/form-data', 'Authorization': `Bearer ${token}`, },
+          headers: { 'Content-Type': 'multipart/form-data', 'Authorization': `Bearer ${token}` },
           timeout: 60000,
         });
-        logger.log('extractBarcode res', JSON.stringify(res.data, null, 2));
-        if (Object.keys(res.data).length === 0) throw new Error('No data found');
+        
+        logger.log('📦 Raw extractBarcode response:', JSON.stringify(res.data, null, 2));
+        
+        
         return res.data;
       } catch (e: any) {
-        throw new Error(e?.message || 'Erreur de détection du barcode');
+        throw new Error(e?.message || 'Erreur de détection du code-barres');
       }
     };
+
     try {
       return await attempt();
     } catch (e) {
-      logger.error('Error extracting Barcode text:', JSON.stringify(e));
+      logger.error('❌ Error extracting Barcode text:', JSON.stringify(e));
       throw e;
     }
   }
 
-  // STEP 3 - MRZ TEXT EXTRACTION
+  async formatBarcodeData(params: { textInput: string; token: string }, env: KycEnvironment = 'PRODUCTION'): Promise<any> {
+    // SANDBOX mode
+    if (env === 'SANDBOX') {
+      console.log("SANDBOX mode: Skipping AI barcode formatting");
+      logger.log("SANDBOX mode: Returning mock formatted barcode response");
+      return {
+        barcode_type: "SANDBOX_MOCK",
+        first_name: "JOHN",
+        last_name: "DOE",
+        card_number: "000000000000"
+      };
+    }
+
+    const { textInput, token } = params;
+    
+    const formData = new URLSearchParams();
+    formData.append('text_input', textInput);
+
+    const url = `${this.barcodeServiceURL}/format_barcode_data/`;
+
+    const attempt = async () => {
+      try {
+        const res = await axios.post(url, formData.toString(), {
+          headers: { 
+            'Content-Type': 'application/x-www-form-urlencoded', 
+            'Authorization': `Bearer ${token}` 
+          },
+          timeout: 60000,
+        });
+        
+        logger.log('📦 Raw formatBarcodeData response:', JSON.stringify(res.data, null, 2));
+        
+        return res.data;
+      } catch (e: any) {
+        throw new Error(e?.message || 'Erreur de formatage du code-barres');
+      }
+    };
+
+    try {
+      return await attempt();
+    } catch (e) {
+      logger.error('❌ Error formatting Barcode text:', JSON.stringify(e));
+      throw e;
+    }
+  }
+
+
   async extractMrzText(
     params: {
       fileUri: string;
@@ -500,8 +555,6 @@ export class KYCService {
      let response;
 
      if (Platform.OS === 'web') {
-         // 🚨 THE FIX: Completely bypass React Native Web's networking polyfills.
-         // We explicitly grab the browser's native APIs so the bundler cannot interfere.
          const nativeFetch = window.fetch;
          const NativeFormData = window.FormData;
 
@@ -642,57 +695,127 @@ export class KYCService {
     }
   }
 
+
   async verificationSession(payload: VerificationSessionRequest): Promise<any> {
-    try {
-      const { session_id, step, data, templateId, action, apiKey } = payload;
-      
-      // 1. Safe Auth Resolution
-      const token = apiKey ? undefined : await authentification();
-      
-      if (!apiKey && !token) {
-         throw new Error("Authentication failed: No API key or Token available.");
-      }
+  try {
+    const { session_id, step, data, templateId, action, apiKey } = payload;
+    const token = apiKey ? undefined : await authentification();
+
+    if (!apiKey && !token) {
+      throw new Error("Authentication failed: No API key or Token available.");
+    }
 
+    // 1. Original Shallow Clone (Preserves file paths perfectly)
+    const normalizedData = { ...data };
 
-      const payloadData = {
-        action: action,
-        data: {
-          ...data, 
-          step: step,
-          templateId: templateId,
-          ...(action === "location_permission" ? { permissionGranted: true } : {}),
-        },
-        session_id: session_id,
-        timestamp: new Date().toISOString(),
+    logger.log("🔍 [DocType Check] Raw incoming data.metadata.document_type:", normalizedData?.metadata?.document_type);
+    logger.log("🔍 [DocType Check] Raw incoming data.documentType:", normalizedData?.documentType);
+
+    // Enhanced fallback to guarantee we find the document type
+    const rawDocType = 
+      normalizedData?.metadata?.document_type || 
+      normalizedData?.documentType || 
+      normalizedData?.documents?.documentType;
+
+    if (rawDocType) {
+      const originalDocType = rawDocType;
+      const mappedDocType = documentTypeMap[originalDocType] ?? originalDocType;
+
+      normalizedData.metadata = {
+        ...normalizedData.metadata,
+        document_type: mappedDocType,
       };
+      
+      normalizedData.documentType = mappedDocType;
 
-      const url = `${KYCConfig.getBackendUrl()}/verification/api/kyc/sessions/${session_id}/steps/${step}/`;
+      if (normalizedData.documents) {
+        normalizedData.documents = {
+          ...normalizedData.documents,
+          documentType: mappedDocType
+        };
 
-      // 3. Clean Logging
-      const logPayload = truncateFields({ payloadData, session_id, step });
-      logger.log('verificationSession payload', JSON.stringify({ 
-          url,
-          apiKey: apiKey ? '***HIDDEN***' : 'None', // Don't log the raw API key!
-          token: token ? '***HIDDEN***' : 'None',
-          payload: logPayload 
-      }, null, 2));
+        const isSingleSided = ['passport', 'visa'].includes(mappedDocType.toLowerCase());
+        if (isSingleSided && !normalizedData.documents.back) {
+          normalizedData.documents.back = {}; 
+        }
 
-      // 4. API Execution
-      const res = await axios.post<SessionResponse>(url, payloadData, {
-          headers: {
-            'Content-Type': 'application/json',
-            ...(apiKey ? { 'Authorization': `ApiKey ${apiKey}` } : { 'Authorization': `Bearer ${token}` })
+        if (normalizedData.documents.front?.mrz && typeof normalizedData.documents.front.mrz === 'string') {
+          try {
+            normalizedData.documents.front = {
+              ...normalizedData.documents.front,
+              mrz: JSON.parse(normalizedData.documents.front.mrz)
+            };
+          } catch (e) {
+            logger.log("Warning: Could not parse front MRZ JSON");
           }
-      });
-      
-      logger.log('verificationSession res', JSON.stringify(truncateFields(res.data), null, 2));
-      return res.data;
+        }
 
-    } catch (error) {
-      logger.error('Error validating component:', JSON.stringify(errorMessage(error), null, 2));
-      throw new Error(errorMessage(error));
+        if (normalizedData.documents.back?.mrz && typeof normalizedData.documents.back.mrz === 'string') {
+          try {
+            normalizedData.documents.back = {
+              ...normalizedData.documents.back,
+              mrz: JSON.parse(normalizedData.documents.back.mrz)
+            };
+          } catch (e) {
+            logger.log("Warning: Could not parse back MRZ JSON");
+          }
+        }
+      }
     }
+
+    const payloadData = {
+      action,
+      data: {
+        ...normalizedData,
+        step,
+        templateId,
+      },
+      session_id,
+      timestamp: new Date().toISOString(),
+    };
+
+    const url = `${KYCConfig.getBackendUrl()}/verification/api/kyc/sessions/${session_id}/steps/${step}/`;
+    const logPayload = truncateFields({ payloadData, session_id, step });
+    
+    logger.log(
+      "verificationSession payload",
+      JSON.stringify(
+        {
+          url,
+          apiKey: apiKey ? "***HIDDEN***" : "None",
+          token: token ? "***HIDDEN***" : "None",
+          payload: logPayload,
+        },
+        null,
+        2
+      )
+    );
+
+    const headers: Record<string, string> = {
+      "Content-Type": "application/json",
+      ...(apiKey ? { Authorization: `ApiKey ${apiKey}` } : {}),
+      ...(token && !apiKey ? { Authorization: `Bearer ${token}` } : {})
+    };
+
+    const res = await axios.post<SessionResponse>(url, payloadData, { headers });
+
+    logger.log(
+      "verificationSession res",
+      JSON.stringify(truncateFields(res.data), null, 2)
+    );
+    return res.data;
+
+  } catch (error: any) {
+    const parsedError = errorMessage(error);
+    const finalErrorMessage = parsedError || error?.message || "Unknown validation error";
+    
+    logger.error(
+      "Error validating component:",
+      JSON.stringify(finalErrorMessage, null, 2)
+    );
+    throw new Error(typeof finalErrorMessage === 'string' ? finalErrorMessage : JSON.stringify(finalErrorMessage));
   }
+}
 
   /** Send email verification code. POST /api/v1/accounts/email/send/ */
   async sendEmailVerificationCode(
@@ -734,16 +857,49 @@ export class KYCService {
     return res.data;
   }
 
-  async getVerificationResult(session_id: string): Promise<VerificationResult> {
+  async getVerificationResult(session_id: string, apiKey?: string): Promise<any> {
     try {
-      const token = await authentification();
+  
+      const token = apiKey ? undefined : await authentification();
+  
       const url = `${KYCConfig.getBackendUrl()}/verification/api/kyc/result/?session_id=${session_id}`;
-      const res = await axios.get<VerificationResult>(url,
-        { headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${token}` } });
-      logger.log('getVerificationResult res', JSON.stringify(truncateFields(res.data), null, 2));
+  
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => {
+        logger.log("⏳ 8 seconds passed. Force-killing hanging Axios request...");
+        controller.abort();
+      }, 8000);
+  
+      const headers: Record<string, string> = {
+        'Content-Type': 'application/json',
+      };
+  
+      if (apiKey) {
+        headers["Authorization"] = `ApiKey ${apiKey}`;
+      } else if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+      }
+  
+      logger.log("3. Firing Axios GET to:", url);
+  
+      const res = await axios.get(url, {
+        headers,
+        signal: controller.signal 
+      });
+  
+      // Clear the timeout if the request succeeds!
+      clearTimeout(timeoutId);
+      
       return res.data;
-    } catch (error) {
-      logger.error('Error getting verification result:', JSON.stringify(errorMessage(error), null, 2));
+  
+    } catch (error: any) {
+      // Catch the AbortController kill signal and format it as a timeout
+      if (axios.isCancel(error) || error.name === 'AbortError' || error.name === 'CanceledError') {
+        logger.error('Axios request was forcefully aborted due to timeout');
+        throw new Error('Timeout exceeded');
+      }
+  
+      logger.error('Error getting verification result:', JSON.stringify(errorMessage(error) || error.message, null, 2));
       throw error;
     }
   }
@@ -852,7 +1008,6 @@ async validateBackTemplate(params: {
 
   const { region, docType, frontTemplateName, backTemplateName, subRegion, token } = params;
   
-  // 🚨 THE FIX: Format the payload as URL Query Parameters
   const queryParams = new URLSearchParams({
     region: region,
     doc_type: docType,
@@ -957,7 +1112,6 @@ export const authentification = async (): Promise<string> => {
   } catch (error: any) {
     cachedToken = null; // Clear bad cache
     
-    // 🚨 FIX: Extract Keycloak's exact error message so it doesn't log as {}
     const safeErrorMessage = 
       error?.response?.data?.error_description || 
       error?.response?.data?.error || 

package/src/types/KYC.types.ts

@@ -505,6 +505,7 @@ export interface ISilentCaptureResult {
   success: boolean;
   path?: string;
   mrz?: string;
+  barcode?: string | any; 
   error?: string;
   isAnalyzing?: boolean;
   bbox?: IBbox;

package/src/utils/aamvaParser.ts

@@ -0,0 +1,102 @@
+export const parseAAMVABarcode = (rawBarcode: string) => {
+    // If it's a short 1D barcode, just return the number
+    if (!rawBarcode || rawBarcode.length < 50) {
+        return { card_number: rawBarcode, barcode_type: "1D" };
+    }
+
+    const fields: Record<string, string> = {};
+    const additionalInfo: string[] = [];
+
+    // 1. Sanitize literal escaped newlines (just in case the SDK stringified them)
+    let normalized = rawBarcode.replace(/\\n/g, '\n').replace(/\\r/g, '\r');
+
+    // 2. Split by standard linebreaks AND AAMVA hidden control characters (FS, GS, RS)
+    const segments = normalized.split(/[\n\r\u001c\u001d\u001e]+/);
+
+    segments.forEach(segment => {
+        let clean = segment.trim();
+
+        // 3. Fix the Canadian/BC quirk: Subfile identifiers attached directly to the first data element
+        // e.g., "IDDAQ123456..." or "DLDAQ123456..."
+        if (clean.startsWith('DL') && clean.length > 5 && /^[A-Z]{3}/.test(clean.substring(2))) {
+            clean = clean.substring(2);
+        } else if (clean.startsWith('ID') && clean.length > 5 && /^[A-Z]{3}/.test(clean.substring(2))) {
+            clean = clean.substring(2);
+        }
+
+        // 4. Forcefully extract the 3-letter code and its data
+        const match = clean.match(/^([A-Z]{3})(.+)/);
+        if (match) {
+            fields[match[1]] = match[2].trim();
+        } else if (clean.length > 0 && !clean.startsWith('@')) {
+            additionalInfo.push(clean);
+        }
+    });
+
+    // Helper to format AAMVA dates (MMDDYYYY or YYYYMMDD) into YYYY-MM-DD
+    const formatDate = (rawDate: string | undefined) => {
+        if (!rawDate || rawDate.length !== 8) return "NONE";
+        
+        const firstFour = parseInt(rawDate.substring(0, 4), 10);
+        // If the first 4 digits are a valid year, it's YYYYMMDD
+        if (firstFour > 1900 && firstFour < 2100) {
+            return `${rawDate.substring(0, 4)}-${rawDate.substring(4, 6)}-${rawDate.substring(6, 8)}`;
+        }
+        // Otherwise, it's MMDDYYYY
+        return `${rawDate.substring(4, 8)}-${rawDate.substring(0, 2)}-${rawDate.substring(2, 4)}`;
+    };
+
+    // Helper to safely fetch a field or its fallback code
+    const getVal = (code: string, fallbackCode?: string) => {
+        const val = fields[code] || (fallbackCode ? fields[fallbackCode] : undefined);
+        return (val && val.trim().length > 0) ? val.trim() : "NONE";
+    };
+
+    // Standardize gender codes
+    let gender = getVal("DBC");
+    if (gender === "1") gender = "M";
+    if (gender === "2") gender = "F";
+
+    return {
+        barcode_type: normalized.includes("ANSI") ? "ANSI" : "UNKNOWN",
+        restriction_codes: getVal("DAR", "DCD"),
+        compliance_type: getVal("DDA"),
+        
+        // --- Document Dates ---
+        issue_date: formatDate(fields["DBD"]),
+        expiry_date: formatDate(fields["DBA"]),
+        birth_date: formatDate(fields["DBB"]),
+        under_18_until: formatDate(fields["DBH"]),
+        under_21_until: formatDate(fields["DBI"]),
+        
+        // --- Demographics ---
+        last_name: getVal("DCS", "DCA"),
+        first_name: getVal("DAC", "DCT"),
+        middle_name: getVal("DAD", "DCU"),
+        name_suffix: getVal("DCU"), 
+        customer_full_name: getVal("DAA"), 
+        gender: gender,
+        eye_color: getVal("DAY"),
+        hair_color: getVal("DAZ"),
+        height: getVal("DAU"),
+        weight: getVal("DAW", "DAX"),
+        
+        // --- Location ---
+        street_address: getVal("DAG"),
+        street_address_2: getVal("DAH"),
+        city: getVal("DAI"),
+        province: getVal("DAJ"),
+        postal_code: getVal("DAK"),
+        country: getVal("DCG") !== "NONE" ? getVal("DCG") : "CAN",
+        
+        // --- ID Numbers & Security ---
+        card_number: getVal("DAQ"),
+        document_discriminator: getVal("DCF"),
+        inventory_control_number: getVal("DCK", "DCB"), 
+        
+        // The raw dump in case you ever need an obscure field
+        raw_fields: fields, 
+        
+        additional_info: additionalInfo.length > 0 ? additionalInfo : ["NONE"]
+    };
+};

package/src/utils/cropByObb.ts

@@ -147,11 +147,13 @@ async function normalizeOrientationAndGetDimensions(
     });
   }
 
-  // Native: re-encode to bake EXIF rotation into actual pixels
   const result = await ImageManipulator.manipulateAsync(
     uri,
-    [], // No transforms — just re-encode to normalize
-    { compress: 1, format: ImageManipulator.SaveFormat.JPEG }
+    [], 
+    { 
+      compress: 1, 
+      format: ImageManipulator.SaveFormat.JPEG 
+    }
   );
   return { normalizedUri: result.uri, width: result.width, height: result.height };
 }