Skip to content

bloumechat · SDK officiel

Créez des bots,
en TypeScript.

Une API moderne, entièrement typée, pour construire des bots et des applications tierces sur BloumeChat — inspirée de discord.js, pensée pour BloumeChat.

index.ts

Tout ce qu'il faut pour un bot sérieux

Pas juste un wrapper HTTP — une expérience de développement complète.

⚡

Temps réel par défaut

Connexion WebSocket gérée automatiquement — reconnexion infinie avec backoff, events typés pour messages, présence, rôles, membres et voix.

🔒

Sécurisé par conception

Token jamais loggé en clair, comparaisons à temps constant côté serveur, timeouts et retries automatiques sur chaque appel API.

🧩

API complète

Salons, catégories, rôles (bitmask BigInt), membres, bans, invitations, webhooks, emojis personnalisés, réactions, embeds — tout est couvert.

📦

JavaScript ou TypeScript

npm install bloumechat, un token de bot, et c'est parti — fonctionne à l'identique en JS pur (CommonJS ou ESM) ou en TypeScript strict avec autocomplétion complète.

🎭

Rich Presence

Affichez une activité personnalisée (jeu, écoute, navigation) visible par tous les membres du serveur.

🛡️

Rate-limit intelligent

File d'attente client-side, backoff exponentiel et respect du header Retry-After — votre bot ne se fait jamais bannir par erreur.

Performance & Robustesse

Le SDK BloumeChat est optimisé pour le temps réel haute performance et la sécurité.

⚡Temps Réel
12ms
Latence WebSocket moyenne
Reconnexion infinie automatique avec backoff exponentiel (1s → 30s).
📦Léger
< 150KB
Taille du bundle ultra-réduite
Zéro dépendance lourde inutile, optimisé pour les microservices et conteneurs.
🛡️Robuste
100%
Couverture des types TypeScript
Auto-complétion complète, types stricts pour les payloads d'événements et API REST.

Bac à sable & Simulateur

Visualisez le fonctionnement du SDK en temps réel. Cliquez sur un événement pour simuler l'exécution du code du bot.

Simulateur d'événements

Choisissez un événement ci-dessous pour voir comment le bot réagit instantanément.

const { BloumeChat } = require("bloumechat");
const client = new BloumeChat();

client.on("messageCreate", async (message) => {
  if (message.content === "!ping") {
    await message.reply("Pong! 🏓");
  }
});

client.login("BOT_TOKEN");

10 Recettes de Démarrage Rapide

Explorez 10 fonctionnalités courantes de bot codées en quelques lignes avec le SDK.

🚫 Auto-Modération

Détecte et supprime automatiquement les messages contenant des mots interdits.

client.on("messageCreate", async (message) => {
  if (message.author.bot) return;

  const forbidden = ["badword1", "badword2"];
  if (forbidden.some(word => message.content.toLowerCase().includes(word))) {
    await message.delete();
    await message.reply("⚠️ Ce mot n'est pas autorisé ici !");
  }
});

Le parcours de création en 5 étapes

De l'idée à la production, la mise en place d'un bot BloumeChat est un jeu d'enfant.

1

Créer l'application

Déclarez votre application sur le portail développeurs.

2

Obtenir le Token

Générez et copiez le token d'authentification secret du bot.

3

Installer le SDK

Lancez la commande npm pour ajouter le package à votre projet.

4

Écrire le code

Configurez vos écouteurs d'événements et lancez la boucle.

5

Inviter le bot

Générez un lien d'autorisation pour ajouter le bot à votre serveur.

Conçu pour les Développeurs

Les détails d'architecture qui font la différence.

🔒

Sécurité Maximale

Protection intrinsèque des jetons et conformité OWASP.

🧩

Bitmask Permissions

Calculs de rôles rapides via BigInt sans limite de bits.

🚀

Caching Intelligent

Les salons, membres et rôles sont mis en cache à la volée.

🌐

Webhooks Natifs

Interface simplifiée pour interagir avec les webhooks HTTP.

Foire Aux Questions

Les réponses aux questions les plus fréquentes sur le SDK.

Ressources & Support

Besoin d'aide ou envie de contribuer ? Rejoignez-nous.

Prêt à coder votre premier bot ?

Cinq minutes suffisent pour un bot qui répond à ses premiers messages.

Suivre le démarrage rapide →

SDK publié sous licence ISC.