⚡ BSJS — moteur JS

Introduction

moteur JS est le API JavaScript de BotStrike. Le chat_id est automatique :

• Chaque commande dans un fichier .js séparé (start.js, help.js…)
• Zéro import / require — Bot, Api, Props sont injectés globalement
• Bot.sendMessage(text) envoie auto au chat actuel (pas besoin de passer chat_id)

Structure des fichiers

Chaque commande est un fichier .js dans le dossier commands/. Le API moteur JS charge automatiquement tous les fichiers.

Variables globales (dans chaque .js)

Contenu de user :

Envoi de messages

Bot.sendMessage(text)

Envoie un message texte au chat actuel (chat_id automatique). Formatage HTML activé.

Copier// start.js — Commande /start
Bot.sendMessage("Bienvenue <b>" + user.nom + "</b> ! 👋");

Suppression automatique (delete_after)

Passez un objet en second paramètre avec delete_after pour supprimer le message après N secondes :

Copier// Le message disparaît après 5 secondes
Bot.sendMessage("Ce message va disparaître... 👻", { delete_after: 5 });

Options d'envoi

Toutes les méthodes d'envoi acceptent un objet d'options :

Copier// Exemple combiné
Bot.sendMessage("📌 Annonce", { pin: true, silent: true });

Bot.sendButtons(text, buttons)

Envoie un clavier inline. Format des boutons : title + command (callback), data, ou url.

CopierBot.sendButtons("Choisissez une option :", [
  { title: "📦 Catalogue", command: "/catalogue" },
  { title: "📞 Contact", data: "contact" },
  { title: "🔗 Site web", url: "https://exemple.com" },
]);

Bot.sendMenu(text, options)

Envoie un reply keyboard (menu persistant en bas de l'écran).

CopierBot.sendMenu("Menu principal :", [
  ["📊 Stats", "⚙️ Paramètres"],
  ["❓ Aide"]
]);

Photos, Vidéos, Documents

CopierBot.sendPhoto("https://exemple.com/produit.jpg", "<b>Notre produit</b>");

Actions

Bot.action({ type, wait })

Affiche un indicateur (typing…) et attend X secondes.

Copier// Afficher "en train d'écrire…" pendant 2 secondes
Bot.action({ type: "typing", wait: 2 });

Bot.run({ command, run_after, options }) — runCommand

Exécute une autre commande, immédiatement ou après un délai. C'est l'équivalent de runCommand dans BotStrike.

Copier// Exécuter /balance après 1 heure
Bot.run({
  command: "/balance",
  run_after: 60 * 60,  // 3600 sec
  options: { amount: 5 }
});

Copier// Dans balance.js — récupérer les options passées
Bot.sendMessage("Montant : " + options.amount);

Stockage (Props)

Stockez des données persistantes par bot. Limite a quelque capaciter .

Copier// Enregistrer le solde d'un utilisateur
Props.set("balance_" + user.id, 100);

// Le récupérer
let balance = Props.get("balance_" + user.id);
Bot.sendMessage("💰 Solde : " + balance);

// Vérifier l'espace
let info = Props.storage();
Bot.sendMessage("Utilisé : " + info.used + " KB / restant : " + info.remaining + " KB");

Commandes

Chaque commande est un fichier .js dans le dossier commands/. Le nom du fichier = le nom de la commande.

Commande Master (*)

Le fichier _.js (underscore) capture tous les messages qui ne correspondent à aucune commande.

Copier// _.js — commande master (capture tout)
Bot.sendMessage("Vous avez dit : " + message);

Callbacks (boutons inline)

Quand un utilisateur clique sur un bouton inline avec command ou data, le callback correspondant est déclenché.

Copier// Enregistrer un callback
Bot.registerCallback("catalogue", maFonction);

Api — Appels Telegram directs

L'objet Api est un Proxy ES6 qui permet d'appeler n'importe quelle méthode de l'API Telegram directement.

Copier// Envoyer un message avec options avancées
Api.sendMessage({
  chat_id: chat_id,
  text: "<b>Message formaté</b>",
  parse_mode: "HTML",
  disable_notification: true
});

Api.sendPhoto

Copier// Envoyer une photo avec légende
Api.sendPhoto({
  chat_id: chat_id,
  photo: "https://exemple.com/img.jpg",
  caption: "<b>Légende en HTML</b>",
  parse_mode: "HTML"
});

Api.sendVideo

Copier// Envoyer une vidéo
Api.sendVideo({
  chat_id: chat_id,
  video: "https://exemple.com/video.mp4",
  caption: "Ma vidéo",
  parse_mode: "HTML"
});

Api.sendDocument

Copier// Envoyer un document / fichier
Api.sendDocument({
  chat_id: chat_id,
  document: "https://exemple.com/fichier.pdf",
  caption: "Votre fichier 📎",
  parse_mode: "HTML"
});

Api.editMessageText

Copier// Modifier un message existant
Api.editMessageText({
  chat_id: chat_id,
  message_id: user.message_id,
  text: "Texte mis à jour ✅"
});

Api.deleteMessage

Copier// Supprimer un message
Api.deleteMessage({
  chat_id: chat_id,
  message_id: user.message_id
});