@transfergratis/react-native-sdk 0.1.26 → 0.1.29

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,10 @@ 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
+    // SANDBOX mode
     if (env === 'SANDBOX') {
       console.log("SANDBOX mode: Skipping AI MRZ extraction");
       logger.log("SANDBOX mode: Returning mock MRZ response");
@@ -372,7 +376,9 @@ 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');
+    
+    // ✅ FIX: 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];
     logger.log("docTypeShorted", docTypeShorted, docRegion, postfix);
@@ -387,7 +393,6 @@ export class KYCService {
           timeout: 60000,
         });
         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);
         return res.data;
@@ -405,7 +410,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 +427,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 +485,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 +500,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 +516,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 +562,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 +577,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 +598,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 +626,6 @@ export const authentification = async () => {
       method: error.config?.method
     });
 
-    // Extract backend error message if available
     const backendMessage = errorMessage(error);
 
     if (backendMessage) {
@@ -643,8 +637,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

@@ -9,17 +9,73 @@ type Point = [number, number];
 export const OBB_CONFIDENCE_THRESHOLD = 0.85;
 
 /**
- * card_obb format from API: [ [ [p1,p2,p3,p4], confidence ] ]
+ * card_obb format from API:
+ * - Legacy: [ [ [p1,p2,p3,p4], confidence ] ]
+ * - New:    [ { obb: [p1,p2,p3,p4], confidence, card_in_frame?, cropped_sides? } ]
  * Returns confidence in [0,1] or null if not present.
  */
 export function getObbConfidence(cardObb: any): number | null {
   if (!cardObb || !Array.isArray(cardObb) || cardObb.length === 0) return null;
   const first = cardObb[0];
+
+  // New format: first is an object with a confidence field
+  if (first && typeof first === 'object' && 'confidence' in first) {
+    const score = (first as any).confidence;
+    return typeof score === 'number' ? score : null;
+  }
+
+  // Legacy format: [ [points], score ]
   if (!Array.isArray(first) || first.length < 2) return null;
   const score = first[1];
   return typeof score === 'number' ? score : null;
 }
 
+/**
+ * Extracts the card_in_frame flag from card_obb when present.
+ * Returns:
+ * - true  => card fully in frame
+ * - 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;
+
+  // card_obb can be an array of objects or a single object
+  const first = Array.isArray(cardObb) ? cardObb[0] : cardObb;
+
+  if (first && typeof first === 'object' && 'card_in_frame' in first) {
+    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; 
+  }
+
+  // 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;
+  }
+
+  return null;
+}
+
 // Compute axis-aligned bounding box from oriented quadrilateral
 function computeAabb(points: Point[]) {
   const xs = points.map(p => p[0]);

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;