feat: add /repel command to timeout users and delete recent mesages (#11)

* 🌟 feat: Add buildCommandString function to format command strings

* 🌟 feat: Implement getPublicChannels function to filter accessible text channels

* 🌟 feat: Add fetchAndCachePublicChannelsMessages function to cache messages from public channels

* 🌟 feat: Implement timeToString function to format milliseconds into readable time

* 🌟 feat: Add cache-messages command to cache messages in all public text channels

* 🌟 feat: Add force re-caching option to cache-messages command

* 🌟 feat: Add new config variables (repel, server Id, moderator role Ids and cache on start)

* 🌟 feat: Fetch and cache messages on client ready event

* 🌟 feat: Implement repel command to timeout users and delete recent messages

* 🌟 feat: Add cacheMessages and repelCommand to commands map

* 🔨 refactor: remove FETCH_AND_SYNC_MESSAGES from env and put it directly in the config

* 🔨 refactor: remove unnecessary `return` from cache-messages command handler

* 🌟 feat: add error logging for target fetching and timeout functions

* 🌟 feat: replace Promis.all with Promise.allSettled and track/log failed channels in message deletion function

* 🌟 feat: enhance message caching by tracking failed channels and using Promise.allSettled

* 🐛 fix: fix missing } after resolving merge conflicts

Author: hmd-ali

.env.example

@@ -1,3 +1,8 @@
 DISCORD_TOKEN="" # Your bot token
 CLIENT_ID="" # Your bot's application ID
-GUIDES_CHANNEL_ID="" # The ID of the channel where guides will be posted
+
+SERVER_ID=
+MODERATORS_ROLE_IDS= # Comma separated list of role IDs that are Moderators(Mods, Admins, etc)
+
+REPEL_LOG_CHANNEL_ID= # Channel ID where the bot will log repel actions
+GUIDES_CHANNEL_ID="" # The ID of the channel where guides will be posted

src/commands/index.ts

@@ -1,9 +1,13 @@
 import { docsCommands } from './docs/index.js';
 import { guidesCommand } from './guides/index.js';
+import cacheMessages from './moderation/cache-messages.js';
+import { repelCommand } from './moderation/repel.js';
 import { pingCommand } from './ping.js';
 import { tipsCommands } from './tips/index.js';
 import type { Command } from './types.js';
 
 export const commands = new Map<string, Command>(
-  [pingCommand, guidesCommand, docsCommands, tipsCommands].flat().map((cmd) => [cmd.data.name, cmd])
+  [pingCommand, guidesCommand, docsCommands, tipsCommands, repelCommand, cacheMessages]
+    .flat()
+    .map((cmd) => [cmd.data.name, cmd])
 );

src/commands/moderation/cache-messages.ts

@@ -0,0 +1,49 @@
+import { ApplicationCommandOptionType, PermissionFlagsBits, PermissionsBitField } from 'discord.js';
+import { fetchAndCachePublicChannelsMessages } from '../../util/cache.js';
+import { createCommand } from '../../util/commands.js';
+
+export default createCommand({
+  data: {
+    name: 'cache-messages',
+    description: 'Cache messages in all text channels of the server',
+    default_member_permissions: new PermissionsBitField(
+      PermissionFlagsBits.ManageMessages
+    ).toJSON(),
+    options: [
+      {
+        name: 'force',
+        description: 'Force re-caching even if messages are already cached',
+        type: ApplicationCommandOptionType.Boolean,
+        required: false,
+      },
+    ],
+  },
+  execute: async (interaction) => {
+    await interaction.deferReply();
+    if (!interaction.guild || !interaction.isChatInputCommand()) {
+      await interaction.editReply('This command can only be used in a guild.');
+      return;
+    }
+
+    if (!interaction.memberPermissions?.has(PermissionFlagsBits.ManageMessages)) {
+      await interaction.editReply('You do not have permission to use this command.');
+      return;
+    }
+
+    const guild = interaction.guild;
+    const force = interaction.options.getBoolean('force') ?? false;
+
+    await interaction.editReply('Caching messages in all public text channels...');
+
+    const { cachedChannels, totalChannels, failedChannels } =
+      await fetchAndCachePublicChannelsMessages(guild, force);
+
+    const failedMessage = failedChannels.length
+      ? `\nFailed to cache messages in the following channels: ${failedChannels.map((id) => `<#${id}>`).join(', ')}`
+      : '';
+
+    await interaction.editReply(
+      `Cached messages in ${cachedChannels} out of ${totalChannels} text channels.${failedMessage}`
+    );
+  },
+});