@transfergratis/react-native-sdk 0.1.28 → 0.1.30

package/src/modules/api/KYCService.ts

@@ -216,7 +216,7 @@ export class KYCService {
 
   // STEP 1 - ID CARD VALIDATION
   async detectFaceOnId(idCardImageUri: string, token: string, docType: string, env: KycEnvironment = 'PRODUCTION'): Promise<{ result: boolean, detail: any[] }> {
-    // SANDBOX mode: skip AI verification and return mock response
+    // SANDBOX mode
     if (env === 'SANDBOX') {
       console.log("SANDBOX mode: Skipping AI face detection on ID");
       logger.log("SANDBOX mode: Returning mock face detection response");
@@ -228,6 +228,7 @@ export class KYCService {
     }
 
     const formData = new FormData();
+    // Defaulting to photo since we don't pass postfix here currently, but making the name generic
     await appendFileToFormData(formData, 'file', idCardImageUri, 'id_card_photo.jpg', 'image/jpeg');
 
     logger.log('detectFaceOnId formData', JSON.stringify(formData, null, 2));
@@ -252,7 +253,7 @@ export class KYCService {
 
   //check templatetemplate_type
   async checkTemplateType(params: { fileUri: string; docType: string; docRegion: string; token: string; postfix: string }, env: KycEnvironment = 'PRODUCTION'): Promise<any> {
-    // SANDBOX mode: skip AI verification and return mock response
+    // SANDBOX mode
     if (env === 'SANDBOX') {
       console.log("SANDBOX mode: Skipping AI template type check");
       logger.log("SANDBOX mode: Returning mock template type response");
@@ -265,7 +266,9 @@ export class KYCService {
 
     const { fileUri, docType, docRegion, token, postfix } = params;
     const formData = new FormData();
-    await appendFileToFormData(formData, 'file', fileUri, 'id_card_front.jpg', 'image/jpeg');
+    
+    // ✅ FIX: Dynamically assign the postfix to the filename
+    await appendFileToFormData(formData, 'file', fileUri, `id_card_${postfix}.jpg`, 'image/jpeg');
 
     const docTypeShorted = GovernmentDocumentTypeShorted[docType as GovernmentDocumentType];
     const url = `${this.mrzServiceURL}/get_template_version/?doc_type=${encodeURIComponent(docTypeShorted)}&doc_region=${encodeURIComponent(docRegion)}&postfix=${postfix}`;
@@ -285,11 +288,12 @@ export class KYCService {
 
   }
 
-  async extractDocumentInformation(params: { fileUri: string; docType: string; docRegion: string; token: string }): Promise<any> {
-    const { fileUri, docType, docRegion, token } = params;
+  async extractDocumentInformation(params: { fileUri: string; docType: string; docRegion: string; token: string; postfix?: string }): Promise<any> {
+    const { fileUri, docType, docRegion, token, postfix = 'front' } = params;
     const formData = new FormData();
-    await appendFileToFormData(formData, 'file', fileUri, 'id_card_front.jpg', 'image/jpeg');
-
+    
+    // ✅ FIX: Dynamic filename
+    await appendFileToFormData(formData, 'file', fileUri, `id_card_${postfix}.jpg`, 'image/jpeg');
 
     const url = `${this.textExtractionServiceURL}/extract_doc_information/?doc_type=${encodeURIComponent(docType)}&doc_region=${encodeURIComponent(docRegion)}`;
     const attempt = async () => {
@@ -307,13 +311,12 @@ export class KYCService {
     } catch (e) {
       logger.error('Error extracting document information:', JSON.stringify(truncateFields(e)));
       throw e;
-      // await new Promise(r => setTimeout(r, 1500));
-      // return await attempt();
     }
   }
+
   // STEP 2 - barcode extraction
-  async extractBarcode(params: { fileUri: string; token: string }, env: KycEnvironment = 'PRODUCTION'): Promise<any> {
-    // SANDBOX mode: skip AI verification and return mock response
+  async extractBarcode(params: { fileUri: string; token: string; postfix?: string }, env: KycEnvironment = 'PRODUCTION'): Promise<any> {
+    // SANDBOX mode
     if (env === 'SANDBOX') {
       console.log("SANDBOX mode: Skipping AI barcode extraction");
       logger.log("SANDBOX mode: Returning mock barcode response");
@@ -323,10 +326,11 @@ export class KYCService {
       };
     }
 
-    const { fileUri, token } = params;
+    const { fileUri, token, postfix = 'back' } = params;
     const formData = new FormData();
-    await appendFileToFormData(formData, 'file', fileUri, 'id_card_back.jpg', 'image/jpeg');
-
+    
+    // ✅ FIX: Dynamic filename
+    await appendFileToFormData(formData, 'file', fileUri, `id_card_${postfix}.jpg`, 'image/jpeg');
 
     const url = `${this.barcodeServiceURL}/decode_barcode/`;
     const attempt = async () => {
@@ -336,7 +340,6 @@ export class KYCService {
           timeout: 60000,
         });
         logger.log('extractBarcode res', JSON.stringify(res.data, null, 2));
-        //check if  res.data has aleast one key
         if (Object.keys(res.data).length === 0) throw new Error('No data found');
         return res.data;
       } catch (e: any) {
@@ -350,9 +353,21 @@ export class KYCService {
       throw e;
     }
   }
+
   // STEP 3 - MRZ TEXT EXTRACTION
-  async extractMrzText(params: { fileUri: string; docType: string; docRegion: string; postfix?: string; token: string; template_path: string; mrz_type: string }, env: KycEnvironment = 'PRODUCTION'): Promise<any> {
-    // SANDBOX mode: skip AI verification and return mock response
+  async extractMrzText(
+    params: { 
+      fileUri: string; 
+      docType: string; 
+      docRegion: string; 
+      postfix?: string; 
+      token: string; 
+      template_path: string; 
+      mrz_type?: string; 
+    }, 
+    env: KycEnvironment = 'PRODUCTION'
+  ): Promise<any> {
+    // SANDBOX mode
     if (env === 'SANDBOX') {
       console.log("SANDBOX mode: Skipping AI MRZ extraction");
       logger.log("SANDBOX mode: Returning mock MRZ response");
@@ -372,29 +387,40 @@ export class KYCService {
 
     const { fileUri, docType, docRegion, postfix = 'back', token, template_path, mrz_type } = params;
     const formData = new FormData();
-    await appendFileToFormData(formData, 'file', fileUri, 'id_card_back.jpg', 'image/jpeg');
+    
+    // ✅ Dynamic filename to prevent passports from crashing (since their MRZ is on the front)
+    await appendFileToFormData(formData, 'file', fileUri, `id_card_${postfix}.jpg`, 'image/jpeg');
 
-    const docTypeShorted = GovernmentDocumentTypeShorted[docType as GovernmentDocumentType];
+    const docTypeShorted = GovernmentDocumentTypeShorted[docType as GovernmentDocumentType] || docType;
     logger.log("docTypeShorted", docTypeShorted, docRegion, postfix);
 
-    const url = `${this.mrzServiceURL}/extract_mrz_text/?doc_type=${docTypeShorted}&doc_region=${docRegion}&postfix=${postfix}&template_path=${template_path}&mrz_type=${mrz_type}`;
+    let url = `${this.mrzServiceURL}/extract_mrz_text/?doc_type=${encodeURIComponent(docTypeShorted)}&doc_region=${encodeURIComponent(docRegion)}&postfix=${encodeURIComponent(postfix)}&template_path=${encodeURIComponent(template_path)}`;
+    
+    if (mrz_type && mrz_type.trim() !== '') {
+        url += `&mrz_type=${encodeURIComponent(mrz_type)}`;
+    }
+    
     logger.log("url", url);
 
     const attempt = async () => {
       try {
         const res = await axios.post<ExtractMrzTextResponse>(url, formData, {
-          headers: { 'Content-Type': 'multipart/form-data', 'Authorization': `Bearer ${token}`, },
-          timeout: 60000,
+          headers: { 'Content-Type': 'multipart/form-data', 'Authorization': `Bearer ${token}` },
+          // Note: Reduced timeout to 10000ms (10s) based on our earlier network fix to prevent infinite hanging!
+          timeout: 10000, 
         });
+        
         logger.log('extractMrzText res', JSON.stringify(res.data, null, 2));
-        //check if  res.data has aleast one key
+        
         if (Object.keys(res.data).length === 0) throw new Error('No data found');
-        if (res.data?.success === false) throw new Error(res.data.parsed_data.status);
+        if (res.data?.success === false) throw new Error(res.data.parsed_data?.status || 'Échec de l\'extraction MRZ');
+        
         return res.data;
       } catch (e: any) {
         throw new Error(e?.message || 'Erreur de détection du MRZ');
       }
     };
+
     try {
       return await attempt();
     } catch (e) {
@@ -405,7 +431,7 @@ export class KYCService {
 
   // STEP 2 - SELFIE VALIDATION
   async recognizeFace(params: { idPhotoUri: string; selfiePhotoUri: string }, env: KycEnvironment = 'PRODUCTION'): Promise<{ is_match: boolean; similarity: number; id_bbox?: number[]; selfie_bbox?: number[] }> {
-    // SANDBOX mode: skip AI verification and return mock response
+    // SANDBOX mode
     if (env === 'SANDBOX') {
       console.log("SANDBOX mode: Skipping AI face recognition");
       logger.log("SANDBOX mode: Returning mock face recognition response");
@@ -422,7 +448,6 @@ export class KYCService {
     await appendFileToFormData(formData, 'id_photo', idPhotoUri, 'id_card_photo.jpg', 'image/jpeg');
     await appendFileToFormData(formData, 'selfie_photo', selfiePhotoUri, 'selfie_final.jpg', 'image/jpeg');
 
-
     const res = await axios.post(`${this.faceServiceURL}/recognize_face/`, formData, { timeout: 45000 });
     if (res.data?.detail) throw new Error(res.data.detail);
     return res.data;
@@ -481,13 +506,8 @@ export class KYCService {
   async verificationSession(payload: VerificationSessionRequest): Promise<any> {
     console.log('apiKey in verificationSession', payload.apiKey);
     try {
-
-
-      // /api/v1/verification/api/kyc/sessions/{session_id}/steps/{step}/
       const { session_id, step, data, templateId, action, apiKey } = payload;
-
       const token = apiKey ? undefined : await authentification();
-      // const session_id = "kyc-8b4e069258d8";
       const payloadData = {
         action: action,
         data: {
@@ -501,7 +521,6 @@ export class KYCService {
       }
       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(truncateFields({ logPayload, token: token ?? "-", path: url, apiKey }),
@@ -518,7 +537,6 @@ export class KYCService {
       logger.log('verificationSession res', JSON.stringify(truncateFields(res.data), null, 2));
       return res.data;
 
-
     } catch (error) {
       logger.error('Error validating component:', JSON.stringify(error, null, 2));
       throw new Error(errorMessage(error));
@@ -565,7 +583,6 @@ export class KYCService {
     return res.data;
   }
 
-  // reultat de la verification
   async getVerificationResult(session_id: string): Promise<VerificationResult> {
     try {
       const token = await authentification();
@@ -581,11 +598,9 @@ export class KYCService {
   }
 }
 
-
 const kycService = new KYCService("", "");
 export default kycService;
 
-
 // Pour éviter d'afficher des champs trop longs, on tronque les valeurs longues dans le log
 export function truncateFields(obj: any, maxLength = 420): any {
   if (typeof obj !== 'object' || obj === null) return obj;
@@ -604,6 +619,7 @@ export function truncateFields(obj: any, maxLength = 420): any {
   }
   return truncated;
 }
+
 export const authentification = async () => {
   try {
     logger.log('authentification params', 'kyc_frontend', 'ZCW4mGaJXWR0UuI40lM1pHNQmYLw2xvX');
@@ -631,7 +647,6 @@ export const authentification = async () => {
       method: error.config?.method
     });
 
-    // Extract backend error message if available
     const backendMessage = errorMessage(error);
 
     if (backendMessage) {
@@ -643,8 +658,6 @@ export const authentification = async () => {
   }
 }
 
-
-
 export const errorMessage = (error: any) => {
   return error.response?.data?.message ||
     error.response?.data?.detail ||

package/src/modules/camera/VisionCameraModule.ts

@@ -26,7 +26,7 @@ async function copyFileCompat(from: string, to: string): Promise<void> {
   // This is the recommended way to avoid deprecation warnings
   try {
     // @ts-ignore - legacy export might not be in types
-    const LegacyFileSystem = require('expo-file-system/legacy');
+    const LegacyFileSystem = require('expo-file-system');
     if (LegacyFileSystem && LegacyFileSystem.copyAsync && typeof LegacyFileSystem.copyAsync === 'function') {
       await LegacyFileSystem.copyAsync({ from, to });
       return;
@@ -81,7 +81,7 @@ function getDocumentDirectory(): string {
   // This is the recommended way to avoid deprecation warnings
   try {
     // @ts-ignore
-    const LegacyFileSystem = require('expo-file-system/legacy');
+    const LegacyFileSystem = require('expo-file-system');
     if (LegacyFileSystem && LegacyFileSystem.documentDirectory) {
       return LegacyFileSystem.documentDirectory;
     }

package/src/utils/cropByObb.ts

@@ -37,6 +37,14 @@ export function getObbConfidence(cardObb: any): number | null {
  * - false => card not fully in frame
  * - null  => field not present (backward compatibility)
  */
+/**
+ * Extracts the framing data from card_obb.
+ * STRICT CHECK: Returns true ONLY if card_in_frame is true AND cropped_sides is empty.
+ * Returns:
+ * - true  => card fully in frame (no sides cropped)
+ * - false => card not fully in frame OR edges are cropped
+ * - null  => field not present (backward compatibility)
+ */
 export function getCardInFrame(cardObb: any): boolean | null {
   if (!cardObb) return null;
 
@@ -44,11 +52,22 @@ export function getCardInFrame(cardObb: any): boolean | null {
   const first = Array.isArray(cardObb) ? cardObb[0] : cardObb;
 
   if (first && typeof first === 'object' && 'card_in_frame' in first) {
-    const value = (first as any).card_in_frame;
-    return typeof value === 'boolean' ? value : null;
+    const isCardInFrame = first.card_in_frame === true;
+    const hasCroppedSides = Array.isArray(first.cropped_sides) && first.cropped_sides.length > 0;
+
+    // If the API explicitly says it's not in frame, OR if it lists cropped edges, reject it.
+    if (!isCardInFrame || hasCroppedSides) {
+      if (hasCroppedSides) {
+        console.warn(`Card is cropped on sides: ${first.cropped_sides.join(', ')}`);
+      }
+      return false; 
+    }
+
+    // If we made it here, card_in_frame is true AND cropped_sides is empty.
+    return true; 
   }
 
-  // Some APIs might put card_in_frame at the top level
+  // Backward compatibility check
   if (cardObb && typeof cardObb === 'object' && 'card_in_frame' in cardObb) {
     const value = (cardObb as any).card_in_frame;
     return typeof value === 'boolean' ? value : null;

package/src/utils/pathToBase64.ts

@@ -13,7 +13,7 @@ export async function pathToBase64(uri: string): Promise<string> {
     // This is the recommended way to avoid deprecation warnings
     try {
       // @ts-ignore - legacy export might not be in types
-      const LegacyFileSystem = require('expo-file-system/legacy');
+      const LegacyFileSystem = require('expo-file-system');
       if (LegacyFileSystem?.readAsStringAsync) {
         const base64 = await LegacyFileSystem.readAsStringAsync(uri, { encoding: LegacyFileSystem.EncodingType.Base64 });
         if (base64) return base64;