Add user-gated bulk delete command

src/commands.js

@@ -864,4 +864,15 @@ export const commands = [
   new SlashCommandBuilder()
     .setName('welcome')
     .setDescription('Post the welcome embed and tag everyone.'),
+  new SlashCommandBuilder()
+    .setName('bulkdeletemessages')
+    .setDescription('Bulk delete recent messages from the current channel.')
+    .addIntegerOption((option) =>
+      option
+        .setName('count')
+        .setDescription('How many of the most recent messages to inspect and bulk delete.')
+        .setRequired(true)
+        .setMinValue(1)
+        .setMaxValue(1000)
+    ),
 ].map((command) => command.toJSON());

src/index.js

@@ -4,6 +4,7 @@ import {
   ButtonStyle,
   ChannelType,
   Client,
+  DiscordAPIError,
   Events,
   GatewayIntentBits,
   MessageFlags,
@@ -583,6 +584,11 @@ async function handleChatInput(interaction, store, config) {
 
   if (commandName === 'welcome') {
     await handleWelcome(interaction, config);
+    return;
+  }
+
+  if (commandName === 'bulkdeletemessages') {
+    await handleBulkDeleteMessages(interaction);
   }
 }
 
@@ -1158,6 +1164,100 @@ async function handleAlerts(interaction) {
   });
 }
 
+async function handleBulkDeleteMessages(interaction) {
+  if (interaction.user.username !== ALERTS_ALLOWED_USERNAME) {
+    await interaction.reply({
+      embeds: [
+        buildErrorEmbed(
+          'Not allowed',
+          `Only **${ALERTS_ALLOWED_USERNAME}** can use this command.`
+        ),
+      ],
+      flags: MessageFlags.Ephemeral,
+    });
+    return;
+  }
+
+  if (!interaction.inGuild() || !interaction.channel || interaction.channel.type === ChannelType.DM || typeof interaction.channel.bulkDelete !== 'function') {
+    await interaction.reply({
+      embeds: [
+        buildErrorEmbed(
+          'Channel unavailable',
+          'This command can only bulk delete messages in a server text channel.'
+        ),
+      ],
+      flags: MessageFlags.Ephemeral,
+    });
+    return;
+  }
+
+  const requestedCount = interaction.options.getInteger('count', true);
+  await interaction.deferReply({ flags: MessageFlags.Ephemeral });
+
+  const now = Date.now();
+  const bulkDeleteCutoffMs = 14 * 24 * 60 * 60 * 1000;
+  let remainingToInspect = requestedCount;
+  let beforeMessageId;
+  let deletedCount = 0;
+  let skippedCount = 0;
+
+  try {
+    while (remainingToInspect > 0) {
+      const fetchLimit = Math.min(100, remainingToInspect);
+      const batch = await interaction.channel.messages.fetch({
+        limit: fetchLimit,
+        ...(beforeMessageId ? { before: beforeMessageId } : {}),
+      });
+
+      if (batch.size === 0) {
+        break;
+      }
+
+      remainingToInspect -= batch.size;
+      beforeMessageId = batch.last()?.id;
+
+      const deletableMessages = batch.filter((message) =>
+        !message.pinned
+        && !message.system
+        && (now - message.createdTimestamp) < bulkDeleteCutoffMs
+      );
+
+      skippedCount += batch.size - deletableMessages.size;
+
+      if (deletableMessages.size === 0) {
+        continue;
+      }
+
+      const deleted = await interaction.channel.bulkDelete(deletableMessages, true);
+      deletedCount += deleted.size;
+    }
+
+    await finalizeDeferredInteraction(interaction, {
+      embeds: [
+        buildErrorEmbed(
+          'Bulk delete complete',
+          `Deleted **${deletedCount}** recent message${deletedCount === 1 ? '' : 's'} from this channel.${skippedCount > 0 ? ` Skipped **${skippedCount}** pinned, system, or older-than-14-days message${skippedCount === 1 ? '' : 's'}.` : ''}`
+        ).setColor(BRAND_COLORS.primary),
+      ],
+      flags: MessageFlags.Ephemeral,
+    });
+  } catch (error) {
+    if (error instanceof DiscordAPIError && error.code === 50013) {
+      await finalizeDeferredInteraction(interaction, {
+        embeds: [
+          buildErrorEmbed(
+            'Missing permissions',
+            'The bot needs permission to manage messages in this channel before it can bulk delete them.'
+          ),
+        ],
+        flags: MessageFlags.Ephemeral,
+      });
+      return;
+    }
+    throw error;
+  }
+}
+
 async function handleScanStatus(interaction, config) {
   const isAdmin = await memberHasRoleName(interaction, config.adminRoleName);
   if (!isAdmin) {

test/alerts.test.js

@@ -17,6 +17,12 @@ test('registers the alerts slash command', () => {
   assert.match(alertsCommand.description, /alert-role embed/i);
 });
 
+test('registers the bulk delete slash command', () => {
+  const bulkDeleteCommand = commands.find((command) => command.name === 'bulkdeletemessages');
+  assert.ok(bulkDeleteCommand);
+  assert.match(bulkDeleteCommand.description, /bulk delete recent messages/i);
+});
+
 test('lists alerts in the public commands embed', () => {
   const embed = buildCommandsEmbed().toJSON();
   const alertsField = embed.fields.find((field) => field.name === '/alerts');