sunuid-sdk 1.0.51 → 1.0.52

package/examples/.htaccess.example

@@ -0,0 +1,187 @@
+# ========================================
+# PROTECTION DES FICHIERS SENSIBLES
+# ========================================
+# Copiez ce fichier vers .htaccess à la racine de votre projet
+
+# Protection des fichiers de configuration sensibles
+<Files ".env">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+<Files "secure-init.php">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+<Files "*.log">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+# Protection des fichiers de développement
+<Files "composer.json">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+<Files "composer.lock">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+<Files "package.json">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+<Files "package-lock.json">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+# Protection des fichiers de documentation
+<Files "README.md">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+<Files "*.md">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+# Protection des fichiers de test
+<Files "phpunit.xml">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+<Files "tests/*">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+# Protection des fichiers de source
+<Files "src/*.php">
+    Order Allow,Deny
+    Deny from all
+</Files>
+
+# Autoriser uniquement les fichiers nécessaires
+<Files "*.html">
+    Order Allow,Deny
+    Allow from all
+</Files>
+
+<Files "*.js">
+    Order Allow,Deny
+    Allow from all
+</Files>
+
+<Files "*.css">
+    Order Allow,Deny
+    Allow from all
+</Files>
+
+<Files "*.png">
+    Order Allow,Deny
+    Allow from all
+</Files>
+
+<Files "*.jpg">
+    Order Allow,Deny
+    Allow from all
+</Files>
+
+<Files "*.svg">
+    Order Allow,Deny
+    Allow from all
+</Files>
+
+# Configuration de sécurité générale
+# Désactiver l'affichage du contenu des répertoires
+Options -Indexes
+
+# Masquer les informations du serveur
+ServerTokens Prod
+ServerSignature Off
+
+# Protection contre les attaques XSS
+<IfModule mod_headers.c>
+    Header always set X-Content-Type-Options nosniff
+    Header always set X-Frame-Options DENY
+    Header always set X-XSS-Protection "1; mode=block"
+    Header always set Referrer-Policy "strict-origin-when-cross-origin"
+</IfModule>
+
+# Protection contre les injections de fichiers
+<FilesMatch "\.(php|php3|php4|php5|phtml|pl|py|jsp|asp|sh|cgi)$">
+    Order Deny,Allow
+    Deny from all
+</FilesMatch>
+
+# Autoriser uniquement les fichiers PHP spécifiques
+<Files "secure-init.php">
+    Order Allow,Deny
+    Allow from all
+</Files>
+
+# Protection contre les accès aux fichiers cachés
+<FilesMatch "^\.">
+    Order Allow,Deny
+    Deny from all
+</FilesMatch>
+
+# Protection contre les accès aux fichiers de sauvegarde
+<FilesMatch "\.(bak|backup|old|tmp|temp)$">
+    Order Allow,Deny
+    Deny from all
+</FilesMatch>
+
+# ========================================
+# CONFIGURATION CORS (si nécessaire)
+# ========================================
+
+# Autoriser les requêtes CORS pour l'API
+<IfModule mod_headers.c>
+    <Files "secure-init.php">
+        Header always set Access-Control-Allow-Origin "*"
+        Header always set Access-Control-Allow-Methods "POST, GET, OPTIONS"
+        Header always set Access-Control-Allow-Headers "Content-Type, Authorization"
+    </Files>
+</IfModule>
+
+# Gestion des requêtes OPTIONS (preflight)
+<IfModule mod_rewrite.c>
+    RewriteEngine On
+    RewriteCond %{REQUEST_METHOD} OPTIONS
+    RewriteRule ^(.*)$ $1 [R=200,L]
+</IfModule>
+
+# ========================================
+# INSTRUCTIONS D'UTILISATION
+# ========================================
+
+# 1. Copiez ce fichier vers .htaccess
+#    cp .htaccess.example .htaccess
+
+# 2. Ajustez les permissions selon vos besoins
+#    - Autorisez l'accès aux fichiers nécessaires
+#    - Protégez les fichiers sensibles
+#    - Configurez CORS si nécessaire
+
+# 3. Testez la configuration
+#    - Vérifiez que les fichiers sensibles sont protégés
+#    - Vérifiez que les fichiers publics sont accessibles
+#    - Testez les requêtes CORS si nécessaire
+
+# ========================================
+# SÉCURITÉ
+# ========================================
+
+# ⚠️ IMPORTANT : Testez toujours la configuration avant la mise en production
+# ⚠️ IMPORTANT : Vérifiez que les fichiers nécessaires sont accessibles
+# ⚠️ IMPORTANT : Surveillez les logs d'erreur après déploiement
+# ⚠️ IMPORTANT : Ajustez les permissions selon votre architecture
+

package/examples/README.md

@@ -0,0 +1,192 @@
+# 🚀 Intégration Minimale SunuID SDK
+
+Exemples de code minimal pour intégrer le SDK SunuID dans votre application.
+
+## 📁 Fichiers disponibles
+
+- **`minimal-integration.html`** - Exemple complet avec interface utilisateur
+- **`minimal-code.js`** - Code JavaScript minimal avec différents exemples
+- **`auto-integration.html`** - **🚀 Initialisation et génération automatique** (Recommandé)
+- **`auto-code.js`** - Code JavaScript pour l'initialisation automatique
+
+## 🎯 Code minimal (3 lignes)
+
+```javascript
+const sunuid = new SunuID({
+    clientId: 'your-client-id',
+    secretId: 'your-secret-id',
+    type: 2
+});
+
+await sunuid.init();
+const result = await sunuid.generateQR('qr-container');
+```
+
+## 🚀 Code automatique (0 ligne de code manuel)
+
+```javascript
+// Initialisation automatique au chargement de la page
+document.addEventListener('DOMContentLoaded', function() {
+    const sunuid = new SunuID(config);
+    sunuid.init().then(() => sunuid.generateQR('qr-container'));
+});
+```
+
+## 📋 Prérequis
+
+### 1. Inclure les scripts
+```html
+<!-- Socket.IO (requis) -->
+<script src="https://cdn.socket.io/4.7.4/socket.io.min.js"></script>
+
+<!-- SunuID SDK -->
+<script src="https://unpkg.com/sunuid-sdk@1.0.34/dist/sunuid-sdk.min.js"></script>
+```
+
+### 2. Conteneur HTML
+```html
+<div id="qr-container">
+    <!-- Le QR code sera affiché ici -->
+</div>
+```
+
+## 🔧 Configuration minimale
+
+```javascript
+const config = {
+    clientId: '1754166754_221A57B46843D755',
+    secretId: '56d40fe70507228b27f2640ae65894177c2fedbf246e2b30978fde1fc43953c5',
+    type: 2, // 1=KYC, 2=AUTH, 3=SIGNATURE
+    autoRefresh: false // Désactivé pour éviter les appels répétitifs
+};
+```
+
+## 📱 Types de services
+
+| Type | Description | Utilisation |
+|------|-------------|-------------|
+| `1` | **KYC** | Vérification d'identité |
+| `2` | **AUTH** | Authentification (défaut) |
+| `3` | **SIGNATURE** | Signature électronique |
+
+## 🚀 Exemples d'utilisation
+
+### Exemple 1 : Intégration automatique (Recommandé)
+```javascript
+// Initialisation automatique au chargement de la page
+document.addEventListener('DOMContentLoaded', function() {
+    const sunuid = new SunuID(config);
+    sunuid.init().then(() => sunuid.generateQR('qr-container'));
+});
+```
+
+### Exemple 2 : Intégration basique
+```javascript
+async function initSunuID() {
+    const sunuid = new SunuID(config);
+    await sunuid.init();
+    return await sunuid.generateQR('qr-container');
+}
+
+// Utilisation
+initSunuID().then(result => console.log('QR généré:', result));
+```
+
+### Exemple 3 : Avec gestion d'événements
+```javascript
+const sunuid = new SunuID({
+    ...config,
+    onSuccess: (data) => console.log('🎉 Succès:', data),
+    onError: (error) => console.error('💥 Erreur:', error),
+    onStatusUpdate: (status) => console.log('📊 Statut:', status)
+});
+```
+
+### Exemple 4 : Avec rafraîchissement automatique
+```javascript
+const sunuid = new SunuID({
+    ...config,
+    autoRefresh: true,
+    refreshInterval: 30000 // 30 secondes
+});
+```
+
+### Exemple 5 : Avec gestion d'erreurs avancée
+```javascript
+async function initWithRetry() {
+    let retryCount = 0;
+    const maxRetries = 3;
+    
+    while (retryCount < maxRetries) {
+        try {
+            const sunuid = new SunuID(config);
+            await sunuid.init();
+            return await sunuid.generateQR('qr-container');
+        } catch (error) {
+            retryCount++;
+            if (retryCount >= maxRetries) throw error;
+            await new Promise(resolve => setTimeout(resolve, 2000));
+        }
+    }
+}
+```
+
+## 🧪 Test rapide
+
+### Test manuel
+1. Ouvrir `minimal-integration.html` dans votre navigateur
+2. Cliquer sur "Initialiser SDK"
+3. Cliquer sur "Générer QR Code"
+4. Vérifier la console pour les logs
+
+### Test automatique (Recommandé)
+1. Ouvrir `auto-integration.html` dans votre navigateur
+2. Le QR code se génère automatiquement
+3. Aucune action manuelle requise
+4. Interface moderne avec animations
+
+## 🔍 Dépannage
+
+### Erreur : "SDK non initialisé"
+```javascript
+// Assurez-vous d'attendre l'initialisation
+await sunuid.init();
+```
+
+### Erreur : "Socket.IO non chargé"
+```html
+<!-- Vérifiez que Socket.IO est inclus avant le SDK -->
+<script src="https://cdn.socket.io/4.7.4/socket.io.min.js"></script>
+<script src="https://unpkg.com/sunuid-sdk@1.0.34/dist/sunuid-sdk.min.js"></script>
+```
+
+### Appels répétitifs à l'API
+```javascript
+// Désactivez le rafraîchissement automatique
+const config = {
+    autoRefresh: false,
+    // ... autres options
+};
+```
+
+## 📊 Résultat attendu
+
+Après une intégration réussie, vous devriez voir :
+- ✅ Un QR code affiché dans le conteneur
+- ✅ Des logs dans la console confirmant la génération
+- ✅ Un objet `result` avec l'URL du QR code
+
+## 🔗 Liens utiles
+
+- **Documentation complète** : [README.md](../README.md)
+- **Changelog** : [CHANGELOG.md](../CHANGELOG.md)
+- **Page de test avancée** : [test-sdk-simple.html](../test-sdk-simple.html)
+
+---
+
+**Intégration en 3 étapes :**
+1. Inclure les scripts
+2. Créer le conteneur HTML
+3. Initialiser et générer le QR code
+
+C'est tout ! 🎉 

package/examples/auto-code.js

@@ -0,0 +1,234 @@
+// ========================================
+// INTÉGRATION AUTOMATIQUE SUNUID SDK
+// ========================================
+
+// 1. INCLUSION DES SCRIPTS (dans le HTML)
+/*
+<script src="https://cdn.socket.io/4.7.4/socket.io.min.js"></script>
+<script src="https://unpkg.com/sunuid-sdk@1.0.34/dist/sunuid-sdk.min.js"></script>
+*/
+
+// 2. CONFIGURATION AUTOMATIQUE
+const autoConfig = {
+    clientId: '1754166754_221A57B46843D755',
+    secretId: '56d40fe70507228b27f2640ae65894177c2fedbf246e2b30978fde1fc43953c5',
+    type: 2, // 1=KYC, 2=AUTH, 3=SIGNATURE
+    autoRefresh: false, // Désactivé pour éviter les appels répétitifs
+    // Callbacks automatiques
+    onSuccess: (data) => console.log('🎉 Succès:', data),
+    onError: (error) => console.error('💥 Erreur:', error),
+    onStatusUpdate: (status) => console.log('📊 Statut:', status)
+};
+
+// 3. CODE D'INITIALISATION AUTOMATIQUE
+async function initAutoSunuID() {
+    try {
+        console.log('🚀 Initialisation automatique...');
+        
+        // Créer l'instance SDK
+        const sunuid = new SunuID(autoConfig);
+        
+        // Initialiser automatiquement
+        await sunuid.init();
+        
+        // Générer le QR code automatiquement
+        const result = await sunuid.generateQR('qr-container');
+        
+        console.log('✅ QR Code généré automatiquement:', result);
+        return result;
+        
+    } catch (error) {
+        console.error('❌ Erreur d\'initialisation automatique:', error);
+        throw error;
+    }
+}
+
+// 4. INITIALISATION AUTOMATIQUE AU CHARGEMENT
+document.addEventListener('DOMContentLoaded', function() {
+    console.log('🚀 Démarrage automatique...');
+    
+    // Attendre que tout soit chargé
+    setTimeout(() => {
+        initAutoSunuID().catch(error => {
+            console.error('❌ Échec de l\'initialisation automatique:', error);
+        });
+    }, 500);
+});
+
+// ========================================
+// VERSION AVEC GESTION D'ÉTAT
+// ========================================
+
+let sunuidInstance = null;
+
+async function initAutoSunuIDWithState() {
+    if (sunuidInstance) {
+        console.log('SDK déjà initialisé');
+        return sunuidInstance;
+    }
+    
+    try {
+        sunuidInstance = new SunuID(autoConfig);
+        await sunuidInstance.init();
+        
+        const result = await sunuidInstance.generateQR('qr-container');
+        console.log('✅ QR Code généré:', result);
+        
+        return sunuidInstance;
+        
+    } catch (error) {
+        sunuidInstance = null;
+        throw error;
+    }
+}
+
+// ========================================
+// VERSION AVEC ÉVÉNEMENTS WEBSOCKET
+// ========================================
+
+async function initAutoSunuIDWithEvents() {
+    const sunuid = new SunuID({
+        ...autoConfig,
+        onSuccess: (data) => {
+            console.log('🎉 Authentification réussie:', data);
+            // Rediriger ou afficher un message de succès
+        },
+        onError: (error) => {
+            console.error('💥 Erreur d\'authentification:', error);
+            // Afficher un message d'erreur
+        }
+    });
+    
+    await sunuid.init();
+    const result = await sunuid.generateQR('qr-container');
+    
+    // Écouter les événements WebSocket
+    if (sunuid.socket) {
+        sunuid.socket.on('qr_scanned', (data) => {
+            console.log('📱 QR code scanné:', data);
+        });
+        
+        sunuid.socket.on('auth_success', (data) => {
+            console.log('🎉 Authentification réussie:', data);
+        });
+        
+        sunuid.socket.on('auth_error', (data) => {
+            console.error('❌ Erreur d\'authentification:', data);
+        });
+    }
+    
+    return result;
+}
+
+// ========================================
+// VERSION AVEC RAFRAÎCHISSEMENT AUTOMATIQUE
+// ========================================
+
+async function initAutoSunuIDWithRefresh() {
+    const sunuid = new SunuID({
+        ...autoConfig,
+        autoRefresh: true, // Activer le rafraîchissement
+        refreshInterval: 30000 // 30 secondes
+    });
+    
+    await sunuid.init();
+    const result = await sunuid.generateQR('qr-container');
+    
+    // Arrêter le rafraîchissement après 2 minutes
+    setTimeout(() => {
+        sunuid.stopAutoRefresh();
+        console.log('🔄 Rafraîchissement arrêté');
+    }, 120000);
+    
+    return result;
+}
+
+// ========================================
+// VERSION AVEC GESTION D'ERREURS AVANCÉE
+// ========================================
+
+async function initAutoSunuIDWithErrorHandling() {
+    let retryCount = 0;
+    const maxRetries = 3;
+    
+    while (retryCount < maxRetries) {
+        try {
+            console.log(`🔄 Tentative ${retryCount + 1}/${maxRetries}`);
+            
+            const sunuid = new SunuID(autoConfig);
+            await sunuid.init();
+            const result = await sunuid.generateQR('qr-container');
+            
+            console.log('✅ QR Code généré avec succès');
+            return result;
+            
+        } catch (error) {
+            retryCount++;
+            console.error(`❌ Tentative ${retryCount} échouée:`, error.message);
+            
+            if (retryCount >= maxRetries) {
+                console.error('❌ Nombre maximum de tentatives atteint');
+                throw new Error('Impossible d\'initialiser le SDK après plusieurs tentatives');
+            }
+            
+            // Attendre avant de réessayer
+            await new Promise(resolve => setTimeout(resolve, 2000 * retryCount));
+        }
+    }
+}
+
+// ========================================
+// VERSION AVEC DIFFÉRENTS TYPES
+// ========================================
+
+// Authentification automatique
+async function initAuthAuto() {
+    const config = { ...autoConfig, type: 2 };
+    const sunuid = new SunuID(config);
+    await sunuid.init();
+    return await sunuid.generateQR('qr-container');
+}
+
+// KYC automatique
+async function initKYCAuto() {
+    const config = { ...autoConfig, type: 1 };
+    const sunuid = new SunuID(config);
+    await sunuid.init();
+    return await sunuid.generateQR('qr-container');
+}
+
+// Signature automatique
+async function initSignatureAuto() {
+    const config = { ...autoConfig, type: 3 };
+    const sunuid = new SunuID(config);
+    await sunuid.init();
+    return await sunuid.generateQR('qr-container');
+}
+
+// ========================================
+// HTML MINIMAL REQUIS
+// ========================================
+
+/*
+<div id="qr-container">
+    <!-- Le QR code sera affiché ici automatiquement -->
+</div>
+*/
+
+// ========================================
+// EXPORT POUR UTILISATION MODULE
+// ========================================
+
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports = {
+        initAutoSunuID,
+        initAutoSunuIDWithState,
+        initAutoSunuIDWithEvents,
+        initAutoSunuIDWithRefresh,
+        initAutoSunuIDWithErrorHandling,
+        initAuthAuto,
+        initKYCAuto,
+        initSignatureAuto,
+        autoConfig
+    };
+}