@sanctum-key/react-native-sdk 1.0.0

package/src/config/KYCConfigs.ts

@@ -0,0 +1,528 @@
+import { KYCFlowConfig } from '../types/KYC.types';
+
+// Configuration pour KYC basique (passeport + selfie)
+export const basicKYCConfig: KYCFlowConfig = {
+  id: 'basic_kyc',
+  name: 'Vérification d\'identité basique',
+  description: 'Vérification avec passeport et selfie',
+  version: '1.0.0',
+  elements: [
+    {
+      id: 'country_selection',
+      type: 'country_selection',
+      title: 'Quel pays a émis votre document ?',
+      description: 'Cela nous aide à vérifier vos documents rapidement et en toute sécurité',
+      isRequired: true,
+      isVisible: true,
+      order: 0,
+      validation: { required: true },
+      options: [
+        { value: 'FR', label: 'France', icon: '🇫🇷' },
+        { value: 'BE', label: 'Belgique', icon: '🇧🇪' },
+        { value: 'LU', label: 'Luxembourg', icon: '🇱🇺' },
+        { value: 'DE', label: 'Allemagne', icon: '🇩🇪' },
+        { value: 'IT', label: 'Italie', icon: '🇮🇹' },
+        { value: 'ES', label: 'Espagne', icon: '🇪🇸' },
+        { value: 'PT', label: 'Portugal', icon: '🇵🇹' },
+        { value: 'AT', label: 'Autriche', icon: '🇦🇹' },
+        { value: 'CH', label: 'Suisse', icon: '🇨🇭' },
+        { value: 'NL', label: 'Pays-Bas', icon: '🇳🇱' },
+        { value: 'OTHER', label: 'Autre', icon: '🌍' },
+      ],
+    },
+    {
+      id: 'document_type',
+      type: 'document_type_selection',
+      title: 'Quel type de document utilisez-vous ?',
+      description: 'Sélectionnez le type de document que vous allez présenter',
+      isRequired: true,
+      isVisible: true,
+      order: 1,
+      validation: { required: true },
+      options: [
+        { value: 'passport', label: 'Passeport', icon: '📘', description: 'Document de voyage officiel' },
+        { value: 'id_card', label: 'Carte d\'identité', icon: '🆔', description: 'Carte d\'identité nationale' },
+        { value: 'drivers_license', label: 'Permis de conduire', icon: '🚗', description: 'Permis de conduire valide' },
+      ],
+    },
+    {
+      id: 'document_front',
+      type: 'camera_capture',
+      title: 'Prenez une photo du recto de votre document',
+      description: 'Placez votre document dans le cadre et assurez-vous qu\'il soit bien visible',
+      isRequired: true,
+      isVisible: true,
+      order: 2,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 4/3,
+        quality: 0.8,
+        flashMode: 'auto',
+        cameraType: 'back',
+        allowRetake: true,
+        maxRetakes: 3,
+        overlay: {
+          showGuide: true,
+          guideText: 'Placez votre document dans le cadre',
+        }
+      },
+    },
+    {
+      id: 'document_back',
+      type: 'camera_capture',
+      title: 'Prenez une photo du verso de votre document',
+      description: 'Placez votre document dans le cadre et assurez-vous qu\'il soit bien visible',
+      isRequired: true,
+      isVisible: true,
+      order: 3,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 4/3,
+        quality: 0.8,
+        flashMode: 'auto',
+        cameraType: 'back',
+        allowRetake: true,
+        maxRetakes: 3,
+        overlay: {
+          showGuide: true,
+          guideText: 'Placez votre document dans le cadre',
+        }
+      },
+    },
+    {
+      id: 'selfie',
+      type: 'selfie_capture',
+      title: 'Prenez une selfie',
+      description: 'Placez votre visage dans le cercle et regardez la caméra',
+      isRequired: true,
+      isVisible: true,
+      order: 4,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 1,
+        quality: 0.8,
+        flashMode: 'off',
+        cameraType: 'front',
+        allowRetake: true,
+        maxRetakes: 3,
+        overlay: {
+          showGuide: true,
+          guideText: 'Placez votre visage dans le cercle',
+        }
+      },
+    },
+    {
+      id: 'verification',
+      type: 'verification',
+      title: 'Vérification en cours',
+      description: 'Nous vérifions vos informations, veuillez patienter...',
+      isRequired: true,
+      isVisible: true,
+      order: 5,
+    },
+    {
+      id: 'completion',
+      type: 'completion',
+      title: 'Vérification terminée !',
+      description: 'Votre identité a été vérifiée avec succès',
+      isRequired: true,
+      isVisible: true,
+      order: 6,
+    },
+  ],
+  settings: {
+    allowBackNavigation: true,
+    showProgressBar: true,
+    showStepNumbers: true,
+    autoAdvance: false,
+    enableRetry: true,
+    maxRetries: 3,
+  },
+  styling: {
+    primaryColor: '#4CAF50',
+    secondaryColor: '#2196F3',
+    backgroundColor: '#f8f9fa',
+    textColor: '#333',
+    borderRadius: 8,
+  },
+  localization: {
+    language: 'fr',
+    translations: {},
+  },
+};
+
+// Configuration pour KYC avancé (avec upload de fichiers)
+export const advancedKYCConfig: KYCFlowConfig = {
+  id: 'advanced_kyc',
+  name: 'Vérification d\'identité avancée',
+  description: 'Vérification avec documents supplémentaires',
+  version: '1.0.0',
+  elements: [
+    {
+      id: 'country_selection',
+      type: 'country_selection',
+      title: 'Quel pays a émis votre document ?',
+      description: 'Cela nous aide à vérifier vos documents rapidement et en toute sécurité',
+      isRequired: true,
+      isVisible: true,
+      order: 0,
+      validation: { required: true },
+    },
+    {
+      id: 'document_type',
+      type: 'document_type_selection',
+      title: 'Quel type de document utilisez-vous ?',
+      description: 'Sélectionnez le type de document que vous allez présenter',
+      isRequired: true,
+      isVisible: true,
+      order: 1,
+      validation: { required: true },
+    },
+    {
+      id: 'document_front',
+      type: 'camera_capture',
+      title: 'Prenez une photo du recto de votre document',
+      description: 'Placez votre document dans le cadre et assurez-vous qu\'il soit bien visible',
+      isRequired: true,
+      isVisible: true,
+      order: 2,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 4/3,
+        quality: 0.8,
+        flashMode: 'auto',
+        cameraType: 'back',
+        allowRetake: true,
+        maxRetakes: 3,
+      },
+    },
+    {
+      id: 'document_back',
+      type: 'camera_capture',
+      title: 'Prenez une photo du verso de votre document',
+      description: 'Placez votre document dans le cadre et assurez-vous qu\'il soit bien visible',
+      isRequired: true,
+      isVisible: true,
+      order: 3,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 4/3,
+        quality: 0.8,
+        flashMode: 'auto',
+        cameraType: 'back',
+        allowRetake: true,
+        maxRetakes: 3,
+      },
+    },
+    {
+      id: 'additional_documents',
+      type: 'file_upload',
+      title: 'Documents supplémentaires (optionnel)',
+      description: 'Vous pouvez ajouter des documents supplémentaires pour accélérer la vérification',
+      isRequired: false,
+      isVisible: true,
+      order: 4,
+      uploadConfig: {
+        allowedTypes: ['image/*', 'application/pdf'],
+        maxFiles: 5,
+        maxFileSize: 10 * 1024 * 1024, // 10MB
+        allowMultiple: true,
+      },
+    },
+    {
+      id: 'selfie',
+      type: 'selfie_capture',
+      title: 'Prenez une selfie',
+      description: 'Placez votre visage dans le cercle et regardez la caméra',
+      isRequired: true,
+      isVisible: true,
+      order: 5,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 1,
+        quality: 0.8,
+        flashMode: 'off',
+        cameraType: 'front',
+        allowRetake: true,
+        maxRetakes: 3,
+      },
+    },
+    {
+      id: 'verification',
+      type: 'verification',
+      title: 'Vérification en cours',
+      description: 'Nous vérifions vos informations, veuillez patienter...',
+      isRequired: true,
+      isVisible: true,
+      order: 6,
+    },
+    {
+      id: 'completion',
+      type: 'completion',
+      title: 'Vérification terminée !',
+      description: 'Votre identité a été vérifiée avec succès',
+      isRequired: true,
+      isVisible: true,
+      order: 7,
+    },
+  ],
+  settings: {
+    allowBackNavigation: true,
+    showProgressBar: true,
+    showStepNumbers: true,
+    autoAdvance: false,
+    enableRetry: true,
+    maxRetries: 3,
+  },
+  styling: {
+    primaryColor: '#2196F3',
+    secondaryColor: '#4CAF50',
+    backgroundColor: '#f8f9fa',
+    textColor: '#333',
+    borderRadius: 8,
+  },
+  localization: {
+    language: 'fr',
+    translations: {},
+  },
+};
+
+// Configuration pour KYC rapide (selfie uniquement)
+export const quickKYCConfig: KYCFlowConfig = {
+  id: 'quick_kyc',
+  name: 'Vérification rapide',
+  description: 'Vérification avec selfie uniquement',
+  version: '1.0.0',
+  elements: [
+    {
+      id: 'selfie',
+      type: 'selfie_capture',
+      title: 'Prenez une selfie',
+      description: 'Placez votre visage dans le cercle et regardez la caméra',
+      isRequired: true,
+      isVisible: true,
+      order: 0,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 1,
+        quality: 0.8,
+        flashMode: 'off',
+        cameraType: 'front',
+        allowRetake: true,
+        maxRetakes: 3,
+      },
+    },
+    {
+      id: 'verification',
+      type: 'verification',
+      title: 'Vérification en cours',
+      description: 'Nous vérifions votre identité, veuillez patienter...',
+      isRequired: true,
+      isVisible: true,
+      order: 1,
+    },
+    {
+      id: 'completion',
+      type: 'completion',
+      title: 'Vérification terminée !',
+      description: 'Votre identité a été vérifiée avec succès',
+      isRequired: true,
+      isVisible: true,
+      order: 2,
+    },
+  ],
+  settings: {
+    allowBackNavigation: false,
+    showProgressBar: true,
+    showStepNumbers: true,
+    autoAdvance: true,
+    enableRetry: true,
+    maxRetries: 3,
+  },
+  styling: {
+    primaryColor: '#FF9800',
+    secondaryColor: '#4CAF50',
+    backgroundColor: '#f8f9fa',
+    textColor: '#333',
+    borderRadius: 8,
+  },
+  localization: {
+    language: 'fr',
+    translations: {},
+  },
+};
+
+// Configuration pour KYC professionnel (avec documents multiples)
+export const professionalKYCConfig: KYCFlowConfig = {
+  id: 'professional_kyc',
+  name: 'Vérification professionnelle',
+  description: 'Vérification complète pour professionnels',
+  version: '1.0.0',
+  elements: [
+    {
+      id: 'country_selection',
+      type: 'country_selection',
+      title: 'Quel pays a émis votre document ?',
+      description: 'Cela nous aide à vérifier vos documents rapidement et en toute sécurité',
+      isRequired: true,
+      isVisible: true,
+      order: 0,
+      validation: { required: true },
+    },
+    {
+      id: 'document_type',
+      type: 'document_type_selection',
+      title: 'Quel type de document utilisez-vous ?',
+      description: 'Sélectionnez le type de document que vous allez présenter',
+      isRequired: true,
+      isVisible: true,
+      order: 1,
+      validation: { required: true },
+    },
+    {
+      id: 'document_front',
+      type: 'camera_capture',
+      title: 'Prenez une photo du recto de votre document',
+      description: 'Placez votre document dans le cadre et assurez-vous qu\'il soit bien visible',
+      isRequired: true,
+      isVisible: true,
+      order: 2,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 4/3,
+        quality: 0.9,
+        flashMode: 'auto',
+        cameraType: 'back',
+        allowRetake: true,
+        maxRetakes: 5,
+      },
+    },
+    {
+      id: 'document_back',
+      type: 'camera_capture',
+      title: 'Prenez une photo du verso de votre document',
+      description: 'Placez votre document dans le cadre et assurez-vous qu\'il soit bien visible',
+      isRequired: true,
+      isVisible: true,
+      order: 3,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 4/3,
+        quality: 0.9,
+        flashMode: 'auto',
+        cameraType: 'back',
+        allowRetake: true,
+        maxRetakes: 5,
+      },
+    },
+    {
+      id: 'selfie',
+      type: 'selfie_capture',
+      title: 'Prenez une selfie',
+      description: 'Placez votre visage dans le cercle et regardez la caméra',
+      isRequired: true,
+      isVisible: true,
+      order: 4,
+      validation: { required: true },
+      cameraConfig: {
+        aspectRatio: 1,
+        quality: 0.9,
+        flashMode: 'off',
+        cameraType: 'front',
+        allowRetake: true,
+        maxRetakes: 5,
+      },
+    },
+    {
+      id: 'additional_documents',
+      type: 'file_upload',
+      title: 'Documents professionnels',
+      description: 'Ajoutez vos documents professionnels (justificatif de domicile, certificat de travail, etc.)',
+      isRequired: true,
+      isVisible: true,
+      order: 5,
+      uploadConfig: {
+        allowedTypes: ['image/*', 'application/pdf'],
+        maxFiles: 10,
+        maxFileSize: 20 * 1024 * 1024, // 20MB
+        allowMultiple: true,
+      },
+    },
+    {
+      id: 'verification',
+      type: 'verification',
+      title: 'Vérification en cours',
+      description: 'Nous vérifions vos informations, veuillez patienter...',
+      isRequired: true,
+      isVisible: true,
+      order: 6,
+    },
+    {
+      id: 'completion',
+      type: 'completion',
+      title: 'Vérification terminée !',
+      description: 'Votre identité a été vérifiée avec succès',
+      isRequired: true,
+      isVisible: true,
+      order: 7,
+    },
+  ],
+  settings: {
+    allowBackNavigation: true,
+    showProgressBar: true,
+    showStepNumbers: true,
+    autoAdvance: false,
+    enableRetry: true,
+    maxRetries: 5,
+  },
+  styling: {
+    primaryColor: '#9C27B0',
+    secondaryColor: '#4CAF50',
+    backgroundColor: '#f8f9fa',
+    textColor: '#333',
+    borderRadius: 8,
+  },
+  localization: {
+    language: 'fr',
+    translations: {},
+  },
+};
+
+// Fonction pour créer une configuration personnalisée
+export const createCustomKYCConfig = (
+  id: string,
+  name: string,
+  description: string,
+  elements: any[],
+  settings?: any,
+  styling?: any
+): KYCFlowConfig => {
+  return {
+    id,
+    name,
+    description,
+    version: '1.0.0',
+    elements: elements.sort((a, b) => a.order - b.order),
+    settings: {
+      allowBackNavigation: true,
+      showProgressBar: true,
+      showStepNumbers: true,
+      autoAdvance: false,
+      enableRetry: true,
+      maxRetries: 3,
+      ...settings,
+    },
+    styling: {
+      primaryColor: '#4CAF50',
+      secondaryColor: '#2196F3',
+      backgroundColor: '#f8f9fa',
+      textColor: '#333',
+      borderRadius: 8,
+      ...styling,
+    },
+    localization: {
+      language: 'fr',
+      translations: {},
+    },
+  };
+}; 

package/src/config/allowedDomains.ts

@@ -0,0 +1,133 @@
+/**
+ * Allowed domains configuration for callback URL validation
+ * These domains are permitted to receive KYC completion callbacks
+ */
+
+export interface AllowedDomainConfig {
+  domains: string[];
+  enforceHttps: boolean;
+  allowLocalhost: boolean;
+}
+
+// Default configuration - can be overridden via environment variables
+const DEFAULT_CONFIG: AllowedDomainConfig = {
+  domains: [
+    'transfergratis.com',
+    'www.transfergratis.com',
+    'admin.transfergratis.com',
+    'dashboard.transfergratis.com',
+    'preweb.transfergratis.net',
+    // Add other trusted domains here
+  ],
+  enforceHttps: true,
+  allowLocalhost: true, // Allow localhost for development
+};
+
+/**
+ * Get allowed domains from environment or use defaults
+ */
+export const getAllowedDomainsConfig = (): AllowedDomainConfig => {
+  // Check for environment variable override
+  if (typeof window !== 'undefined' && (window as any).KYC_ALLOWED_DOMAINS) {
+    const envDomains = (window as any).KYC_ALLOWED_DOMAINS;
+    if (Array.isArray(envDomains)) {
+      return {
+        ...DEFAULT_CONFIG,
+        domains: envDomains,
+      };
+    }
+  }
+
+  return DEFAULT_CONFIG;
+};
+
+/**
+ * Check if a domain is in the allowed list
+ */
+export const isDomainAllowed = (domain: string): boolean => {
+  const config = getAllowedDomainsConfig();
+
+  // Allow localhost in development
+  if (config.allowLocalhost && (domain === 'localhost' || domain.startsWith('127.0.0.1'))) {
+    return true;
+  }
+
+  // Check if domain matches any in the allowed list
+  return config.domains.some(allowedDomain => {
+    // Exact match
+    if (domain === allowedDomain) {
+      return true;
+    }
+
+    // Subdomain match (e.g., app.transfergratis.com matches transfergratis.com)
+    if (domain.endsWith('.' + allowedDomain)) {
+      return true;
+    }
+
+    return false;
+  });
+};
+
+/**
+ * Validate if a URL is allowed for callback
+ */
+export const isCallbackUrlAllowed = (url: string): { allowed: boolean; reason?: string } => {
+  try {
+    // Check if valid URL
+    new URL(url);
+    // Allow all URLs for redirection as requested
+    return { allowed: true };
+  } catch (error) {
+    return {
+      allowed: false,
+      reason: 'Invalid URL format',
+    };
+  }
+};
+
+/**
+ * Generate a signature for the callback URL parameters
+ * This can be used to verify the integrity of the callback
+ */
+export const generateCallbackSignature = async (
+  params: Record<string, string>,
+  secret?: string
+): Promise<string> => {
+  // Only generate signature if secret is provided
+  if (!secret) {
+    return '';
+  }
+
+  // Sort params for consistent signature
+  const sortedParams = Object.keys(params)
+    .sort()
+    .map(key => `${key}=${params[key]}`)
+    .join('&');
+
+  const data = `${sortedParams}:${secret}`;
+
+  // Use Web Crypto API for signature generation
+  if (typeof window !== 'undefined' && window.crypto && window.crypto.subtle) {
+    try {
+      const encoder = new TextEncoder();
+      const dataBuffer = encoder.encode(data);
+      const hashBuffer = await window.crypto.subtle.digest('SHA-256', dataBuffer);
+      const hashArray = Array.from(new Uint8Array(hashBuffer));
+      const hashHex = hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
+      return hashHex;
+    } catch (error) {
+      console.error('Error generating signature:', error);
+      return '';
+    }
+  }
+
+  // Fallback: simple hash for environments without Web Crypto API
+  let hash = 0;
+  for (let i = 0; i < data.length; i++) {
+    const char = data.charCodeAt(i);
+    hash = ((hash << 5) - hash) + char;
+    hash = hash & hash;
+  }
+  return Math.abs(hash).toString(16);
+};
+