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

package/build/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/build/src/components/KYCElements/IDCardCapture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IDCardCapture.d.ts","sourceRoot":"","sources":["../../../../src/components/KYCElements/IDCardCapture.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAIpE,OAAO,EAAE,iBAAiB,EAAoI,MAAM,uBAAuB,CAAC;AAuB5L,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,kBAAkB;IAC1B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkCD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAo2BtD,CAAC"}
+{"version":3,"file":"IDCardCapture.d.ts","sourceRoot":"","sources":["../../../../src/components/KYCElements/IDCardCapture.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAIpE,OAAO,EAAE,iBAAiB,EAAoI,MAAM,uBAAuB,CAAC;AAuB5L,UAAU,cAAc;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,kBAAkB;IAC1B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkCD,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAm5BtD,CAAC"}

package/build/src/components/KYCElements/IDCardCapture.js

@@ -447,7 +447,7 @@ export const IDCardCapture = ({ component, value = {}, onValueChange, error, lan
     };
     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
@@ -458,16 +458,18 @@ export const IDCardCapture = ({ component, value = {}, onValueChange, error, lan
         setPendingCAImage(null);
         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
-            actions.resetTemplate();
+        // 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.goToComponent && state.template?.components?.length > 0) {
-            actions.goToComponent(state.template.components[0].id);
+        else if (actions.resetTemplate) {
+            // Fallback
+            clearAuthToken();
+            actions.resetTemplate();
         }
         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.");
         }
     };
     const handleSilentCapture = async (result) => {
@@ -594,26 +596,58 @@ export const IDCardCapture = ({ component, value = {}, onValueChange, error, lan
                 }
                 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é.';
+                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é.';
                 }
-                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.';
+                // 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é.';
                 }
-                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.';
+                // 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.';
                 }
-                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.';
+                // 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 }));
@@ -889,7 +923,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' }, 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)' }, 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)'
+            },
+            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)' } }) },
     processingText: { color: '#FFF', fontSize: 18, fontWeight: 'bold', marginTop: 16, textAlign: 'center' },