datakeen-session-react 1.1.197 → 1.1.198-rc.1

package/docs/JOURNEY_NODE_BUILDER.md

@@ -196,3 +196,18 @@ L’absence signifie donnée personnelle côté backoffice/backend. Seul `false`
 permet un affichage restreint des champs métier ; une liste est classée en bloc.
 La version mineure `1.2.0-dev.0` est préparée localement, sans publication.
 Le backend doit conserver exactement la conversion `labelToKey` du SDK.
+
+## Regex conditionnelle des colonnes email
+
+Les colonnes `email` d'un champ `list` contrôlent d'abord le format email, puis la
+regex résolue selon la colonne enum de la même ligne (cas, regex par défaut, aucune
+regex). Message : cas, colonne, traduction générique. `allowUnconstrained` est un
+choix du builder et n'affecte pas la résolution runtime.
+Le serveur peut refuser une liste configurée avec HTTP 400 et le code
+`CUSTOM_FIELD_VALIDATION_FAILED` ; `useSessionData` journalise ce code sans modifier
+le comportement de synchronisation.
+
+
+## Mandat complémentaire
+
+Le nœud auto-exécutant `complementary-mandate` route sur le verdict serveur (`same_signer`, `new_signer`, `no_mandate`). Toute erreur bloque le routage et propose de réessayer. Voir [COMPLEMENTARY_MANDATE.md](COMPLEMENTARY_MANDATE.md).

package/docs/navigation-history.md

@@ -143,6 +143,14 @@ const goOnPreviousStep = () => goBack();
 
 Préférer `goToNextStep(node.id, template)` qui résout automatiquement l'index suivant via le graphe. `setStep` est réservé aux cas où l'index de destination est déjà connu (ex: reprise de session, `goBack`).
 
+### Reprise d'une session déjà terminée : ne jamais rejouer un nœud `end`
+
+La reprise se fait **par index** (`currentStep`) sur `getOrderedJourneySteps()` (nœuds triés par `order`, puis par `id`). Si le parcours est modifié après coup — par exemple un nœud `end` ajouté avec le même `order` qu'une étape existante — l'index persisté peut désigner un autre nœud qu'au moment de la sauvegarde. Une session rouverte peut alors « atterrir » sur une fin jamais empruntée, et `EndFlow` enverrait `ended` + l'id de cette fin au montage (incident Quadient, sept. 2026 : dossiers signés passés en `ai_rejected`).
+
+Protection : `isSessionFinished(status)` (`src/utils/sessionStatus.ts`) — vrai pour `ended` et les statuts consolidés (`verify`, `ai_approved`, `ai_rejected`, `user_approved`, `user_rejected`), **faux pour `conform`** (posé après la signature, avant le vrai nœud `end`). `useStepNavigation`, `TemplateNodeRenderer` et `SessionContent` l'utilisent pour afficher directement l'écran de fin ; pour un statut consolidé, `EndFlow` reçoit `alreadyFinished` : **aucun PATCH** au montage, écran calculé depuis le statut connu. Le backend ignore de son côté un second `ended` sur une session déjà terminée (voir `backend/docs/SESSION_STATUS_CALCULATION.md`).
+
+La reprise par index reste une limite connue : la remplacer par une reprise par id de nœud est un chantier séparé.
+
 ---
 
 ## Fichiers de référence

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "datakeen-session-react",
-  "version": "1.1.197",
+  "version": "1.1.198-rc.1",
   "description": "React SDK component to manage and render Datakeen session experiences easily.",
   "publishConfig": {
     "access": "public",