@sanctum-key/react-native-sdk 1.0.46 → 1.0.48

package/build/src/types/KYC.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"KYC.types.js","sourceRoot":"","sources":["../../../src/types/KYC.types.ts"],"names":[],"mappings":"AA+UA,MAAM,CAAC,MAAM,6BAA6B,GAA2C;IACnF,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,eAAe,EAAE,IAAI;IACrB,qBAAqB,EAAE,KAAK;IAC5B,mBAAmB,EAAE,IAAI;IACzB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,IAAI;IACjB,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,GAAG,EAAE,KAAK;IACV,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;CACT,CAAA;AAED,MAAM,CAAC,MAAM,6BAA6B,GAA2C;IACnF,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,iBAAiB;IACjC,mBAAmB,EAAE,uBAAuB;IAC5C,kBAAkB,EAAE,qBAAqB;IACzC,UAAU,EAAE,aAAa;IACzB,eAAe,EAAE,qBAAqB;CACvC,CAAA","sourcesContent":["import { VerificationResult } from \"../modules/api/types\";\n\n// Types pour les documents\nexport interface Document {\n  id: string;\n  type: DocumentType;\n  imageUri: string;\n  uploadedAt: Date;\n  validated: boolean;\n  extractedData?: DocumentData;\n\n}\n\nexport type DocumentType = 'passport' | 'id_card' | 'drivers_license';\n\nexport interface DocumentData {\n  firstName?: string;\n  lastName?: string;\n  dateOfBirth?: string;\n  documentNumber?: string;\n  expiryDate?: string;\n  nationality?: string;\n}\n\n// Types pour les selfies\nexport interface Selfie {\n  id: string;\n  imageUri: string;\n  capturedAt: Date;\n  validated: boolean;\n  faceDetected: boolean;\n}\n\n// Types pour la session KYC\nexport interface KYCSession {\n  id: string;\n  userId: string;\n  status: KYCStatus;\n  currentStep: number;\n  documents: Document[];\n  selfie?: Selfie;\n  verificationId?: string;\n  createdAt: Date;\n  updatedAt: Date;\n  completedAt?: Date;\n}\n\nexport type KYCStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'rejected';\n\n// Types pour les étapes du processus\nexport interface KYCStep {\n  id: number;\n  title: string;\n  description: string;\n  isCompleted: boolean;\n  isRequired: boolean;\n}\n\n// Types pour les erreurs\nexport interface KYCError {\n  code: string;\n  message: string;\n  field?: string;\n  details?: any;\n}\n\n// Types pour les réponses API\nexport interface KYCResponse {\n  success: boolean;\n  data?: any;\n  error?: KYCError;\n  message?: string;\n}\n\n// Types pour les événements\nexport interface KYCEvent {\n  type: 'step_completed' | 'document_uploaded' | 'selfie_captured' | 'verification_started' | 'verification_completed';\n  timestamp: Date;\n  data?: any;\n}\n\n// Types pour les configurations\nexport interface KYCConfig {\n  apiBaseUrl: string;\n  apiKey: string;\n  timeout: number;\n  retryAttempts: number;\n  enableDebug: boolean;\n}\n\n// Types pour les hooks\nexport interface UseKYCReturn {\n  session: KYCSession | null;\n  currentStep: number;\n  isProcessing: boolean;\n  error: KYCError | null;\n  startSession: (userId: string) => void;\n  nextStep: () => void;\n  previousStep: () => void;\n  uploadDocument: (document: Document) => Promise<void>;\n  captureSelfie: (selfie: Selfie) => Promise<void>;\n  submitVerification: () => Promise<void>;\n  resetSession: () => void;\n}\n\n// ===== NOUVEAUX TYPES POUR CONFIGURATION AUTOMATIQUE =====\n\n// Types d'éléments KYC configurables\nexport type KYCElementType =\n  | 'country_selection'\n  | 'document_type_selection'\n  | 'camera_capture'\n  | 'file_upload'\n  | 'selfie_capture'\n  | 'verification'\n  | 'completion';\n//KYCElementType shorted\n\n\n// Configuration d'un élément KYC\nexport interface KYCElement {\n  id: string;\n  type: KYCElementType;\n  title: string;\n  description: string;\n  isRequired: boolean;\n  isVisible: boolean;\n  order: number;\n  validation?: KYCValidation;\n  options?: KYCElementOption[];\n  cameraConfig?: KYCCameraConfig;\n  uploadConfig?: KYCUploadConfig;\n}\n\n// Options pour les éléments de sélection\nexport interface KYCElementOption {\n  value: string;\n  label: string;\n  icon?: string;\n  description?: string;\n}\n\n// Configuration de validation\nexport interface KYCValidation {\n  required: boolean;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n  customValidator?: (value: any) => boolean | string;\n}\n\n// Configuration de la caméra\nexport interface KYCCameraConfig {\n  aspectRatio?: number;\n  quality?: number;\n  flashMode?: 'on' | 'off' | 'auto';\n  cameraType?: 'front' | 'back';\n  allowRetake: boolean;\n  maxRetakes?: number;\n  overlay?: {\n    showGuide: boolean;\n    guideText?: string;\n    guideImage?: string;\n  };\n}\n\n// Configuration d'upload\nexport interface KYCUploadConfig {\n  allowedTypes: string[];\n  maxFiles: number;\n  maxFileSize?: number;\n  allowMultiple: boolean;\n}\n\n// Configuration complète du flux KYC\nexport interface KYCFlowConfig {\n  id: string;\n  name: string;\n  description: string;\n  version: string;\n  elements: KYCElement[];\n  settings: {\n    allowBackNavigation: boolean;\n    showProgressBar: boolean;\n    showStepNumbers: boolean;\n    autoAdvance: boolean;\n    enableRetry: boolean;\n    maxRetries: number;\n  };\n  styling: {\n    primaryColor: string;\n    secondaryColor: string;\n    backgroundColor: string;\n    textColor: string;\n    borderRadius: number;\n    fontFamily?: string;\n  };\n  localization: {\n    language: string;\n    translations: Record<string, Record<string, string>>;\n  };\n}\n\n// État du flux KYC\nexport interface KYCFlowState {\n  config: KYCFlowConfig;\n  currentElementIndex: number;\n  completedElements: string[];\n  elementData: Record<string, any>;\n  errors: Record<string, string>;\n  isProcessing: boolean;\n}\n\n// Actions pour le flux KYC\nexport interface KYCFlowActions {\n  initializeFlow: (config: KYCFlowConfig) => void;\n  nextElement: () => void;\n  previousElement: () => void;\n  goToElement: (elementId: string) => void;\n  updateElementData: (elementId: string, data: any) => void;\n  validateElement: (elementId: string) => boolean;\n  submitFlow: () => Promise<void>;\n  resetFlow: () => void;\n}\n\n// Hook pour le flux KYC\nexport interface UseKYCFlowReturn {\n  state: KYCFlowState;\n  actions: KYCFlowActions;\n  currentElement: KYCElement | null;\n  progress: number;\n  canGoNext: boolean;\n  canGoPrevious: boolean;\n  isComplete: boolean;\n}\n\n// ===== TYPES FOR ORIENTATION VIDEO PROCESSING =====\n\n// Orientation types for liveness detection\nexport type OrientationType = 'center' | 'left' | 'right';\n\n// Individual orientation capture result\nexport interface OrientationCapture {\n  captured: boolean;\n  frame: number | null;\n}\n\n// Complete orientation video processing result\nexport interface OrientationVideoResult {\n  center: OrientationCapture;\n  right: OrientationCapture;\n  left: OrientationCapture;\n}\n\n// Orientation video processing request\nexport interface OrientationVideoRequest {\n  file: string; // Base64 encoded video or file path\n}\n\n// Orientation video processing response\nexport interface OrientationVideoResponse {\n  success: boolean;\n  data?: OrientationVideoResult;\n  error?: KYCError;\n  message?: string;\n}\n\n// Configuration for orientation video capture\nexport interface OrientationVideoConfig {\n  duration: number; // Duration in seconds\n  orientations: OrientationType[];\n  instructions: Record<OrientationType, string>;\n  showPreview: boolean;\n  allowRetake: boolean;\n  maxRetakes: number;\n  quality: number;\n  aspectRatio: number;\n}\n\n// State for orientation video capture\nexport interface OrientationVideoState {\n  isRecording: boolean;\n  currentOrientation: OrientationType | null;\n  recordedVideo: string | null;\n  processingResult: OrientationVideoResult | null;\n  isProcessing: boolean;\n  error: string | null;\n  retakeCount: number;\n}\n\n// Actions for orientation video capture\nexport interface OrientationVideoActions {\n  startRecording: () => void;\n  stopRecording: () => void;\n  processVideo: () => Promise<OrientationVideoResult>;\n  retake: () => void;\n  reset: () => void;\n  setCurrentOrientation: (orientation: OrientationType) => void;\n}\n\n// ===== NOUVEAUX TYPES POUR TEMPLATE JSON =====\n\n// Types pour les labels et instructions multilingues\nexport interface LocalizedText {\n  en: string;\n  fr: string;\n  [key: string]: string; // Support pour d'autres langues\n}\n\n// Configuration UI pour les composants\nexport interface ComponentUI {\n  icon?: string;\n  themeColor?: string;\n  buttonText: LocalizedText | Record<string, LocalizedText>;\n  backgroundColor?: string;\n  textColor?: string;\n  borderRadius?: number;\n}\n\n// Types de documents gouvernementaux supportés\nexport type GovernmentDocumentType =\n  | 'identity_card'\n  | 'passport'\n  | 'drivers_licence'\n  | 'health_insurance_card'\n  | 'permanent_residence'\n  | 'national_id'\n  | 'work_permit'\n  | 'id'\n  | 'pp'\n  | 'dl'\n  | 'hic'\n  | 'pr'\n  | 'wp'\n\nexport const GovernmentDocumentTypeShorted: Record<GovernmentDocumentType, string> = {\n  identity_card: 'id',\n  passport: 'pp',\n  drivers_licence: 'dl',\n  health_insurance_card: 'hic',\n  permanent_residence: 'pr',\n  national_id: 'id',\n  work_permit: 'wp',\n  id: 'id',\n  pp: 'pp',\n  dl: 'dl',\n  hic: 'hic',\n  pr: 'pr',\n  wp: 'wp',\n}\n\nexport const GovernmentDocumentTypeBackend: Record<string, GovernmentDocumentType> = {\n  national_id: 'identity_card',\n  passport: 'passport',\n  driversLicense: 'drivers_licence',\n  healthInsuranceCard: 'health_insurance_card',\n  permanentResidence: 'permanent_residence',\n  workPermit: 'work_permit',\n  residencePermit: 'permanent_residence',\n}\n\n// Configuration spécifique pour chaque type de composant\nexport interface IDCardConfig {\n  sides: string[];\n  allowed_formats: string[];\n  max_size_mb: number;\n  document_types: GovernmentDocumentType[]; // Types de documents disponibles\n  bbox_configs?: Record<GovernmentDocumentType, {\n    xMin: number;\n    yMin: number;\n    xMax: number;\n    yMax: number;\n    borderColor?: string;\n    borderWidth?: number;\n    cornerRadius?: number;\n  }>;\n}\n\n\nexport interface SelfieConfig {\n  liveness_check: boolean;\n  max_attempts: number;\n  orientations: ('center' | 'left' | 'right')[]; // Tableau d'orientations à capturer\n}\n\nexport interface FileUploadConfig {\n  allowed_formats: string[];\n  max_size_mb: number;\n  required: boolean;\n}\n\nexport interface LocationConfig {\n  accuracy: string;\n  required: boolean;\n}\n\nexport interface CountrySelectionConfig {\n  allowed_countries: string[];\n  default_country: string;\n  required: boolean;\n}\n\n// Union type pour toutes les configurations\nexport type ComponentConfig =\n  | IDCardConfig\n  | SelfieConfig\n  | FileUploadConfig\n  | LocationConfig\n  | CountrySelectionConfig\n  | CountrySelectionConfig\n  | WelcomeConfig\n  | EmailVerificationConfig\n  | PhoneVerificationConfig\n  | PersonalInformationConfig\n  | AdditionalDocumentsConfig;\n\n// Nouveau type de composant basé sur le template JSON\nexport interface TemplateComponent {\n  id: number;\n  type: 'id_card' | 'selfie' | 'file_upload' | 'location' | 'country_selection' | 'initialization' | 'review_submit' | 'verification_progress' | 'welcome' | 'email_verification' | 'phone_verification' | 'personal_information' | 'additional_documents';\n  order: number;\n  templateId?: number;\n  labels: LocalizedText | Record<string, LocalizedText>;\n  instructions: LocalizedText | Record<string, LocalizedText>;\n  ui: ComponentUI | Record<string, ComponentUI>;\n  config: ComponentConfig;\n}\n\n// Template KYC complet\nexport interface KYCTemplate {\n  id: number;\n  name: LocalizedText;\n  description: LocalizedText;\n  version: string;\n  components: TemplateComponent[];\n}\n\n// État pour le template KYC\nexport interface TemplateState {\n  template: KYCTemplate;\n  currentComponentIndex: number;\n  completedComponents: number[];\n  componentData: Record<number, any>;\n  errors: Record<number, string>;\n  isProcessing: boolean;\n  currentLanguage: string;\n  showCustomStepper: boolean;\n  session: SessionState;\n  verification: VerificationState;\n}\n\nexport interface SessionState {\n  session_id: string;\n  token: string;\n  isInitialized: boolean;\n  isProcessing: boolean;\n  error: string | null;\n  /** True once loadSessionData has run (for resume flow); allows UI to show loading until country/data restored */\n  sessionDataRestored?: boolean;\n}\n\nexport type VerificationStatus = 'idle' | 'in_progress' | 'success' | 'failed';\n\n\n\nexport interface VerificationState {\n  status: VerificationStatus;\n  result?: VerificationResult;\n}\n\n// Actions pour le template KYC\nexport interface TemplateActions {\n  initializeTemplate: (template: KYCTemplate) => void;\n  nextComponent: (overrideData?: any) => void;\n  previousComponent: () => void;\n  goToComponent: (componentId: number) => void;\n  updateComponentData: (componentId: number, data: any) => void;\n  validateComponent: (componentId: number, dataOverride?: any) => boolean;\n  submitTemplate: () => Promise<void>;\n  resetTemplate: () => void;\n  setLanguage: (language: string) => void;\n  showCustomStepper: (show: boolean) => void;\n  setVerificationState: (state: VerificationState) => void;\n  submitVerification: () => Promise<void>;\n}\n\n// Hook pour le template KYC (return type of useTemplateKYCFlow)\nexport interface UseTemplateReturn {\n  state: TemplateState;\n  actions: TemplateActions;\n  currentComponent: TemplateComponent | null;\n  progress: number;\n  canGoNext: boolean;\n  canGoPrevious: boolean;\n  isComplete: boolean;\n  getLocalizedText: (text: LocalizedText) => string;\n  initializeSession: () => Promise<void>;\n  env: 'PRODUCTION' | 'SANDBOX';\n  /** Optional API key for backend auth (e.g. email verification endpoints). */\n  apiKey?: string;\n}\n\n\nexport interface ISilentCaptureResult {\n  success: boolean;\n  path?: string;\n  mrz?: string;\n  barcode?: string | any; \n  error?: string;\n  isAnalyzing?: boolean;\n  bbox?: IBbox;\n  country?: string;\n  documentType?: string;\n  templatePath?: string;\n  lpipsScore?: number;\n}\n\nexport interface IBbox {\n  minX: number;\n  minY: number;\n  width: number;\n  height: number;\n}\n\nexport interface ICountryMapping {\n  py_file?: string;\n  front?: string;\n  back?: string;\n  keys_found?: string | null;\n  mrz_type?: string;\n}\n\nexport interface Country {\n  code?: string; // ISO 3166-1 alpha-2\n  name: string;\n  name_en: string;\n  flag: string;\n  regionMapping?: ICountryMapping;\n  hasRegions?: boolean;\n}\n\n// ===== TYPES FOR BACKEND TEMPLATE FORMAT =====\n\n// Backend component configuration types\nexport interface WelcomeConfig {\n  subtitle?: string;\n  buttonText?: string;\n  requirements?: string[];\n  estimatedTime?: string;\n  consentOptions?: {\n    showPrivacyPolicy?: boolean;\n    showTermsOfService?: boolean;\n    showMarketingConsent?: boolean;\n  };\n  welcomeMessage?: string;\n  showEstimatedTime?: boolean;\n}\n\nexport interface LocationCaptureConfig {\n  showMap?: boolean;\n  accuracy?: string;\n  required?: boolean;\n  maxDistance?: number;\n  captureMethod?: string;\n  allowManualEntry?: boolean;\n  countryRestrictions?: string[];\n}\n\nexport interface GovernmentIdConfig {\n  required?: boolean;\n  allowSkip?: boolean;\n  cameraOverlay?: {\n    bbox?: {\n      xMax?: number;\n      xMin?: number;\n      yMax?: number;\n      yMin?: number;\n      borderColor?: string;\n      borderWidth?: number;\n      cornerRadius?: number;\n    };\n  };\n  documentTypes?: string[];\n  requiredSides?: string;\n  cameraSettings?: {\n    quality?: number;\n    flashMode?: string;\n    maxRetakes?: number;\n    allowRetake?: boolean;\n    aspectRatio?: number;\n  };\n  validationRules?: string[];\n  regionsByCountry?: Record<string, any>;\n  selectedCountries?: string[];\n  authenticationMethods?: Record<string, Record<string, {\n    back?: string[];\n    front?: string[];\n    mrzTypes?: string[];\n  }>>;\n  documentTypesByCountry?: Record<string, string[]>;\n  instructionsByDocumentType?: Record<string, LocalizedText>;\n}\n\nexport interface SelfieCaptureConfig {\n  timeout?: number;\n  maxAttempts?: number;\n  faceMatching?: boolean;\n  captureMethod?: string;\n  qualityChecks?: string[];\n  livenessChecks?: string[];\n  matchThreshold?: string;\n  livenessEnabled?: boolean;\n}\n\nexport interface ReviewSubmitConfig {\n  allowEditing?: boolean;\n  displayOptions?: string[];\n  requireConsent?: boolean;\n  postSubmitActions?: string[];\n}\n\nexport type BackendComponentConfig =\n  | WelcomeConfig\n  | LocationCaptureConfig\n  | GovernmentIdConfig\n  | SelfieCaptureConfig\n  | ReviewSubmitConfig\n  | Record<string, any>;\n\n// Backend component translation structure\nexport interface BackendComponentTranslations {\n  en?: {\n    title?: string;\n    description?: string;\n    instructions?: string;\n    buttonText?: string;\n    consentText?: string;\n    successMessage?: string;\n  };\n  fr?: {\n    title?: string;\n    description?: string;\n    instructions?: string;\n    buttonText?: string;\n    consentText?: string;\n    successMessage?: string;\n  };\n  [key: string]: {\n    title?: string;\n    description?: string;\n    instructions?: string;\n    buttonText?: string;\n    consentText?: string;\n    successMessage?: string;\n  } | undefined;\n}\n\n// Backend template component\nexport interface BackendTemplateComponent {\n  id: string;\n  type: 'welcome' | 'location-capture' | 'government-id' | 'selfie-capture' | 'review-submit' | 'verification-progress' | 'email-verification' | 'phone-verification' | 'personal-information' | 'additional-documents';\n  order: number;\n  config: BackendComponentConfig;\n  required?: boolean;\n  translations: BackendComponentTranslations;\n}\n\n// Backend template structure\nexport interface BackendKYCTemplate {\n  id: string;\n  name: {\n    en: string;\n    fr: string;\n    [key: string]: string;\n  };\n  status?: string;\n  version?: string;\n  components: BackendTemplateComponent[];\n  description?: {\n    en: string;\n    fr: string;\n    [key: string]: string;\n  };\n}\n\n// ===== NEW CONFIG TYPES FOR INPUT VERIFICATION =====\n\nexport interface EmailVerificationConfig {\n  allowResend: boolean;\n  otpSettings: {\n    codeLength: number;\n    expiryTime: number;\n  };\n  resendCooldown: number;\n  emailValidation: {\n    corporateOnly: boolean;\n    validateFormat: boolean;\n    checkDisposable: boolean;\n    checkDeliverability: boolean;\n  };\n  verificationMethod: string;\n  required?: boolean;\n}\n\nexport interface PhoneVerificationConfig {\n  required: boolean;\n  codeExpiry: number;\n  codeLength: number;\n  maxAttempts: number;\n  resendDelay: number;\n  countryRestrictions: string;\n  verificationMethods: string[];\n  allowSkipForVerified: boolean;\n}\n\nexport interface PersonalInfoField {\n  id: string;\n  type: string;\n  label: string;\n  required: boolean;\n  placeholder?: string;\n  autoFillFromId?: boolean;\n  minAge?: number;\n  verifyAge?: boolean;\n  dateFormat?: string;\n}\n\nexport interface PersonalInformationConfig {\n  fields: PersonalInfoField[];\n  validationSettings: {\n    validateOnBlur: boolean;\n    showAllErrorsAtOnce: boolean;\n    preventSubmissionWithErrors: boolean;\n  };\n  required?: boolean;\n}\n\nexport interface DocumentCategory {\n  enabled: boolean;\n  category: string;\n  documentTypes: string[];\n}\n\nexport interface AdditionalDocumentsConfig {\n  required: boolean;\n  maxSizeEach: string;\n  maxDocuments: number;\n  minDocuments: number;\n  documentCategories: DocumentCategory[];\n  customDocumentTypes: any[];\n  showBasedOnUserProfile: boolean;\n}\n\n// API response for template\nexport interface TemplateAPIResponse {\n  id: string;\n  name: {\n    en: string;\n    fr: string;\n    [key: string]: string;\n  };\n  status?: string;\n  version?: string;\n  components: BackendTemplateComponent[];\n  description?: {\n    en: string;\n    fr: string;\n    [key: string]: string;\n  };\n}\n\n// ===== NEW CONFIG TYPES FOR INPUT VERIFICATION =====\n\nexport interface EmailVerificationConfig {\n  allowResend: boolean;\n  otpSettings: {\n    codeLength: number;\n    expiryTime: number;\n  };\n  resendCooldown: number;\n  emailValidation: {\n    corporateOnly: boolean;\n    validateFormat: boolean;\n    checkDisposable: boolean;\n    checkDeliverability: boolean;\n  };\n  verificationMethod: string;\n  required?: boolean;\n}\n\nexport interface PhoneVerificationConfig {\n  required: boolean;\n  codeExpiry: number;\n  codeLength: number;\n  maxAttempts: number;\n  resendDelay: number;\n  countryRestrictions: string;\n  verificationMethods: string[];\n  allowSkipForVerified: boolean;\n}\n\nexport interface PersonalInfoField {\n  id: string;\n  type: string;\n  label: string;\n  required: boolean;\n  placeholder?: string;\n  autoFillFromId?: boolean;\n  minAge?: number;\n  verifyAge?: boolean;\n  dateFormat?: string;\n}\n\nexport interface PersonalInformationConfig {\n  fields: PersonalInfoField[];\n  validationSettings: {\n    validateOnBlur: boolean;\n    showAllErrorsAtOnce: boolean;\n    preventSubmissionWithErrors: boolean;\n  };\n  required?: boolean;\n}\n\nexport interface DocumentCategory {\n  enabled: boolean;\n  category: string;\n  documentTypes: string[];\n}\n\nexport interface AdditionalDocumentsConfig {\n  required: boolean;\n  maxSizeEach: string;\n  maxDocuments: number;\n  minDocuments: number;\n  documentCategories: DocumentCategory[];\n  customDocumentTypes: any[];\n  showBasedOnUserProfile: boolean;\n}"]}
+{"version":3,"file":"KYC.types.js","sourceRoot":"","sources":["../../../src/types/KYC.types.ts"],"names":[],"mappings":"AA+UA,MAAM,CAAC,MAAM,6BAA6B,GAA2C;IACnF,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,eAAe,EAAE,IAAI;IACrB,qBAAqB,EAAE,KAAK;IAC5B,mBAAmB,EAAE,IAAI;IACzB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE,IAAI;IACjB,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,GAAG,EAAE,KAAK;IACV,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;CACT,CAAA;AAED,MAAM,CAAC,MAAM,6BAA6B,GAA2C;IACnF,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,iBAAiB;IACjC,mBAAmB,EAAE,uBAAuB;IAC5C,kBAAkB,EAAE,qBAAqB;IACzC,UAAU,EAAE,aAAa;IACzB,eAAe,EAAE,qBAAqB;CACvC,CAAA","sourcesContent":["import { VerificationResult } from \"../modules/api/types\";\n\n// Types pour les documents\nexport interface Document {\n  id: string;\n  type: DocumentType;\n  imageUri: string;\n  uploadedAt: Date;\n  validated: boolean;\n  extractedData?: DocumentData;\n\n}\n\nexport type DocumentType = 'passport' | 'id_card' | 'drivers_license';\n\nexport interface DocumentData {\n  firstName?: string;\n  lastName?: string;\n  dateOfBirth?: string;\n  documentNumber?: string;\n  expiryDate?: string;\n  nationality?: string;\n}\n\n// Types pour les selfies\nexport interface Selfie {\n  id: string;\n  imageUri: string;\n  capturedAt: Date;\n  validated: boolean;\n  faceDetected: boolean;\n}\n\n// Types pour la session KYC\nexport interface KYCSession {\n  id: string;\n  userId: string;\n  status: KYCStatus;\n  currentStep: number;\n  documents: Document[];\n  selfie?: Selfie;\n  verificationId?: string;\n  createdAt: Date;\n  updatedAt: Date;\n  completedAt?: Date;\n}\n\nexport type KYCStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'rejected';\n\n// Types pour les étapes du processus\nexport interface KYCStep {\n  id: number;\n  title: string;\n  description: string;\n  isCompleted: boolean;\n  isRequired: boolean;\n}\n\n// Types pour les erreurs\nexport interface KYCError {\n  code: string;\n  message: string;\n  field?: string;\n  details?: any;\n}\n\n// Types pour les réponses API\nexport interface KYCResponse {\n  success: boolean;\n  data?: any;\n  error?: KYCError;\n  message?: string;\n}\n\n// Types pour les événements\nexport interface KYCEvent {\n  type: 'step_completed' | 'document_uploaded' | 'selfie_captured' | 'verification_started' | 'verification_completed';\n  timestamp: Date;\n  data?: any;\n}\n\n// Types pour les configurations\nexport interface KYCConfig {\n  apiBaseUrl: string;\n  apiKey: string;\n  timeout: number;\n  retryAttempts: number;\n  enableDebug: boolean;\n}\n\n// Types pour les hooks\nexport interface UseKYCReturn {\n  session: KYCSession | null;\n  currentStep: number;\n  isProcessing: boolean;\n  error: KYCError | null;\n  startSession: (userId: string) => void;\n  nextStep: () => void;\n  previousStep: () => void;\n  uploadDocument: (document: Document) => Promise<void>;\n  captureSelfie: (selfie: Selfie) => Promise<void>;\n  submitVerification: () => Promise<void>;\n  resetSession: () => void;\n}\n\n// ===== NOUVEAUX TYPES POUR CONFIGURATION AUTOMATIQUE =====\n\n// Types d'éléments KYC configurables\nexport type KYCElementType =\n  | 'country_selection'\n  | 'document_type_selection'\n  | 'camera_capture'\n  | 'file_upload'\n  | 'selfie_capture'\n  | 'verification'\n  | 'completion';\n//KYCElementType shorted\n\n\n// Configuration d'un élément KYC\nexport interface KYCElement {\n  id: string;\n  type: KYCElementType;\n  title: string;\n  description: string;\n  isRequired: boolean;\n  isVisible: boolean;\n  order: number;\n  validation?: KYCValidation;\n  options?: KYCElementOption[];\n  cameraConfig?: KYCCameraConfig;\n  uploadConfig?: KYCUploadConfig;\n}\n\n// Options pour les éléments de sélection\nexport interface KYCElementOption {\n  value: string;\n  label: string;\n  icon?: string;\n  description?: string;\n}\n\n// Configuration de validation\nexport interface KYCValidation {\n  required: boolean;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n  customValidator?: (value: any) => boolean | string;\n}\n\n// Configuration de la caméra\nexport interface KYCCameraConfig {\n  aspectRatio?: number;\n  quality?: number;\n  flashMode?: 'on' | 'off' | 'auto';\n  cameraType?: 'front' | 'back';\n  allowRetake: boolean;\n  maxRetakes?: number;\n  overlay?: {\n    showGuide: boolean;\n    guideText?: string;\n    guideImage?: string;\n  };\n}\n\n// Configuration d'upload\nexport interface KYCUploadConfig {\n  allowedTypes: string[];\n  maxFiles: number;\n  maxFileSize?: number;\n  allowMultiple: boolean;\n}\n\n// Configuration complète du flux KYC\nexport interface KYCFlowConfig {\n  id: string;\n  name: string;\n  description: string;\n  version: string;\n  elements: KYCElement[];\n  settings: {\n    allowBackNavigation: boolean;\n    showProgressBar: boolean;\n    showStepNumbers: boolean;\n    autoAdvance: boolean;\n    enableRetry: boolean;\n    maxRetries: number;\n  };\n  styling: {\n    primaryColor: string;\n    secondaryColor: string;\n    backgroundColor: string;\n    textColor: string;\n    borderRadius: number;\n    fontFamily?: string;\n  };\n  localization: {\n    language: string;\n    translations: Record<string, Record<string, string>>;\n  };\n}\n\n// État du flux KYC\nexport interface KYCFlowState {\n  config: KYCFlowConfig;\n  currentElementIndex: number;\n  completedElements: string[];\n  elementData: Record<string, any>;\n  errors: Record<string, string>;\n  isProcessing: boolean;\n}\n\n// Actions pour le flux KYC\nexport interface KYCFlowActions {\n  initializeFlow: (config: KYCFlowConfig) => void;\n  nextElement: () => void;\n  previousElement: () => void;\n  goToElement: (elementId: string) => void;\n  updateElementData: (elementId: string, data: any) => void;\n  validateElement: (elementId: string) => boolean;\n  submitFlow: () => Promise<void>;\n  resetFlow: () => void;\n}\n\n// Hook pour le flux KYC\nexport interface UseKYCFlowReturn {\n  state: KYCFlowState;\n  actions: KYCFlowActions;\n  currentElement: KYCElement | null;\n  progress: number;\n  canGoNext: boolean;\n  canGoPrevious: boolean;\n  isComplete: boolean;\n}\n\n// ===== TYPES FOR ORIENTATION VIDEO PROCESSING =====\n\n// Orientation types for liveness detection\nexport type OrientationType = 'center' | 'left' | 'right';\n\n// Individual orientation capture result\nexport interface OrientationCapture {\n  captured: boolean;\n  frame: number | null;\n}\n\n// Complete orientation video processing result\nexport interface OrientationVideoResult {\n  center: OrientationCapture;\n  right: OrientationCapture;\n  left: OrientationCapture;\n}\n\n// Orientation video processing request\nexport interface OrientationVideoRequest {\n  file: string; // Base64 encoded video or file path\n}\n\n// Orientation video processing response\nexport interface OrientationVideoResponse {\n  success: boolean;\n  data?: OrientationVideoResult;\n  error?: KYCError;\n  message?: string;\n}\n\n// Configuration for orientation video capture\nexport interface OrientationVideoConfig {\n  duration: number; // Duration in seconds\n  orientations: OrientationType[];\n  instructions: Record<OrientationType, string>;\n  showPreview: boolean;\n  allowRetake: boolean;\n  maxRetakes: number;\n  quality: number;\n  aspectRatio: number;\n}\n\n// State for orientation video capture\nexport interface OrientationVideoState {\n  isRecording: boolean;\n  currentOrientation: OrientationType | null;\n  recordedVideo: string | null;\n  processingResult: OrientationVideoResult | null;\n  isProcessing: boolean;\n  error: string | null;\n  retakeCount: number;\n}\n\n// Actions for orientation video capture\nexport interface OrientationVideoActions {\n  startRecording: () => void;\n  stopRecording: () => void;\n  processVideo: () => Promise<OrientationVideoResult>;\n  retake: () => void;\n  reset: () => void;\n  setCurrentOrientation: (orientation: OrientationType) => void;\n}\n\n// ===== NOUVEAUX TYPES POUR TEMPLATE JSON =====\n\n// Types pour les labels et instructions multilingues\nexport interface LocalizedText {\n  en: string;\n  fr: string;\n  [key: string]: string; // Support pour d'autres langues\n}\n\n// Configuration UI pour les composants\nexport interface ComponentUI {\n  icon?: string;\n  themeColor?: string;\n  buttonText: LocalizedText | Record<string, LocalizedText>;\n  backgroundColor?: string;\n  textColor?: string;\n  borderRadius?: number;\n}\n\n// Types de documents gouvernementaux supportés\nexport type GovernmentDocumentType =\n  | 'identity_card'\n  | 'passport'\n  | 'drivers_licence'\n  | 'health_insurance_card'\n  | 'permanent_residence'\n  | 'national_id'\n  | 'work_permit'\n  | 'id'\n  | 'pp'\n  | 'dl'\n  | 'hic'\n  | 'pr'\n  | 'wp'\n\nexport const GovernmentDocumentTypeShorted: Record<GovernmentDocumentType, string> = {\n  identity_card: 'id',\n  passport: 'pp',\n  drivers_licence: 'dl',\n  health_insurance_card: 'hic',\n  permanent_residence: 'pr',\n  national_id: 'id',\n  work_permit: 'wp',\n  id: 'id',\n  pp: 'pp',\n  dl: 'dl',\n  hic: 'hic',\n  pr: 'pr',\n  wp: 'wp',\n}\n\nexport const GovernmentDocumentTypeBackend: Record<string, GovernmentDocumentType> = {\n  national_id: 'identity_card',\n  passport: 'passport',\n  driversLicense: 'drivers_licence',\n  healthInsuranceCard: 'health_insurance_card',\n  permanentResidence: 'permanent_residence',\n  workPermit: 'work_permit',\n  residencePermit: 'permanent_residence',\n}\n\n// Configuration spécifique pour chaque type de composant\nexport interface IDCardConfig {\n  sides: string[];\n  allowed_formats: string[];\n  max_size_mb: number;\n  document_types: GovernmentDocumentType[]; // Types de documents disponibles\n  bbox_configs?: Record<GovernmentDocumentType, {\n    xMin: number;\n    yMin: number;\n    xMax: number;\n    yMax: number;\n    borderColor?: string;\n    borderWidth?: number;\n    cornerRadius?: number;\n  }>;\n}\n\n\nexport interface SelfieConfig {\n  liveness_check: boolean;\n  max_attempts: number;\n  orientations: ('center' | 'left' | 'right')[]; // Tableau d'orientations à capturer\n}\n\nexport interface FileUploadConfig {\n  allowed_formats: string[];\n  max_size_mb: number;\n  required: boolean;\n}\n\nexport interface LocationConfig {\n  accuracy: string;\n  required: boolean;\n}\n\nexport interface CountrySelectionConfig {\n  allowed_countries: string[];\n  default_country: string;\n  required: boolean;\n}\n\n// Union type pour toutes les configurations\nexport type ComponentConfig =\n  | IDCardConfig\n  | SelfieConfig\n  | FileUploadConfig\n  | LocationConfig\n  | CountrySelectionConfig\n  | CountrySelectionConfig\n  | WelcomeConfig\n  | EmailVerificationConfig\n  | PhoneVerificationConfig\n  | PersonalInformationConfig\n  | AdditionalDocumentsConfig;\n\n// Nouveau type de composant basé sur le template JSON\nexport interface TemplateComponent {\n  id: number;\n  type: 'id_card' | 'selfie' | 'file_upload' | 'location' | 'country_selection' | 'initialization' | 'review_submit' | 'verification_progress' | 'welcome' | 'email_verification' | 'phone_verification' | 'personal_information' | 'additional_documents';\n  order: number;\n  templateId?: number;\n  labels: LocalizedText | Record<string, LocalizedText>;\n  instructions: LocalizedText | Record<string, LocalizedText>;\n  ui: ComponentUI | Record<string, ComponentUI>;\n  config: ComponentConfig;\n}\n\n// Template KYC complet\nexport interface KYCTemplate {\n  id: number;\n  name: LocalizedText;\n  description: LocalizedText;\n  version: string;\n  components: TemplateComponent[];\n}\n\n// État pour le template KYC\nexport interface TemplateState {\n  template: KYCTemplate;\n  currentComponentIndex: number;\n  completedComponents: number[];\n  componentData: Record<number, any>;\n  errors: Record<number, string>;\n  isProcessing: boolean;\n  currentLanguage: string;\n  showCustomStepper: boolean;\n  session: SessionState;\n  verification: VerificationState;\n}\n\nexport interface SessionState {\n  session_id: string;\n  token: string;\n  isInitialized: boolean;\n  isProcessing: boolean;\n  error: string | null;\n  /** True once loadSessionData has run (for resume flow); allows UI to show loading until country/data restored */\n  sessionDataRestored?: boolean;\n}\n\nexport type VerificationStatus = 'idle' | 'in_progress' | 'success' | 'failed';\n\n\n\nexport interface VerificationState {\n  status: VerificationStatus;\n  result?: VerificationResult;\n}\n\n// Actions pour le template KYC\nexport interface TemplateActions {\n  initializeTemplate: (template: KYCTemplate) => void;\n  nextComponent: (overrideData?: any) => void;\n  previousComponent: () => void;\n  goToComponent: (componentId: number) => void;\n  updateComponentData: (componentId: number, data: any) => void;\n  validateComponent: (componentId: number, dataOverride?: any) => boolean;\n  submitTemplate: () => Promise<void>;\n  resetTemplate: () => void;\n  restartSession: () => void;\n  setLanguage: (language: string) => void;\n  showCustomStepper: (show: boolean) => void;\n  setVerificationState: (state: VerificationState) => void;\n  submitVerification: () => Promise<void>;\n}\n\n// Hook pour le template KYC (return type of useTemplateKYCFlow)\nexport interface UseTemplateReturn {\n  state: TemplateState;\n  actions: TemplateActions;\n  currentComponent: TemplateComponent | null;\n  progress: number;\n  canGoNext: boolean;\n  canGoPrevious: boolean;\n  isComplete: boolean;\n  getLocalizedText: (text: LocalizedText) => string;\n  initializeSession: () => Promise<void>;\n  env: 'PRODUCTION' | 'SANDBOX';\n  /** Optional API key for backend auth (e.g. email verification endpoints). */\n  apiKey?: string;\n}\n\n\nexport interface ISilentCaptureResult {\n  success: boolean;\n  path?: string;\n  mrz?: string;\n  barcode?: string | any; \n  error?: string;\n  isAnalyzing?: boolean;\n  bbox?: IBbox;\n  country?: string;\n  documentType?: string;\n  templatePath?: string;\n  lpipsScore?: number;\n}\n\nexport interface IBbox {\n  minX: number;\n  minY: number;\n  width: number;\n  height: number;\n}\n\nexport interface ICountryMapping {\n  py_file?: string;\n  front?: string;\n  back?: string;\n  keys_found?: string | null;\n  mrz_type?: string;\n}\n\nexport interface Country {\n  code?: string; // ISO 3166-1 alpha-2\n  name: string;\n  name_en: string;\n  flag: string;\n  regionMapping?: ICountryMapping;\n  hasRegions?: boolean;\n}\n\n// ===== TYPES FOR BACKEND TEMPLATE FORMAT =====\n\n// Backend component configuration types\nexport interface WelcomeConfig {\n  subtitle?: string;\n  buttonText?: string;\n  requirements?: string[];\n  estimatedTime?: string;\n  consentOptions?: {\n    showPrivacyPolicy?: boolean;\n    showTermsOfService?: boolean;\n    showMarketingConsent?: boolean;\n  };\n  welcomeMessage?: string;\n  showEstimatedTime?: boolean;\n}\n\nexport interface LocationCaptureConfig {\n  showMap?: boolean;\n  accuracy?: string;\n  required?: boolean;\n  maxDistance?: number;\n  captureMethod?: string;\n  allowManualEntry?: boolean;\n  countryRestrictions?: string[];\n}\n\nexport interface GovernmentIdConfig {\n  required?: boolean;\n  allowSkip?: boolean;\n  cameraOverlay?: {\n    bbox?: {\n      xMax?: number;\n      xMin?: number;\n      yMax?: number;\n      yMin?: number;\n      borderColor?: string;\n      borderWidth?: number;\n      cornerRadius?: number;\n    };\n  };\n  documentTypes?: string[];\n  requiredSides?: string;\n  cameraSettings?: {\n    quality?: number;\n    flashMode?: string;\n    maxRetakes?: number;\n    allowRetake?: boolean;\n    aspectRatio?: number;\n  };\n  validationRules?: string[];\n  regionsByCountry?: Record<string, any>;\n  selectedCountries?: string[];\n  authenticationMethods?: Record<string, Record<string, {\n    back?: string[];\n    front?: string[];\n    mrzTypes?: string[];\n  }>>;\n  documentTypesByCountry?: Record<string, string[]>;\n  instructionsByDocumentType?: Record<string, LocalizedText>;\n}\n\nexport interface SelfieCaptureConfig {\n  timeout?: number;\n  maxAttempts?: number;\n  faceMatching?: boolean;\n  captureMethod?: string;\n  qualityChecks?: string[];\n  livenessChecks?: string[];\n  matchThreshold?: string;\n  livenessEnabled?: boolean;\n}\n\nexport interface ReviewSubmitConfig {\n  allowEditing?: boolean;\n  displayOptions?: string[];\n  requireConsent?: boolean;\n  postSubmitActions?: string[];\n}\n\nexport type BackendComponentConfig =\n  | WelcomeConfig\n  | LocationCaptureConfig\n  | GovernmentIdConfig\n  | SelfieCaptureConfig\n  | ReviewSubmitConfig\n  | Record<string, any>;\n\n// Backend component translation structure\nexport interface BackendComponentTranslations {\n  en?: {\n    title?: string;\n    description?: string;\n    instructions?: string;\n    buttonText?: string;\n    consentText?: string;\n    successMessage?: string;\n  };\n  fr?: {\n    title?: string;\n    description?: string;\n    instructions?: string;\n    buttonText?: string;\n    consentText?: string;\n    successMessage?: string;\n  };\n  [key: string]: {\n    title?: string;\n    description?: string;\n    instructions?: string;\n    buttonText?: string;\n    consentText?: string;\n    successMessage?: string;\n  } | undefined;\n}\n\n// Backend template component\nexport interface BackendTemplateComponent {\n  id: string;\n  type: 'welcome' | 'location-capture' | 'government-id' | 'selfie-capture' | 'review-submit' | 'verification-progress' | 'email-verification' | 'phone-verification' | 'personal-information' | 'additional-documents';\n  order: number;\n  config: BackendComponentConfig;\n  required?: boolean;\n  translations: BackendComponentTranslations;\n}\n\n// Backend template structure\nexport interface BackendKYCTemplate {\n  id: string;\n  name: {\n    en: string;\n    fr: string;\n    [key: string]: string;\n  };\n  status?: string;\n  version?: string;\n  components: BackendTemplateComponent[];\n  description?: {\n    en: string;\n    fr: string;\n    [key: string]: string;\n  };\n}\n\n// ===== NEW CONFIG TYPES FOR INPUT VERIFICATION =====\n\nexport interface EmailVerificationConfig {\n  allowResend: boolean;\n  otpSettings: {\n    codeLength: number;\n    expiryTime: number;\n  };\n  resendCooldown: number;\n  emailValidation: {\n    corporateOnly: boolean;\n    validateFormat: boolean;\n    checkDisposable: boolean;\n    checkDeliverability: boolean;\n  };\n  verificationMethod: string;\n  required?: boolean;\n}\n\nexport interface PhoneVerificationConfig {\n  required: boolean;\n  codeExpiry: number;\n  codeLength: number;\n  maxAttempts: number;\n  resendDelay: number;\n  countryRestrictions: string;\n  verificationMethods: string[];\n  allowSkipForVerified: boolean;\n}\n\nexport interface PersonalInfoField {\n  id: string;\n  type: string;\n  label: string;\n  required: boolean;\n  placeholder?: string;\n  autoFillFromId?: boolean;\n  minAge?: number;\n  verifyAge?: boolean;\n  dateFormat?: string;\n}\n\nexport interface PersonalInformationConfig {\n  fields: PersonalInfoField[];\n  validationSettings: {\n    validateOnBlur: boolean;\n    showAllErrorsAtOnce: boolean;\n    preventSubmissionWithErrors: boolean;\n  };\n  required?: boolean;\n}\n\nexport interface DocumentCategory {\n  enabled: boolean;\n  category: string;\n  documentTypes: string[];\n}\n\nexport interface AdditionalDocumentsConfig {\n  required: boolean;\n  maxSizeEach: string;\n  maxDocuments: number;\n  minDocuments: number;\n  documentCategories: DocumentCategory[];\n  customDocumentTypes: any[];\n  showBasedOnUserProfile: boolean;\n}\n\n// API response for template\nexport interface TemplateAPIResponse {\n  id: string;\n  name: {\n    en: string;\n    fr: string;\n    [key: string]: string;\n  };\n  status?: string;\n  version?: string;\n  components: BackendTemplateComponent[];\n  description?: {\n    en: string;\n    fr: string;\n    [key: string]: string;\n  };\n}\n\n// ===== NEW CONFIG TYPES FOR INPUT VERIFICATION =====\n\nexport interface EmailVerificationConfig {\n  allowResend: boolean;\n  otpSettings: {\n    codeLength: number;\n    expiryTime: number;\n  };\n  resendCooldown: number;\n  emailValidation: {\n    corporateOnly: boolean;\n    validateFormat: boolean;\n    checkDisposable: boolean;\n    checkDeliverability: boolean;\n  };\n  verificationMethod: string;\n  required?: boolean;\n}\n\nexport interface PhoneVerificationConfig {\n  required: boolean;\n  codeExpiry: number;\n  codeLength: number;\n  maxAttempts: number;\n  resendDelay: number;\n  countryRestrictions: string;\n  verificationMethods: string[];\n  allowSkipForVerified: boolean;\n}\n\nexport interface PersonalInfoField {\n  id: string;\n  type: string;\n  label: string;\n  required: boolean;\n  placeholder?: string;\n  autoFillFromId?: boolean;\n  minAge?: number;\n  verifyAge?: boolean;\n  dateFormat?: string;\n}\n\nexport interface PersonalInformationConfig {\n  fields: PersonalInfoField[];\n  validationSettings: {\n    validateOnBlur: boolean;\n    showAllErrorsAtOnce: boolean;\n    preventSubmissionWithErrors: boolean;\n  };\n  required?: boolean;\n}\n\nexport interface DocumentCategory {\n  enabled: boolean;\n  category: string;\n  documentTypes: string[];\n}\n\nexport interface AdditionalDocumentsConfig {\n  required: boolean;\n  maxSizeEach: string;\n  maxDocuments: number;\n  minDocuments: number;\n  documentCategories: DocumentCategory[];\n  customDocumentTypes: any[];\n  showBasedOnUserProfile: boolean;\n}"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanctum-key/react-native-sdk",
-  "version": "1.0.46",
+  "version": "1.0.48",
   "description": "Sanctum Key React Native SDK",
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",

package/src/components/KYCElements/IDCardCapture.tsx

@@ -464,8 +464,7 @@ export const IDCardCapture: React.FC<IDCardCaptureProps> = ({ component, value =
 
   const handleExitKYCFlow = () => {
     clearAuthToken();
-    
-    // 2. Clear all local camera/capture states
+    // 1. Clear local UI and camera states immediately
     setCapturedImages({});
     if (onValueChange) onValueChange({}); // Clear the parent's form state
     setCurrentSide('front');
@@ -476,14 +475,16 @@ export const IDCardCapture: React.FC<IDCardCaptureProps> = ({ component, value =
     setIsProcessingCapture(false);
     setProcessingImagePath(null);
   
-    // 3. Restart the flow
-    if (actions.resetTemplate) {
-      // This is the best method: it wipes the context and rebuilds the initial state
+    // 2. Restart the backend session and context state
+    if (actions.restartSession) {
+      // This is your new custom action that wipes the token, state, and fetches a new session
+      actions.restartSession();
+    } else if (actions.resetTemplate) {
+      // Fallback
+      clearAuthToken();
       actions.resetTemplate();
-    } else if (actions.goToComponent && state.template?.components?.length > 0) {
-      actions.goToComponent(state.template.components[0].id);
     } else {
-      console.warn("Could not restart flow. Check your KYC context actions.");
+      console.warn("Could not restart flow. Ensure restartSession is added to your KYC context actions.");
     }
 };
 
@@ -626,26 +627,72 @@ export const IDCardCapture: React.FC<IDCardCaptureProps> = ({ component, value =
         let hintMessage = '';
 
         // 2. Business Logic Errors
-        if (rawMessage.includes('pays sélectionné') || rawMessage.includes('country mismatch')) {
-          hintMessage = state.currentLanguage === 'en' ? 'Does not match the selected country.' : 'Ne correspond pas au pays sélectionné.';
-        } else if (rawMessage.includes('impossible') || rawMessage.includes('unreadable')) {
-          hintMessage = state.currentLanguage === 'en' ? 'Move to better lighting and ensure card is in frame.' : 'Améliorez l\'éclairage et assurez-vous que la carte est bien cadrée.';
-        } else if (rawMessage.includes('card_not_fully_in_frame') || rawMessage.includes('frame')) {
-          hintMessage = state.currentLanguage === 'en' ? 'Move closer to the document.' : 'Rapprochez-vous du document.';
-        } else if (rawMessage.includes('ne correspond pas au recto')) {
-          hintMessage = state.currentLanguage === 'en' ? 'Please scan the same ID.' : 'Veuillez scanner la même pièce.';
+        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é.';
+        } 
+        
+        // 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é.';
+        } 
+        
+        // 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.';
+        }
+        
+        // 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.';
         } 
-        // 3. Fallback to Network/API failure
+        
+        // 6. True Network Errors vs. Fallback Processing
         else {
-          const isNetworkError = error.isAxiosError || error.message === 'Network Error' || error.code === 'ECONNABORTED' || rawMessage.includes('network') || !error.response;
+          // 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. Retrying...' : 'Connexion faible. Nouvelle tentative...';
-          } else {
-            hintMessage = state.currentLanguage === 'en' ? 'Analyzing...' : 'Analyse en cours...';
-          }
+            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 }));
       }
     }
@@ -971,7 +1018,35 @@ const styles = StyleSheet.create({
   sideTitle: { fontSize: 22, fontWeight: 'bold', color: '#000', marginBottom: 12, textAlign: 'center' },
   imagePreviewWrapper: { width: '100%', borderRadius: 12, padding: 1, overflow: 'hidden', shadowColor: '#000', shadowOffset: { width: 0, height: 4 }, shadowOpacity: 0.12, shadowRadius: 8, elevation: 8, backgroundColor: '#f0f0f0', ...Platform.select({ web: { aspectRatio: 1.59, height: 'auto', maxWidth: 450, alignSelf: 'center' } as any, default: { height: 220 } }) },
   previewImage: { width: '100%', height: '100%', borderRadius: 12, resizeMode: 'cover' },
-  floatingErrorBanner: { backgroundColor: '#FEF2F2', borderWidth: 1, borderColor: '#FCA5A5', paddingVertical: 12, paddingHorizontal: 16, borderRadius: 12, alignItems: 'center', justifyContent: 'center', width: '100%', ...Platform.select({ web: { position: 'absolute', bottom: '100%', marginBottom: 16, maxWidth: 500, alignSelf: 'center', zIndex: 100000, boxShadow: '0 4px 12px rgba(0,0,0,0.15)' } as any, default: { position: 'absolute', top: Platform.OS === 'ios' ? 90 : 70, left: 24, right: 24, zIndex: 10000 } }) },
+  floatingErrorBanner: {
+    backgroundColor: '#FEF2F2',
+    borderWidth: 1,
+    borderColor: '#FCA5A5',
+    paddingVertical: 12,
+    paddingHorizontal: 16,
+    borderRadius: 12,
+    alignItems: 'center',
+    justifyContent: 'center',
+    ...Platform.select({
+      web: {
+        position: 'absolute',
+        bottom: '100%',
+        marginBottom: 16,
+        maxWidth: 500,
+        width: '100%', // Safe to keep 100% on web since left/right aren't used
+        alignSelf: 'center',
+        zIndex: 100000,
+        boxShadow: '0 4px 12px rgba(0,0,0,0.15)'
+      } as any,
+      default: {
+        position: 'absolute',
+        top: Platform.OS === 'ios' ? 90 : 70,
+        left: 24,
+        right: 24,
+        zIndex: 10000
+      }
+    })
+  },
   floatingErrorText: { color: '#991B1B', fontSize: 14, fontWeight: '700', textAlign: 'center' },
   processingOverlay: { flex: 1, backgroundColor: 'rgba(0, 0, 0, 0.7)', justifyContent: 'center', alignItems: 'center', zIndex: 9999, ...Platform.select({ web: { backdropFilter: 'blur(4px)' } as any }) },
   processingText: { color: '#FFF', fontSize: 18, fontWeight: 'bold', marginTop: 16, textAlign: 'center' },

package/src/components/KYCElements/VerificationProgressTemplate.tsx

@@ -1,5 +1,5 @@
 import React, { useEffect, useRef, useState } from 'react';
-import { View, Text, StyleSheet, TouchableOpacity } from 'react-native';
+import { View, Text, StyleSheet, TouchableOpacity, ActivityIndicator } from 'react-native';
 import { TemplateComponent } from '../../types/KYC.types';
 import { useTemplateKYCFlowContext } from '../../hooks/useTemplateKYCFlow';
 import { useI18n } from '../../hooks/useI18n';
@@ -14,16 +14,14 @@ interface VerificationProgressTemplateProps {
   language?: string;
 }
 
-const MAX_RETRIES = 40; // 40 attempts * 3 seconds = exactly 2 minutes of polling
+const MAX_RETRIES = 40; // 40 attempts * 3 seconds = 2 minutes of polling
 
 export const VerificationProgressTemplate: React.FC<VerificationProgressTemplateProps> = () => {
   const { t } = useI18n();
   const { state, actions } = useTemplateKYCFlowContext();
   
   const [retryCount, setRetryCount] = useState(0);
-  const [isRetrying, setIsRetrying] = useState(false);
   
-  // 🚨 BULLETPROOF REFS: Prevents memory leaks and duplicate polling loops
   const timeoutIdRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const isPollingRef = useRef(false);
   const isMountedRef = useRef(true); 
@@ -33,14 +31,12 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
   const isFailed = verification.status === 'failed';
 
   const getVerificationResult = async (currentRetryCount = 0) => {
-    // If component unmounted while waiting, stop everything
     if (!isMountedRef.current) return;
 
     try {
-      logger.log(`Starting verification check (attempt ${currentRetryCount + 1}/${MAX_RETRIES})`);
+      logger.log(`Starting verification check (attempt ${currentRetryCount + 1}/${MAX_RETRIES})...`);
       const result: any = await kycService.getVerificationResult(state.session.session_id);
-      logger.log('getVerificationResult raw result:', JSON.stringify(result, null, 2));
-
+      
       const rootStatus = (result?.status || '').toLowerCase();
       if (rootStatus === 'failed.' || rootStatus === 'failed' || rootStatus === 'rejected' || rootStatus === 'error') {
         actions.setVerificationState({
@@ -50,12 +46,10 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
             issues: [result?.message || result?.reason || 'Verification failed. Sent for manual review.']
           } as any
         });
-        if (isMountedRef.current) setIsRetrying(false);
         isPollingRef.current = false;
         return;
       }
 
-      // 2. Safely Extract Nested Payload
       let vData = result?.data || result;
       
       if (typeof vData === 'string') {
@@ -76,17 +70,21 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
 
       const vStatus = (vData.verification_status || vData.status || vData.state || '').toLowerCase();
       const vDecision = (vData.decision || vData.outcome || vData.result || '').toLowerCase();
-      const selfieMatch = vData.selfie_info?.is_match;
-
-      logger.log(`Parsed Status: [${vStatus}], Decision: [${vDecision}], Selfie Match: [${selfieMatch}]`);
+      
+      logger.log(`Parsed Status: [${vStatus}], Decision: [${vDecision}]`);
 
       // SUCCESS CONDITION
       if (
-        vStatus === 'approved' || vStatus === 'verified' || vStatus === 'success' ||
-        vDecision === 'approved' || vDecision === 'passed' || vDecision === 'clear' ||
-        (vStatus === 'completed' && selfieMatch === true)
+        vStatus === 'approved' || 
+        vStatus === 'verified' || 
+        vStatus === 'success' || 
+        vStatus === 'completed' || 
+        vDecision === 'approved' || 
+        vDecision === 'passed' || 
+        vDecision === 'clear'
       ) {
         const hasActualData = vData && Object.keys(vData).length > 0;
+        
         if (!hasActualData) {
           actions.setVerificationState({
             status: 'failed',
@@ -95,7 +93,6 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
               issues: ['Document text could not be read clearly. Please retake the photo in better lighting.']
             } as any
           });
-          if (isMountedRef.current) setIsRetrying(false);
           isPollingRef.current = false;
           return;
         }
@@ -104,38 +101,39 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
           status: 'success',
           result: { ...result, referenceId: vData.verification_id || vData.session_id || state.session.session_id } as any
         });
-        if (isMountedRef.current) setIsRetrying(false);
         isPollingRef.current = false;
         return;
       }
 
-      // PENDING/PROCESSING CONDITION
+      // PENDING/PROCESSING CONDITION - RE-INTRODUCING POLLING
       if (
-        vStatus === 'processing' || vStatus === 'pending' || vStatus === 'in_progress' ||
-        vStatus === 'initiated' || (vStatus === 'completed' && selfieMatch === null) || !vStatus
+        vStatus === 'processing' || 
+        vStatus === 'pending' || 
+        vStatus === 'in_progress' || 
+        vStatus === 'initiated' || 
+        !vStatus
       ) {
         if (currentRetryCount < MAX_RETRIES) {
-          const nextRetryCount = currentRetryCount + 1;
+          const nextCount = currentRetryCount + 1;
           if (isMountedRef.current) {
-            setRetryCount(nextRetryCount);
-            setIsRetrying(true);
+             setRetryCount(nextCount);
           }
-          logger.log(`Verification still processing, retrying in 3s... (${nextRetryCount}/${MAX_RETRIES})`);
           
+          logger.log(`Verification still processing, scheduling next check in 3s...`);
           if (timeoutIdRef.current) clearTimeout(timeoutIdRef.current);
+          
           timeoutIdRef.current = setTimeout(() => {
-            getVerificationResult(nextRetryCount);
+            getVerificationResult(nextCount);
           }, 3000);
         } else {
-          logger.error('Max retries reached, verification still processing');
+          logger.log('Max retries reached. Sending to manual review.');
           actions.setVerificationState({
             status: 'failed',
             result: {
               referenceId: state.session.session_id,
-              issues: ['Verification timed out after maximum attempts. Please try again.']
+              issues: ['Verification is taking longer than usual and requires manual review. Please check back later.']
             } as any
           });
-          if (isMountedRef.current) setIsRetrying(false);
           isPollingRef.current = false;
         }
         return;
@@ -143,26 +141,28 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
 
       // UNKNOWN FALLBACK
       logger.warn(`Unknown verification status received: ${vStatus}`);
-      if (isMountedRef.current) setIsRetrying(false);
+      actions.setVerificationState({
+        status: 'failed',
+        result: {
+          referenceId: state.session.session_id,
+          issues: ['Received an unknown status from the server.']
+        } as any
+      });
       isPollingRef.current = false;
 
     } catch (error: any) {
       logger.error('getVerificationResult error', JSON.stringify(errorMessage(error) || { message: error?.message || 'Unknown error' }, null, 2));
       
+      // If network fails temporarily, we should also retry instead of instantly failing
       if (currentRetryCount < MAX_RETRIES) {
-        const nextRetryCount = currentRetryCount + 1;
-        if (isMountedRef.current) {
-          setRetryCount(nextRetryCount);
-          setIsRetrying(true);
-        }
-        logger.log(`Error occurred, retrying in 3s... (${nextRetryCount}/${MAX_RETRIES})`);
+        const nextCount = currentRetryCount + 1;
+        if (isMountedRef.current) setRetryCount(nextCount);
         
         if (timeoutIdRef.current) clearTimeout(timeoutIdRef.current);
         timeoutIdRef.current = setTimeout(() => {
-          getVerificationResult(nextRetryCount);
+          getVerificationResult(nextCount);
         }, 3000);
       } else {
-        logger.error('Max retries reached after errors');
         actions.setVerificationState({
           status: 'failed',
           result: {
@@ -170,22 +170,19 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
             issues: ['Connection failed multiple times. Please check your network and try again.']
           } as any
         });
-        if (isMountedRef.current) setIsRetrying(false);
         isPollingRef.current = false;
       }
     }
   };
 
-  // 1. Kick off polling when component mounts
   useEffect(() => {
     isMountedRef.current = true;
     if (state.session.session_id && !isSuccess && !isFailed && !isPollingRef.current) {
       isPollingRef.current = true;
-      getVerificationResult(0); // Always start explicitly at 0
+      getVerificationResult(0);
     }
   }, [state.session.session_id, isSuccess, isFailed]);
 
-  // 2. Strict cleanup on unmount ONLY
   useEffect(() => {
     return () => {
       isMountedRef.current = false;
@@ -194,7 +191,6 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
     };
   }, []);
 
-  // 3. Auto-submit on success
   useEffect(() => {
     let autoSubmitTimer: ReturnType<typeof setTimeout>;
     if (isSuccess) {
@@ -262,9 +258,9 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
     <View style={styles.container}>
       <Text style={styles.title}>{t('kyc.verificationProgress.title')}</Text>
       <Text style={styles.subtitle}>
-        {isRetrying
-          ? `${t('kyc.verificationProgress.retrying', { current: retryCount, max: MAX_RETRIES })}`
-          : t('kyc.verificationProgress.estimatedTime')}
+        {state.currentLanguage === 'en' 
+          ? `Checking verification status...` 
+          : `Vérification du statut en cours...`}
       </Text>
 
       <View style={styles.timeline}>
@@ -289,9 +285,14 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
         <Text style={styles.cardLine}>{t('kyc.verificationProgress.steps.analyzing')}</Text>
         
         <Text style={styles.cardTitle}>{t('kyc.verificationProgress.title')}</Text>
-        <Text style={styles.cardLine}>
-          {isRetrying ? `${t('kyc.verificationProgress.status.processing')}...` : t('kyc.verificationProgress.status.pending')}
-        </Text>
+        
+        <View style={styles.loadingRow}>
+          <ActivityIndicator size="small" color="#2DBD60" style={{ marginRight: 8 }} />
+          <Text style={styles.cardLine}>
+            {t('kyc.verificationProgress.status.processing')}... 
+            <Text style={styles.retryText}> ({retryCount}/{MAX_RETRIES})</Text>
+          </Text>
+        </View>
       </View>
     </View>
   );
@@ -313,6 +314,8 @@ const styles = StyleSheet.create({
   card: { backgroundColor: 'white', padding: 16, borderRadius: 16, marginTop: 24 },
   cardTitle: { fontSize: 16, color: '#6B7280', marginTop: 8 },
   cardLine: { fontSize: 18, color: '#111827', fontWeight: '600', marginTop: 2 },
+  loadingRow: { flexDirection: 'row', alignItems: 'center', marginTop: 4 },
+  retryText: { fontSize: 14, color: '#9CA3AF', fontWeight: '500' },
   button: { paddingVertical: 14, borderRadius: 10, alignItems: 'center', marginTop: 14 },
   primary: { backgroundColor: '#2DBD60' },
   buttonText: { color: 'white', fontSize: 16, fontWeight: '600' },

package/src/hooks/useTemplateKYCFlow.tsx

@@ -1,7 +1,7 @@
 import React, { useState, useCallback, useMemo, createContext, useContext, ReactNode, useEffect, useRef } from 'react';
 import { KYCTemplate, TemplateState, TemplateActions, UseTemplateReturn, TemplateComponent, GovernmentDocumentType, VerificationState } from '../types/KYC.types';
 import { KycEnvironment } from '../types/env.types';
-import kycService, { authentification, truncateFields } from '../modules/api/KYCService';
+import kycService, { authentification, clearAuthToken, truncateFields } from '../modules/api/KYCService';
 import useI18n from './useI18n';
 import { logger } from '../utils/logger';
 import { countryMapping } from '../config/region_mapping';
@@ -1083,6 +1083,24 @@ export const useTemplateKYCFlow = (
       setState(buildInitialState());
     }, [buildInitialState, apiKey]),
 
+    restartSession: useCallback(async () => {
+      // 1. Clear the cached token so the backend doesn't reject the new request
+      // Make sure to import clearAuthToken at the top of your context file!
+      clearAuthToken(); 
+
+      // 2. Wipe the local component and UI state
+      setState(buildInitialState());
+
+     
+      try {
+         await initializeSession(); 
+         // OR
+      } catch (error) {
+         logger.error("Failed to fetch new session on restart", error);
+      }
+      
+    }, [buildInitialState, apiKey, initializeSession]),
+
     // Changer la langue
     setLanguage: useCallback((language: string) => {
       setState(prev => ({