@sanctum-key/react-native-sdk 1.0.47 → 1.0.48

package/src/modules/api/CardAuthentification.ts

@@ -23,173 +23,133 @@ interface ApiVerificationResponse {
 }
 
 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 // 🚨 ADDED: Accept the SDK barcode data
-    },
+    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;
-        }
-        
-        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;
-            }
-        }
-        
-        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.');
+      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;
+      }
+  
+      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;
         }
-        
-        let croppedBase64: string | undefined;
-        let bbox: IBbox | undefined;
-        let mrz: any | undefined;
-        let barcode: any | undefined;
-        let documentData: any | undefined;
-        
+      }
+  
+      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 {
-            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) {
-                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.");
+          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) {
+          // 🚨 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.");
         }
-        
-        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) {
-                logger.log("MRZ Extraction Error:", err);
-                throw new Error(err?.message || "Erreur lors de l'extraction MRZ. Veuillez reprendre la photo.");
-            }
+      }
+  
+      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) {
+          // 🚨 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.");
         }
-        
-
-        
-        return {
-            ...detected,
-            croppedBase64,
-            bbox,
-            ...(mrz ? { mrz } : {}),
-            ...(barcode ? { barcode } : {}),
-            ...(documentData ? { documentData } : {})
-        };
-        
+      }
+  
+      return { ...detected, croppedBase64, bbox, ...(mrz ? { mrz } : {}), ...(barcode ? { barcode } : {}), ...(documentData ? { documentData } : {}) };
+  
     } catch (e: any) {
-        logger.log('Error front verification:', e?.message);
-        throw new Error(e?.message || 'Erreur de détection du visage');
+      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;
+      }
+      
+      throw new Error(e?.message || 'Erreur de détection du visage');
     }
-}
+  }
 
 export async function backVerification(
     result: {
@@ -428,88 +388,95 @@ export async function backVerification(
 }
 
 export async function checkTemplateType(
-    result: { 
-         path?: string, 
-         docType: string, 
-         docRegion: string, 
-         postfix: string,
-         issuingSubdivision?: string 
-    },
+    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}).`);
+      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;
         }
-        
-        logger.log("templateType result", JSON.stringify(truncateFields(templateType), null, 2));
-        return templateType;
-        
+      } 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));
-        if (e?.response?.status === 401 || e?.response?.status === 403 || e?.isAxiosError) {
-            throw e; 
-        }
-        if (e?.message === 'CARD_NOT_FULLY_IN_FRAME' || e?.message?.includes('ne correspond pas')) throw e;
-        throw new Error(e?.message || 'Erreur de vérification du template');
+      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;
+      }
+  
+      // Safely fall back without swallowing string-based errors
+      throw new Error(typeof e === 'string' ? e : (e?.message || 'Erreur de vérification du template'));
     }
-}
+  }

package/src/modules/api/KYCService.ts

@@ -474,14 +474,17 @@ export const authentification = async (): Promise<string> => {
       
       cachedToken = token;
       tokenExpiryTime = Date.now() + ((res.data.expires_in || 300) * 1000);
+      activeAuthRequest = null; // 🚨 FIX: Clear the promise once resolved
       
-      return cachedToken as string; // 🚨 Guaranteed string to satisfy TypeScript
+      return cachedToken as string;
     })();
     
     return await activeAuthRequest;
   } catch (error: any) {
     cachedToken = null;
+    tokenExpiryTime = null; 
     activeAuthRequest = null;
+    
     const safeErrorMessage = error?.response?.data?.error_description || error?.message || 'Unknown error';
     logger.error('Error authentifying:', safeErrorMessage);
     throw new Error(`Échec de l'authentification: ${safeErrorMessage}`);
@@ -489,9 +492,13 @@ export const authentification = async (): Promise<string> => {
 }
 
 export const clearAuthToken = () => {
-  cachedToken = null; // Clear memory cache
+  logger.log("Wiping AI services auth token cache...");
+  cachedToken = null;
+  tokenExpiryTime = null;
+  activeAuthRequest = null;
 };
 
+
 export const errorMessage = (error: any) => {
   return error.response?.data?.message || error.response?.data?.detail || error.response?.data?.error || error.response?.data || error.message;
 }

package/src/types/KYC.types.ts

@@ -478,6 +478,7 @@ export interface TemplateActions {
   validateComponent: (componentId: number, dataOverride?: any) => boolean;
   submitTemplate: () => Promise<void>;
   resetTemplate: () => void;
+  restartSession: () => void;
   setLanguage: (language: string) => void;
   showCustomStepper: (show: boolean) => void;
   setVerificationState: (state: VerificationState) => void;