feat: user bot messages

oxlint.config.ts

@@ -11,6 +11,14 @@ export default defineConfig({
     'prefer-template': 'warn',
     'typescript/no-explicit-any': 'error',
     'prefer-const': 'error',
+    'id-length': [
+      'error',
+      {
+        min: 2,
+        checkGeneric: false,
+        exceptions: ['_', 'i', 'j', 'x', 'y', 'z'],
+      },
+    ],
   },
   ignorePatterns: ['node_modules', 'dist', 'build', 'coverage', '.git'],
 });

prisma/schema.prisma

@@ -11,6 +11,7 @@ enum OptionKey {
   TAG_PREFIX
   MAX_TAGS_PER_MESSAGE
   DAYS_TO_KEEP_TAGS
+  DAYS_TO_KEEP_USER_BOT_MESSAGES
 }
 
 // Options for the bot, stored in the database.

src/common/events/index.ts

@@ -5,6 +5,7 @@ import { readyEvent } from '@/features/ready/index.js';
 import type { DiscordEvent } from './types.js';
 import archiveChannels from '@/features/archive-channels/index.js';
 import { tagReceivedEvent } from '@/features/tags/tag-received.js';
+import { reactionAddEvent } from '@/features/reactions/index.js';
 
 export const events: DiscordEvent[] = [
   readyEvent,
@@ -13,4 +14,5 @@ export const events: DiscordEvent[] = [
   interactionCreateEvent,
   archiveChannels,
   tagReceivedEvent,
+  reactionAddEvent,
 ].flat();

src/env.ts

@@ -1,3 +1,4 @@
+// oxlint-disable id-length
 import '@/loadEnvFile.js';
 
 function optionalEnv(key: string): string | undefined {

src/features/reactions/index.ts

@@ -0,0 +1,38 @@
+import { createEvent } from '@/common/events/create-event.js';
+import {
+  Events,
+  MessageReaction,
+  PartialMessageReaction,
+  PartialUser,
+  User,
+} from 'discord.js';
+import { removeUserBotMessage } from './remove-user-bot-message.js';
+
+export type ReactionAddEvent = {
+  reaction: MessageReaction | PartialMessageReaction;
+  user: User | PartialUser;
+};
+
+const handlers = [removeUserBotMessage];
+
+export const reactionAddEvent = createEvent(
+  {
+    name: Events.MessageReactionAdd,
+  },
+  async (reaction, user, details) => {
+    if (user.bot) {
+      return;
+    }
+    try {
+      if (reaction.partial) {
+        await reaction.fetch();
+      }
+    } catch {
+      return;
+    }
+
+    for (const handler of handlers) {
+      await handler(reaction, user, details);
+    }
+  }
+);

src/features/reactions/remove-user-bot-message.ts

@@ -0,0 +1,45 @@
+import type { ClientEvents, Events, GuildMember } from 'discord.js';
+import { UserBotMessagesService } from '@/services/user-bot-messages/user-bot-messages-service.js';
+
+const DELETE_EMOJIS = ['🗑️', '❌'];
+
+export const removeUserBotMessage: (
+  ...args: ClientEvents[Events.MessageReactionAdd]
+) => Promise<void> | void = async (reaction, user) => {
+  if (
+    reaction.emoji.name === null ||
+    !DELETE_EMOJIS.includes(reaction.emoji.name)
+  ) {
+    return;
+  }
+
+  if (reaction.message.author?.id !== user.client.user.id) {
+    return;
+  }
+
+  const guild = reaction.message.guild;
+  if (guild === null) {
+    return;
+  }
+
+  let member: GuildMember;
+  try {
+    member =
+      guild.members.cache.get(user.id) ?? (await guild.members.fetch(user.id));
+  } catch {
+    return;
+  }
+
+  try {
+    const deleted = await UserBotMessagesService.deleteUserBotMessage({
+      messageId: reaction.message.id,
+      user: member,
+    });
+
+    if (deleted) {
+      await reaction.message.delete();
+    }
+  } catch {
+    return;
+  }
+};

src/features/ready/index.ts

@@ -6,6 +6,7 @@ import { fetchAndCachePublicChannelsMessages } from '@/util/cache.js';
 import { syncGuidesToChannel } from '@/util/post-guides.js';
 import { leaveIfNotAllowedServer } from '@/util/server-guard.js';
 import { syncArchiveCategoryChannels } from '../archive-channels/util.js';
+import { UserBotMessagesService } from '@/services/user-bot-messages/user-bot-messages-service.js';
 
 export const readyEvent = createEvent(
   {
@@ -71,5 +72,7 @@ export const readyEvent = createEvent(
         error
       );
     }
+
+    void UserBotMessagesService.startExpiredMessageCleanup();
   }
 );

src/features/showcase/edit-showcase.ts

@@ -223,8 +223,8 @@ const modalHandler: ModalSubmitInteraction = {
         if (prevTagIds.length !== newProjectTags.length) {
           return false;
         }
-        const s = new Set(prevTagIds);
-        return newProjectTags.every((t) => s.has(t));
+        const previousTagIdsSet = new Set(prevTagIds);
+        return newProjectTags.every((tag) => previousTagIdsSet.has(tag));
       };
       if (!tagsEqual()) {
         changes.push({

src/features/showcase/util.ts

@@ -160,7 +160,9 @@ export const resolveTagNames = (
   tagIds: readonly string[],
   availableTags: GuildForumTag[]
 ): string[] => {
-  return tagIds.map((id) => availableTags.find((t) => t.id === id)?.name ?? id);
+  return tagIds.map(
+    (id) => availableTags.find((tag) => tag.id === id)?.name ?? id
+  );
 };
 
 export const getShowcaseLogChannel = (guild: Guild | null) => {

src/features/tags/create-tag.ts

@@ -129,7 +129,7 @@ const submissionHandler: ModalSubmitInteraction = {
           await interaction.reply({
             components: [
               ErrorMessages.Tags.TagAlreadyExists(
-                existingTags.map((t) => t.name).join(', ')
+                existingTags.map((tag) => tag.name).join(', ')
               ),
             ],
             flags: MessageFlags.Ephemeral | MessageFlags.IsComponentsV2,

src/features/tags/edit-tag.ts

@@ -63,7 +63,7 @@ export const editTagCommandHandler = async (
             .setCustomId('aliases')
             .setStyle(TextInputStyle.Short)
             .setRequired(true)
-            .setValue(tag.aliases.map((a) => a.name).join(', '))
+            .setValue(tag.aliases.map((alias) => alias.name).join(', '))
         ),
       new LabelBuilder()
         .setLabel('Short Description')
@@ -142,7 +142,7 @@ const modalHandler: ModalSubmitInteraction = {
         await interaction.reply({
           components: [
             ErrorMessages.Tags.TagAlreadyExists(
-              existingTags.map((t) => t.name).join(', ')
+              existingTags.map((tag) => tag.name).join(', ')
             ),
           ],
           flags: MessageFlags.Ephemeral | MessageFlags.IsComponentsV2,

src/options.ts

@@ -23,6 +23,11 @@ const OptionsDefaults = {
     type: 'number',
     displayName: 'Days to Keep Tags',
   },
+  [OptionKey.DAYS_TO_KEEP_USER_BOT_MESSAGES]: {
+    value: '7',
+    type: 'number',
+    displayName: 'Days to Keep User Bot Messages',
+  },
 } as const satisfies Record<OptionKey, OptionValue>;
 
 export type OptionTypeOf<K extends OptionKey> =

src/services/user-bot-messages/user-bot-messages-service.ts

@@ -2,8 +2,8 @@ import type { GuildMember } from 'discord.js';
 import { prisma } from '@/db/prisma.js';
 import { isStaff } from '@/util/permissions.js';
 import { DAY } from '@/constants/time.js';
-
-const CLEANUP_INTERVAL_MS = 60 * 60 * 1000; // every hour
+import { getBotOption } from '@/options.js';
+import { OptionKey } from '@/generated/prisma/enums.js';
 
 export const UserBotMessagesService = {
   async deleteUserBotMessage({
@@ -65,6 +65,9 @@ export const UserBotMessagesService = {
     };
 
     void cleanup();
-    setInterval(cleanup, CLEANUP_INTERVAL_MS);
+    const daysToKeep = getBotOption(
+      OptionKey.DAYS_TO_KEEP_USER_BOT_MESSAGES
+    ).value;
+    setInterval(cleanup, daysToKeep * DAY);
   },
 };

src/util/advent-scheduler.test.ts

@@ -1,6 +1,6 @@
 import assert from 'node:assert/strict';
 import { promises as fs } from 'node:fs';
-import test from 'node:test';
+import test, { it } from 'node:test';
 import { config } from '@/env.js';
 
 const { loadTracker, saveTracker } = await import('./advent-scheduler.js');
@@ -13,17 +13,14 @@ async function cleanupTestTracker() {
   }
 }
 
-void test('advent scheduler: tracker file operations', async (t) => {
-  await t.test(
-    'should create empty tracker if file does not exist',
-    async () => {
-      await cleanupTestTracker();
-      const tracker = await loadTracker();
-      assert.deepEqual(tracker, {});
-    }
-  );
+void test('advent scheduler: tracker file operations', async () => {
+  await it('should create empty tracker if file does not exist', async () => {
+    await cleanupTestTracker();
+    const tracker = await loadTracker();
+    assert.deepEqual(tracker, {});
+  });
 
-  await t.test('should save and load tracker data correctly', async () => {
+  await it('should save and load tracker data correctly', async () => {
     const testData = {
       '2025': [1, 2, 3],
       '2026': [1],
@@ -33,7 +30,7 @@ void test('advent scheduler: tracker file operations', async (t) => {
     assert.deepEqual(loaded, testData);
   });
 
-  await t.test('should track multiple days per year', async () => {
+  await it('should track multiple days per year', async () => {
     const tracker = {
       '2025': [1, 5, 10, 15, 20, 25],
     };

src/util/advent-scheduler.ts

@@ -39,7 +39,7 @@ async function markDayAsPosted(year: number, day: number): Promise<void> {
 
   if (!tracker[yearKey].includes(day)) {
     tracker[yearKey].push(day);
-    tracker[yearKey].sort((a, b) => a - b);
+    tracker[yearKey].sort((firstDay, secondDay) => firstDay - secondDay);
     await saveTracker(tracker);
   }
 }

src/util/fuzzy-search.ts

@@ -1,18 +1,18 @@
-export const levenshtein = (a: string, b: string) => {
-  const dp = Array.from({ length: a.length + 1 }, () =>
-    Array(b.length + 1).fill(0)
+export const levenshtein = (originalString: string, targetString: string) => {
+  const dp = Array.from({ length: originalString.length + 1 }, () =>
+    Array(targetString.length + 1).fill(0)
   );
 
-  for (let i = 0; i <= a.length; i++) {
+  for (let i = 0; i <= originalString.length; i++) {
     dp[i][0] = i;
   }
-  for (let j = 0; j <= b.length; j++) {
+  for (let j = 0; j <= targetString.length; j++) {
     dp[0][j] = j;
   }
 
-  for (let i = 1; i <= a.length; i++) {
-    for (let j = 1; j <= b.length; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+  for (let i = 1; i <= originalString.length; i++) {
+    for (let j = 1; j <= targetString.length; j++) {
+      const cost = originalString[i - 1] === targetString[j - 1] ? 0 : 1;
       dp[i][j] = Math.min(
         dp[i - 1][j] + 1, // deletion
         dp[i][j - 1] + 1, // insertion
@@ -21,7 +21,7 @@ export const levenshtein = (a: string, b: string) => {
     }
   }
 
-  return dp[a.length][b.length];
+  return dp[originalString.length][targetString.length];
 };
 
 const bestSubstringDistance = (query: string, text: string): number => {
@@ -71,7 +71,7 @@ export function fuzzySearch<T>({
   query = query.trim().toLowerCase();
   const queryLen = query.length;
 
-  const scored = items.map((item) => {
+  const scoringArray = items.map((item) => {
     let maxFuzzyScore = 0;
     let titleMatchScore = 0;
 
@@ -110,11 +110,11 @@ export function fuzzySearch<T>({
   });
 
   return (
-    scored
+    scoringArray
       // Filter by the original fuzzy score threshold (optional, you could use a lower threshold)
-      .filter((s) => s.score >= threshold)
-      .sort((a, b) => b.score - a.score)
+      .filter((result) => result.score >= threshold)
+      .sort((first, second) => second.score - first.score)
       .slice(0, limit)
-      .map((s) => s.item)
+      .map((result) => result.item)
   );
 }