datakeen-session-react 1.1.140-rc.71 → 1.1.140-rc.73

package/dist/esm/components/session/DocumentCheck.js

@@ -1,6 +1,6 @@
 import { __awaiter, __generator, __assign } from '../../node_modules/tslib/tslib.es6.js';
 import { jsxs, jsx } from 'react/jsx-runtime';
-import { useState, useEffect, useMemo } from 'react';
+import { useState, useEffect, useRef, useMemo } from 'react';
 import JDIPreIntroduction from '../jdi/JDIPreIntroduction.js';
 import JDICountrySelection from '../jdi/JDICountrySelection.js';
 import JDIDocumentSelection from '../jdi/JDIDocumentSelection.js';
@@ -26,8 +26,10 @@ import { getAllDocumentTemplates, getDocumentTemplateId, getDocTypeKey } from '.
 import { blobToDataUrl, dataUrlToBlob, resizeAfterCapture } from '../../utils/imageProcessing.js';
 import { getNodeRetryCount, incrementNodeRetryCount } from '../../services/retryService.js';
 import { getSession } from '../../context/SessionContext.js';
-import { updateSessionUserInput } from '../../services/sessionService.js';
+import { updateSessionUserInput, skipNfcWithReason } from '../../services/sessionService.js';
 import NfcScanStep from '../nfc-scan/NfcScanNode.js';
+import NfcChipGate from '../nfc-scan/NfcChipGate.js';
+import NfcFallbackSurvey from '../nfc-scan/NfcFallbackSurvey.js';
 import { EUROPEAN_COUNTRY_CODES } from '../../utils/europeanCountries.js';
 
 var NFC_ELIGIBLE_DOCUMENT_TYPES = new Set([
@@ -35,6 +37,14 @@ var NFC_ELIGIBLE_DOCUMENT_TYPES = new Set([
     "idCard",
     "residencePermit",
 ]);
+/**
+ * Normalise le mode NFC vers les valeurs courantes.
+ * Rétrocompat : les parcours enregistrés avant le renommage portent encore
+ * `nfcAndApi`, qui doit être traité comme `nfcOrPhoto` (scan NFC avec alternative photo).
+ */
+var normalizeNfcMode = function (mode) {
+    return mode === "nfcAndApi" || mode === "nfcOrPhoto" ? "nfcOrPhoto" : "nfcOnly";
+};
 /**
  * DocumentCheck component manages the multi-step document verification flow for a session.
  * It handles country and document type selection, document upload or photo capture, processing, and error/success handling.
@@ -60,12 +70,12 @@ var NFC_ELIGIBLE_DOCUMENT_TYPES = new Set([
  * - Uses hooks for translation, retry navigation, and context management.
  */
 var DocumentCheck = function (_a) {
-    var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-    var stepObject = _a.stepObject, sessionId = _a.sessionId, node = _a.node; _a.onContinueOnPC; var documentTypeId = _a.documentTypeId, acceptedCountries = _a.acceptedCountries, _m = _a.isMobileCapture, isMobileCapture = _m === void 0 ? false : _m, allowedAddingMethods = _a.allowedAddingMethods, template = _a.template, setUserInput = _a.setUserInput;
+    var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+    var stepObject = _a.stepObject, sessionId = _a.sessionId, node = _a.node; _a.onContinueOnPC; var documentTypeId = _a.documentTypeId, acceptedCountries = _a.acceptedCountries, _p = _a.isMobileCapture, isMobileCapture = _p === void 0 ? false : _p, allowedAddingMethods = _a.allowedAddingMethods, template = _a.template, setUserInput = _a.setUserInput;
     var t = useI18n().t;
     var session = getSession().session;
-    var _o = useState(), documentTemplates = _o[0], setDocumentTemplates = _o[1];
-    var _p = useState(true), loadingTemplates = _p[0], setLoadingTemplates = _p[1];
+    var _q = useState(), documentTemplates = _q[0], setDocumentTemplates = _q[1];
+    var _r = useState(true), loadingTemplates = _r[0], setLoadingTemplates = _r[1];
     useEffect(function () {
         (function () { return __awaiter(void 0, void 0, void 0, function () {
             var templates;
@@ -84,7 +94,7 @@ var DocumentCheck = function (_a) {
         }); })();
     }, []);
     var initialRetryCount = getNodeRetryCount(session, node.id);
-    var _q = useState(null), selectedMethod = _q[0], setSelectedMethod = _q[1];
+    var _s = useState(null), selectedMethod = _s[0], setSelectedMethod = _s[1];
     var isPictureAllowed = (_b = allowedAddingMethods === null || allowedAddingMethods === void 0 ? void 0 : allowedAddingMethods.includes("picture")) !== null && _b !== void 0 ? _b : true;
     var isDownloadAllowed = (_c = allowedAddingMethods === null || allowedAddingMethods === void 0 ? void 0 : allowedAddingMethods.includes("download")) !== null && _c !== void 0 ? _c : true;
     // Check if retry is allowed based on initial retry count
@@ -103,21 +113,24 @@ var DocumentCheck = function (_a) {
         return true;
     };
     // Initialize docStep - if retries exhausted, start at error page (step 6)
-    var _r = useState(function () {
+    var _t = useState(function () {
         if (initialRetryCount > 0 && !isInitialRetryAllowed()) {
             return 6; // Error page
         }
         return 0; // Normal flow - start with introduction
-    }), docStep = _r[0], setDocStep = _r[1];
-    var _s = useState(((_e = (_d = acceptedCountries === null || acceptedCountries === void 0 ? void 0 : acceptedCountries[0]) === null || _d === void 0 ? void 0 : _d.code) === null || _e === void 0 ? void 0 : _e.toUpperCase()) || "FR"), selectedCountry = _s[0], setSelectedCountry = _s[1];
-    var _t = useState(null), fileUploaded = _t[0], setFileUploaded = _t[1];
-    var _u = useState(null), analysisData = _u[0], setAnalysisData = _u[1];
-    var _v = useState(null), errorCode = _v[0], setErrorCode = _v[1];
-    var _w = useState(null), nfcPreparationError = _w[0], setNfcPreparationError = _w[1];
+    }), docStep = _t[0], setDocStep = _t[1];
+    var _u = useState(((_e = (_d = acceptedCountries === null || acceptedCountries === void 0 ? void 0 : acceptedCountries[0]) === null || _d === void 0 ? void 0 : _d.code) === null || _e === void 0 ? void 0 : _e.toUpperCase()) || "FR"), selectedCountry = _u[0], setSelectedCountry = _u[1];
+    var _v = useState(null), fileUploaded = _v[0], setFileUploaded = _v[1];
+    var _w = useState(null), analysisData = _w[0], setAnalysisData = _w[1];
+    var _x = useState(null), errorCode = _x[0], setErrorCode = _x[1];
+    var _y = useState(null), nfcPreparationError = _y[0], setNfcPreparationError = _y[1];
+    // Quand l'utilisateur déclare ne pas avoir de puce (questionnaire de fallback),
+    // on ne doit plus le réorienter vers le scan NFC (ni avant, ni après l'analyse API).
+    var _z = useState(false), nfcSkipped = _z[0], setNfcSkipped = _z[1];
     // Initialize retry count from session data
-    var _x = useState(function () {
+    var _0 = useState(function () {
         return getNodeRetryCount(session, node.id);
-    }), retryCount = _x[0], setRetryCount = _x[1];
+    }), retryCount = _0[0], setRetryCount = _0[1];
     // Update retry count when session loads/changes
     useEffect(function () {
         if (session) {
@@ -125,6 +138,21 @@ var DocumentCheck = function (_a) {
             setRetryCount(sessionRetryCount);
         }
     }, [session, node.id]);
+    // Restauration après refresh : si le NFC est en cours côté backend (l'utilisateur attendait sur
+    // l'écran QR), revenir directement à cet écran (docStep 7) au lieu de repartir au début du nœud.
+    // `docStep` est en mémoire et serait sinon perdu au rechargement.
+    var hasRestoredNfcStep = useRef(false);
+    useEffect(function () {
+        if (hasRestoredNfcStep.current)
+            return;
+        if (node.nfcEnabled !== true)
+            return;
+        var status = session === null || session === void 0 ? void 0 : session.nfcStatus;
+        if (status === "pending" || status === "opened") {
+            hasRestoredNfcStep.current = true;
+            setDocStep(7);
+        }
+    }, [session, node.nfcEnabled]);
     // Check retry limits on mount/reload - if retries exhausted, show error page immediately
     useEffect(function () {
         // Special case: if allowResubmission is false and retryCount > 0, show error immediately
@@ -157,10 +185,10 @@ var DocumentCheck = function (_a) {
             setDocStep(6);
         }
     }, [retryCount, node.allowResubmission, node.maxResubmissionAttempts]);
-    var _y = useState({}), capturedImages = _y[0], setCapturedImages = _y[1];
-    var _z = useState("before-recto"), currentPhotoStep = _z[0], setCurrentPhotoStep = _z[1];
-    var _0 = useState("photo"), videoFlowPhase = _0[0], setVideoFlowPhase = _0[1];
-    var _1 = useDocumentContext(), selectedDocumentType = _1.selectedDocumentType, setSelectedDocumentType = _1.setSelectedDocumentType;
+    var _1 = useState({}), capturedImages = _1[0], setCapturedImages = _1[1];
+    var _2 = useState("before-recto"), currentPhotoStep = _2[0], setCurrentPhotoStep = _2[1];
+    var _3 = useState("photo"), videoFlowPhase = _3[0], setVideoFlowPhase = _3[1];
+    var _4 = useDocumentContext(), selectedDocumentType = _4.selectedDocumentType, setSelectedDocumentType = _4.setSelectedDocumentType;
     var finalAcceptedCountries = useMemo(function () {
         if (loadingTemplates)
             return acceptedCountries;
@@ -240,6 +268,11 @@ var DocumentCheck = function (_a) {
         if (docStep === 6) {
             return;
         }
+        // En NFC, on affiche d'abord l'écran de confirmation de la puce (gate -1)
+        if (node.nfcEnabled === true) {
+            setDocStep(-1);
+            return;
+        }
         if (((_a = node.introductionPage) === null || _a === void 0 ? void 0 : _a.title) === undefined &&
             ((_b = node.introductionPage) === null || _b === void 0 ? void 0 : _b.description) === undefined) {
             setDocStep(1);
@@ -344,9 +377,9 @@ var DocumentCheck = function (_a) {
     };
     var handleDocumentTypeSelect = function (documentId) { return __awaiter(void 0, void 0, void 0, function () {
         var documentLabel, documentTemplateID, selectedDoc, selectedCountryCode, selectedDocumentInput, nfcMode, error_2;
-        var _a, _b;
-        return __generator(this, function (_c) {
-            switch (_c.label) {
+        var _a;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
                 case 0:
                     documentLabel = t("documentTypes.".concat(documentId), documentId);
                     logDocumentTypeSelected(sessionId, documentId, documentLabel);
@@ -379,22 +412,24 @@ var DocumentCheck = function (_a) {
                     setCapturedImages({});
                     setCurrentPhotoStep("before-recto");
                     setVideoFlowPhase("photo");
-                    if (!(node.nfcEnabled === true && NFC_ELIGIBLE_DOCUMENT_TYPES.has(documentId))) return [3 /*break*/, 5];
-                    nfcMode = (_a = node.nfcMode) !== null && _a !== void 0 ? _a : "nfcOnly";
-                    _c.label = 1;
+                    if (!(node.nfcEnabled === true &&
+                        !nfcSkipped &&
+                        NFC_ELIGIBLE_DOCUMENT_TYPES.has(documentId))) return [3 /*break*/, 5];
+                    nfcMode = normalizeNfcMode(node.nfcMode);
+                    _b.label = 1;
                 case 1:
-                    _c.trys.push([1, 3, , 4]);
-                    return [4 /*yield*/, updateSessionUserInput(sessionId, __assign(__assign({}, ((_b = session === null || session === void 0 ? void 0 : session.userInput) !== null && _b !== void 0 ? _b : {})), selectedDocumentInput))];
+                    _b.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, updateSessionUserInput(sessionId, __assign(__assign({}, ((_a = session === null || session === void 0 ? void 0 : session.userInput) !== null && _a !== void 0 ? _a : {})), selectedDocumentInput))];
                 case 2:
-                    _c.sent();
+                    _b.sent();
                     return [3 /*break*/, 4];
                 case 3:
-                    error_2 = _c.sent();
+                    error_2 = _b.sent();
                     console.error("Failed to persist NFC document selection:", error_2);
                     setNfcPreparationError(t("nfc_scan.preparation_failed", "Impossible de préparer le scan NFC. Veuillez réessayer."));
                     return [3 /*break*/, 4];
                 case 4:
-                    setDocStep(nfcMode === "nfcAndApi" ? 3 : 7);
+                    setDocStep(nfcMode === "nfcOrPhoto" ? 3 : 7);
                     return [2 /*return*/];
                 case 5:
                     setDocStep(3);
@@ -420,7 +455,6 @@ var DocumentCheck = function (_a) {
         }
     };
     var handleProcessingComplete = function (success, _retryCount, apiAnalysisData) {
-        var _a;
         if (apiAnalysisData) {
             setAnalysisData(apiAnalysisData);
             // Extract and store the error code
@@ -431,7 +465,8 @@ var DocumentCheck = function (_a) {
         }
         if (success) {
             var shouldRunNfcAfterApi = node.nfcEnabled === true &&
-                ((_a = node.nfcMode) !== null && _a !== void 0 ? _a : "nfcOnly") === "nfcAndApi" &&
+                !nfcSkipped &&
+                normalizeNfcMode(node.nfcMode) === "nfcOrPhoto" &&
                 !!(selectedDocumentType === null || selectedDocumentType === void 0 ? void 0 : selectedDocumentType.id) &&
                 NFC_ELIGIBLE_DOCUMENT_TYPES.has(selectedDocumentType.id);
             if (shouldRunNfcAfterApi) {
@@ -520,7 +555,61 @@ var DocumentCheck = function (_a) {
         }
         setDocStep(0);
     };
+    // Questionnaire de fallback NFC : l'utilisateur a déclaré ne pas avoir de puce.
+    // On enregistre la raison (non bloquant) puis on poursuit selon le mode du nœud :
+    //  - nfcOrPhoto → flux photo/API du même nœud (intro/pays → upload → analyse), sans scan NFC
+    //  - nfcOnly    → on saute le nœud (nœud suivant)
+    var handleNfcFallback = function (reason, label, comment) { return __awaiter(void 0, void 0, void 0, function () {
+        var error_3, nfcMode, hasIntroduction;
+        var _a, _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    setNfcSkipped(true);
+                    _c.label = 1;
+                case 1:
+                    _c.trys.push([1, 3, , 4]);
+                    return [4 /*yield*/, skipNfcWithReason(sessionId, { reason: reason, label: label, comment: comment })];
+                case 2:
+                    _c.sent();
+                    return [3 /*break*/, 4];
+                case 3:
+                    error_3 = _c.sent();
+                    console.error("Failed to persist NFC fallback reason:", error_3);
+                    return [3 /*break*/, 4];
+                case 4:
+                    nfcMode = normalizeNfcMode(node.nfcMode);
+                    if (nfcMode === "nfcOrPhoto") {
+                        hasIntroduction = ((_a = node.introductionPage) === null || _a === void 0 ? void 0 : _a.title) !== undefined ||
+                            ((_b = node.introductionPage) === null || _b === void 0 ? void 0 : _b.description) !== undefined;
+                        setDocStep(hasIntroduction ? 0 : 1);
+                        return [2 /*return*/];
+                    }
+                    if (template) {
+                        stepObject.goToNextStep(node.id, template);
+                    }
+                    else {
+                        stepObject.setStep(stepObject.step + 1);
+                    }
+                    return [2 /*return*/];
+            }
+        });
+    }); };
     var handleBack = function () {
+        var _a, _b;
+        var hasIntroduction = ((_a = node.introductionPage) === null || _a === void 0 ? void 0 : _a.title) !== undefined ||
+            ((_b = node.introductionPage) === null || _b === void 0 ? void 0 : _b.description) !== undefined;
+        // Le questionnaire de fallback (-2) revient au gate (-1)
+        if (docStep === -2) {
+            setDocStep(-1);
+            return;
+        }
+        // En NFC, le premier écran réel (intro=0 sinon pays=1) revient au gate (-1)
+        if (node.nfcEnabled === true &&
+            docStep === (hasIntroduction ? 0 : 1)) {
+            setDocStep(-1);
+            return;
+        }
         if (docStep === 0) {
             stepObject.goBack();
         }
@@ -529,6 +618,15 @@ var DocumentCheck = function (_a) {
         }
     };
     switch (docStep) {
+        case -1: {
+            var hasIntroduction_1 = ((_f = node.introductionPage) === null || _f === void 0 ? void 0 : _f.title) !== undefined ||
+                ((_g = node.introductionPage) === null || _g === void 0 ? void 0 : _g.description) !== undefined;
+            return (jsx(NfcChipGate, { onConfirm: function () { return setDocStep(hasIntroduction_1 ? 0 : 1); }, 
+                // Pas de puce → questionnaire de fallback pour recueillir la raison
+                onNoChip: function () { return setDocStep(-2); } }));
+        }
+        case -2:
+            return jsx(NfcFallbackSurvey, { onSubmit: handleNfcFallback });
         case 0:
             if (!documentTypeId) {
                 console.error("DocumentCheck: Missing documentTypeId in step 0");
@@ -536,15 +634,20 @@ var DocumentCheck = function (_a) {
                                 return stepObject.setStep(Math.max(0, stepObject.step - 1));
                             }, children: t("document_check.config_error.back", "Retour") })] }));
             }
-            return (jsx(JDIPreIntroduction, { documentTypeId: documentTypeId, onContinue: function () { return setDocStep(1); }, onBack: handleBack, introTitleText: ((_f = node.introductionPage) === null || _f === void 0 ? void 0 : _f.title) || t("jdi.pre_introduction.title"), introDescText: ((_g = node.introductionPage) === null || _g === void 0 ? void 0 : _g.description) ||
+            return (jsx(JDIPreIntroduction, { documentTypeId: documentTypeId, onContinue: function () { return setDocStep(1); }, onBack: handleBack, introTitleText: ((_h = node.introductionPage) === null || _h === void 0 ? void 0 : _h.title) || t("jdi.pre_introduction.title"), introDescText: ((_j = node.introductionPage) === null || _j === void 0 ? void 0 : _j.description) ||
                     t("jdi.pre_introduction.description") }));
         case 1:
-            return (jsx(JDICountrySelection, { onCountrySelect: handleCountrySelect, onBack: handleBack, documentTypeId: documentTypeId, acceptedCountries: finalAcceptedCountries, countryIntroText: ((_h = node.countrySelection) === null || _h === void 0 ? void 0 : _h.title) || t("jdi.country_selection.title"), countryDescText: ((_j = node.countrySelection) === null || _j === void 0 ? void 0 : _j.description) ||
+            return (jsx(JDICountrySelection, { onCountrySelect: handleCountrySelect, onBack: handleBack, documentTypeId: documentTypeId, acceptedCountries: finalAcceptedCountries, countryIntroText: ((_k = node.countrySelection) === null || _k === void 0 ? void 0 : _k.title) || t("jdi.country_selection.title"), countryDescText: ((_l = node.countrySelection) === null || _l === void 0 ? void 0 : _l.description) ||
                     t("jdi.country_selection.description") }));
         case 2:
             return (jsx(JDIDocumentSelection, { onDocumentSelect: handleDocumentTypeSelect, onBack: handleBack, documentTypeId: documentTypeId, sessionId: sessionId, chosenCountry: (finalAcceptedCountries === null || finalAcceptedCountries === void 0 ? void 0 : finalAcceptedCountries.find(function (c) { return c.code === selectedCountry; })) ||
-                    undefined, documentSelectionTitle: ((_k = node.documentSelection) === null || _k === void 0 ? void 0 : _k.title) || t("jdi.document_selection.title"), documentSelectionDescription: ((_l = node.documentSelection) === null || _l === void 0 ? void 0 : _l.description) ||
-                    t("jdi.document_selection.description") }));
+                    undefined, documentSelectionTitle: ((_m = node.documentSelection) === null || _m === void 0 ? void 0 : _m.title) || t("jdi.document_selection.title"), documentSelectionDescription: 
+                // En NFC, on laisse JDIDocumentSelection choisir le wording adapté
+                // (subtitle_identity_nfc) plutôt que l'override "téléverser" du nœud.
+                node.nfcEnabled === true
+                    ? undefined
+                    : ((_o = node.documentSelection) === null || _o === void 0 ? void 0 : _o.description) ||
+                        t("jdi.document_selection.description"), nfcEnabled: node.nfcEnabled === true }));
         case 3:
             if (!selectedDocumentType) {
                 console.error("DocumentCheck: selectedDocumentType is null for step 3!");
@@ -607,7 +710,15 @@ var DocumentCheck = function (_a) {
             if (nfcPreparationError) {
                 return (jsx(MobilePageLayout, { footer: jsx("div", { className: "w-full max-w-md mx-auto", children: jsx(ButtonDesktop, { type: "back", onClick: function () { return setDocStep(2); }, className: "w-full text-[#3C3C40] text-center font-poppins text-sm font-medium hover:underline py-2", children: t("buttons.back", "Retour") }) }), children: jsxs("div", { className: "flex flex-col items-center justify-center h-full p-4 text-center", children: [jsx("div", { className: "text-red-500 text-4xl mb-4", children: "\u26A0\uFE0F" }), jsx("h2", { className: "text-xl font-bold text-red-600 mb-2", children: t("nfc_scan.preparation_error_title", "Erreur de préparation NFC") }), jsx("p", { className: "text-gray-600 mb-4", children: nfcPreparationError })] }) }));
             }
-            return (jsx(NfcScanStep, { sessionId: sessionId, nodeId: node.id, stepObject: stepObject, template: template }));
+            return (jsx(NfcScanStep, { sessionId: sessionId, nodeId: node.id, stepObject: stepObject, template: template, onBack: function () {
+                    var _a, _b;
+                    // Retour vers la sélection du document (corriger un mauvais choix). Le démontage de
+                    // NfcScanStep ferme le SSE via le cleanup du hook (pas d'appel backend nécessaire).
+                    var hasIntroduction = ((_a = node.introductionPage) === null || _a === void 0 ? void 0 : _a.title) !== undefined ||
+                        ((_b = node.introductionPage) === null || _b === void 0 ? void 0 : _b.description) !== undefined;
+                    hasRestoredNfcStep.current = true; // ne pas re-restaurer l'étape QR après ce retour
+                    setDocStep(hasIntroduction ? 0 : 1);
+                } }));
         default:
             console.error("Invalid docStep: ".concat(docStep));
             return (jsxs("div", { className: "flex flex-col items-center justify-center h-full p-4 text-center", children: [jsx("div", { className: "text-red-500 text-4xl mb-4", children: "\u26A0\uFE0F" }), jsx("h2", { className: "text-xl font-bold text-red-600 mb-2", children: t("document_check.navigation_error.title", "Erreur de navigation") }), jsx("p", { className: "text-gray-600 mb-4", children: t("document_check.navigation_error.description", "Étape non valide. Veuillez recommencer.") }), jsx(ButtonDesktop, { className: "px-4 py-2 bg-primary text-white rounded hover:bg-primary-dark transition-colors", type: "back", onClick: function () { return setDocStep(0); }, children: t("document_check.navigation_error.back", "Retour au début") })] }));