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

package/build/src/components/KYCElements/IDCardCapture.js

@@ -504,6 +504,8 @@ export const IDCardCapture = ({ component, value = {}, onValueChange, error, lan
             return;
         if (isAnalyzingRef.current)
             return;
+        // 🚨 SYNCHRONOUS LOCK: Block all subsequent camera frames immediately
+        isAnalyzingRef.current = true;
         const side = currentSideRef.current;
         const captured = capturedImagesRef.current;
         const docType = selectedDocTypeRef.current;
@@ -516,17 +518,30 @@ export const IDCardCapture = ({ component, value = {}, onValueChange, error, lan
             let templateResponse;
             if (!docType) {
                 setSilentCaptureResult((prev) => ({ ...prev, isAnalyzing: false, success: false, error: 'Document type not selected' }));
+                isAnalyzingRef.current = false; // 🚨 UNLOCK
                 return;
             }
             const issuingSubdivision = docType.region !== 'root' ? docType.region : undefined;
             const watchdog = setTimeout(() => {
                 if (isAnalyzingRef.current) {
-                    setSilentCaptureResult((prev) => ({ ...prev, isAnalyzing: false, success: false, error: state.currentLanguage === 'en' ? 'Taking longer than expected. Hold steady.' : 'Traitement long. Veuillez rester immobile.' }));
+                    isAnalyzingRef.current = false; // 🚨 UNLOCK inside watchdog
+                    setSilentCaptureResult((prev) => ({
+                        ...prev,
+                        isAnalyzing: false,
+                        success: false,
+                        error: state.currentLanguage === 'en' ? 'Taking longer than expected. Hold steady.' : 'Traitement long. Veuillez rester immobile.'
+                    }));
                 }
             }, 20000);
             try {
                 if (!templatePath) {
-                    const templateType = await checkTemplateType({ path: safeCapturePath, docType: docType.type, docRegion: cData?.code || "", postfix: side, issuingSubdivision: issuingSubdivision }, env);
+                    const templateType = await checkTemplateType({
+                        path: safeCapturePath,
+                        docType: docType.type,
+                        docRegion: cData?.code || "",
+                        postfix: side,
+                        issuingSubdivision: issuingSubdivision
+                    }, env);
                     templateResponse = templateType;
                     if (templateType.template_path)
                         templatePath = templateType.template_path;
@@ -535,6 +550,7 @@ export const IDCardCapture = ({ component, value = {}, onValueChange, error, lan
                         if (obbConfidence !== null && obbConfidence < OBB_CONFIDENCE_THRESHOLD) {
                             clearTimeout(watchdog);
                             setSilentCaptureResult((prev) => ({ ...prev, isAnalyzing: false, success: false, error: t('kyc.idCardCapture.cardNotFullyInFrame') }));
+                            isAnalyzingRef.current = false; // 🚨 UNLOCK
                             return;
                         }
                         try {
@@ -551,13 +567,34 @@ export const IDCardCapture = ({ component, value = {}, onValueChange, error, lan
                 if (side === 'front') {
                     const matchedAuthMethod = getCorrespondingAuthMethod(templatePath, regionMappings.regionMapping, regionMappings.key || '', 'front');
                     const mrzType = getCorrespondingMrzType(templatePath, regionMappings.regionMapping, regionMappings.key || '') || 'TD1';
-                    verificationRes = await frontVerification({ path: safeCapturePath, regionMapping: { authMethod: matchedAuthMethod ? [matchedAuthMethod] : [], mrzTypes: mrzType ? [mrzType] : [] }, selectedDocumentType: GovernmentDocumentTypeShorted[docType.type] || '', code: cData?.code || '', currentSide: side, templatePath, mrzType, issuingSubdivision: issuingSubdivision, clientSideBarcodeData: silentCaptureResult.barcode }, env);
+                    verificationRes = await frontVerification({
+                        path: safeCapturePath,
+                        regionMapping: { authMethod: matchedAuthMethod ? [matchedAuthMethod] : [], mrzTypes: mrzType ? [mrzType] : [] },
+                        selectedDocumentType: GovernmentDocumentTypeShorted[docType.type] || '',
+                        code: cData?.code || '',
+                        currentSide: side,
+                        templatePath,
+                        mrzType,
+                        issuingSubdivision: issuingSubdivision,
+                        clientSideBarcodeData: silentCaptureResult.barcode
+                    }, env);
                 }
                 else {
                     const matchedBackAuthMethod = getCorrespondingAuthMethod(templatePath, regionMappings.regionMapping, regionMappings.key || '', 'back');
                     const backMrzType = getCorrespondingMrzType(templatePath, regionMappings.regionMapping, regionMappings.key || '') || '';
                     const frontTemplatePath = captured['front']?.templatePath || '';
-                    verificationRes = await backVerification({ path: safeCapturePath, regionMapping: { authMethod: matchedBackAuthMethod ? [matchedBackAuthMethod] : [], mrzTypes: backMrzType ? [backMrzType] : [] }, selectedDocumentType: GovernmentDocumentTypeShorted[docType.type] || '', code: cData?.code || '', currentSide: side, templatePath, mrzType: backMrzType, templateResponse, issuingSubdivision: issuingSubdivision, frontTemplatePath: frontTemplatePath }, env);
+                    verificationRes = await backVerification({
+                        path: safeCapturePath,
+                        regionMapping: { authMethod: matchedBackAuthMethod ? [matchedBackAuthMethod] : [], mrzTypes: backMrzType ? [backMrzType] : [] },
+                        selectedDocumentType: GovernmentDocumentTypeShorted[docType.type] || '',
+                        code: cData?.code || '',
+                        currentSide: side,
+                        templatePath,
+                        mrzType: backMrzType,
+                        templateResponse,
+                        issuingSubdivision: issuingSubdivision,
+                        frontTemplatePath: frontTemplatePath
+                    }, env);
                 }
                 const bbox = verificationRes?.bbox || templateBbox;
                 const verifiedMrz = verificationRes?.mrz ? JSON.stringify(verificationRes.mrz) : "";
@@ -574,113 +611,83 @@ export const IDCardCapture = ({ component, value = {}, onValueChange, error, lan
                             const token = await authentification();
                             parsedDictionary = await kycService.formatBarcodeData({ textInput: barcodeData, token }, env);
                         }
-                        const verifiedResult = { path: safeCapturePath, templatePath: templatePath, bbox: bbox, success: true, mrz: JSON.stringify(parsedDictionary), barcode: barcodeData, isAnalyzing: false, country: cData?.code, documentType: docType.type, region: docType.region !== 'root' ? docType.region : undefined };
+                        const verifiedResult = {
+                            path: safeCapturePath, templatePath: templatePath, bbox: bbox, success: true,
+                            mrz: JSON.stringify(parsedDictionary), barcode: barcodeData, isAnalyzing: false,
+                            country: cData?.code, documentType: docType.type, region: docType.region !== 'root' ? docType.region : undefined
+                        };
                         clearTimeout(watchdog);
                         setSilentCaptureResult(verifiedResult);
                         if (bbox)
                             setBboxBySide(prev => ({ ...prev, ['back']: bbox }));
+                        isAnalyzingRef.current = false; // 🚨 UNLOCK on success
                         await autoCapture(safeCapturePath, verifiedResult);
                         return;
                     }
-                    sdkLogger.info(`Verification passed. Waiting for barcode scan phase.`); // 🚨 LOG
+                    sdkLogger.info(`Verification passed. Waiting for barcode scan phase.`);
                     clearTimeout(watchdog);
                     setPendingCAImage({ path: safeCapturePath, templateResponse, templatePath, bbox });
                     setScanPhase('barcode');
                     setSilentCaptureResult(prev => ({ ...prev, isAnalyzing: false }));
+                    isAnalyzingRef.current = false; // 🚨 UNLOCK before phase shift
                     return;
                 }
-                const verifiedResult = { path: safeCapturePath, templatePath, bbox, success: true, mrz: verifiedMrz, isAnalyzing: false, country: cData?.code, documentType: docType.type, region: issuingSubdivision };
+                const verifiedResult = {
+                    path: safeCapturePath, templatePath, bbox, success: true, mrz: verifiedMrz, isAnalyzing: false,
+                    country: cData?.code, documentType: docType.type, region: issuingSubdivision
+                };
                 clearTimeout(watchdog);
                 setSilentCaptureResult(verifiedResult);
                 if (bbox)
                     setBboxBySide(prev => ({ ...prev, [side]: bbox }));
+                isAnalyzingRef.current = false; // 🚨 UNLOCK on final success
                 await autoCapture(safeCapturePath, verifiedResult);
             }
             catch (error) {
                 clearTimeout(watchdog);
                 const rawMessage = (typeof error === 'string' ? error : (error?.message || '')).toLowerCase();
                 const statusCode = error?.response?.status || error?.status;
-                if (statusCode === 401 ||
-                    statusCode === 403 ||
-                    rawMessage.includes('401') ||
-                    rawMessage.includes('unauthorized') ||
-                    rawMessage.includes('token') ||
-                    rawMessage.includes('unauthenticated')) {
+                if (statusCode === 401 || statusCode === 403 ||
+                    rawMessage.includes('401') || rawMessage.includes('unauthorized') ||
+                    rawMessage.includes('token') || rawMessage.includes('unauthenticated')) {
                     sdkLogger.error(`Secure API Session Expired during AI extraction`);
                     setShowCamera(false);
                     setIsProcessingCapture(false);
                     setSilentCaptureResult(prev => ({ ...prev, isAnalyzing: false, success: false, error: '' }));
-                    // Use React Native's native Alert to wait for the user's tap
-                    Alert.alert(state.currentLanguage === 'en' ? 'Session Expired' : 'Session Expirée', state.currentLanguage === 'en'
-                        ? 'Your secure session has expired. Please restart the process.'
-                        : 'Votre session sécurisée a expiré. Veuillez recommencer.', [
-                        {
-                            text: state.currentLanguage === 'en' ? 'Restart' : 'Recommencer',
-                            onPress: () => handleExitKYCFlow() // Redirects ONLY when they click the button
-                        }
-                    ], { cancelable: false } // Forces them to click the button
-                    );
+                    Alert.alert(state.currentLanguage === 'en' ? 'Session Expired' : 'Session Expirée', state.currentLanguage === 'en' ? 'Your secure session has expired. Please restart the process.' : 'Votre session sécurisée a expiré. Veuillez recommencer.', [{ text: state.currentLanguage === 'en' ? 'Restart' : 'Recommencer', onPress: () => handleExitKYCFlow() }], { cancelable: false });
+                    isAnalyzingRef.current = false; // 🚨 UNLOCK on session expiry
                     return;
                 }
                 let hintMessage = '';
-                // 2. Business Logic Errors
-                if (rawMessage.includes('card_not_fully_in_frame') ||
-                    rawMessage.includes('non entièrement visible') ||
-                    rawMessage.includes('aucun visage détecté') ||
-                    rawMessage.includes('stabiliser la caméra')) {
-                    hintMessage = state.currentLanguage === 'en'
-                        ? 'Ensure the entire card and your face are clearly inside the frame.'
-                        : 'Assurez-vous que toute la carte et le visage sont clairement dans le cadre.';
+                if (rawMessage.includes('card_not_fully_in_frame') || rawMessage.includes('non entièrement visible') || rawMessage.includes('aucun visage détecté') || rawMessage.includes('stabiliser la caméra')) {
+                    hintMessage = state.currentLanguage === 'en' ? 'Ensure the entire card and your face are clearly inside the frame.' : 'Assurez-vous que toute la carte et le visage sont clairement dans le cadre.';
                 }
-                // 2. Document/Country Mismatch
-                // Catches: 'pays sélectionné', 'LPIPS'
                 else if (rawMessage.includes('pays sélectionné')) {
-                    hintMessage = state.currentLanguage === 'en'
-                        ? 'This document does not match the selected country.'
-                        : 'Ce document ne correspond pas au pays sélectionné.';
+                    hintMessage = state.currentLanguage === 'en' ? 'This document does not match the selected country.' : 'Ce document ne correspond pas au pays sélectionné.';
                 }
-                // 3. Front/Back Document Mismatch
-                // Catches: 'ne correspond pas au recto', 'document différent'
                 else if (rawMessage.includes('ne correspond pas au recto') || rawMessage.includes('document différent')) {
-                    hintMessage = state.currentLanguage === 'en'
-                        ? 'Please scan the back of the exact same ID.'
-                        : 'Veuillez scanner le verso de la même pièce d\'identité.';
+                    hintMessage = state.currentLanguage === 'en' ? 'Please scan the back of the exact same ID.' : 'Veuillez scanner le verso de la même pièce d\'identité.';
                 }
-                // 4. Data Extraction Failures (OCR & MRZ)
-                // Catches: 'impossible de lire', 'impossible d'extraire', 'mrz illisible', 'lecture mrz invalide'
-                else if (rawMessage.includes('impossible de lire') ||
-                    rawMessage.includes('impossible d\'extraire') ||
-                    rawMessage.includes('mrz') ||
-                    rawMessage.includes('extraction') ||
-                    rawMessage.includes('illisible') ||
-                    rawMessage.includes('invalide')) {
-                    hintMessage = state.currentLanguage === 'en'
-                        ? 'Cannot read document text. Avoid glare, improve lighting, and hold steady.'
-                        : 'Impossible de lire le texte. Évitez les reflets, améliorez l\'éclairage et restez immobile.';
+                else if (rawMessage.includes('impossible de lire') || rawMessage.includes('impossible d\'extraire') || rawMessage.includes('mrz') || rawMessage.includes('extraction') || rawMessage.includes('illisible') || rawMessage.includes('invalide')) {
+                    hintMessage = state.currentLanguage === 'en' ? 'Cannot read document text. Avoid glare, improve lighting, and hold steady.' : 'Impossible de lire le texte. Évitez les reflets, améliorez l\'éclairage et restez immobile.';
                 }
-                // 5. Server Infrastructure & Downtime
-                // Catches: Cloudflare tunnel errors, 502/503 Gateway timeouts
-                else if (rawMessage.includes('cloudflare') ||
-                    rawMessage.includes('tunnel') ||
-                    rawMessage.includes('502') ||
-                    rawMessage.includes('503')) {
-                    hintMessage = state.currentLanguage === 'en'
-                        ? 'Server is temporarily offline. Please try again in a few minutes.'
-                        : 'Le serveur est temporairement hors ligne. Veuillez réessayer dans quelques minutes.';
+                else if (rawMessage.includes('cloudflare') || rawMessage.includes('tunnel') || rawMessage.includes('502') || rawMessage.includes('503')) {
+                    hintMessage = state.currentLanguage === 'en' ? 'Server is temporarily offline. Please try again in a few minutes.' : 'Le serveur est temporairement hors ligne. Veuillez réessayer dans quelques minutes.';
                 }
-                // 6. True Network Errors vs. Fallback Processing
                 else {
-                    // Strictly detect Axios network drops without swallowing unknown custom errors
                     const isNetworkError = error?.isAxiosError || rawMessage === 'network error' || error?.code === 'econnaborted' || rawMessage.includes('network');
                     if (isNetworkError) {
-                        hintMessage = state.currentLanguage === 'en'
-                            ? 'Poor connection. Please check your internet.'
-                            : 'Connexion faible. Veuillez vérifier votre internet.';
+                        hintMessage = state.currentLanguage === 'en' ? 'Poor connection. Please check your internet.' : 'Connexion faible. Veuillez vérifier votre internet.';
                     }
                 }
                 setSilentCaptureResult(prev => ({ ...prev, isAnalyzing: false, success: false, error: hintMessage }));
+                isAnalyzingRef.current = false; // 🚨 UNLOCK at end of catch block
             }
         }
+        else {
+            // 🚨 UNLOCK if the camera frame was invalid or empty
+            isAnalyzingRef.current = false;
+        }
     };
     useEffect(() => {
         if (scanPhase === 'barcode' && pendingCAImage && silentCaptureResult.barcode) {