fbp-language 1.1.3 → 1.1.6

package/README.md

@@ -23,7 +23,7 @@ Puis, dans le `package.json` de ton projet :
     "start": "fbp run lancer"
   },
   "dependencies": {
-    "fbp-language": "^1.1.3"
+    "fbp-language": "^1.1.6"
   }
 }
 ```
@@ -127,3 +127,76 @@ npm test
 ```
 
 Les fichiers d'essai internes se trouvent dans `tests/fixtures`. Ils ne font pas partie du paquet publié.
+
+
+## Informations Discord dynamiques (v1.1.6)
+
+Les champs d'un embed peuvent récupérer les informations accessibles au moment où la commande est utilisée. Exemple :
+
+```fbp
+discordConnexion()
+discordCommandeEmbed("serveur-info", "Informations du serveur", "Données actuelles", "#5865F2")
+discordChampDynamique("serveur-info", "Nom", "discordServeur.nom")
+discordChampDynamique("serveur-info", "Identifiant", "discordServeur.id")
+discordChampDynamique("serveur-info", "Création", "discordServeur.creation")
+discordChampDynamique("serveur-info", "Membres", "discordMembres.nombre")
+discordChampDynamique("serveur-info", "Rôles", "discordRoles.nombre")
+discordChampDynamique("serveur-info", "Salons", "discordSalons.nombre")
+discordChampDynamique("serveur-info", "Latence", "discordLatence")
+discordOptionUtilisateur("serveur-info", "membre", "Membre à afficher")
+discordChampDynamique("serveur-info", "Profil", "discordProfil.nom")
+discordChampDynamique("serveur-info", "Avatar", "discordAvatar")
+```
+
+Sources disponibles : `discordServeur.nom`, `discordServeur.id`, `discordServeur.creation`, `discordMembres.nombre`, `discordProfil.nom`, `discordProfil.id`, `discordProfil.avatar`, `discordRoles.nombre`, `discordSalons.nombre`, `discordStatistiques.membres`, `discordStatistiques.roles`, `discordStatistiques.salons`, `discordLatence` et `discordAvatar`. `discordOptionUtilisateur(nomCommande, nomOption, description)` ajoute un sélecteur facultatif de membre à une commande embed. Les données accessibles dépendent des permissions et du cache Discord du bot.
+
+
+## Options des commandes slash (v1.1.6)
+
+Les commandes slash peuvent maintenant recevoir des options texte, nombre, entier ou booléen. Le dernier argument indique si l'option est obligatoire ; il est facultatif et vaut `false` par défaut.
+
+```fbp
+discordConnexion()
+discordCommande("bonjour", "Salut {{prenom}} !")
+discordOptionTexte("bonjour", "prenom", "Ton prénom", true)
+discordOptionEntier("bonjour", "age", "Ton âge")
+discordOptionNombre("bonjour", "note", "Une valeur décimale")
+discordOptionBooleen("bonjour", "confirme", "Confirmer ?")
+```
+
+Dans une réponse texte, `{{prenom}}` est remplacé par la valeur saisie. Pour les embeds, les champs dynamiques peuvent lire une option avec `discordChampDynamique("commande", "Champ", "option.prenom")` (ou `discordOption.prenom`). Les options absentes ne sont pas remplacées et une option obligatoire inaccessible produit une réponse d'erreur.
+
+Fonctions disponibles :
+
+- `discordOptionTexte(commande, nom, description, obligatoire)`
+- `discordOptionNombre(commande, nom, description, obligatoire)`
+- `discordOptionEntier(commande, nom, description, obligatoire)`
+- `discordOptionBooleen(commande, nom, description, obligatoire)`
+- `discordOptionUtilisateur(commande, nom, description)` pour le sélecteur de membre existant des commandes embed.
+
+Les noms d'options doivent respecter les règles Discord (minuscules, chiffres, tirets et underscores, 1 à 32 caractères). Une commande peut avoir jusqu'à 25 options. Les types d'options sont déclarés lors de l'enregistrement des commandes ; redémarre le bot après avoir modifié leur définition. Le bot a besoin du scope `applications.commands` et de l'accès au serveur concerné. Aucun intent privilégié supplémentaire n'est requis pour ces options.
+
+
+## Choix prédéfinis des options (v1.1.6)
+
+Pour limiter les réponses possibles d'une option, ajoute des choix après avoir déclaré l'option :
+
+```fbp
+discordConnexion()
+discordCommande("couleur", "Couleur choisie : {{couleur}}")
+discordOptionTexte("couleur", "couleur", "Choisis une couleur", true)
+discordChoixTexte("couleur", "couleur", "Bleu", "bleu")
+discordChoixTexte("couleur", "couleur", "Rouge", "rouge")
+
+discordCommande("difficulte", "Niveau choisi : {{niveau}}")
+discordOptionEntier("difficulte", "niveau", "Choisis un niveau", true)
+discordChoixEntier("difficulte", "niveau", "Facile", 1)
+discordChoixEntier("difficulte", "niveau", "Normal", 2)
+discordChoixEntier("difficulte", "niveau", "Difficile", 3)
+```
+
+- `discordChoixTexte(commande, option, nomChoix, valeur)` ajoute un choix à une option texte.
+- `discordChoixEntier(commande, option, nomChoix, valeur)` ajoute un choix à une option entière.
+- Déclare toujours l'option avant ses choix.
+- Une option peut avoir jusqu'à 25 choix. Les noms de choix sont limités à 100 caractères.
+- Les choix sont présentés par Discord sous forme de liste et la valeur choisie est récupérable comme les autres options.

package/dist/cli.js

@@ -8,7 +8,7 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const compiler_1 = require("./compiler");
 const errors_1 = require("./errors");
-const VERSION = "1.1.3";
+const VERSION = "1.1.6";
 function help() {
     console.log(`FBP — French Bot Programming
 

package/dist/compiler.js

@@ -112,6 +112,29 @@ class FbpCompiler {
     constructor(options = {}) {
         this.output = options.onOutput ?? (value => console.log(value));
     }
+    resolveDiscordValue(source, interaction, selectedUser, selectedMember, optionValues) {
+        const guild = interaction.guild;
+        const values = {
+            "discordServeur.nom": guild?.name ?? "Serveur indisponible",
+            "discordServeur.id": guild?.id ?? "Indisponible",
+            "discordServeur.creation": guild ? "<t:" + Math.floor(guild.createdTimestamp / 1000) + ":D>" : "Indisponible",
+            "discordMembres.nombre": guild ? String(guild.memberCount) : "Indisponible",
+            "discordProfil.nom": selectedMember?.displayName ?? selectedUser?.username ?? "Sélectionne un membre",
+            "discordProfil.id": selectedUser?.id ?? "Sélectionne un membre",
+            "discordProfil.avatar": selectedUser?.displayAvatarURL({ size: 256 }) ?? "Sélectionne un membre",
+            "discordRoles.nombre": guild ? String(guild.roles.cache.size) : "Indisponible",
+            "discordSalons.nombre": guild ? String(guild.channels.cache.size) : "Indisponible",
+            "discordStatistiques.membres": guild ? String(guild.memberCount) : "Indisponible",
+            "discordStatistiques.roles": guild ? String(guild.roles.cache.size) : "Indisponible",
+            "discordStatistiques.salons": guild ? String(guild.channels.cache.size) : "Indisponible",
+            "discordLatence": String(Math.max(0, Math.round(interaction.client.ws.ping))) + " ms",
+            "discordAvatar": selectedUser?.displayAvatarURL({ size: 256 }) ?? interaction.user.displayAvatarURL({ size: 256 })
+        };
+        const optionMatch = source.trim().match(/^(?:discordOption|option)\.([a-z0-9_-]{1,32})$/);
+        if (optionMatch)
+            return optionValues.get(optionMatch[1]) ?? "Option indisponible : " + optionMatch[1];
+        return source.trim() in values ? values[source.trim()] : "Source inconnue : " + source.trim();
+    }
     runFile(filePath) {
         const absolute = node_path_1.default.resolve(filePath);
         if (!node_fs_1.default.existsSync(absolute))
@@ -188,10 +211,44 @@ class FbpCompiler {
             this.discordClient = client;
             client.once("ready", async () => {
                 try {
-                    const commands = [...this.discordCommands.entries()].map(([commandName]) => new discord_js_1.SlashCommandBuilder()
-                        .setName(commandName)
-                        .setDescription(`Commande ${commandName} du bot FBP`)
-                        .toJSON());
+                    const commands = [...this.discordCommands.entries()].map(([commandName, response]) => {
+                        const builder = new discord_js_1.SlashCommandBuilder()
+                            .setName(commandName)
+                            .setDescription(`Commande ${commandName} du bot FBP`);
+                        if (response.type === "embed" && response.userOption) {
+                            builder.addUserOption(option => option.setName(response.userOption.name)
+                                .setDescription(response.userOption.description)
+                                .setRequired(false));
+                        }
+                        for (const option of response.options ?? []) {
+                            const add = {
+                                texte: () => builder.addStringOption(item => {
+                                    item.setName(option.name).setDescription(option.description).setRequired(option.required);
+                                    for (const choice of option.choices ?? [])
+                                        if (typeof choice.value === "string")
+                                            item.addChoices({ name: choice.name, value: choice.value });
+                                    return item;
+                                }),
+                                nombre: () => builder.addNumberOption(item => {
+                                    item.setName(option.name).setDescription(option.description).setRequired(option.required);
+                                    for (const choice of option.choices ?? [])
+                                        if (typeof choice.value === "number")
+                                            item.addChoices({ name: choice.name, value: choice.value });
+                                    return item;
+                                }),
+                                entier: () => builder.addIntegerOption(item => {
+                                    item.setName(option.name).setDescription(option.description).setRequired(option.required);
+                                    for (const choice of option.choices ?? [])
+                                        if (typeof choice.value === "number")
+                                            item.addChoices({ name: choice.name, value: choice.value });
+                                    return item;
+                                }),
+                                booleen: () => builder.addBooleanOption(item => item.setName(option.name).setDescription(option.description).setRequired(option.required))
+                            }[option.type];
+                            add();
+                        }
+                        return builder.toJSON();
+                    });
                     const manager = client.application?.commands;
                     if (!manager)
                         throw new Error("L'application Discord n'est pas disponible.");
@@ -217,21 +274,60 @@ class FbpCompiler {
                 if (response === undefined)
                     return;
                 try {
+                    const optionValues = new Map();
+                    for (const option of response.options ?? []) {
+                        let value = null;
+                        if (option.type === "texte")
+                            value = interaction.options.getString(option.name);
+                        else if (option.type === "nombre") {
+                            const number = interaction.options.getNumber(option.name);
+                            value = number === null ? null : String(number);
+                        }
+                        else if (option.type === "entier") {
+                            const number = interaction.options.getInteger(option.name);
+                            value = number === null ? null : String(number);
+                        }
+                        else {
+                            const boolean = interaction.options.getBoolean(option.name);
+                            value = boolean === null ? null : String(boolean);
+                        }
+                        if (value === null && option.required) {
+                            await interaction.reply({ content: "Option obligatoire indisponible : " + option.name, ephemeral: true });
+                            return;
+                        }
+                        if (value !== null)
+                            optionValues.set(option.name, value);
+                    }
                     if (response.type === "text") {
-                        await interaction.reply(response.content);
+                        const content = response.content.replace(/\{\{([a-z0-9_-]{1,32})\}\}/g, (match, name) => optionValues.has(name) ? optionValues.get(name) : match);
+                        await interaction.reply(content);
                     }
                     else {
                         const embed = new discord_js_1.EmbedBuilder()
                             .setTitle(response.title)
                             .setDescription(response.description)
                             .setColor(Number.parseInt(response.color.slice(1), 16));
-                        if (response.fields.length)
-                            embed.addFields(response.fields.map(field => ({ name: field.name, value: field.value, inline: false })));
+                        const guild = interaction.guild;
+                        const selectedUser = response.userOption ? interaction.options.getUser(response.userOption.name) : null;
+                        const selectedMember = selectedUser && guild ? await guild.members.fetch(selectedUser.id).catch(() => null) : null;
+                        if (response.userOption && selectedUser)
+                            optionValues.set(response.userOption.name, selectedMember?.displayName ?? selectedUser.username);
+                        const fields = response.fields.map(field => ({
+                            name: field.name,
+                            value: field.dynamic ? this.resolveDiscordValue(field.value, interaction, selectedUser, selectedMember, optionValues) : field.value.replace(/\{\{([a-z0-9_-]{1,32})\}\}/g, (match, name) => optionValues.get(name) ?? match),
+                            inline: false
+                        }));
+                        if (fields.length)
+                            embed.addFields(fields);
                         await interaction.reply({ embeds: [embed] });
                     }
                 }
                 catch (error) {
+                    const message = "Une erreur est survenue pendant l'exécution de cette commande.";
                     this.output("Erreur Discord : " + (error instanceof Error ? error.message : String(error)));
+                    if (!interaction.replied && !interaction.deferred) {
+                        await interaction.reply({ content: message, ephemeral: true }).catch(() => undefined);
+                    }
                 }
             });
             void client.login(token).catch((error) => this.output("Connexion Discord impossible : " + (error instanceof Error ? error.message : String(error))));
@@ -247,7 +343,7 @@ class FbpCompiler {
             if (!/^[a-z0-9_-]{1,32}$/.test(commandName)) {
                 throw new errors_1.FbpError("Le nom d'une commande slash doit contenir 1 à 32 caractères : lettres minuscules, chiffres, tirets ou underscores.", undefined, line);
             }
-            this.discordCommands.set(commandName, { type: "text", content: values[1] });
+            this.discordCommands.set(commandName, { type: "text", content: values[1], options: [] });
             return;
         }
         if (name === "discordCommandeEmbed") {
@@ -261,7 +357,96 @@ class FbpCompiler {
                 throw new errors_1.FbpError("Le nom d'une commande slash doit contenir 1 à 32 caractères : lettres minuscules, chiffres, tirets ou underscores.", undefined, line);
             if (!/^#[0-9a-fA-F]{6}$/.test(color))
                 throw new errors_1.FbpError("La couleur d'un embed doit être au format hexadécimal, par exemple #5865F2.", undefined, line);
-            this.discordCommands.set(commandName, { type: "embed", title, description, color, fields: [] });
+            this.discordCommands.set(commandName, { type: "embed", title, description, color, fields: [], options: [] });
+            return;
+        }
+        if (name === "discordChampDynamique") {
+            if (values.length !== 3 || values.some(value => typeof value !== "string")) {
+                throw new errors_1.FbpError("Utilisation : discordChampDynamique(nomCommande, nomChamp, source).", undefined, line);
+            }
+            const [commandName, fieldName, source] = values;
+            const command = this.discordCommands.get(commandName);
+            if (!command || command.type !== "embed")
+                throw new errors_1.FbpError("La commande « " + commandName + " » n'est pas un embed déclaré.", undefined, line);
+            if (command.fields.length >= 25)
+                throw new errors_1.FbpError("Un embed Discord ne peut pas contenir plus de 25 champs.", undefined, line);
+            if (!fieldName.trim() || !source.trim() || fieldName.length > 256 || source.length > 1024)
+                throw new errors_1.FbpError("Un champ dynamique doit avoir un nom et une source valides.", undefined, line);
+            command.fields.push({ name: fieldName, value: source, dynamic: true });
+            return;
+        }
+        if (name === "discordChoixTexte" || name === "discordChoixEntier") {
+            if (values.length !== 4 || values.some(value => typeof value !== "string" && typeof value !== "number")) {
+                throw new errors_1.FbpError("Utilisation : discordChoixTexte(nomCommande, nomOption, nomChoix, valeur) ou discordChoixEntier(...).", undefined, line);
+            }
+            const [commandName, optionName, choiceName, choiceValue] = values;
+            if (typeof commandName !== "string" || typeof optionName !== "string" || typeof choiceName !== "string") {
+                throw new errors_1.FbpError("Le nom de la commande, de l'option et du choix doivent être du texte.", undefined, line);
+            }
+            const command = this.discordCommands.get(commandName);
+            if (!command)
+                throw new errors_1.FbpError("La commande « " + commandName + " » n'est pas déclarée.", undefined, line);
+            const option = (command.options ?? []).find(item => item.name === optionName);
+            const expectedType = name === "discordChoixTexte" ? "texte" : "entier";
+            if (!option || option.type !== expectedType)
+                throw new errors_1.FbpError("L'option « " + optionName + " » n'existe pas ou n'a pas le bon type.", undefined, line);
+            if (!choiceName.trim() || choiceName.length > 100)
+                throw new errors_1.FbpError("Le nom d'un choix doit contenir de 1 à 100 caractères.", undefined, line);
+            if (expectedType === "texte" && typeof choiceValue !== "string")
+                throw new errors_1.FbpError("La valeur d'un choix texte doit être du texte.", undefined, line);
+            if (expectedType === "entier" && (typeof choiceValue !== "number" || !Number.isInteger(choiceValue)))
+                throw new errors_1.FbpError("La valeur d'un choix entier doit être un nombre entier.", undefined, line);
+            const choices = option.choices ?? (option.choices = []);
+            if (choices.some(choice => choice.name === choiceName || choice.value === choiceValue))
+                throw new errors_1.FbpError("Ce nom ou cette valeur de choix existe déjà.", undefined, line);
+            if (choices.length >= 25)
+                throw new errors_1.FbpError("Une option Discord ne peut pas contenir plus de 25 choix.", undefined, line);
+            choices.push({ name: choiceName, value: choiceValue });
+            return;
+        }
+        if (name === "discordOptionTexte" || name === "discordOptionNombre" || name === "discordOptionEntier" || name === "discordOptionBooleen") {
+            if (values.length < 3 || values.length > 4 || values.some(value => typeof value !== "string" && typeof value !== "boolean")) {
+                throw new errors_1.FbpError("Utilisation : discordOptionTexte/Nombre/Entier/Booleen(nomCommande, nomOption, description, obligatoire).", undefined, line);
+            }
+            const [commandName, optionName, description] = values;
+            const required = values.length === 4 ? values[3] : false;
+            if (typeof commandName !== "string" || typeof optionName !== "string" || typeof description !== "string" || typeof required !== "boolean") {
+                throw new errors_1.FbpError("Les trois premiers arguments doivent être du texte et le quatrième, facultatif, doit être true ou false.", undefined, line);
+            }
+            const command = this.discordCommands.get(commandName);
+            if (!command)
+                throw new errors_1.FbpError("La commande « " + commandName + " » n'est pas déclarée.", undefined, line);
+            if (!/^[a-z0-9_-]{1,32}$/.test(optionName))
+                throw new errors_1.FbpError("Le nom de l'option doit contenir 1 à 32 caractères minuscules, chiffres, tirets ou underscores.", undefined, line);
+            if (!description.trim() || description.length > 100)
+                throw new errors_1.FbpError("La description de l'option doit contenir 1 à 100 caractères.", undefined, line);
+            const options = command.options ?? (command.options = []);
+            if (options.some(option => option.name === optionName) || (command.type === "embed" && command.userOption?.name === optionName))
+                throw new errors_1.FbpError("L'option « " + optionName + " » existe déjà pour cette commande.", undefined, line);
+            if (options.length + (command.type === "embed" && command.userOption ? 1 : 0) >= 25)
+                throw new errors_1.FbpError("Une commande slash Discord ne peut pas contenir plus de 25 options.", undefined, line);
+            const type = name === "discordOptionTexte" ? "texte" : name === "discordOptionNombre" ? "nombre" : name === "discordOptionEntier" ? "entier" : "booleen";
+            options.push({ name: optionName, description, type, required });
+            return;
+        }
+        if (name === "discordOptionUtilisateur") {
+            if (values.length !== 3 || values.some(value => typeof value !== "string")) {
+                throw new errors_1.FbpError("Utilisation : discordOptionUtilisateur(nomCommande, nomOption, description).", undefined, line);
+            }
+            const [commandName, optionName, description] = values;
+            const command = this.discordCommands.get(commandName);
+            if (!command || command.type !== "embed")
+                throw new errors_1.FbpError("La commande « " + commandName + " » n'est pas un embed déclaré.", undefined, line);
+            if (!/^[a-z0-9_-]{1,32}$/.test(optionName))
+                throw new errors_1.FbpError("Le nom de l'option doit contenir 1 à 32 caractères minuscules, chiffres, tirets ou underscores.", undefined, line);
+            if (!description.trim() || description.length > 100)
+                throw new errors_1.FbpError("La description de l'option doit contenir 1 à 100 caractères.", undefined, line);
+            const options = command.options ?? (command.options = []);
+            if (options.some(option => option.name === optionName) || command.userOption?.name === optionName)
+                throw new errors_1.FbpError("L'option « " + optionName + " » existe déjà pour cette commande.", undefined, line);
+            if (options.length + 1 > 25)
+                throw new errors_1.FbpError("Une commande slash Discord ne peut pas contenir plus de 25 options.", undefined, line);
+            command.userOption = { name: optionName, description };
             return;
         }
         if (name === "discordChamp") {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "fbp-language",
   "displayName": "FBP - French Bot Programming",
-  "description": "Langage FBP avec prise en charge des commandes slash et des embeds Discord.",
-  "version": "1.1.3",
+  "description": "Langage FBP avec options slash Discord, choix prédéfinis et embeds dynamiques.",
+  "version": "1.1.6",
   "type": "commonjs",
   "main": "dist/compiler.js",
   "bin": {