datakeen-session-react 1.1.170 → 1.1.172

package/dist/esm/types/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sources":["../../../../src/types/session.ts"],"sourcesContent":["import type React from \"react\";\n\nexport interface SessionConfig {\n  selfie?: boolean;\n  requireMobile?: boolean;\n}\n\nexport interface DatakeenSessionProps {\n  sessionId: string;\n  sessionConfig?: SessionConfig;\n  apiBaseUrl?: string; // Optional API base URL for dynamic environment configuration\n}\n\nexport interface UseSessionReturn {\n  SessionComponent: React.ReactElement;\n}\n\nexport type stepObject = {\n  setStep: (step: number) => void;\n  goBack: () => void;\n  goToNextStep: (\n    currentNodeId: string,\n    template: SessionTemplate,\n    handle?: string,\n  ) => void;\n  step: number;\n  canGoBack: boolean;\n};\n\nexport interface ProcessingStep {\n  title: string;\n  subtitle: string;\n  hasError?: boolean;\n}\n\nexport type ConditionTokenType = \"variable\" | \"control\" | \"operator\" | \"input\";\n\nexport interface ConditionToken {\n  type: ConditionTokenType;\n  value: string;\n  label?: string;\n  sourceNodeId?: string;\n}\n\n/**\n * Type for custom field value types\n */\nexport type CustomFieldValueType =\n  | \"text\"\n  | \"enum\"\n  | \"number\"\n  | \"boolean\"\n  | \"date\"\n  | \"email\"\n  | \"address\"\n  | \"list\";\n\n/**\n * Display formats supported for date fields (top-level and list columns).\n */\nexport type DateDisplayFormat = \"dd/mm/yyyy\" | \"mm/dd/yyyy\" | \"yyyy-mm-dd\";\n\nexport const DEFAULT_DATE_DISPLAY_FORMAT: DateDisplayFormat = \"dd/mm/yyyy\";\n\n/**\n * Column definition for a list-type custom field\n */\nexport interface ListColumn {\n  label: string;\n  type: \"text\" | \"enum\" | \"date\" | \"email\";\n  options?: string[]; // required when type === 'enum'\n  placeholder?: string; // text/email/date — shown to the end user\n  regex?: string; // text — JS regex source (without slashes)\n  regexErrorMessage?: string; // text — message displayed when regex fails\n  dateFormat?: DateDisplayFormat; // date — display format expected\n}\n\n/**\n * Interface for custom field definition\n */\nexport interface CustomField {\n  id: string;\n  label: string;\n  placeholder?: string;\n  description?: string;\n  valueType: CustomFieldValueType;\n  enumOptions?: string[];\n  listColumns?: ListColumn[]; // for list type: column definitions\n  minRows?: number; // for list type: minimum rows expected\n  required?: boolean;\n  regex?: string; // text — JS regex source (without slashes)\n  regexErrorMessage?: string; // text — message displayed when regex fails\n  dateFormat?: DateDisplayFormat; // date — display format expected\n  lockedFromApi?: boolean;\n  userInputKey?: string;\n}\n\n/**\n * Interface for session template node\n */\nexport interface SessionTemplateNode {\n  id: string;\n  type: string;\n  title: string;\n  description: string;\n  informationType?:\n  | \"identity\"\n  | \"identity-legal\"\n  | \"contact\"\n  | \"address\"\n  | \"nationality\"\n  | \"custom\";\n  position: {\n    x: number;\n    y: number;\n  };\n  options: unknown[];\n  selectedOptions: string[];\n  requiredDocumentType?: string;\n  isRequired: boolean;\n  order: number;\n  optionalFields?: string[];\n  requiredFields?: string[];\n  pageTitle?: string;\n  pageDescription?: string;\n  // Properties for document-collection node type\n  allowedDocumentTypes?: Array<{\n    id: string;\n    name: string;\n    /**\n     * Optional side information coming from the template.\n     * When provided and equals to two (\"two\", 2, \"double\", \"recto-verso\"),\n     * consumers should allow uploading two sides (front/back).\n     */\n    side?: string | number;\n  }>;\n  allowedAddingMethods?: string[];\n  introductionPage?: {\n    title?: string;\n    description?: string;\n  };\n  documentSelection?: {\n    title?: string;\n    description?: string;\n  };\n  // Start node specific properties\n  welcomeTitle?: string;\n  welcomeSubtitle?: string;\n  welcomeDescription?: string;\n  welcomeImage?: string;\n  qrCodeTitle?: string;\n  qrCodeDescription?: string;\n  showLegacyCGU?: boolean; // default: true — rétrocompatibilité\n\n  // Legal consent node specific properties\n  consentDescription?: string;\n  consentDescription2?: string;\n  cguUrl?: string;\n  privacyPolicyUrl?: string;\n  checkboxText?: string;\n  // Identity control specific properties\n  automaticPhotoCapture?: boolean;\n  acceptedCountries?: AcceptedCountry[];\n  // End node specific properties\n  callbackURL?: string | null;\n  // Condition node specific properties\n  conditionExpression?: string;\n  conditionTokens?: ConditionToken[];\n  conditionFalseErrorMessage?: string;\n  conditionMaxRetries?: number;\n  conditionMaxRetryAction?: \"end-journey\" | \"force-true\";\n  conditionFalseMode?: \"retry\" | \"loop\";\n\n  // External verification specific properties\n  targetApi?: \"INSEE\";\n  referenceNodeId?: string;\n  referenceNodeType?:\n  | \"information-input\"\n  | \"document-collection\"\n  | \"identity-control\";\n  referenceField?: \"siren\" | \"siret\";\n  referenceVariable?: string;\n  // Custom form fields (for information-input with type 'custom')\n  customFields?: CustomField[];\n\n  // Electronic signature specific properties\n  templateId?: string;\n  external_id?: string;\n  fieldMappings?: Array<{\n    sourceFieldId: string;\n    label: string;\n    docusealType: string;\n    readonly: boolean;\n    role?: string;\n    sourceNodeId?: string;\n  }>;\n  /** If set, the generated PDF from this upstream pdf-generation node will be used as the document to sign */\n  sourcePdfNodeId?: string;\n\n  // PDF generation node specific properties\n  // Note: htmlTemplate is intentionally NOT included — it is server-side only and never sent to the client\n  pdfMode?: \"upload\" | \"html-template\";\n  sourceNodeIds?: string[];\n\n  // retry properties\n  allowResubmission: boolean;\n  maxResubmissionAttempts?: number;\n}\n\n/**\n * Interface for accepted countries\n */\nexport interface AcceptedCountry {\n  code: string;\n  documents: {\n    passport: string[];\n    idCard: string[];\n    driverLicense: string[];\n    residencePermit: string[];\n    pinkDriverLicense: string[];\n  };\n}\n\n/**\n * Interface for session template edge\n */\nexport interface SessionTemplateEdge {\n  id: string;\n  source: string;\n  target: string;\n  sourceHandle?: string;\n  targetHandle?: string;\n  conditionValue?: string;\n}\n\n/**\n * Interface for platform information\n */\nexport interface PlatformInfo {\n  mobile: boolean;\n  desktop: boolean;\n  backoffice: boolean;\n}\n\n/**\n * Interface for session template\n */\nexport interface SessionTemplate {\n  id: string;\n  name: string;\n  description: string;\n  version: string;\n  languages: string[];\n  nodes: SessionTemplateNode[];\n  edges: SessionTemplateEdge[];\n  groupId: string;\n  userId: string | null;\n  created_at: string;\n  updated_at: string;\n  platforms?: PlatformInfo;\n  logo?: string;\n  showQRCode?: boolean;\n  buttonBgColor?: string;\n  buttonTextColor?: string;\n}\n\n/**\n * Interface for session data\n */\nexport interface SessionData {\n  id: string;\n  userId: string | null;\n  token: string;\n  templateId: string;\n  templateKey: string;\n  expireTime: number;\n  status: string;\n  result: Record<string, unknown>;\n  landingPage: unknown;\n  withSelfie: boolean | null;\n  groupId: string | null;\n  userInput: Record<string, unknown>;\n  contactInfo?: {\n    email: string;\n    phoneNumber: string;\n  };\n  callbackURL?: string | null;\n  webhookURL: string;\n  analysisTemplateId: string | null;\n  userAgent: unknown[];\n  mobile: boolean;\n  analysisId: string | null;\n  currentStep?: number;\n  createdAt: string;\n  updatedAt: string;\n  auditTrail: unknown[];\n  user: unknown | null;\n  analysis: unknown[];\n  documents: unknown[];\n  template: SessionTemplate;\n  retryCounts?: Record<string, number>; // nodeId -> retry count\n}\n\nexport interface ClientInfo {\n  ip?: string;\n  location?: string;\n  device: string;\n  browser: string;\n  os: string;\n}\n"],"names":[],"mappings":"AA8DO,IAAM,2BAA2B,GAAsB;;;;"}
+{"version":3,"file":"session.js","sources":["../../../../src/types/session.ts"],"sourcesContent":["import type React from \"react\";\n\nexport interface SessionConfig {\n  selfie?: boolean;\n  requireMobile?: boolean;\n}\n\nexport interface DatakeenSessionProps {\n  sessionId: string;\n  sessionConfig?: SessionConfig;\n  apiBaseUrl?: string; // Optional API base URL for dynamic environment configuration\n}\n\nexport interface UseSessionReturn {\n  SessionComponent: React.ReactElement;\n}\n\nexport type stepObject = {\n  setStep: (step: number) => void;\n  goBack: () => void;\n  /** Retour arrière vers un nœud précis (ex: \"Corriger ma saisie\") :\n   *  tronque l'historique jusqu'à `targetStep` au lieu de l'empiler. */\n  goBackToStep: (targetStep: number) => void;\n  goToNextStep: (\n    currentNodeId: string,\n    template: SessionTemplate,\n    handle?: string,\n  ) => void;\n  step: number;\n  canGoBack: boolean;\n};\n\nexport interface ProcessingStep {\n  title: string;\n  subtitle: string;\n  hasError?: boolean;\n}\n\nexport type ConditionTokenType = \"variable\" | \"control\" | \"operator\" | \"input\";\n\nexport interface ConditionToken {\n  type: ConditionTokenType;\n  value: string;\n  label?: string;\n  sourceNodeId?: string;\n}\n\n/**\n * Type for custom field value types\n */\nexport type CustomFieldValueType =\n  | \"text\"\n  | \"enum\"\n  | \"number\"\n  | \"boolean\"\n  | \"date\"\n  | \"email\"\n  | \"address\"\n  | \"list\";\n\n/**\n * Display formats supported for date fields (top-level and list columns).\n */\nexport type DateDisplayFormat = \"dd/mm/yyyy\" | \"mm/dd/yyyy\" | \"yyyy-mm-dd\";\n\nexport const DEFAULT_DATE_DISPLAY_FORMAT: DateDisplayFormat = \"dd/mm/yyyy\";\n\n/**\n * Column definition for a list-type custom field\n */\nexport interface ListColumn {\n  label: string;\n  type: \"text\" | \"enum\" | \"date\" | \"email\";\n  options?: string[]; // required when type === 'enum'\n  placeholder?: string; // text/email/date — shown to the end user\n  regex?: string; // text — JS regex source (without slashes)\n  regexErrorMessage?: string; // text — message displayed when regex fails\n  dateFormat?: DateDisplayFormat; // date — display format expected\n}\n\n/**\n * Interface for custom field definition\n */\nexport interface CustomField {\n  id: string;\n  label: string;\n  placeholder?: string;\n  description?: string;\n  valueType: CustomFieldValueType;\n  enumOptions?: string[];\n  listColumns?: ListColumn[]; // for list type: column definitions\n  minRows?: number; // for list type: minimum rows expected\n  required?: boolean;\n  regex?: string; // text — JS regex source (without slashes)\n  regexErrorMessage?: string; // text — message displayed when regex fails\n  dateFormat?: DateDisplayFormat; // date — display format expected\n  lockedFromApi?: boolean;\n  userInputKey?: string;\n}\n\n/**\n * Interface for session template node\n */\nexport interface SessionTemplateNode {\n  id: string;\n  type: string;\n  title: string;\n  description: string;\n  informationType?:\n  | \"identity\"\n  | \"identity-legal\"\n  | \"contact\"\n  | \"address\"\n  | \"nationality\"\n  | \"custom\";\n  position: {\n    x: number;\n    y: number;\n  };\n  options: unknown[];\n  selectedOptions: string[];\n  requiredDocumentType?: string;\n  isRequired: boolean;\n  order: number;\n  optionalFields?: string[];\n  requiredFields?: string[];\n  pageTitle?: string;\n  pageDescription?: string;\n  // Properties for document-collection node type\n  allowedDocumentTypes?: Array<{\n    id: string;\n    name: string;\n    /**\n     * Optional side information coming from the template.\n     * When provided and equals to two (\"two\", 2, \"double\", \"recto-verso\"),\n     * consumers should allow uploading two sides (front/back).\n     */\n    side?: string | number;\n  }>;\n  allowedAddingMethods?: string[];\n  introductionPage?: {\n    title?: string;\n    description?: string;\n  };\n  documentSelection?: {\n    title?: string;\n    description?: string;\n  };\n  // Start node specific properties\n  welcomeTitle?: string;\n  welcomeSubtitle?: string;\n  welcomeDescription?: string;\n  welcomeImage?: string;\n  qrCodeTitle?: string;\n  qrCodeDescription?: string;\n  showLegacyCGU?: boolean; // default: true — rétrocompatibilité\n\n  // Legal consent node specific properties\n  consentDescription?: string;\n  consentDescription2?: string;\n  cguUrl?: string;\n  privacyPolicyUrl?: string;\n  checkboxText?: string;\n  // Identity control specific properties\n  automaticPhotoCapture?: boolean;\n  acceptedCountries?: AcceptedCountry[];\n  // End node specific properties\n  callbackURL?: string | null;\n  // Condition node specific properties\n  conditionExpression?: string;\n  conditionTokens?: ConditionToken[];\n  conditionFalseErrorMessage?: string;\n  conditionMaxRetries?: number;\n  conditionMaxRetryAction?: \"end-journey\" | \"force-true\";\n  conditionFalseMode?: \"retry\" | \"loop\";\n\n  // External verification specific properties\n  targetApi?: \"INSEE\";\n  referenceNodeId?: string;\n  referenceNodeType?:\n  | \"information-input\"\n  | \"document-collection\"\n  | \"identity-control\";\n  referenceField?: \"siren\" | \"siret\";\n  referenceVariable?: string;\n  // Custom form fields (for information-input with type 'custom')\n  customFields?: CustomField[];\n\n  // Electronic signature specific properties\n  templateId?: string;\n  external_id?: string;\n  fieldMappings?: Array<{\n    sourceFieldId: string;\n    label: string;\n    docusealType: string;\n    readonly: boolean;\n    role?: string;\n    sourceNodeId?: string;\n  }>;\n  /** If set, the generated PDF from this upstream pdf-generation node will be used as the document to sign */\n  sourcePdfNodeId?: string;\n\n  // PDF generation node specific properties\n  // Note: htmlTemplate is intentionally NOT included — it is server-side only and never sent to the client\n  pdfMode?: \"upload\" | \"html-template\";\n  sourceNodeIds?: string[];\n\n  // retry properties\n  allowResubmission: boolean;\n  maxResubmissionAttempts?: number;\n}\n\n/**\n * Interface for accepted countries\n */\nexport interface AcceptedCountry {\n  code: string;\n  documents: {\n    passport: string[];\n    idCard: string[];\n    driverLicense: string[];\n    residencePermit: string[];\n    pinkDriverLicense: string[];\n  };\n}\n\n/**\n * Interface for session template edge\n */\nexport interface SessionTemplateEdge {\n  id: string;\n  source: string;\n  target: string;\n  sourceHandle?: string;\n  targetHandle?: string;\n  conditionValue?: string;\n}\n\n/**\n * Interface for platform information\n */\nexport interface PlatformInfo {\n  mobile: boolean;\n  desktop: boolean;\n  backoffice: boolean;\n}\n\n/**\n * Interface for session template\n */\nexport interface SessionTemplate {\n  id: string;\n  name: string;\n  description: string;\n  version: string;\n  languages: string[];\n  nodes: SessionTemplateNode[];\n  edges: SessionTemplateEdge[];\n  groupId: string;\n  userId: string | null;\n  created_at: string;\n  updated_at: string;\n  platforms?: PlatformInfo;\n  logo?: string;\n  showQRCode?: boolean;\n  buttonBgColor?: string;\n  buttonTextColor?: string;\n}\n\n/**\n * Interface for session data\n */\nexport interface SessionData {\n  id: string;\n  userId: string | null;\n  token: string;\n  templateId: string;\n  templateKey: string;\n  expireTime: number;\n  status: string;\n  result: Record<string, unknown>;\n  landingPage: unknown;\n  withSelfie: boolean | null;\n  groupId: string | null;\n  userInput: Record<string, unknown>;\n  contactInfo?: {\n    email: string;\n    phoneNumber: string;\n  };\n  callbackURL?: string | null;\n  webhookURL: string;\n  analysisTemplateId: string | null;\n  userAgent: unknown[];\n  mobile: boolean;\n  analysisId: string | null;\n  currentStep?: number;\n  createdAt: string;\n  updatedAt: string;\n  auditTrail: unknown[];\n  user: unknown | null;\n  analysis: unknown[];\n  documents: unknown[];\n  template: SessionTemplate;\n  retryCounts?: Record<string, number>; // nodeId -> retry count\n}\n\nexport interface ClientInfo {\n  ip?: string;\n  location?: string;\n  device: string;\n  browser: string;\n  os: string;\n}\n"],"names":[],"mappings":"AAiEO,IAAM,2BAA2B,GAAsB;;;;"}

package/docs/multi-runs.md

@@ -49,11 +49,15 @@ Il n'y a **rien à configurer** — le SDK sélectionne automatiquement la bonne
 
 | Situation | `initialUserInput` reçu par le formulaire |
 |-----------|------------------------------------------|
-| `userInput` sans `_list` | `userInput` global (comportement inchangé) |
+| `userInput` sans `_list` (1er passage **ou** ré-entrée) | `userInput` global persisté |
 | `_list` présent, run 0 | `_list[0]` |
 | `_list` présent, run 1 | `_list[1]` |
 | `_list` présent, run N ≥ longueur | `{}` (formulaire vide) |
 
+> **Sans `_list`, le formulaire est toujours pré-rempli depuis le `userInput` persisté**, y compris lors d'une ré-entrée (boucle `condition` de correction, retour arrière, bouton « Corriger ma saisie »). Une ré-entrée sans `_list` correspond à *corriger les mêmes données*, pas à en saisir de nouvelles — on ne vide donc pas le formulaire.
+>
+> ⚠️ **L'énumération de plusieurs entités distinctes (ex: plusieurs bénéficiaires) doit passer par `_list`.** Sans `_list`, chaque ré-entrée ré-affiche les données précédentes (pas de formulaire vierge par run).
+
 ---
 
 ## Retour arrière

package/package.json

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