@transfergratis/react-native-sdk 0.1.30 → 0.1.32

package/src/components/TemplateKYCExample.tsx

@@ -149,7 +149,8 @@ export const TemplateKYCExample: React.FC<{
   existingSessionId?: string;
   initialComponentIndex?: number;
   initialCountryResume?: { code: string; documentType: string; region?: string };
-}> = ({ onComplete, onCancel, onError, language, API_KEY, templateId, template, env = 'PRODUCTION', serverEnv, existingSessionId, initialComponentIndex, initialCountryResume }) => {
+  onSessionSave?: (sessionId: string) => void;
+}> = ({ onComplete, onCancel, onError, language, API_KEY, templateId, template, env = 'PRODUCTION', serverEnv, existingSessionId, initialComponentIndex, initialCountryResume, onSessionSave }) => {
   const handleComplete = (data: VerificationState) => {
     console.log('KYC Template completed with data:', data);
     onComplete(data);
@@ -186,6 +187,7 @@ export const TemplateKYCExample: React.FC<{
           existingSessionId={existingSessionId}
           initialComponentIndex={initialComponentIndex}
           initialCountryResume={initialCountryResume}
+          onSessionSave={onSessionSave}
         />
       </View>
     </SafeAreaView>

package/src/components/TemplateKYCFlowRefactored.tsx

@@ -36,6 +36,7 @@ interface TemplateKYCFlowProps {
   initialComponentIndex?: number;
   /** Pays / type de document depuis l'URL de reprise (reprise multi-appareil) */
   initialCountryResume?: { code: string; documentType: string; region?: string };
+  onSessionSave?: (sessionId: string) => void;
 }
 
 export const TemplateKYCFlow: React.FC<TemplateKYCFlowProps> = ({
@@ -51,6 +52,7 @@ export const TemplateKYCFlow: React.FC<TemplateKYCFlowProps> = ({
   existingSessionId,
   initialComponentIndex,
   initialCountryResume,
+  onSessionSave,
 }) => {
   const { t } = useI18n();
   const { template: loadedTemplate, isLoading, error, loadTemplate } = useTemplateLoader();
@@ -152,6 +154,7 @@ export const TemplateKYCFlow: React.FC<TemplateKYCFlowProps> = ({
       existingSessionId={existingSessionId}
       initialComponentIndex={initialComponentIndex}
       initialCountryResume={initialCountryResume}
+      onSessionSave={onSessionSave}
     >
       <TemplateKYCFlowContent onCancel={OnCancel} />
     </TemplateKYCFlowProvider>

package/src/config/region_mapping.json

@@ -73,7 +73,7 @@
         "identity_card": {
             "root": [
                 {
-                    "py_file": "cameroon_id_back_1_1.py",
+                    "py_file": "cameroon_id_back_1_1_new.py",
                     "back": "MRZ",
                     "mrz_type": "TD1"
                 },
@@ -96,11 +96,7 @@
                     "mrz_type": "TD1"
                 },
                 {
-                    "py_file": "cameroon_id_front_1_1.py",
-                    "keys_found": null
-                },
-                {
-                    "py_file": "cameroon_id_front_2_1.py",
+                    "py_file": "cameroon_id_front_1_1_new.py",
                     "keys_found": null
                 },
                 {
@@ -599,30 +595,26 @@
         "identity_card": {
             "root": [
                 {
-                    "py_file": "back_1.py",
+                    "py_file": "back_2.py",
                     "back": "MRZ",
                     "mrz_type": "TD1"
                 },
                 {
-                    "py_file": "back_2.py",
-                    "back": "MRZ",
-                    "mrz_type": "TD1"
+                    "py_file": "front_3.py",
+                    "keys_found": null
                 },
                 {
-                    "py_file": "back_3.py",
+                    "py_file": "kenya_back_1.py",
                     "back": "MRZ",
                     "mrz_type": "TD1"
                 },
                 {
-                    "py_file": "front_1.py",
-                    "keys_found": null
-                },
-                {
-                    "py_file": "front_2.py",
-                    "keys_found": null
+                    "py_file": "kenya_back_3.py",
+                    "back": "MRZ",
+                    "mrz_type": "TD1"
                 },
                 {
-                    "py_file": "front_3.py",
+                    "py_file": "kenya_front_2.py",
                     "keys_found": null
                 }
             ]

package/src/config/region_mapping.ts

@@ -75,7 +75,7 @@ export const countryMapping: Record<string, Record<string, Record<string, ICount
         "identity_card": {
             "root": [
                 {
-                    "py_file": "cameroon_id_back_1_1.py",
+                    "py_file": "cameroon_id_back_1_1_new.py",
                     "back": "MRZ",
                     "mrz_type": "TD1"
                 },
@@ -98,11 +98,7 @@ export const countryMapping: Record<string, Record<string, Record<string, ICount
                     "mrz_type": "TD1"
                 },
                 {
-                    "py_file": "cameroon_id_front_1_1.py",
-                    "keys_found": null
-                },
-                {
-                    "py_file": "cameroon_id_front_2_1.py",
+                    "py_file": "cameroon_id_front_1_1_new.py",
                     "keys_found": null
                 },
                 {
@@ -601,30 +597,26 @@ export const countryMapping: Record<string, Record<string, Record<string, ICount
         "identity_card": {
             "root": [
                 {
-                    "py_file": "back_1.py",
+                    "py_file": "back_2.py",
                     "back": "MRZ",
                     "mrz_type": "TD1"
                 },
                 {
-                    "py_file": "back_2.py",
-                    "back": "MRZ",
-                    "mrz_type": "TD1"
+                    "py_file": "front_3.py",
+                    "keys_found": null
                 },
                 {
-                    "py_file": "back_3.py",
+                    "py_file": "kenya_back_1.py",
                     "back": "MRZ",
                     "mrz_type": "TD1"
                 },
                 {
-                    "py_file": "front_1.py",
-                    "keys_found": null
-                },
-                {
-                    "py_file": "front_2.py",
-                    "keys_found": null
+                    "py_file": "kenya_back_3.py",
+                    "back": "MRZ",
+                    "mrz_type": "TD1"
                 },
                 {
-                    "py_file": "front_3.py",
+                    "py_file": "kenya_front_2.py",
                     "keys_found": null
                 }
             ]

package/src/hooks/useTemplateKYCFlow.tsx

@@ -1,4 +1,4 @@
-import React, { useState, useCallback, useMemo, createContext, useContext, ReactNode, useEffect } from 'react';
+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';
@@ -39,6 +39,7 @@ interface TemplateKYCFlowProviderProps {
   initialComponentIndex?: number;
   /** Pays / type de document depuis l'URL de reprise — évite de dépendre du backend pour afficher les pays. */
   initialCountryResume?: { code: string; documentType: string; region?: string };
+  onSessionSave?: (sessionId: string) => void;
 }
 
 export const TemplateKYCFlowProvider: React.FC<TemplateKYCFlowProviderProps> = ({
@@ -53,8 +54,9 @@ export const TemplateKYCFlowProvider: React.FC<TemplateKYCFlowProviderProps> = (
   existingSessionId,
   initialComponentIndex,
   initialCountryResume,
+  onSessionSave,
 }) => {
-  const hookResult = useTemplateKYCFlow(template, onComplete, onError, onCancel, initialLanguage, apiKey, env, existingSessionId, initialComponentIndex, initialCountryResume);
+  const hookResult = useTemplateKYCFlow(template, onComplete, onError, onCancel, initialLanguage, apiKey, env, existingSessionId, initialComponentIndex, initialCountryResume, onSessionSave);
 
   return (
     <TemplateKYCFlowContext.Provider value={hookResult}>
@@ -83,6 +85,7 @@ export const useTemplateKYCFlow = (
   existingSessionId?: string,
   initialComponentIndex?: number,
   initialCountryResume?: { code: string; documentType: string; region?: string },
+  onSessionSave?: (sessionId: string) => void,
 ): UseTemplateReturn => {
 
   const { setLocale } = useI18n();
@@ -253,6 +256,7 @@ export const useTemplateKYCFlow = (
 
   // État du flux
   const [state, setState] = useState<TemplateState>(() => buildInitialState());
+  const hasSavedSessionRef = useRef(false);
   
   // Fonction utilitaire pour convertir base64 en data URI pour l'affichage
   const base64ToDataUri = useCallback((base64: string, mimeType: string = 'image/jpeg'): string => {
@@ -723,6 +727,15 @@ export const useTemplateKYCFlow = (
     initializeSession();
   }, [existingSessionId, state.session.session_id, state.session.isInitialized, initializeSession]);
 
+  // Emit session id once when session becomes available.
+  useEffect(() => {
+    if (!onSessionSave || hasSavedSessionRef.current) return;
+    if (!state.session.isInitialized || !state.session.session_id) return;
+
+    hasSavedSessionRef.current = true;
+    onSessionSave(state.session.session_id);
+  }, [onSessionSave, state.session.isInitialized, state.session.session_id]);
+
   // Validation d'un composant (dataOverride permet de valider sans attendre la mise à jour du state)
   const validateComponent = useCallback((componentId: number, dataOverride?: any): boolean => {
     const component = state.template.components.find(c => c.id === componentId);

package/src/web/WebKYCEntry.tsx

@@ -12,12 +12,14 @@ interface WebKYCEntryProps {
   onComplete?: (data: any) => void;
   onError?: (error: string) => void;
   onCancel?: () => void;
+  onSessionSave?: (sessionId: string) => void;
 }
 
 interface URLParams {
   token?: string;
   return_url?: string;
   push_url?: string;
+  save_session_url?: string;
   lang?: string;
   theme?: string;
   kyc_id?: string;
@@ -42,6 +44,7 @@ const WebKYCEntry: React.FC<WebKYCEntryProps> = ({
   onComplete,
   onError,
   onCancel,
+  onSessionSave,
 }) => {
   const { setLocale } = useI18n();
   const [urlParams, setUrlParams] = useState<URLParams>({});
@@ -66,6 +69,7 @@ const WebKYCEntry: React.FC<WebKYCEntryProps> = ({
       token: urlParams.get('token') || undefined,
       return_url: urlParams.get('return_url') || undefined,
       push_url: urlParams.get('push_url') || undefined,
+      save_session_url: urlParams.get('save_session_url') || undefined,
       lang: urlParams.get('lang') || 'en',
       theme: urlParams.get('theme') || 'light',
       kyc_id: urlParams.get('kyc_id') || undefined,
@@ -234,6 +238,42 @@ const WebKYCEntry: React.FC<WebKYCEntryProps> = ({
     onCancel?.();
   }, [redirectToReturnUrl, urlParams.kyc_id, onCancel]);
 
+  const handleSessionSave = useCallback(async (sessionId: string) => {
+    console.log('KYC session created:', sessionId);
+
+    if (urlParams.save_session_url) {
+      try {
+        const payload = {
+          status: 'session_created',
+          result: {
+            session_id: sessionId,
+            kyc_id: sessionId,
+          },
+        };
+
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), 5000);
+
+        await fetch(urlParams.save_session_url, {
+          method: 'POST',
+          headers: {
+            'Content-Type': 'application/json',
+          },
+          body: JSON.stringify(payload),
+          signal: controller.signal,
+        });
+
+        clearTimeout(timeoutId);
+        console.log('Successfully pushed session data to save_session_url');
+      } catch (err) {
+        // Fail open - do not block the KYC flow if save_session webhook fails
+        console.warn('Failed to push session data to save_session_url:', err);
+      }
+    }
+
+    onSessionSave?.(sessionId);
+  }, [urlParams.save_session_url, onSessionSave]);
+
   // Initialize component
   useEffect(() => {
     try {
@@ -311,6 +351,7 @@ const WebKYCEntry: React.FC<WebKYCEntryProps> = ({
           return Number.isNaN(index) ? undefined : index;
         })()}
         initialCountryResume={urlParams.country && urlParams.document_type ? { code: urlParams.country, documentType: urlParams.document_type, region: urlParams.region || undefined } : undefined}
+        onSessionSave={handleSessionSave}
       />
     </SafeAreaView>
   );