feat: add command deployment and deletion functionality

Author: The-LukeZ

.gitignore

@@ -21,10 +21,6 @@ jspm_packages/
 # Optional eslint cache
 .eslintcache
 
-# Output directories
-dist/
-build/
-
 # IDE specific files
 .vscode/
 .idea/

dist/index.js

@@ -0,0 +1,100 @@
+import { REST } from "@discordjs/rest";
+import { readdirSync } from "node:fs";
+import path from "node:path";
+const Routes = {
+    commands: (appId) => {
+        return `/applications/${appId}/commands`;
+    },
+    command: (appId, cmdId) => {
+        return `/applications/${appId}/commands/${cmdId}`;
+    },
+    guildCommands: (appId, guildId) => {
+        return `/applications/${appId}/guilds/${guildId}/commands`;
+    },
+    guildCommand: (appId, guildId, cmdId) => {
+        return `/applications/${appId}/guilds/${guildId}/commands/${cmdId}`;
+    },
+};
+/**
+ * Create, update and delete global and guild application commands.
+ *
+ * To update guild-specific commands correctly, make sure the bot is logged in.\
+ * Otherwise the check for a guild ID is omitted, and you could make pointless requests which can also result in an error
+ */
+export async function deployCommands(folderPath, opts) {
+    var _a, _b, _c;
+    opts.logs = (_a = opts.logs) !== null && _a !== void 0 ? _a : true;
+    const FILE_EXTENSION = (_b = opts.fileExtension) !== null && _b !== void 0 ? _b : ".js";
+    if (!opts.appToken || !opts.appId) {
+        throw new Error("Missing 'appToken' or 'appId' in 'opts'!");
+    }
+    let commands = [];
+    let privateCommands = [];
+    const commandFiles = readdirSync(folderPath).filter((file) => file.endsWith(FILE_EXTENSION));
+    if (opts.logs)
+        console.log(`🔁 Started refreshing global and guild commands.`);
+    try {
+        const rest = new REST().setToken(opts.appToken);
+        for (const file of commandFiles) {
+            const filePath = "file://" + path.join(folderPath, file);
+            const command = (await import(filePath)).default;
+            if (typeof command != "object" || !("data" in command)) {
+                console.error(`- Command '${command.name}' is missing the 'data' property!`);
+                continue;
+            }
+            else if ("data" in command && Boolean((_c = command.ignore) !== null && _c !== void 0 ? _c : false)) {
+                if (opts.logs)
+                    console.log(`- Command '${command.data.name}' is ignored!`);
+                continue;
+            }
+            if ((command.guildIds || []).length > 0) {
+                privateCommands.push({
+                    data: command.data,
+                    guildIds: command.guildIds,
+                });
+            }
+            else {
+                commands.push(command.data);
+            }
+        }
+        let data = await rest.put(Routes.commands(opts.appId), {
+            body: commands,
+        });
+        if (opts.logs)
+            console.log(`✅ ${data.length} global commands refreshed`);
+        for (let cmd of privateCommands) {
+            for (let gid of cmd.guildIds) {
+                data = null;
+                data = await rest.post(Routes.guildCommands(opts.appId, gid), {
+                    body: cmd.data,
+                });
+                if (opts.logs)
+                    console.log(`✅ Guild command '${data.name}' refreshed`);
+            }
+        }
+        return true;
+    }
+    catch (err) {
+        console.error("❌ Error while refreshing commands:", err);
+        return false;
+    }
+}
+/**
+ * Shortcut method to delete an application command by its ID. **The client needs to be logged in!**
+ */
+export async function deleteCommand(commandId, opts) {
+    var _a;
+    const guildId = (_a = opts.guildId) !== null && _a !== void 0 ? _a : null;
+    const commandPath = guildId
+        ? Routes.guildCommand(opts.appId, guildId, commandId)
+        : Routes.command(opts.appId, commandId);
+    if (commandId.match(/^\d+$/i)) {
+        await new REST({ version: "10" })
+            .setToken(opts.appToken)
+            .delete(commandPath);
+    }
+    else {
+        throw new Error("'commandId' is not a only-number-string!");
+    }
+    return;
+}

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "djs-command-helper",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "A simple, easy to use module that houses functions to can refresh global and guild specific commands for your Discord App.",
   "main": "./dist/index.js",
   "types": "./types.d.ts",