@sanctum-key/react-native-sdk 1.0.51 → 1.0.52

package/src/modules/api/CardAuthentification.ts

@@ -4,479 +4,443 @@ import { GovernmentDocumentType, IBbox } from "../../types/KYC.types";
 import { KycEnvironment } from "../../types/env.types";
 import { logger } from "../../utils/logger";
 import { countryData } from "../../config/countriesData";
+import { Platform } from "react-native";
 
 interface CardObbData {
-    obb: number[][];
-    confidence: number;
-    card_in_frame?: boolean;
-    cropped_sides?: string[];
+  obb: number[][];
+  confidence: number;
+  card_in_frame?: boolean;
+  cropped_sides?: string[];
 }
 
 interface ApiVerificationResponse {
-    result?: boolean;
-    success?: boolean;
-    detail?: any[];
-    card_obb?: CardObbData[] | any;
-    template_path?: string;
-    Error?: any;
-    [key: string]: any;
+  result?: boolean;
+  success?: boolean;
+  detail?: any[];
+  card_obb?: CardObbData[] | any;
+  template_path?: string;
+  Error?: any;
+  [key: string]: any;
 }
 
 export async function frontVerification(
-    result: { path?: string, regionMapping: { authMethod: string[], mrzTypes: string[] }, selectedDocumentType: string, code: string, currentSide: string, templatePath?: string, mrzType?: string, issuingSubdivision?: string, clientSideBarcodeData?: string },
-    env: KycEnvironment = 'PRODUCTION'
-  ) {
-    try {
-      console.log("Front verification START", JSON.stringify({ result }, null, 2));
-      logger.log("Front verification", JSON.stringify({ result }, null, 2));
-  
-      const authMethods = Array.isArray(result.regionMapping?.authMethod) ? result.regionMapping.authMethod.map(m => String(m).toUpperCase()) : [];
-      const hasMrz = authMethods.some(m => m.includes('MRZ'));
-      const hasBarcode = authMethods.some(m => m.includes('BARCODE') || m.includes('2D'));
-  
-      if (env === 'SANDBOX') {
-        console.log("SANDBOX mode: Skipping AI verification for front document");
-        const mockBbox: IBbox = { minX: 400, minY: 800, width: 2200, height: 1400 };
-        const mockResponse = {
-          result: true, detail: [{ confidence: 0.95 }],
-          card_obb: [{ obb: [[400, 800], [2600, 800], [2600, 2200], [400, 2200]], confidence: 0.95, card_in_frame: true, cropped_sides: [] }],
-          bbox: mockBbox,
-          ...(hasMrz ? { mrz: { success: true, parsed_data: { status: 'SUCCESS', document_type: result.selectedDocumentType, mrz_type: result.mrzType || 'TD1' } } } : {}),
-          ...(hasBarcode ? { barcode: { barcode_data: 'SANDBOX_MOCK_BARCODE' } } : {})
-        };
-        return mockResponse;
+  result: {
+    path?: string,
+    regionMapping: { authMethod: string[], mrzTypes: string[] },
+    selectedDocumentType: string,
+    code: string,
+    currentSide: string,
+    templatePath?: string,
+    mrzType?: string,
+    issuingSubdivision?: string,
+    clientSideBarcodeData?: string
+  },
+  env: KycEnvironment = 'PRODUCTION'
+) {
+  try {
+    console.log("Front verification START", JSON.stringify({ result }, null, 2));
+    logger.log("Front verification", JSON.stringify({ result }, null, 2));
+
+    const authMethods = Array.isArray(result.regionMapping?.authMethod) ? result.regionMapping.authMethod.map(m => String(m).toUpperCase()) : [];
+    const hasMrz = authMethods.some(m => m.includes('MRZ'));
+    const hasBarcode = authMethods.some(m => m.includes('BARCODE') || m.includes('2D'));
+
+    const token = await authentification();
+    const detected = await kycService.detectFaceOnId(
+      result?.path || '',
+      token,
+      result?.selectedDocumentType || '',
+      env
+    ) as ApiVerificationResponse;
+
+    if (!detected.result) {
+      throw new Error('Aucun visage détecté sur la carte. Veuillez reprendre.');
+    }
+
+    const cardData = detected.card_obb && Array.isArray(detected.card_obb) && detected.card_obb.length > 0 ? detected.card_obb[0] : null;
+    let points: number[][] | null = null;
+    console.log(points)
+    let isCardInFrame = true;
+    let hasCroppedSides = false;
+
+    if (cardData) {
+      points = cardData.obb;
+      if (typeof cardData.card_in_frame !== 'undefined') {
+        isCardInFrame = cardData.card_in_frame === true;
+        hasCroppedSides = Array.isArray(cardData.cropped_sides) && cardData.cropped_sides.length > 0;
       }
-  
-      const token = await authentification();
-      const detected = await kycService.detectFaceOnId(
-        result?.path || '', token, result?.selectedDocumentType || '', env
-      ) as ApiVerificationResponse;
-  
-      if (!detected.result) {
-        throw new Error('Aucun visage détecté sur la carte. Veuillez reprendre.');
+    }
+
+    if (!isCardInFrame || hasCroppedSides) {
+      logger.log(`Front Framing failed. Cropped sides detected by backend.`);
+      throw new Error('CARD_NOT_FULLY_IN_FRAME');
+    }
+
+    const obbConfidence = getObbConfidence(detected.card_obb);
+    if (obbConfidence !== null && obbConfidence < OBB_CONFIDENCE_THRESHOLD) {
+      throw new Error('Carte non entièrement visible. Positionnez toute la carte dans le cadre.');
+    }
+
+    let croppedBase64: string | undefined;
+    let bbox: IBbox | undefined;
+    let mrz: any | undefined;
+    let barcode: any | undefined;
+    let documentData: any | undefined;
+
+    try {
+      const crop = await cropByObb(result?.path || '', detected.card_obb);
+      croppedBase64 = crop.base64;
+      bbox = crop.bbox;
+    } catch {
+    }
+
+    if (result.code === 'CA') {
+      try {
+        logger.log("Tentative d'extraction OCR (Front) - Canada Only");
+        documentData = await kycService.extractDocumentInformation({
+          fileUri: result.path || '',
+          docType: result.selectedDocumentType,
+          docRegion: result.code,
+          templatePath: result.templatePath || '',
+          issuingSubdivision: result.issuingSubdivision,
+          token: token,
+          postfix: result.currentSide || 'front'
+        });
+
+        if (documentData?.no_data || (documentData && documentData.data && Object.keys(documentData.data).length === 0)) {
+          logger.log("Front OCR Extraction Failed: Backend returned empty data dict.");
+          if (!hasBarcode && !hasMrz) {
+            throw new Error("Impossible de lire les informations du document. L'image est peut-être floue ou mal éclairée.");
+          }
+        }
+      } catch (err: any) {
+        if (err?.response?.status === 401 || err?.response?.status === 403 || err?.status === 401) throw err;
+        const errorMsg = typeof err === 'object' ? JSON.stringify(err) : err;
+        logger.log("Front OCR Extraction Error:", errorMsg);
+        throw new Error(err?.message || "Impossible d'extraire les données. Veuillez reprendre la photo.");
       }
-  
-      const cardData = detected.card_obb && Array.isArray(detected.card_obb) && detected.card_obb.length > 0 ? detected.card_obb[0] : null;
-      let points: number[][] | null = null;
-      console.log(points)
-      let isCardInFrame = true;
-      let hasCroppedSides = false;
-  
-      if (cardData) {
-        points = cardData.obb;
-        if (typeof cardData.card_in_frame !== 'undefined') {
-          isCardInFrame = cardData.card_in_frame === true;
-          hasCroppedSides = Array.isArray(cardData.cropped_sides) && cardData.cropped_sides.length > 0;
+    }
+
+    if (hasMrz) {
+      try {
+        logger.log("Tentative d'extraction MRZ (Front)");
+        const mrzResponse = await kycService.extractMrzText(
+          {
+            fileUri: result.path || '',
+            docType: result?.selectedDocumentType || '',
+            docRegion: result?.code || "",
+            postfix: result?.currentSide || 'front',
+            token: token,
+            template_path: result?.templatePath || '',
+            mrz_type: result?.mrzType || 'TD1'
+          },
+          env
+        );
+
+        mrz = typeof mrzResponse === 'string' ? JSON.parse(mrzResponse) : mrzResponse;
+
+        if (mrz?.parsed_data?.status === 'FAILURE' || mrz?.success === false) {
+          logger.log("Front MRZ Extraction Failed:", mrz?.parsed_data?.status_message);
+          throw new Error(`MRZ illisible: ${mrz?.parsed_data?.status_message || 'Veuillez nettoyer l\'objectif et réessayer'}`);
         }
+      } catch (err: any) {
+        if (err?.response?.status === 401 || err?.response?.status === 403 || err?.status === 401) throw err;
+        logger.log("MRZ Extraction Error:", err);
+        throw new Error(err?.message || "Erreur lors de l'extraction MRZ. Veuillez reprendre la photo.");
       }
-  
-      if (!isCardInFrame || hasCroppedSides) {
-        logger.log(`Front Framing failed. Cropped sides detected by backend.`);
-        throw new Error('CARD_NOT_FULLY_IN_FRAME');
+    }
+
+    return {
+      ...detected,
+      croppedBase64,
+      bbox,
+      ...(mrz ? { mrz } : {}),
+      ...(barcode ? { barcode } : {}),
+      ...(documentData ? { documentData } : {})
+    };
+
+  } catch (e: any) {
+    logger.log('Error front verification:', e?.message);
+    if (e?.response?.status || e?.status || e?.isAxiosError) {
+      throw e;
+    }
+    throw new Error(e?.message || 'Erreur de détection du visage');
+  }
+}
+
+export async function backVerification(
+  result: {
+    path?: string,
+    regionMapping: { authMethod: string[], mrzTypes: string[] },
+    selectedDocumentType: string,
+    code: string,
+    currentSide: string,
+    templatePath?: string,
+    mrzType?: string,
+    templateResponse?: ApiVerificationResponse,
+    issuingSubdivision?: string,
+    frontTemplatePath?: string,
+    clientSideBarcodeData?: string
+  },
+  env: KycEnvironment = 'PRODUCTION'
+) {
+  try {
+    if (!result.path) throw new Error('No path provided');
+    logger.log("result.regionMapping", result.regionMapping, result.currentSide, result.code);
+
+    const authMethods = Array.isArray(result.regionMapping?.authMethod) ? result.regionMapping.authMethod.map(m => String(m).toUpperCase()) : [];
+    const hasMrz = authMethods.some(m => m.includes('MRZ'));
+    const hasBarcode = authMethods.some(m => m.includes('BARCODE') || m.includes('2D'));
+
+    const token = await authentification();
+    logger.log("1. Checking template and framing for back document...");
+
+    const templateResponse: ApiVerificationResponse = result.templateResponse || await kycService.checkTemplateType({
+      fileUri: result.path,
+      docType: result.selectedDocumentType as any,
+      docRegion: result.code,
+      postfix: 'back',
+      token: token,
+    }, env);
+
+    if (templateResponse.success === false || templateResponse.Error) {
+      throw new Error('Impossible de lire le document. Veuillez vous rapprocher et stabiliser la caméra.');
+    }
+
+    const cardData = templateResponse?.card_obb && Array.isArray(templateResponse.card_obb) && templateResponse.card_obb.length > 0 ? templateResponse.card_obb[0] : null;
+    if (!cardData) throw new Error('CARD_NOT_FULLY_IN_FRAME');
+
+    let points: number[][] | null = null;
+    console.log(points);
+    let isCardInFrame = false;
+    let hasCroppedSides = true;
+
+    if (cardData.obb) {
+      points = cardData.obb;
+      if (typeof cardData.card_in_frame !== 'undefined') {
+        isCardInFrame = cardData.card_in_frame === true;
+        hasCroppedSides = Array.isArray(cardData.cropped_sides) && cardData.cropped_sides.length > 0;
       }
-  
-      const obbConfidence = getObbConfidence(detected.card_obb);
-      if (obbConfidence !== null && obbConfidence < OBB_CONFIDENCE_THRESHOLD) {
-        throw new Error('Carte non entièrement visible. Positionnez toute la carte dans le cadre.');
+    } else if (Array.isArray(cardData) && Array.isArray(cardData[0])) {
+      points = cardData[0];
+      isCardInFrame = true;
+      hasCroppedSides = false;
+    }
+
+    if (!isCardInFrame || hasCroppedSides) {
+      logger.log(`Back Framing failed. Backend reported document out of bounds.`);
+      throw new Error('CARD_NOT_FULLY_IN_FRAME');
+    }
+
+    const obbConf = getObbConfidence(templateResponse?.card_obb);
+    if (obbConf !== null && obbConf < OBB_CONFIDENCE_THRESHOLD) {
+      throw new Error('Carte non entièrement visible. Positionnez toute la carte dans le cadre.');
+    }
+
+    const activeTemplatePath = templateResponse.template_path || result.templatePath || '';
+
+    if (activeTemplatePath) {
+      const countryInfo = countryData[result.code];
+      const countryName = countryInfo?.name_en || countryInfo?.name || '';
+      
+      const hasCodeMatch = activeTemplatePath.toUpperCase().includes(`_${result.code.toUpperCase()}_`) || activeTemplatePath.toUpperCase().includes(`${result.code.toUpperCase()}/`);
+      const hasNameMatch = countryName && activeTemplatePath.toLowerCase().includes(countryName.toLowerCase());
+
+      if (!hasCodeMatch && !hasNameMatch) {
+        logger.log(`Template mismatch! Expected region: ${result.code} (${countryName}), Detected: ${activeTemplatePath}`);
+        throw new Error(`Le document ne correspond pas au pays sélectionné (${result.code}).`);
       }
-  
-      let croppedBase64: string | undefined;
-      let bbox: IBbox | undefined;
-      let mrz: any | undefined;
-      let barcode: any | undefined;
-      let documentData: any | undefined;
-  
+    }
+
+    if (result.frontTemplatePath && activeTemplatePath) {
       try {
-        const crop = await cropByObb(result?.path || '', detected.card_obb);
-        croppedBase64 = crop.base64;
-        bbox = crop.bbox;
-      } catch { }
-  
-      if (result.code === 'CA') {
-        try {
-          logger.log("Tentative d'extraction OCR (Front) - Canada Only");
-          documentData = await kycService.extractDocumentInformation({
-            fileUri: result.path || '', docType: result.selectedDocumentType, docRegion: result.code, templatePath: result.templatePath || '', issuingSubdivision: result.issuingSubdivision, token: token, postfix: result.currentSide || 'front'
-          });
-  
-          if (documentData?.no_data || (documentData && documentData.data && Object.keys(documentData.data).length === 0)) {
-            logger.log("Front OCR Extraction Failed: Backend returned empty data dict.");
-            if (!hasBarcode && !hasMrz) {
-              throw new Error("Impossible de lire les informations du document. L'image est peut-être floue ou mal éclairée.");
-            }
+        const frontPy = result.frontTemplatePath.split("/").pop()?.replace(/\.(jpg|png)$/i, ".py");
+        const backPy = activeTemplatePath.split("/").pop()?.replace(/\.(jpg|png)$/i, ".py");
+
+        if (frontPy && backPy) {
+          logger.log(`Validating Front (${frontPy}) vs Back (${backPy}) for region ${result.code}`);
+          const isCanadianSubRegionDoc = result.code === 'CA' && ['pr'].includes(result.selectedDocumentType);
+          const safeSubRegion = isCanadianSubRegionDoc ? (result.issuingSubdivision || "") : "";
+
+          const matchValidation = await kycService.validateBackTemplate({
+            region: result.code,
+            docType: result.selectedDocumentType,
+            frontTemplateName: frontPy,
+            backTemplateName: backPy,
+            subRegion: safeSubRegion,
+            token: token
+          }, env);
+
+          if (!matchValidation || matchValidation.is_match === false) {
+            logger.log(`Front/Back Mismatch: ${matchValidation?.status_message}`);
+            throw new Error(`Le verso ne correspond pas au recto fourni. Vous avez scanné un document différent.`);
           }
-        } catch (err: any) {
-          // 🚨 FIX: Allow 401/403 errors to bubble up directly!
-          if (err?.response?.status === 401 || err?.response?.status === 403 || err?.status === 401) throw err;
-          
-          const errorMsg = typeof err === 'object' ? JSON.stringify(err) : err;
-          logger.log("Front OCR Extraction Error:", errorMsg);
-          throw new Error(err?.message || "Impossible d'extraire les données. Veuillez reprendre la photo.");
         }
+      } catch (err: any) {
+        if (err?.message?.includes('ne correspond pas')) throw err;
+        logger.log("Template matching validation skipped/failed internally:", err?.message);
       }
-  
-      if (hasMrz) {
-        try {
-          logger.log("Tentative d'extraction MRZ (Front)");
-          const mrzResponse = await kycService.extractMrzText(
-            { fileUri: result.path || '', docType: result?.selectedDocumentType || '', docRegion: result?.code || "", postfix: result?.currentSide || 'front', token: token, template_path: result?.templatePath || '', mrz_type: result?.mrzType || 'TD1' }, env
-          );
-          mrz = typeof mrzResponse === 'string' ? JSON.parse(mrzResponse) : mrzResponse;
-  
-          if (mrz?.parsed_data?.status === 'FAILURE' || mrz?.success === false) {
-            logger.log("Front MRZ Extraction Failed:", mrz?.parsed_data?.status_message);
-            throw new Error(`MRZ illisible: ${mrz?.parsed_data?.status_message || 'Veuillez nettoyer l\'objectif et réessayer'}`);
+    }
+
+    logger.log("Framing, Country, and Match verified successfully. Proceeding to Data Extraction.");
+    let extractionResult: any = {};
+
+    if (result.code === 'CA') {
+      try {
+        logger.log("Tentative d'extraction OCR (Back) - Canada Only");
+        const documentData = await kycService.extractDocumentInformation({
+          fileUri: result.path!,
+          docType: result.selectedDocumentType,
+          docRegion: result.code,
+          templatePath: activeTemplatePath,
+          issuingSubdivision: result.issuingSubdivision,
+          token: token,
+          postfix: result.currentSide || 'back'
+        });
+
+        if (documentData?.no_data || (documentData?.data && Object.keys(documentData.data).length === 0)) {
+          logger.log("Back OCR Extraction: No text data found (Normal for barcode-only sides).");
+          if (!hasBarcode && !hasMrz) {
+            throw new Error("Impossible de lire les informations du document. L'image est peut-être floue ou mal éclairée.");
           }
-        } catch (err: any) {
-          // 🚨 FIX: Allow 401/403 errors to bubble up directly!
-          if (err?.response?.status === 401 || err?.response?.status === 403 || err?.status === 401) throw err;
-  
-          logger.log("MRZ Extraction Error:", err);
-          throw new Error(err?.message || "Erreur lors de l'extraction MRZ. Veuillez reprendre la photo.");
+        } else {
+          extractionResult.documentData = documentData;
         }
+      } catch (err: any) {
+        const errorMsg = typeof err === 'object' ? JSON.stringify(err) : err;
+        logger.log("Back OCR Extraction Error:", errorMsg);
+        throw new Error(err?.message || "Impossible d'extraire les données. Veuillez reprendre la photo.");
       }
-  
-      return { ...detected, croppedBase64, bbox, ...(mrz ? { mrz } : {}), ...(barcode ? { barcode } : {}), ...(documentData ? { documentData } : {}) };
-  
-    } catch (e: any) {
-      logger.log('Error front verification:', e?.message);
-      
-      // 🚨 FINAL FIX: If the root catch block receives an API error with a status code, 
-      // we must throw the RAW object so `handleSilentCapture` can read `e.response.status`.
-      if (e?.response?.status || e?.status || e?.isAxiosError) {
-        throw e;
+    }
+
+    if (hasMrz) {
+      try {
+        logger.log("Tentative d'extraction MRZ (Back)");
+        const mrzResponse = await kycService.extractMrzText({
+          fileUri: result.path!,
+          docType: result?.selectedDocumentType || '',
+          docRegion: result?.code || '',
+          postfix: result?.currentSide || 'back',
+          token: token,
+          template_path: activeTemplatePath,
+          mrz_type: result?.mrzType || 'TD1'
+        }, env);
+
+        const mrz = typeof mrzResponse === 'string' ? JSON.parse(mrzResponse) : mrzResponse;
+        if (mrz?.parsed_data?.status === 'FAILURE' || mrz?.success === false) {
+          throw new Error(mrz?.parsed_data?.status_message || 'Lecture MRZ échouée');
+        }
+        extractionResult.mrz = mrz;
+      } catch (mrzError: any) {
+        logger.log(`MRZ échoué: ${mrzError?.message}`);
+        throw new Error(`Lecture MRZ invalide: ${mrzError?.message || 'Veuillez nettoyer l\'objectif et réessayer'}`);
       }
-      
-      throw new Error(e?.message || 'Erreur de détection du visage');
     }
-  }
 
-export async function backVerification(
-    result: {
-        path?: string,
-        regionMapping: { authMethod: string[], mrzTypes: string[] },
-        selectedDocumentType: string,
-        code: string,
-        currentSide: string,
-        templatePath?: string,
-        mrzType?: string,
-        templateResponse?: ApiVerificationResponse,
-        issuingSubdivision?: string,
-        frontTemplatePath?: string,
-        clientSideBarcodeData?: string // 🚨 ADDED: Accept the SDK barcode data
-    },
-    env: KycEnvironment = 'PRODUCTION'
-) {
+    let bbox: IBbox | undefined;
+    let croppedBase64: string | undefined;
+
     try {
-        if (!result.path) throw new Error('No path provided');
-        logger.log("result.regionMapping", result.regionMapping, result.currentSide, result.code);
-        
-        const authMethods = Array.isArray(result.regionMapping?.authMethod)
-            ? result.regionMapping.authMethod.map(m => String(m).toUpperCase())
-            : [];
-            
-        const hasMrz = authMethods.some(m => m.includes('MRZ'));
-        const hasBarcode = authMethods.some(m => m.includes('BARCODE') || m.includes('2D'));
-        
-        if (env === 'SANDBOX') {
-            console.log("SANDBOX mode: Skipping AI verification for back document");
-            const mockBbox: IBbox = { minX: 400, minY: 800, width: 2200, height: 1400 };
-            const mockCardObb = [{
-                obb: [[400, 800], [2600, 800], [2600, 2200], [400, 2200]],
-                confidence: 0.95,
-                card_in_frame: true,
-                cropped_sides: []
-            }];
-            
-            if (hasMrz) {
-                return {
-                    success: true,
-                    mrz: {
-                        success: true,
-                        parsed_data: { status: 'SUCCESS', document_type: result.selectedDocumentType, mrz_type: result.mrzType || 'TD1' }
-                    },
-                    bbox: mockBbox,
-                    card_obb: mockCardObb
-                };
-            } else if (hasBarcode) {
-                return {
-                    success: true,
-                    barcode: { barcode_data: 'SANDBOX_MOCK_BARCODE' },
-                    bbox: mockBbox,
-                    card_obb: mockCardObb
-                };
-            }
-            return { success: true, bbox: mockBbox, card_obb: mockCardObb };
-        }
-        
-        const token = await authentification();
-        logger.log("1. Checking template and framing for back document...");
-        
-        const templateResponse: ApiVerificationResponse = result.templateResponse ||
-            await kycService.checkTemplateType({
-                fileUri: result.path,
-                docType: result.selectedDocumentType as any,
-                docRegion: result.code,
-                postfix: 'back',
-                token: token,
-            }, env);
-            
-        if (templateResponse.success === false || templateResponse.Error) {
-            throw new Error('Impossible de lire le document. Veuillez vous rapprocher et stabiliser la caméra.');
-        }
-        
-        const cardData = templateResponse?.card_obb && Array.isArray(templateResponse.card_obb) && templateResponse.card_obb.length > 0
-            ? templateResponse.card_obb[0]
-            : null;
-            
-        if (!cardData) throw new Error('CARD_NOT_FULLY_IN_FRAME');
-        
-        let points: number[][] | null = null;
-        console.log(points);
-        let isCardInFrame = false;
-        let hasCroppedSides = true;
-        
-        if (cardData.obb) {
-            points = cardData.obb;
-            if (typeof cardData.card_in_frame !== 'undefined') {
-                isCardInFrame = cardData.card_in_frame === true;
-                hasCroppedSides = Array.isArray(cardData.cropped_sides) && cardData.cropped_sides.length > 0;
-            }
-        } else if (Array.isArray(cardData) && Array.isArray(cardData[0])) {
-            points = cardData[0];
-            isCardInFrame = true;
-            hasCroppedSides = false;
-        }
-        
-        if (!isCardInFrame || hasCroppedSides) {
-            logger.log(`Back Framing failed. Backend reported document out of bounds.`);
-            throw new Error('CARD_NOT_FULLY_IN_FRAME');
-        }
-        
-        const obbConf = getObbConfidence(templateResponse?.card_obb);
-        if (obbConf !== null && obbConf < OBB_CONFIDENCE_THRESHOLD) {
-            throw new Error('Carte non entièrement visible. Positionnez toute la carte dans le cadre.');
-        }
-        
-        const activeTemplatePath = templateResponse.template_path || result.templatePath || '';
-        
-        if (activeTemplatePath) {
-            const countryInfo = countryData[result.code];
-            
-            const countryName = countryInfo?.name_en || countryInfo?.name || '';
-            
-            const hasCodeMatch = activeTemplatePath.toUpperCase().includes(`_${result.code.toUpperCase()}_`) || 
-                                activeTemplatePath.toUpperCase().includes(`${result.code.toUpperCase()}/`);
-                                
-            const hasNameMatch = countryName && activeTemplatePath.toLowerCase().includes(countryName.toLowerCase());
-
-            // 5. If NEITHER match, throw the error
-            if (!hasCodeMatch && !hasNameMatch) {
-                logger.log(`Template mismatch! Expected region: ${result.code} (${countryName}), Detected: ${activeTemplatePath}`);
-                throw new Error(`Le document ne correspond pas au pays sélectionné (${result.code}).`);
-            }
-        }
-        
-        if (result.frontTemplatePath && activeTemplatePath) {
-            try {
-                const frontPy = result.frontTemplatePath.split("/").pop()?.replace(/\.(jpg|png)$/i, ".py");
-                const backPy = activeTemplatePath.split("/").pop()?.replace(/\.(jpg|png)$/i, ".py");
-                
-                if (frontPy && backPy) {
-                    logger.log(`Validating Front (${frontPy}) vs Back (${backPy}) for region ${result.code}`);
-                    
-                    const isCanadianSubRegionDoc = result.code === 'CA' && ['pr'].includes(result.selectedDocumentType);
-                    const safeSubRegion = isCanadianSubRegionDoc ? (result.issuingSubdivision || "") : "";
-                    
-                    const matchValidation = await kycService.validateBackTemplate({
-                        region: result.code,
-                        docType: result.selectedDocumentType,
-                        frontTemplateName: frontPy,
-                        backTemplateName: backPy,
-                        subRegion: safeSubRegion,
-                        token: token
-                    }, env);
-                    
-                    if (!matchValidation || matchValidation.is_match === false) {
-                        logger.log(`Front/Back Mismatch: ${matchValidation?.status_message}`);
-                        throw new Error(`Le verso ne correspond pas au recto fourni. Vous avez scanné un document différent.`);
-                    }
-                }
-            } catch (err: any) {
-                if (err?.message?.includes('ne correspond pas')) throw err;
-                logger.log("Template matching validation skipped/failed internally:", err?.message);
-            }
-        }
-        
-        logger.log("Framing, Country, and Match verified successfully. Proceeding to Data Extraction.");
-        let extractionResult: any = {};
-        
-        if (result.code === 'CA') {
-            try {
-                logger.log("Tentative d'extraction OCR (Back) - Canada Only");
-                const documentData = await kycService.extractDocumentInformation({
-                    fileUri: result.path!,
-                    docType: result.selectedDocumentType,
-                    docRegion: result.code,
-                    templatePath: activeTemplatePath,
-                    issuingSubdivision: result.issuingSubdivision,
-                    token: token,
-                    postfix: result.currentSide || 'back'
-                });
-                
-                if (documentData?.no_data || (documentData?.data && Object.keys(documentData.data).length === 0)) {
-                    logger.log("Back OCR Extraction: No text data found (Normal for barcode-only sides).");
-                    if (!hasBarcode && !hasMrz) {
-                        throw new Error("Impossible de lire les informations du document. L'image est peut-être floue ou mal éclairée.");
-                    }
-                } else {
-                    extractionResult.documentData = documentData;
-                }
-            } catch (err: any) {
-                const errorMsg = typeof err === 'object' ? JSON.stringify(err) : err;
-                logger.log("Back OCR Extraction Error:", errorMsg);
-                throw new Error(err?.message || "Impossible d'extraire les données. Veuillez reprendre la photo.");
-            }
-        }
-        
-        if (hasMrz) {
-            try {
-                logger.log("Tentative d'extraction MRZ (Back)");
-                const mrzResponse = await kycService.extractMrzText({
-                    fileUri: result.path!,
-                    docType: result?.selectedDocumentType || '',
-                    docRegion: result?.code || '',
-                    postfix: result?.currentSide || 'back',
-                    token: token,
-                    template_path: activeTemplatePath,
-                    mrz_type: result?.mrzType || 'TD1'
-                }, env);
-                
-                const mrz = typeof mrzResponse === 'string' ? JSON.parse(mrzResponse) : mrzResponse;
-                
-                if (mrz?.parsed_data?.status === 'FAILURE' || mrz?.success === false) {
-                    throw new Error(mrz?.parsed_data?.status_message || 'Lecture MRZ échouée');
-                }
-                extractionResult.mrz = mrz;
-            } catch (mrzError: any) {
-                logger.log(`MRZ échoué: ${mrzError?.message}`);
-                throw new Error(`Lecture MRZ invalide: ${mrzError?.message || 'Veuillez nettoyer l\'objectif et réessayer'}`);
-            }
-        }
-        
-        
-        let bbox: IBbox | undefined;
-        let croppedBase64: string | undefined;
-        try {
-            const crop = await cropByObb(result?.path || '', templateResponse.card_obb);
-            bbox = crop.bbox;
-            croppedBase64 = crop.base64;
-        } catch { }
-        
-        return {
-            success: true,
-            ...extractionResult,
-            bbox,
-            croppedBase64,
-            card_obb: templateResponse.card_obb
-        };
-        
-    } catch (e: any) {
-        if (e?.message === 'CARD_NOT_FULLY_IN_FRAME') throw e;
-        throw new Error(e?.message || 'Erreur de détection des données');
+      const crop = await cropByObb(result?.path || '', templateResponse.card_obb);
+      bbox = crop.bbox;
+      croppedBase64 = crop.base64;
+    } catch {
     }
+
+    return {
+      success: true,
+      ...extractionResult,
+      bbox,
+      croppedBase64,
+      card_obb: templateResponse.card_obb
+    };
+
+  } catch (e: any) {
+    if (e?.message === 'CARD_NOT_FULLY_IN_FRAME') throw e;
+    throw new Error(e?.message || 'Erreur de détection des données');
+  }
 }
 
 export async function checkTemplateType(
-    result: { path?: string, docType: string, docRegion: string, postfix: string, issuingSubdivision?: string },
-    env: KycEnvironment = 'PRODUCTION'
-  ) {
-    try {
-      if (env === 'SANDBOX') {
-        return {
-          template_path: `templates/${result.docType}_${result.docRegion}_${result.postfix}.jpg`,
-          card_obb: [{ obb: [[400, 800], [2600, 800], [2600, 2200], [400, 2200]], confidence: 0.95, card_in_frame: true, cropped_sides: [] }]
-        };
-      }
-  
-      const token = await authentification();
-      const isCanada = result.docRegion?.toUpperCase() === 'CA';
-  
-      const templateType = await kycService.checkTemplateType({
-        fileUri: result.path || '',
-        docType: result?.docType as GovernmentDocumentType,
-        docRegion: result?.docRegion || "",
-        postfix: result?.postfix,
-        token: token,
-        issuingSubdivision: isCanada ? result.issuingSubdivision : undefined
-      }, env);
-  
-      if (templateType.success === false || templateType.Error) {
-        logger.log("Backend returned an error:", templateType.Error);
-        throw new Error('Impossible de lire le document. Veuillez vous rapprocher et stabiliser la caméra.');
-      }
-  
-      const cardData = templateType.card_obb && Array.isArray(templateType.card_obb) && templateType.card_obb.length > 0 ? templateType.card_obb[0] : null;
-  
-      if (!cardData) throw new Error('CARD_NOT_FULLY_IN_FRAME');
-  
-      let points: number[][] | null = null;
-      console.log(points);
-      let isCardInFrame = false;
-      let hasCroppedSides = true;
-  
-      if (cardData.obb) {
-        points = cardData.obb;
-        if (typeof cardData.card_in_frame !== 'undefined') {
-          isCardInFrame = cardData.card_in_frame === true;
-          hasCroppedSides = Array.isArray(cardData.cropped_sides) && cardData.cropped_sides.length > 0;
-        }
-      } else if (Array.isArray(cardData) && Array.isArray(cardData[0])) {
-        points = cardData[0];
-        isCardInFrame = true;
-        hasCroppedSides = false;
-      }
-  
-      if (!isCardInFrame || hasCroppedSides) {
-        logger.log(`Template Framing failed by backend check.`);
-        throw new Error('CARD_NOT_FULLY_IN_FRAME');
-      }
-  
-      const LPIPS_THRESHOLD = 0.75;
-      if (templateType.lpips_score !== undefined && templateType.lpips_score > LPIPS_THRESHOLD) {
-        logger.log(`Country Mismatch! LPIPS: ${templateType.lpips_score}`);
-        throw new Error(`Le document présenté ne correspond pas au pays sélectionné (${result.docRegion}).`);
-      }
-  
-      logger.log("templateType result", JSON.stringify(truncateFields(templateType), null, 2));
-  
-      return templateType;
-    } catch (e: any) {
-      logger.log('Error checking template type:', JSON.stringify(errorMessage(e), null, 2));
-  
-      // Safely extract the raw message to check for string-based errors like "Unauthorized"
-      const rawMessage = (typeof e === 'string' ? e : (e?.message || '')).toLowerCase();
-  
-      // 🚨 CRITICAL FIX: Ensure 401/403 and string-based "Unauthorized" errors bubble up exactly as they are!
-      if (
-        e?.response?.status === 401 || 
-        e?.response?.status === 403 || 
-        e?.status === 401 ||
-        rawMessage.includes('unauthorized') ||
-        rawMessage.includes('401')
-      ) {
-        throw e; 
-      }
-  
-      if (e?.isAxiosError) {
-        throw e;
-      }
-  
-      if (e?.message === 'CARD_NOT_FULLY_IN_FRAME' || e?.message?.includes('ne correspond pas')) {
-        throw e;
+  result: { path?: string, docType: string, docRegion: string, postfix: string, issuingSubdivision?: string },
+  env: KycEnvironment = 'PRODUCTION'
+) {
+  try {
+    const token = await authentification();
+    const isCanada = result.docRegion?.toUpperCase() === 'CA';
+
+    let safeCapturePath = result.path || '';
+    if (Platform.OS === 'ios' && safeCapturePath && !safeCapturePath.startsWith('file://')) {
+      safeCapturePath = `file://${safeCapturePath}`;
+    }
+    
+    const templateType = await kycService.checkTemplateType({
+      fileUri: safeCapturePath || '',
+      docType: result?.docType as GovernmentDocumentType,
+      docRegion: result?.docRegion || "",
+      postfix: result?.postfix,
+      token: token,
+      issuingSubdivision: isCanada ? result.issuingSubdivision : undefined
+    }, env);
+
+    if (templateType.success === false || templateType.Error) {
+      logger.log("Backend returned an error:", templateType.Error);
+      throw new Error('Impossible de lire le document. Veuillez vous rapprocher et stabiliser la caméra.');
+    }
+
+    const cardData = templateType.card_obb && Array.isArray(templateType.card_obb) && templateType.card_obb.length > 0 ? templateType.card_obb[0] : null;
+    if (!cardData) throw new Error('CARD_NOT_FULLY_IN_FRAME');
+
+    let points: number[][] | null = null;
+    console.log(points);
+    let isCardInFrame = false;
+    let hasCroppedSides = true;
+
+    if (cardData.obb) {
+      points = cardData.obb;
+      if (typeof cardData.card_in_frame !== 'undefined') {
+        isCardInFrame = cardData.card_in_frame === true;
+        hasCroppedSides = Array.isArray(cardData.cropped_sides) && cardData.cropped_sides.length > 0;
       }
-  
-      // Safely fall back without swallowing string-based errors
-      throw new Error(typeof e === 'string' ? e : (e?.message || 'Erreur de vérification du template'));
+    } else if (Array.isArray(cardData) && Array.isArray(cardData[0])) {
+      points = cardData[0];
+      isCardInFrame = true;
+      hasCroppedSides = false;
     }
-  }
+
+    if (!isCardInFrame || hasCroppedSides) {
+      logger.log(`Template Framing failed by backend check.`);
+      throw new Error('CARD_NOT_FULLY_IN_FRAME');
+    }
+
+    const LPIPS_THRESHOLD = 0.75;
+    if (templateType.lpips_score !== undefined && templateType.lpips_score > LPIPS_THRESHOLD) {
+      logger.log(`Country Mismatch! LPIPS: ${templateType.lpips_score}`);
+      throw new Error(`Le document présenté ne correspond pas au pays sélectionné (${result.docRegion}).`);
+    }
+
+    logger.log("templateType result", JSON.stringify(truncateFields(templateType), null, 2));
+    return templateType;
+
+  } catch (e: any) {
+    logger.log('Error checking template type:', JSON.stringify(errorMessage(e), null, 2));
+    const rawMessage = (typeof e === 'string' ? e : (e?.message || '')).toLowerCase();
+
+    if (
+      e?.response?.status === 401 || e?.response?.status === 403 || 
+      e?.status === 401 || rawMessage.includes('unauthorized') || rawMessage.includes('401')
+    ) {
+      throw e;
+    }
+
+    if (e?.isAxiosError) {
+      throw e;
+    }
+
+    if (e?.message === 'CARD_NOT_FULLY_IN_FRAME' || e?.message?.includes('ne correspond pas')) {
+      throw e;
+    }
+
+    throw new Error(typeof e === 'string' ? e : (e?.message || 'Erreur de vérification du template'));
+  }
+}