@spatulox/simplediscordbot 1.0.1 → 1.0.3

package/dist/manager/handlers/interactions/BaseInteractionManager.js

@@ -0,0 +1,338 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseInteractionManager = exports.CommandType = void 0;
+const rest_1 = require("@discordjs/rest");
+const v10_1 = require("discord-api-types/v10");
+const discord_js_1 = require("discord.js");
+const fs = __importStar(require("fs/promises"));
+const FileManager_1 = require("../../FileManager");
+const Log_1 = require("../../../utils/Log");
+var CommandType;
+(function (CommandType) {
+    CommandType[CommandType["SLASH"] = 1] = "SLASH";
+    CommandType[CommandType["USER_CONTEXT_MENU"] = 2] = "USER_CONTEXT_MENU";
+    CommandType[CommandType["MESSAGE_CONTEXT_MENU"] = 3] = "MESSAGE_CONTEXT_MENU";
+})(CommandType || (exports.CommandType = CommandType = {}));
+class BaseInteractionManager {
+    constructor(clientId, token) {
+        this.clientId = clientId;
+        this.token = token;
+        this.rest = new rest_1.REST({ version: '10' }).setToken(token);
+    }
+    async listFromFile() {
+        console.log(`Listing Handlers (${this.folderPath}) not deployed on discord`);
+        try {
+            const files = await FileManager_1.FileManager.listJsonFiles(`./handlers/${this.folderPath}`);
+            if (!files || files.length === 0) {
+                console.log('No files found');
+                return [];
+            }
+            const commandList = [];
+            for (const [index, file] of files.entries()) {
+                const cmd = await this.readInteraction(`./handlers/${this.folderPath}/${file}`);
+                if (!cmd || cmd.id)
+                    continue;
+                const commandWithIndex = {
+                    ...cmd,
+                    index: index,
+                    filename: file
+                };
+                commandList.push(commandWithIndex);
+            }
+            console.log(`✅ ${commandList.length} local ${this.folderPath}(s) not deployed\n`);
+            console.table(commandList.map((cmd) => ({
+                '#': cmd.index,
+                Nom: cmd.name,
+                Type: cmd.type === CommandType.SLASH ? 'Slash' :
+                    cmd.type === CommandType.USER_CONTEXT_MENU ? 'User' : 'Message',
+                Description: cmd.description,
+                Fichier: cmd.filename
+            })));
+            return commandList;
+        }
+        catch (error) {
+            Log_1.Log.error(`${error.message}`);
+            return [];
+        }
+    }
+    async fetchCommands(endpoint, scope, guildId, printResult = true) {
+        const scopeLabel = scope === 'global' ? 'global' : `guild ${scope}`;
+        console.log(`Handlers ${this.folderPath} on Discord (${scopeLabel})...`);
+        try {
+            const rawCmds = await this.rest.get(endpoint);
+            const commands = rawCmds.filter(cmd => this.commandType.includes(cmd.type));
+            const commandList = commands.map((cmd, index) => ({
+                index: index,
+                name: cmd.name,
+                type: cmd.type,
+                description: cmd.description || 'N/A',
+                default_member_permissions: cmd.default_member_permissions,
+                default_member_permissions_string: this.bitfieldToPermissions(cmd.default_member_permissions),
+                id: cmd.id,
+                ...(guildId && { guildID: [guildId] })
+            }));
+            if (printResult) {
+                console.log(`✅ ${commandList.length} ${this.folderPath}(s) found\n`);
+                console.table(commandList.map((cmd) => ({
+                    Nom: cmd.name,
+                    Type: cmd.type === CommandType.SLASH ? 'Slash' :
+                        cmd.type === CommandType.USER_CONTEXT_MENU ? 'User Context Menu' : 'Message Context Menu',
+                    Description: cmd.description,
+                    Permissions: cmd.default_member_permissions_string?.join(", "),
+                    ID: cmd.id
+                })));
+            }
+            return commandList;
+        }
+        catch (error) {
+            const errorMsg = scope === 'global'
+                ? `❌ Error: ${error.message}`
+                : `❌ Guild error ${scope}: ${error.message}`;
+            Log_1.Log.error(errorMsg);
+            return [];
+        }
+    }
+    async list() {
+        return this.fetchCommands(v10_1.Routes.applicationCommands(this.clientId), 'global');
+    }
+    async listGuild(guildID) {
+        return this.fetchCommands(v10_1.Routes.applicationGuildCommands(this.clientId, guildID), guildID, guildID);
+    }
+    async listAllGuilds(guilds) {
+        console.log("📡 Getting all guilds...\n");
+        console.log(`📋 ${guilds.length} guild(s) found\n`);
+        if (!guilds.length)
+            return [];
+        const guildCommandPromises = guilds.map(async (guild) => {
+            try {
+                const commands = await this.fetchCommands(v10_1.Routes.applicationGuildCommands(this.clientId, guild.id), guild.id, guild.id, false);
+                return {
+                    guild: `${guild.name} (${guild.id})`,
+                    guildId: guild.id,
+                    commands,
+                    count: commands.length
+                };
+            }
+            catch (error) {
+                console.error(`⚠️ Guild ${guild.id}: ${error.message}`);
+                return {
+                    guild: `${guild.name} (${guild.id})`,
+                    guildId: guild.id,
+                    commands: [],
+                    count: 0
+                };
+            }
+        });
+        const results = await Promise.all(guildCommandPromises);
+        console.log("\n📊 INTERACTION PER GUILD :\n");
+        console.table(results.map(r => ({
+            "Guild": r.guild,
+            "Interactions": r.count,
+            "Total": r.commands.length
+        })));
+        return results.filter(r => r.count > 0);
+    }
+    async deploy(commands) {
+        console.log(`Deploying ${commands.length} ${this.folderPath}(s)...`);
+        let updatedCount = 0;
+        for (const cmd of commands) {
+            const file = cmd.filename;
+            if (!file) {
+                Log_1.Log.error(`${cmd.name}: Not linked to a file (wtf)`);
+                continue;
+            }
+            try {
+                await this.deploySingleInteraction(cmd, file);
+                updatedCount++;
+            }
+            catch (error) {
+                Log_1.Log.error(`Error ${file}: ${error.message}`);
+            }
+        }
+        console.log(`✅ ${updatedCount}/${commands.length} deployed`);
+    }
+    async delete(commands) {
+        console.log(`Deleting ${commands.length} ${this.folderPath}(s)...`);
+        const IDList = [];
+        for (const cmd of commands) {
+            if (!cmd.id) {
+                Log_1.Log.error(`${cmd.name}: No Discord ID, cannot delete the ${this.folderPath}`);
+                continue;
+            }
+            IDList.push(cmd.id);
+            try {
+                await this.rest.delete(v10_1.Routes.applicationCommand(this.clientId, cmd.id));
+                console.log(`${cmd.name} (${cmd.id.slice(-8)}) deleted`);
+            }
+            catch (error) {
+                Log_1.Log.error(`${cmd.name} (${cmd.id.slice(-8)}): ${error.message}`);
+            }
+        }
+        await this.removeLocalIdFromFile(IDList);
+    }
+    async update(commands) {
+        console.log(`Updating ${commands.length} ${this.folderPath}(s)...`);
+        for (const cmd of commands) {
+            if (!cmd.id) {
+                Log_1.Log.error(`${cmd.name}: No Discord ID, cannot update the ${this.folderPath}`);
+                continue;
+            }
+            try {
+                await this.rest.patch(v10_1.Routes.applicationCommand(this.clientId, cmd.id), {
+                    body: { description: `${cmd.description} (Updated ${new Date().toISOString()})` }
+                });
+                console.log(`${cmd.name} updated`);
+            }
+            catch (error) {
+                Log_1.Log.error(`${cmd.name}: ${error.message}`);
+            }
+        }
+    }
+    async deploySingleInteraction(cmd, file) {
+        const deployToGuilds = cmd.guildID?.length ? cmd.guildID : [];
+        const dataToSend = { ...cmd };
+        delete dataToSend.guildID;
+        if (cmd.default_member_permissions_string && Array.isArray(cmd.default_member_permissions_string)) {
+            const bitfield = this.permissionsToBitfield(cmd.default_member_permissions_string);
+            if (bitfield !== undefined) {
+                dataToSend.default_member_permissions = bitfield;
+                cmd.default_member_permissions = bitfield;
+            }
+            else {
+                delete dataToSend.default_member_permissions;
+            }
+        }
+        if (cmd.type === CommandType.MESSAGE_CONTEXT_MENU || cmd.type === CommandType.USER_CONTEXT_MENU) {
+            delete dataToSend.options;
+        }
+        // Guild deployment
+        if (deployToGuilds.length > 0) {
+            for (const guildId of deployToGuilds) {
+                try {
+                    const guildCmds = await this.rest.get(v10_1.Routes.applicationGuildCommands(this.clientId, guildId));
+                    const found = guildCmds.find((c) => c.name === cmd.name);
+                    if (!cmd.id || !found) {
+                        const resp = await this.rest.post(v10_1.Routes.applicationGuildCommands(this.clientId, guildId), { body: dataToSend });
+                        cmd.id = resp.id;
+                        await this.saveInteraction(file, cmd);
+                    }
+                    else {
+                        await this.rest.patch(v10_1.Routes.applicationGuildCommand(this.clientId, guildId, found.id), { body: dataToSend });
+                    }
+                }
+                catch (error) {
+                    console.error(`⚠️  Guild ${guildId}: ${error.message}`);
+                }
+            }
+        }
+        else {
+            // Global deployment
+            try {
+                const globalCmds = await this.rest.get(v10_1.Routes.applicationCommands(this.clientId));
+                const found = globalCmds.find((c) => c.name === cmd.name);
+                if (!cmd.id || !found) {
+                    const resp = await this.rest.post(v10_1.Routes.applicationCommands(this.clientId), { body: dataToSend });
+                    cmd.id = resp.id;
+                    await this.saveInteraction(file, cmd);
+                }
+                else {
+                    await this.rest.patch(v10_1.Routes.applicationCommand(this.clientId, found.id), { body: dataToSend });
+                }
+            }
+            catch (error) {
+                console.error(`⚠️  Global: ${error.message}`);
+            }
+        }
+    }
+    async readInteraction(filePath) {
+        try {
+            const data = await fs.readFile(filePath, 'utf8');
+            return JSON.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    async saveInteraction(fileName, cmd) {
+        delete cmd.filename;
+        const filePath = `./handlers/${this.folderPath}/${fileName}`;
+        await fs.writeFile(filePath, JSON.stringify(cmd, null, 2));
+    }
+    async removeLocalIdFromFile(idListToDelete) {
+        const files = await FileManager_1.FileManager.listJsonFiles(`./handlers/${this.folderPath}`);
+        if (!files || files.length === 0) {
+            console.log('No local files to clean');
+            return;
+        }
+        for (const file of files) {
+            const filePath = `./handlers/${this.folderPath}/${file}`;
+            const localCmd = await this.readInteraction(filePath);
+            if (localCmd && localCmd.id && idListToDelete.includes(localCmd.id)) {
+                delete localCmd.id;
+                await this.saveInteraction(file, localCmd);
+                break;
+            }
+        }
+    }
+    permissionsToBitfield(perms) {
+        if (!perms || perms.length === 0)
+            return undefined;
+        let bits = 0n;
+        for (const name of perms) {
+            const value = discord_js_1.PermissionFlagsBits[name];
+            if (!value) {
+                console.warn(`Unknow permission in default_member_permissions: ${name}`);
+                continue;
+            }
+            bits |= value;
+        }
+        return bits.toString();
+    }
+    bitfieldToPermissions(bitfield) {
+        if (!bitfield)
+            return [];
+        const bits = BigInt(bitfield);
+        const result = [];
+        for (const [name, value] of Object.entries(discord_js_1.PermissionFlagsBits)) {
+            if ((bits & value) === value) {
+                result.push(name);
+            }
+        }
+        return result;
+    }
+}
+exports.BaseInteractionManager = BaseInteractionManager;

package/dist/manager/handlers/interactions/InteractionManager.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AllInteractionManager = exports.ContextMenuManager = exports.CommandManager = void 0;
+const BaseInteractionManager_1 = require("./BaseInteractionManager");
+const FolderName_1 = require("../../../type/FolderName");
+class CommandManager extends BaseInteractionManager_1.BaseInteractionManager {
+    constructor() {
+        super(...arguments);
+        this.commandType = [BaseInteractionManager_1.CommandType.SLASH];
+        this.folderPath = FolderName_1.FolderName.SLASH_COMMANDS;
+    }
+}
+exports.CommandManager = CommandManager;
+class ContextMenuManager extends BaseInteractionManager_1.BaseInteractionManager {
+    constructor() {
+        super(...arguments);
+        this.commandType = [BaseInteractionManager_1.CommandType.USER_CONTEXT_MENU, BaseInteractionManager_1.CommandType.MESSAGE_CONTEXT_MENU];
+        this.folderPath = FolderName_1.FolderName.CONTEXT_MENU;
+    }
+}
+exports.ContextMenuManager = ContextMenuManager;
+class AllInteractionManager extends BaseInteractionManager_1.BaseInteractionManager {
+    constructor() {
+        super(...arguments);
+        this.commandType = [BaseInteractionManager_1.CommandType.SLASH, BaseInteractionManager_1.CommandType.USER_CONTEXT_MENU, BaseInteractionManager_1.CommandType.MESSAGE_CONTEXT_MENU];
+        this.folderPath = undefined;
+    }
+}
+exports.AllInteractionManager = AllInteractionManager;

package/dist/manager/messages/EmbedManager.js

@@ -53,16 +53,16 @@ class EmbedManager {
      * Creates base embed - SAME SIMPLE API !
      */
     static create(color = null) {
-        return new discord_js_1.EmbedBuilder()
+        const embed = new discord_js_1.EmbedBuilder()
             .setColor(color ?? this.DEFAULT_COLOR)
-            .setTitle('Title')
-            .setDescription('')
-            .setThumbnail('')
-            .setFooter({
-            text: Bot_1.Bot.config.botName || "",
-            iconURL: this.BOT_ICON
-        })
             .setTimestamp(new Date());
+        if (this.BOT_ICON && Bot_1.Bot.config.botName) {
+            embed.setFooter({
+                text: Bot_1.Bot.config.botName,
+                iconURL: this.BOT_ICON
+            });
+        }
+        return embed;
     }
     /**
      * Creates simple embed with just description
@@ -89,6 +89,13 @@ class EmbedManager {
             .setTitle('Success')
             .setDescription(description);
     }
+    /**
+     * Creates success embed
+     */
+    static description(description) {
+        return this.create(EmbedColor.minecraft)
+            .setDescription(description);
+    }
     /**
      * Creates debug embed
      */

package/dist/utils/DiscordRegex.js

@@ -100,6 +100,7 @@ DiscordRegex.DISCORD_MENTION_REGEX = new RegExp(`(${_a.DISCORD_PING_REGEX.source
 DiscordRegex.USER_ID = /^[0-9]{18}$/;
 DiscordRegex.CHANNEL_ID = /^[0-9]{18}$/;
 DiscordRegex.GUILD_ID = /^[0-9]{19}$/;
+DiscordRegex.BOT_ID = /^[0-9]{19}$/;
 // Username Discord (2-32 caractères alphanumériques + _ .)
 DiscordRegex.USERNAME = /^[a-zA-Z0-9_]{2,32}$/;
 // Username + discrim (ancien format)

package/handlers/commands/README.md

@@ -0,0 +1,11 @@
+Discord Command type :
+1. SUB_COMMAND (default)
+2. SUB_COMMAND_GROUP
+3. STRING
+4. INTEGER
+5. BOOLEAN
+6. USER
+7. CHANNEL
+8. ROLE
+9. MENTIONABLE
+10. NUMBER

package/handlers/commands/example.json

@@ -0,0 +1,144 @@
+{
+  "name": "server-management",
+  "type": 1,
+  "description": "Manage various aspects of the server",
+  "permissions": ["admin", "manage_role", "manage_users"],
+  "permissionsComment": "if undefined, or empty, all user gonna have access to the command",
+  "options": [
+    {
+      "type": 2,
+      "name": "user",
+      "description": "User management commands",
+      "options": [
+        {
+          "type": 1,
+          "name": "info",
+          "description": "Get information about a user",
+          "options": [
+            {
+              "type": 6,
+              "name": "target",
+              "description": "The user to get information about",
+              "required": true
+            }
+          ]
+        },
+        {
+          "type": 1,
+          "name": "role",
+          "description": "Manage user roles",
+          "options": [
+            {
+              "type": 6,
+              "name": "user",
+              "description": "The user to manage roles for",
+              "required": true
+            },
+            {
+              "type": 8,
+              "name": "role",
+              "description": "The role to add or remove",
+              "required": true
+            },
+            {
+              "type": 5,
+              "name": "add",
+              "description": "Add the role if true, remove if false",
+              "required": true
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "type": 1,
+      "name": "channel",
+      "description": "Manage server channels",
+      "options": [
+        {
+          "type": 7,
+          "name": "target",
+          "description": "The channel to manage",
+          "required": true
+        },
+        {
+          "type": 3,
+          "name": "action",
+          "description": "The action to perform",
+          "required": true,
+          "choices": [
+            {
+              "name": "Rename",
+              "value": "rename"
+            },
+            {
+              "name": "Delete",
+              "value": "delete"
+            },
+            {
+              "name": "Archive",
+              "value": "archive"
+            }
+          ]
+        },
+        {
+          "type": 3,
+          "name": "new_name",
+          "description": "New name for the channel (only for rename action)",
+          "required": false,
+          "min_length": 1,
+          "max_length": 100
+        }
+      ]
+    },
+    {
+      "type": 1,
+      "name": "server-stats",
+      "description": "Get server statistics",
+      "options": [
+        {
+          "type": 4,
+          "name": "days",
+          "description": "Number of days to get stats for",
+          "required": false,
+          "min_value": 1,
+          "max_value": 30
+        },
+        {
+          "type": 10,
+          "name": "activity-threshold",
+          "description": "Minimum activity level to consider",
+          "required": false,
+          "min_value": 0.0,
+          "max_value": 1.0
+        }
+      ]
+    },
+    {
+      "type": 1,
+      "name": "announcement",
+      "description": "Make a server announcement",
+      "options": [
+        {
+          "type": 3,
+          "name": "message",
+          "description": "The announcement message",
+          "required": true
+        },
+        {
+          "type": 7,
+          "name": "channel",
+          "description": "The channel to post the announcement in",
+          "required": true,
+          "channel_types": [0, 5]
+        },
+        {
+          "type": 11,
+          "name": "attachment",
+          "description": "An optional attachment for the announcement",
+          "required": false
+        }
+      ]
+    }
+  ]
+}

package/handlers/commands/example_v2.json

@@ -0,0 +1,32 @@
+{
+    "name": "example",
+    "description": "Description",
+    "defaultMemberPermissions": ["Administrator"],
+    "dmPermission": false,
+    "integration_types":[0,1],
+    "integration_type_comment":{
+      "0":"GUILD_INSTALL",
+      "1":"USER_INSTALL"
+    },
+    "contexts": [0,1,2],
+    "contexts_comment": {
+      "0":"Interaction can be used inside server",
+      "1":"Interaction can be used inside DMs with the app's bot user",
+      "2":"Interaction can be used inside Groups DMs and DMs other than the app bot user"
+    },
+    "options": [
+      {
+        "type": 3,
+        "name": "parametre",
+        "description": "Description paramètre",
+        "required": true,
+        "choices": [
+          {
+            "name": "Option 1",
+            "value": "valeur1"
+          }
+        ]
+      }
+    ]
+}
+  

package/handlers/context_menu/example.json

@@ -0,0 +1,24 @@
+{
+    "name": "Example context Menu",
+    "type": 3,
+    "type_comment": [
+        "1 => It's like a Slash command",
+        "2 => Context Menu for users",
+        "3 => Context Menu for messages"
+    ],
+    "default_member_permissions": ["ModerateMembers", "KickMembers", "BanMembers"],
+    "default_member_permissions_comment": "It's the same as the PermissionFlagsBits enum from discordjs",
+    "dm_permission": false,
+    "integration_types": [0, 1],
+    "integration_type_comment":{
+      "0":"GUILD_INSTALL",
+      "1":"USER_INSTALL"
+    },
+    "contexts": [0, 1, 2],
+    "contexts_comment": {
+      "0":"Interaction can be used inside server",
+      "1":"Interaction can be used inside DMs with the app's bot user",
+      "2":"Interaction can be used inside Groups DMs and DMs other than the app bot user"
+    },
+    "guildID":["1111160769132896377", "1214320754578165901"]
+}

package/handlers/modals/example.json

@@ -0,0 +1,51 @@
+{
+  "title": "Example Modal",
+  "customId": "example_modal",
+  "label": "example_modal",
+  "fields": [
+    {
+      "title": "Name",
+      "customId": "name",
+      "placeholder": "Name",
+      "required": true,
+      "style": 1,
+      "minLength": 3,
+      "maxLength": 100
+    },
+    {
+      "title": "Description",
+      "customId": "description",
+      "placeholder": "Description",
+      "required": true,
+      "style": 2,
+      "maxLength": 400
+    },
+    {
+      "title": "Phone",
+      "customId": "phone",
+      "placeholder": "Phone",
+      "required": true,
+      "style": "Phone",
+      "minLength": 10,
+      "maxLength": 10
+    },
+    {
+      "title": "Age",
+      "customId": "age",
+      "placeholder": "Age",
+      "required": true,
+      "style": "Number",
+      "minLength": 1,
+      "maxLength": 2
+    },
+    {
+      "title": "Birthday",
+      "customId": "birthday",
+      "placeholder": "Birthday",
+      "required": true,
+      "style": "Date",
+      "minLength": 10,
+      "maxLength": 10
+    }
+  ]
+}