@sanctum-key/react-native-sdk 1.0.5 → 1.0.7

package/build/src/index.d.ts

@@ -1,8 +1,8 @@
-export * from './TransfergratisSdk.types';
+export * from './SanctumKeySdk.types';
 export * from './types/KYC.types';
 export * from './types/env.types';
-export { TemplateKYCExample as LaunchTransferGratisKYC } from './components/TemplateKYCExample';
-export { TemplateKYCExample as LauchTransferGratisKYC } from './components/TemplateKYCExample';
+export { TemplateKYCExample as LaunchSanctumKeyKYC } from './components/TemplateKYCExample';
+export { TemplateKYCExample as LauchSanctumKeyKYC } from './components/TemplateKYCExample';
 export { TemplateKYCFlow } from './components/TemplateKYCFlowRefactored';
 export { default as templateService } from './modules/api/TemplateService';
 export { transformBackendTemplateToSDK, validateTransformedTemplate } from './utils/template-transformer';

package/build/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAI1C,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,kBAAkB,IAAI,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAEhG,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAG/F,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAGzE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAItC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,kBAAkB,IAAI,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE5F,OAAO,EAAE,kBAAkB,IAAI,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAG3F,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAGzE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC"}

package/build/src/index.js

@@ -1,11 +1,11 @@
-export * from './TransfergratisSdk.types';
+export * from './SanctumKeySdk.types';
 // Export KYC types
 export * from './types/KYC.types';
 // Export Environment types
 export * from './types/env.types';
-export { TemplateKYCExample as LaunchTransferGratisKYC } from './components/TemplateKYCExample';
+export { TemplateKYCExample as LaunchSanctumKeyKYC } from './components/TemplateKYCExample';
 // Backward compatibility for existing integrations using the typo.
-export { TemplateKYCExample as LauchTransferGratisKYC } from './components/TemplateKYCExample';
+export { TemplateKYCExample as LauchSanctumKeyKYC } from './components/TemplateKYCExample';
 // Export Template Flow Components
 export { TemplateKYCFlow } from './components/TemplateKYCFlowRefactored';
 // Export Template Service and Utilities

package/build/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAG1C,mBAAmB;AACnB,cAAc,mBAAmB,CAAC;AAElC,2BAA2B;AAC3B,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,kBAAkB,IAAI,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAChG,mEAAmE;AACnE,OAAO,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE/F,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAEzE,wCAAwC;AACxC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC","sourcesContent":["export * from './TransfergratisSdk.types';\n\n\n// Export KYC types\nexport * from './types/KYC.types';\n\n// Export Environment types\nexport * from './types/env.types';\n\n\nexport { TemplateKYCExample as LaunchTransferGratisKYC } from './components/TemplateKYCExample';\n// Backward compatibility for existing integrations using the typo.\nexport { TemplateKYCExample as LauchTransferGratisKYC } from './components/TemplateKYCExample';\n\n// Export Template Flow Components\nexport { TemplateKYCFlow } from './components/TemplateKYCFlowRefactored';\n\n// Export Template Service and Utilities\nexport { default as templateService } from './modules/api/TemplateService';\nexport { transformBackendTemplateToSDK, validateTransformedTemplate } from './utils/template-transformer';\nexport { useTemplateLoader } from './hooks/useTemplateLoader';\n\n// Export Template Components\nexport { WelcomeTemplate } from './components/KYCElements/WelcomeTemplate';\nexport { EnhancedCameraView } from './components/EnhancedCameraView';\nexport { UnifiedCameraModule } from './modules/camera';\n\n// Export Web KYC Components\nexport { WebKYCEntry } from './web';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAGtC,mBAAmB;AACnB,cAAc,mBAAmB,CAAC;AAElC,2BAA2B;AAC3B,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,kBAAkB,IAAI,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,mEAAmE;AACnE,OAAO,EAAE,kBAAkB,IAAI,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE3F,kCAAkC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAEzE,wCAAwC;AACxC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC1G,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC","sourcesContent":["export * from './SanctumKeySdk.types';\n\n\n// Export KYC types\nexport * from './types/KYC.types';\n\n// Export Environment types\nexport * from './types/env.types';\n\n\nexport { TemplateKYCExample as LaunchSanctumKeyKYC } from './components/TemplateKYCExample';\n// Backward compatibility for existing integrations using the typo.\nexport { TemplateKYCExample as LauchSanctumKeyKYC } from './components/TemplateKYCExample';\n\n// Export Template Flow Components\nexport { TemplateKYCFlow } from './components/TemplateKYCFlowRefactored';\n\n// Export Template Service and Utilities\nexport { default as templateService } from './modules/api/TemplateService';\nexport { transformBackendTemplateToSDK, validateTransformedTemplate } from './utils/template-transformer';\nexport { useTemplateLoader } from './hooks/useTemplateLoader';\n\n// Export Template Components\nexport { WelcomeTemplate } from './components/KYCElements/WelcomeTemplate';\nexport { EnhancedCameraView } from './components/EnhancedCameraView';\nexport { UnifiedCameraModule } from './modules/camera';\n\n// Export Web KYC Components\nexport { WebKYCEntry } from './web';\n"]}

package/build/src/modules/api/CardAuthentification.d.ts

@@ -70,11 +70,6 @@ export declare function backVerification(result: {
     mrzType?: string;
     templateResponse?: ApiVerificationResponse;
 }, env?: KycEnvironment): Promise<any>;
-/**
- * Check template type
- * @param result
- * @returns
- */
 export declare function checkTemplateType(result: {
     path?: string;
     docType: string;

package/build/src/modules/api/CardAuthentification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CardAuthentification.d.ts","sourceRoot":"","sources":["../../../../src/modules/api/CardAuthentification.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAKvD,UAAU,WAAW;IACjB,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,UAAU,uBAAuB;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,wBAAsB,iBAAiB,CACnC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAChM,GAAG,GAAE,cAA6B;;;;;;;;;;;;;;;;;;;;;;;;aAXzB,OAAO;cACN,OAAO;aACR,GAAG,EAAE;eACH,WAAW,EAAE,GAAG,GAAG;oBACd,MAAM;YACd,GAAG;GAkJd;AAGD,wBAAsB,gBAAgB,CAClC,MAAM,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,uBAAuB,CAAA;CAC7C,EACD,GAAG,GAAE,cAA6B,gBAoNrC;AAGD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,GAAE,cAA6B,gBAoFzJ"}
+{"version":3,"file":"CardAuthentification.d.ts","sourceRoot":"","sources":["../../../../src/modules/api/CardAuthentification.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,UAAU,WAAW;IACjB,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,UAAU,uBAAuB;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AA8CD,wBAAsB,iBAAiB,CACnC,MAAM,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,EACD,GAAG,GAAE,cAA6B;;;;;;;;;;;;;;;;;;;;;;;;aA/DzB,OAAO;cACN,OAAO;aACR,GAAG,EAAE;eACH,WAAW,EAAE,GAAG,GAAG;oBACd,MAAM;YACd,GAAG;GAqLd;AAID,wBAAsB,gBAAgB,CAClC,MAAM,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,uBAAuB,CAAA;CAC7C,EACD,GAAG,GAAE,cAA6B,gBA0LrC;AAED,wBAAsB,iBAAiB,CACnC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC9E,GAAG,GAAE,cAA6B,gBAiFrC"}

package/build/src/modules/api/CardAuthentification.js

@@ -2,14 +2,47 @@ import kycService, { authentification, errorMessage, truncateFields } from "./KY
 import { cropByObb, getObbConfidence, OBB_CONFIDENCE_THRESHOLD } from "../../utils/cropByObb";
 import { logger } from "../../utils/logger";
 import { countryData } from "../../config/countriesData";
+function getDistance(p1, p2) {
+    return Math.sqrt(Math.pow(p2[0] - p1[0], 2) + Math.pow(p2[1] - p1[1], 2));
+}
+function getPolygonArea(points) {
+    const n = points.length;
+    let area = 0;
+    for (let i = 0; i < n; i++) {
+        const j = (i + 1) % n;
+        area += points[i][0] * points[j][1];
+        area -= points[j][0] * points[i][1];
+    }
+    return Math.abs(area) / 2;
+}
+function assertCardNotTooFar(points) {
+    if (!points || points.length < 3)
+        return;
+    const longestCardEdge = Math.max(getDistance(points[0], points[1]), getDistance(points[1], points[2]), getDistance(points[2], points[3] ?? points[0]));
+    const cardArea = getPolygonArea(points);
+    logger.log(`Card distance check – longest edge: ${Math.round(longestCardEdge)} px, ` +
+        `OBB area: ${Math.round(cardArea)} px²`);
+    if (longestCardEdge < 700) {
+        logger.log(`🛑 Rejected: longest edge too short (${Math.round(longestCardEdge)} px < 700 px)`);
+        throw new Error('TOO_FAR_AWAY');
+    }
+    if (cardArea < 400_000) {
+        logger.log(`🛑 Rejected: card area too small (${Math.round(cardArea)} px² < 400 000 px²)`);
+        throw new Error('TOO_FAR_AWAY');
+    }
+}
+// ─── frontVerification ────────────────────────────────────────────────────────
 export async function frontVerification(result, env = 'PRODUCTION') {
     try {
         console.log("Front verification START", JSON.stringify({ result }, null, 2));
         logger.log("Front verification", JSON.stringify({ result }, null, 2));
-        // SANDBOX mode
+        // 🚨 FIX 1: Bulletproof Case-Insensitive Check
+        const authMethods = Array.isArray(result.regionMapping?.authMethod)
+            ? result.regionMapping.authMethod.map(m => String(m).toUpperCase())
+            : [];
+        const hasMrz = authMethods.some(m => m.includes('MRZ'));
         if (env === 'SANDBOX') {
             console.log("SANDBOX mode: Skipping AI verification for front document");
-            logger.log("SANDBOX mode: Returning mock front verification response");
             const mockBbox = { minX: 400, minY: 800, width: 2200, height: 1400 };
             const mockResponse = {
                 result: true,
@@ -21,11 +54,11 @@ export async function frontVerification(result, env = 'PRODUCTION') {
                         cropped_sides: []
                     }],
                 bbox: mockBbox,
-                ...(result.regionMapping?.authMethod?.includes('MRZ') ? {
+                ...(hasMrz ? {
                     mrz: {
                         success: true,
                         parsed_data: {
-                            status: 'success',
+                            status: 'SUCCESS',
                             document_type: result.selectedDocumentType,
                             mrz_type: result.mrzType || 'TD1'
                         }
@@ -35,7 +68,6 @@ export async function frontVerification(result, env = 'PRODUCTION') {
             return mockResponse;
         }
         const token = await authentification();
-        // Cast the response so TypeScript knows about card_obb
         const detected = await kycService.detectFaceOnId(result?.path || '', token, result?.selectedDocumentType || '', env);
         if (!detected.result) {
             throw new Error('Aucun visage détecté sur la carte. Veuillez reprendre.');
@@ -46,7 +78,6 @@ export async function frontVerification(result, env = 'PRODUCTION') {
         let points = null;
         let isCardInFrame = true;
         let hasCroppedSides = false;
-        // Extract data safely
         if (cardData) {
             points = cardData.obb;
             if (typeof cardData.card_in_frame !== 'undefined') {
@@ -54,31 +85,17 @@ export async function frontVerification(result, env = 'PRODUCTION') {
                 hasCroppedSides = Array.isArray(cardData.cropped_sides) && cardData.cropped_sides.length > 0;
             }
         }
-        // --- 1. STRICT FRAMING CHECK (MUST HAPPEN FIRST) ---
         if (!isCardInFrame || hasCroppedSides) {
             logger.log(`Front Framing failed. Cropped sides detected.`);
             throw new Error('CARD_NOT_FULLY_IN_FRAME');
         }
-        // --- 2. STRICT DISTANCE CHECK (ONLY RUNS IF FULLY IN FRAME) ---
-        if (points && points.length === 4) {
-            const getDistance = (p1, p2) => Math.sqrt(Math.pow(p2[0] - p1[0], 2) + Math.pow(p2[1] - p1[1], 2));
-            const longestCardEdge = Math.max(getDistance(points[0], points[1]), getDistance(points[1], points[2]));
-            const maxX = Math.max(points[0][0], points[1][0], points[2][0], points[3][0]);
-            const maxY = Math.max(points[0][1], points[1][1], points[2][1], points[3][1]);
-            const estimatedImageScale = Math.max(maxX, maxY);
-            const fillPercentage = longestCardEdge / estimatedImageScale;
-            logger.log(`Front Card Fill Percentage: ${(fillPercentage * 100).toFixed(1)}%`);
-            if (fillPercentage < 0.50) {
-                logger.log("🛑 Front Image rejected: Document is too far away.");
-                throw new Error("TOO_FAR_AWAY");
-            }
+        if (points && points.length >= 3) {
+            assertCardNotTooFar(points);
         }
-        // Check Confidence Threshold
         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.');
         }
-        // Optional: crop image using card_obb for better MRZ/barcode extraction
         let croppedBase64;
         let bbox;
         let mrz;
@@ -88,40 +105,49 @@ export async function frontVerification(result, env = 'PRODUCTION') {
             bbox = crop.bbox;
         }
         catch { }
-        // MRZ Extraction: only run when a concrete mrzType is available
-        const shouldRunMrzExtraction = result.regionMapping?.authMethod?.length > 0 &&
-            result.regionMapping.authMethod.includes('MRZ') &&
-            !!result?.mrzType;
-        if (shouldRunMrzExtraction) {
-            const mrzResponse = await kycService.extractMrzText({
-                fileUri: result.path || '',
-                docType: result?.selectedDocumentType || '',
-                docRegion: result?.code || "",
-                postfix: result?.currentSide,
-                token: token,
-                template_path: result?.templatePath || '',
-                mrz_type: result?.mrzType || ''
-            }, env);
-            // Safety check: parse if it was returned as a raw string
-            mrz = typeof mrzResponse === 'string' ? JSON.parse(mrzResponse) : mrzResponse;
-            if (mrz && (!mrz.success || mrz.parsed_data?.status === 'FAILURE')) {
-                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'}`);
+        // 🚨 FIX 2: Execute MRZ if required (Removed restrictive guards)
+        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' // Fallback to ensure it always runs
+                }, 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) {
+                logger.error("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 } : {}) };
     }
     catch (e) {
         logger.error('Error front verification:', e?.message);
-        // Do not use LogBox for background silent errors
         throw new Error(e?.message || 'Erreur de détection du visage');
     }
 }
+// ─── backVerification ────────────────────────────────────────────────────────
 export async function backVerification(result, env = 'PRODUCTION') {
     try {
         if (!result.path)
             throw new Error('No path provided');
         logger.log("result.regionMapping", result.regionMapping, result.currentSide, result.code);
+        // 🚨 FIX 3: Robust Auth Method Resolution for the Back Side
+        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 = { minX: 400, minY: 800, width: 2200, height: 1400 };
@@ -131,7 +157,7 @@ export async function backVerification(result, env = 'PRODUCTION') {
                     card_in_frame: true,
                     cropped_sides: []
                 }];
-            if (result.regionMapping?.authMethod?.includes('MRZ')) {
+            if (hasMrz) {
                 return {
                     success: true,
                     mrz: {
@@ -146,7 +172,7 @@ export async function backVerification(result, env = 'PRODUCTION') {
                     card_obb: mockCardObb
                 };
             }
-            else if (result.regionMapping?.authMethod?.includes('2D_barcode')) {
+            else if (hasBarcode) {
                 return {
                     success: true,
                     barcode: { barcode_data: 'SANDBOX_MOCK_BARCODE' },
@@ -158,27 +184,25 @@ export async function backVerification(result, env = 'PRODUCTION') {
         }
         const token = await authentification();
         logger.log("1. Checking template and framing for back document...");
-        const templateResponse = result.templateResponse || await kycService.checkTemplateType({
-            fileUri: result.path,
-            docType: result.selectedDocumentType,
-            docRegion: result.code,
-            postfix: 'back',
-            token: token
-        }, env);
+        const templateResponse = result.templateResponse ||
+            await kycService.checkTemplateType({
+                fileUri: result.path,
+                docType: result.selectedDocumentType,
+                docRegion: result.code,
+                postfix: 'back',
+                token: token
+            }, env);
         if (templateResponse.success === false || templateResponse.Error) {
-            logger.log("Backend returned an error:", 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) {
+        if (!cardData)
             throw new Error('CARD_NOT_FULLY_IN_FRAME');
-        }
         let points = null;
         let isCardInFrame = false;
         let hasCroppedSides = true;
-        // Safely extract coordinates and frame status
         if (cardData.obb) {
             points = cardData.obb;
             if (typeof cardData.card_in_frame !== 'undefined') {
@@ -199,24 +223,12 @@ export async function backVerification(result, env = 'PRODUCTION') {
                 }
             }
         }
-        // --- 2. STRICT FRAMING CHECK (MUST HAPPEN FIRST) ---
         if (!isCardInFrame || hasCroppedSides) {
             logger.log(`Back Framing failed. Coordinates hit image boundary.`);
             throw new Error('CARD_NOT_FULLY_IN_FRAME');
         }
-        // --- 3. STRICT DISTANCE CHECK (ONLY RUNS IF FULLY IN FRAME) ---
-        if (points && points.length === 4) {
-            const getDistance = (p1, p2) => Math.sqrt(Math.pow(p2[0] - p1[0], 2) + Math.pow(p2[1] - p1[1], 2));
-            const longestCardEdge = Math.max(getDistance(points[0], points[1]), getDistance(points[1], points[2]));
-            const maxX = Math.max(points[0][0], points[1][0], points[2][0], points[3][0]);
-            const maxY = Math.max(points[0][1], points[1][1], points[2][1], points[3][1]);
-            const estimatedImageScale = Math.max(maxX, maxY);
-            const fillPercentage = longestCardEdge / estimatedImageScale;
-            logger.log(`Back Card Fill Percentage: ${(fillPercentage * 100).toFixed(1)}%`);
-            if (fillPercentage < 0.50) {
-                logger.log("🛑 Back Image rejected: Document is too far away.");
-                throw new Error("TOO_FAR_AWAY");
-            }
+        if (points && points.length >= 3) {
+            assertCardNotTooFar(points);
         }
         const obbConf = getObbConfidence(templateResponse?.card_obb);
         if (obbConf !== null && obbConf < OBB_CONFIDENCE_THRESHOLD) {
@@ -228,58 +240,48 @@ export async function backVerification(result, env = 'PRODUCTION') {
             const hasCodeMatch = activeTemplatePath.includes(`_${result.code}_`);
             const hasNameMatch = expectedCountryName && activeTemplatePath.toLowerCase().includes(expectedCountryName.toLowerCase());
             if (!hasCodeMatch && !hasNameMatch) {
-                logger.log(`Template mismatch! Expected country: ${result.code} (${expectedCountryName}), Detected: ${activeTemplatePath}`);
+                logger.log(`Template mismatch! Expected: ${result.code} (${expectedCountryName}), Detected: ${activeTemplatePath}`);
                 throw new Error(`Le document ne correspond pas au pays sélectionné (${result.code}).`);
             }
         }
         logger.log("Framing and Country Template verified successfully. Proceeding to Data Extraction.");
-        const hasMrz = result.regionMapping?.authMethod?.includes('MRZ') && result?.mrzType;
-        const hasBarcode = result.regionMapping?.authMethod?.includes('2D_barcode');
         let extractionResult = {};
-        // --- 4. Try MRZ First (If required or default) ---
+        // 🚨 FIX 4: Guaranteed MRZ Extraction Attachment
         if (hasMrz) {
             try {
-                logger.log("Tentative d'extraction MRZ");
+                logger.log("Tentative d'extraction MRZ (Back)");
                 const mrzResponse = await kycService.extractMrzText({
                     fileUri: result.path,
                     docType: result?.selectedDocumentType || '',
                     docRegion: result?.code || '',
-                    postfix: 'back',
+                    postfix: result?.currentSide || 'back',
                     token: token,
                     template_path: activeTemplatePath,
-                    mrz_type: result?.mrzType || '' // Safe to send empty string
+                    mrz_type: result?.mrzType || 'TD1'
                 }, env);
                 const mrz = typeof mrzResponse === 'string' ? JSON.parse(mrzResponse) : mrzResponse;
-                if (!mrz || !mrz.success || mrz.parsed_data?.status === 'FAILURE') {
+                if (mrz?.parsed_data?.status === 'FAILURE' || mrz?.success === false) {
                     throw new Error(mrz?.parsed_data?.status_message || 'Lecture MRZ échouée');
                 }
-                extractionResult = { mrz };
+                extractionResult.mrz = mrz; // Attaching securely to result object
             }
             catch (mrzError) {
-                if (hasBarcode) {
-                    logger.log(`MRZ échoué (${mrzError?.message}), tentative d'extraction barcode...`);
-                    try {
-                        const barcode = await kycService.extractBarcode({ fileUri: result.path, token: token }, env);
-                        extractionResult = { barcode };
-                    }
-                    catch (barcodeError) {
-                        throw new Error(`MRZ et Barcode ont échoué. Veuillez stabiliser la carte.`);
-                    }
-                }
-                else {
-                    throw new Error(`Lecture MRZ invalide: ${mrzError?.message}`);
-                }
+                logger.log(`MRZ échoué: ${mrzError?.message}`);
+                // If MRZ fails, we MUST throw an error so the user is forced to retake it!
+                throw new Error(`Lecture MRZ invalide: ${mrzError?.message || 'Veuillez nettoyer l\'objectif et réessayer'}`);
             }
         }
-        // --- 5. Try Barcode Only ---
-        else if (hasBarcode) {
+        if (hasBarcode) {
             try {
-                logger.log("Tentative d'extraction barcode seule");
+                logger.log("Tentative d'extraction barcode");
                 const barcode = await kycService.extractBarcode({ fileUri: result.path, token: token }, env);
-                extractionResult = { barcode };
+                extractionResult.barcode = barcode;
             }
             catch (e) {
-                throw new Error(`Lecture Barcode échouée: ${e?.message}`);
+                // Only throw barcode error if MRZ wasn't already successfully extracted
+                if (!extractionResult.mrz) {
+                    throw new Error(`Lecture Barcode échouée: ${e?.message}`);
+                }
             }
         }
         let bbox;
@@ -299,17 +301,11 @@ export async function backVerification(result, env = 'PRODUCTION') {
         };
     }
     catch (e) {
-        if (e?.message === 'CARD_NOT_FULLY_IN_FRAME' || e?.message === 'TOO_FAR_AWAY') {
+        if (e?.message === 'CARD_NOT_FULLY_IN_FRAME' || e?.message === 'TOO_FAR_AWAY')
             throw e;
-        }
         throw new Error(e?.message || 'Erreur de détection des données');
     }
 }
-/**
- * Check template type
- * @param result
- * @returns
- */
 export async function checkTemplateType(result, env = 'PRODUCTION') {
     try {
         if (env === 'SANDBOX') {
@@ -324,7 +320,13 @@ export async function checkTemplateType(result, env = 'PRODUCTION') {
             };
         }
         const token = await authentification();
-        const templateType = await kycService.checkTemplateType({ fileUri: result.path || '', docType: result?.docType, docRegion: result?.docRegion || "", postfix: result?.postfix, token: token }, env);
+        const templateType = await kycService.checkTemplateType({
+            fileUri: result.path || '',
+            docType: result?.docType,
+            docRegion: result?.docRegion || "",
+            postfix: result?.postfix,
+            token: token
+        }, 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.');
@@ -332,14 +334,11 @@ export async function checkTemplateType(result, env = 'PRODUCTION') {
         const cardData = templateType.card_obb && Array.isArray(templateType.card_obb) && templateType.card_obb.length > 0
             ? templateType.card_obb[0]
             : null;
-        if (!cardData) {
+        if (!cardData)
             throw new Error('CARD_NOT_FULLY_IN_FRAME');
-        }
-        // Default to FALSE so it must prove it is in the frame
         let points = null;
         let isCardInFrame = false;
         let hasCroppedSides = true;
-        // Extract data safely based on API response format
         if (cardData.obb) {
             points = cardData.obb;
             if (typeof cardData.card_in_frame !== 'undefined') {
@@ -349,27 +348,27 @@ export async function checkTemplateType(result, env = 'PRODUCTION') {
         }
         else if (Array.isArray(cardData) && Array.isArray(cardData[0])) {
             points = cardData[0];
-            isCardInFrame = true; // Passed initial existence check
+            isCardInFrame = true;
             hasCroppedSides = false;
-            // MATH FALLBACK: Check if the coordinates are touching the absolute edge of the photo.
             if (points && points.length === 4) {
                 const minX = Math.min(...points.map((p) => p[0]));
                 const minY = Math.min(...points.map((p) => p[1]));
-                // If any corner is within 15 pixels of the edge, it is physically cut off!
                 if (minX <= 15 || minY <= 15) {
                     isCardInFrame = false;
                     hasCroppedSides = true;
                 }
             }
         }
-        // --- 3. STRICT FRAMING CHECK (MUST HAPPEN FIRST) ---
         if (!isCardInFrame || hasCroppedSides) {
-            logger.log(`Template Framing failed. Coordinates hit image boundary.`);
+            logger.log(`Template Framing failed.`);
             throw new Error('CARD_NOT_FULLY_IN_FRAME');
         }
+        if (points && points.length >= 3) {
+            assertCardNotTooFar(points);
+        }
         const LPIPS_THRESHOLD = 0.75;
         if (templateType.lpips_score !== undefined && templateType.lpips_score > LPIPS_THRESHOLD) {
-            logger.log(`🛑 Country Mismatch! LPIPS Score too high: ${templateType.lpips_score}`);
+            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));
@@ -377,9 +376,8 @@ export async function checkTemplateType(result, env = 'PRODUCTION') {
     }
     catch (e) {
         logger.error('Error checking template type:', JSON.stringify(errorMessage(e), null, 2));
-        if (e?.message === 'CARD_NOT_FULLY_IN_FRAME' || e?.message?.includes('ne correspond pas')) {
+        if (e?.message === 'CARD_NOT_FULLY_IN_FRAME' || e?.message === 'TOO_FAR_AWAY' || e?.message?.includes('ne correspond pas'))
             throw e;
-        }
         throw new Error(e?.message || 'Erreur de vérification du template');
     }
 }