npm - @sanctum-key/react-native-sdk - Versions diffs - 1.0.47 → 1.0.48 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

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

	@@ -1 +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}"]}
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 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 CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@sanctum-key/react-native-sdk",
-  "version": "1.0.47",
+  "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 CHANGED Viewed

@@ -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,27 +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.';
         }
+        // 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'
-            ? 'Taking longer than expected. Retrying...'
-            : 'Cela prend un peu plus de temps que prévu. Nouvel essai...';
-          } else {
-            hintMessage = state.currentLanguage === 'en' ? 'Analyzing...' : 'Analyse en cours...';
-          }
+              ? 'Poor connection. Please check your internet.'
+              : 'Connexion faible. Veuillez vérifier votre internet.';
+          }
         }
         setSilentCaptureResult(prev => ({ ...prev, isAnalyzing: false, success: false, error: hintMessage }));
       }
     }
@@ -972,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 CHANGED Viewed

@@ -1,5 +1,5 @@
-import React, { useEffect, useRef } from 'react';
-import { View, Text, StyleSheet, TouchableOpacity } from 'react-native';
+import React, { useEffect, useRef, useState } from 'react';
+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,27 +14,29 @@ interface VerificationProgressTemplateProps {
   language?: string;
 }
+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();
-  // 🚨 BULLETPROOF REFS: Ensures we only fetch once and don't update unmounted state
-  const hasFetchedRef = useRef(false);
+  const [retryCount, setRetryCount] = useState(0);
+  const timeoutIdRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+  const isPollingRef = useRef(false);
   const isMountedRef = useRef(true);
   const verification = state.verification;
   const isSuccess = verification.status === 'success';
   const isFailed = verification.status === 'failed';
-  const getVerificationResult = async () => {
-    // If component unmounted while waiting, stop everything
+  const getVerificationResult = async (currentRetryCount = 0) => {
     if (!isMountedRef.current) return;
     try {
-      logger.log(`Starting single verification check...`);
+      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({
@@ -44,10 +46,10 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
             issues: [result?.message || result?.reason || 'Verification failed. Sent for manual review.']
           } as any
         });
+        isPollingRef.current = false;
         return;
       }
-      // 2. Safely Extract Nested Payload
       let vData = result?.data || result;
       if (typeof vData === 'string') {
@@ -68,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',
@@ -87,6 +93,7 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
               issues: ['Document text could not be read clearly. Please retake the photo in better lighting.']
             } as any
           });
+          isPollingRef.current = false;
           return;
         }
@@ -94,22 +101,41 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
           status: 'success',
           result: { ...result, referenceId: vData.verification_id || vData.session_id || state.session.session_id } as any
         });
+        isPollingRef.current = false;
         return;
       }
-      // PENDING/PROCESSING CONDITION - NO MORE POLLING
+      // 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
       ) {
-        logger.log('Verification still processing. Sending to manual review.');
-        actions.setVerificationState({
-          status: 'failed',
-          result: {
-            referenceId: state.session.session_id,
-            issues: ['Verification requires manual review or is taking longer than usual. Please check back later.']
-          } as any
-        });
+        if (currentRetryCount < MAX_RETRIES) {
+          const nextCount = currentRetryCount + 1;
+          if (isMountedRef.current) {
+             setRetryCount(nextCount);
+          }
+          logger.log(`Verification still processing, scheduling next check in 3s...`);
+          if (timeoutIdRef.current) clearTimeout(timeoutIdRef.current);
+          timeoutIdRef.current = setTimeout(() => {
+            getVerificationResult(nextCount);
+          }, 3000);
+        } else {
+          logger.log('Max retries reached. Sending to manual review.');
+          actions.setVerificationState({
+            status: 'failed',
+            result: {
+              referenceId: state.session.session_id,
+              issues: ['Verification is taking longer than usual and requires manual review. Please check back later.']
+            } as any
+          });
+          isPollingRef.current = false;
+        }
         return;
       }
@@ -122,37 +148,49 @@ export const VerificationProgressTemplate: React.FC<VerificationProgressTemplate
           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));
-      actions.setVerificationState({
-        status: 'failed',
-        result: {
-          referenceId: state.session.session_id,
-          issues: ['Connection failed. Please check your network and try again.']
-        } as any
-      });
+      // If network fails temporarily, we should also retry instead of instantly failing
+      if (currentRetryCount < MAX_RETRIES) {
+        const nextCount = currentRetryCount + 1;
+        if (isMountedRef.current) setRetryCount(nextCount);
+        if (timeoutIdRef.current) clearTimeout(timeoutIdRef.current);
+        timeoutIdRef.current = setTimeout(() => {
+          getVerificationResult(nextCount);
+        }, 3000);
+      } else {
+        actions.setVerificationState({
+          status: 'failed',
+          result: {
+            referenceId: state.session.session_id,
+            issues: ['Connection failed multiple times. Please check your network and try again.']
+          } as any
+        });
+        isPollingRef.current = false;
+      }
     }
   };
-  // 1. Kick off single fetch when component mounts
   useEffect(() => {
     isMountedRef.current = true;
-    if (state.session.session_id && !isSuccess && !isFailed && !hasFetchedRef.current) {
-      hasFetchedRef.current = true;
-      getVerificationResult();
+    if (state.session.session_id && !isSuccess && !isFailed && !isPollingRef.current) {
+      isPollingRef.current = true;
+      getVerificationResult(0);
     }
   }, [state.session.session_id, isSuccess, isFailed]);
-  // 2. Strict cleanup on unmount ONLY
   useEffect(() => {
     return () => {
       isMountedRef.current = false;
+      if (timeoutIdRef.current) clearTimeout(timeoutIdRef.current);
+      isPollingRef.current = false;
     };
   }, []);
-  // 3. Auto-submit on success
   useEffect(() => {
     let autoSubmitTimer: ReturnType<typeof setTimeout>;
     if (isSuccess) {
@@ -220,7 +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}>
-        {t('kyc.verificationProgress.estimatedTime')}
+        {state.currentLanguage === 'en'
+          ? `Checking verification status...`
+          : `Vérification du statut en cours...`}
       </Text>
       <View style={styles.timeline}>
@@ -245,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}>
-          {t('kyc.verificationProgress.status.processing')}...
-        </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>
   );
@@ -269,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 CHANGED Viewed

@@ -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 => ({