🛰️ LatencyHub Agent

LatencyHub Agent est le pont officiel entre vos bots Discord et l'application mobile LatencyHub. Surveillez vos performances et pilotez vos instances à distance avec une sécurité de niveau industriel.

✨ Caractéristiques

• 📈 Monitoring Temps Réel : CPU, RAM et Uptime mis à jour chaque seconde.
• 🎮 Commandes Distantes : Redémarrez, stoppez ou rechargez vos commandes depuis votre téléphone.
• 🛠️ Actions Personnalisées : Liez n'importe quelle fonction de votre bot à un bouton de l'app.
• 🔒 Sécurité Native : Protection par clé API unique, CORS filtré et headers de sécurité (Helmet).
• 🚀 Ultra-léger : Empreinte mémoire minimale, aucune surcharge sur l'Event Loop.

⚙️ Installation

npm install latencyhub-agent

🚀 Démarrage Rapide

1. Initialisation

Ajoutez ces quelques lignes dans votre fichier principal (ex: index.js) :

const LatencyHub = require('latencyhub-agent');

const agent = new LatencyHub({
    apiKey: "VOTRE_TOKEN_LATENCYHUB", // Disponible dans les réglages de l'app mobile
    botName: "MonBotDiscord",
    avatar: "https://lien-vers-mon-avatar.com/img.png", // Optionnel
    port: 4000
});

agent.start();

2. Configurer des actions personnalisées

Vous pouvez définir ce que font les boutons de l'application mobile :

// Exemple : Recharger les commandes sans redémarrer
agent.onAction('RELOAD_CMDS', async () => {
    console.log("🔄 Rechargement des commandes Slash...");
    await client.commands.load(); 
});

// Exemple : Nettoyer le cache
agent.onAction('CLEAR_CACHE', () => {
    client.guilds.cache.clear();
});

🕹️ Commandes Supportées

L'agent gère nativement les IDs d'actions suivants envoyés par l'application :

| Action ID | Description | | --- | --- | | RESTART | Arrête le processus (exit 0) pour laisser PM2/Docker le relancer. | | STOP | Arrêt définitif de l'instance. | | RELOAD_CMDS | Déclenche votre logique de rechargement de commandes. | | CLEAR_CACHE | Déclenche votre logique de nettoyage mémoire. | | MAINTENANCE | Bascule votre bot en mode maintenance. | | GET_LOGS | (Bientôt) Récupère les dernières lignes de console. |

🛡️ Sécurité (Zero Trust)

La sécurité est notre priorité. L'agent implémente plusieurs couches de protection :

1. Validation de Clé : Chaque requête doit contenir un header x-latencyhub-key valide.
2. CORS : Seules les requêtes autorisées sont acceptées.
3. Protection Headers : Utilisation de helmet pour prévenir les vulnérabilités HTTP classiques.
4. Isolations des processus : L'agent n'a accès qu'aux métriques de son propre processus (PID).

📊 API de Monitoring

Si vous souhaitez interroger l'agent manuellement (via Curl ou Postman) :

GET /status Headers : x-latencyhub-key: VOTRE_CLE

Réponse :

{
  "botName": "MonBot",
  "status": "Online",
  "metrics": {
    "cpu": "1.2%",
    "ram": "45MB",
    "uptime": "3600s"
  }
}

📄 Licence

Ce projet est sous licence MIT. Vous êtes libre de l'utiliser, de le modifier et de le distribuer.

Développé avec ❤️ pour la communauté Discord par Vaurti.