feat: showcase logs and starter post (#61)

* chore: bump biome to 2.5.0

* feat: add SHOWCASE_LOG_CHANNEL_ID env

* feat: add send showcase pinned post command

* feat: add wrapInDiffBlock util

* feat: add toDiscordDiff

* feat: update pinned post to send raw message

* feat: add showcase logs

* feat: add showcase logs channel id to env

Author: hmd-ali

.env.production

@@ -10,6 +10,7 @@ GUIDES_CHANNEL_ID=1429492053825290371
 REPEL_LOG_CHANNEL_ID=1403558160144531589
 ADVENT_OF_CODE_CHANNEL_ID=1047623689488830495
 SHOWCASE_CHANNEL_ID=1517161718818541658
+SHOWCASE_LOG_CHANNEL_ID=1517565847982444634
 
 # Role IDs (from your dev server)
 REPEL_ROLE_ID=1002411741776461844

.env.test

@@ -17,6 +17,7 @@ GUIDES_CHANNEL_ID=your-guide-channel-id
 ADVENT_OF_CODE_CHANNEL_ID=your_advent_of_code_forum_channel_id_here
 REPEL_LOG_CHANNEL_ID=your-repel-log-channel-id
 SHOWCASE_CHANNEL_ID=your-showcase-forum-channel-id
+SHOWCASE_LOG_CHANNEL_ID=your-showcase-log-channel-id
 
 # Role IDs (from your dev server)
 REPEL_ROLE_ID=your-repel-role-id

package.json

@@ -32,7 +32,7 @@
     "web-features": "^3.9.2"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.2.4",
+    "@biomejs/biome": "2.5.0",
     "@types/node": "^24.5.2",
     "@types/node-cron": "^3.0.11",
     "husky": "^9.1.7",

pnpm-lock.yaml

@@ -5,6 +5,7 @@ import { repelCommand } from '@/features/moderation/repel.js';
 import { pingCommand } from '@/features/ping/index.js';
 import { publicGuidesCommand } from '@/features/public-guides/index.js';
 import { createShowcaseCommand } from '@/features/showcase/create-showcase.js';
+import { sendShowcasePinnedMessage } from '@/features/showcase/send-pinned-message.js';
 import { tipsCommands } from '@/features/tips/index.js';
 import type { Command } from './types.js';
 
@@ -18,6 +19,7 @@ export const commands = new Map<string, Command>(
     cacheMessages,
     publicGuidesCommand,
     createShowcaseCommand,
+    sendShowcasePinnedMessage,
   ]
     .flat()
     .map((command) => [command.data.name, command])

src/common/commands/index.ts

@@ -39,6 +39,7 @@ export const config = {
     guides: requireEnv('GUIDES_CHANNEL_ID'),
     adventOfCode: requireEnv('ADVENT_OF_CODE_CHANNEL_ID'),
     showcase: requireEnv('SHOWCASE_CHANNEL_ID'),
+    showcaseLogs: requireEnv('SHOWCASE_LOG_CHANNEL_ID'),
   },
   onboarding: {
     channelId: optionalEnv('ONBOARDING_CHANNEL_ID'),

src/env.ts

@@ -1,29 +1,33 @@
 import {
   ButtonBuilder,
+  type ButtonInteraction,
   ButtonStyle,
   ChannelType,
+  type ChatInputCommandInteraction,
+  Colors,
   ContainerBuilder,
+  EmbedBuilder,
   MessageFlags,
   TextDisplayBuilder,
 } from 'discord.js';
 import { createSlashCommand } from '@/common/commands/create-commands.js';
-import { registerButtonSubmitInteraction } from '@/common/interactions/button-interaction.js';
+import {
+  type ButtonSubmitInteraction,
+  registerButtonSubmitInteraction,
+} from '@/common/interactions/button-interaction.js';
 import {
   type ModalSubmitInteraction,
   registerModalSubmitInteraction,
 } from '@/common/interactions/modal-interaction.js';
 import { config } from '@/env.js';
+import { logToChannel } from '@/util/channel-logging.js';
 import { customId } from '@/util/custom-id.js';
 import { deleteShowcase } from './delete-showcase.js';
 import { editShowcaseInteraction } from './edit-showcase.js';
-import { buildShowcaseModal } from './util.js';
+import { buildShowcaseModal, getShowcaseLogChannel } from './util.js';
 
-export const createShowcaseCommand = createSlashCommand({
-  data: {
-    name: 'showcase',
-    description: 'Showcase a project in the showcase channel',
-  },
-  execute: async (interaction) => {
+export const showModal = async (interaction: ButtonInteraction | ChatInputCommandInteraction) => {
+  try {
     const channel = interaction.guild?.channels.cache.get(config.channelIds.showcase);
     if (channel === undefined || channel.type !== ChannelType.GuildForum) {
       await interaction.reply({
@@ -40,9 +44,30 @@ export const createShowcaseCommand = createSlashCommand({
     });
 
     await interaction.showModal(modal);
+  } catch (error) {
+    console.error('Error showing showcase modal:', error);
+    await interaction.reply({
+      content: 'There was an error showing the showcase modal. Please try again later.',
+      flags: MessageFlags.Ephemeral,
+    });
+  }
+};
+
+export const createShowcaseCommand = createSlashCommand({
+  data: {
+    name: 'showcase',
+    description: 'Showcase a project in the showcase channel',
   },
+  execute: showModal,
 });
 
+const createShowcaseButtonHandler: ButtonSubmitInteraction = {
+  commandName: 'create_showcase',
+  handler: showModal,
+};
+
+registerButtonSubmitInteraction(createShowcaseButtonHandler);
+
 const modalHandler: ModalSubmitInteraction = {
   commandName: 'showcase',
   handler: async (interaction) => {
@@ -104,6 +129,34 @@ const modalHandler: ModalSubmitInteraction = {
             ),
         ],
       });
+
+      try {
+        const logChannel = getShowcaseLogChannel(interaction.guild);
+        const author = {
+          name: interaction.user.tag,
+          iconURL: interaction.user.displayAvatarURL(),
+        };
+
+        const embed = new EmbedBuilder()
+          .setAuthor(author)
+          .setTitle('Showcase Created')
+          .addFields(
+            { name: 'Project Name', value: projectName || '—', inline: false },
+            { name: 'Author', value: `<@${interaction.user.id}>`, inline: true },
+            { name: 'Thread', value: thread.url ?? '—', inline: true }
+          )
+          .setColor(Colors.Green)
+          .setTimestamp();
+
+        await logToChannel({
+          channel: logChannel,
+          content: { type: 'embed', embed },
+          silent: true,
+        });
+      } catch (error) {
+        console.error('Failed to log showcase creation:', error);
+      }
+
       await interaction.editReply({
         content: `Your project has been showcased successfully! You can view it here: ${thread.url}`,
       });

src/features/showcase/create-showcase.ts

@@ -1,7 +1,9 @@
-import { MessageFlags } from 'discord.js';
+import { ChannelType, Colors, EmbedBuilder, MessageFlags } from 'discord.js';
 import type { ButtonSubmitInteraction } from '@/common/interactions/button-interaction.js';
+import { logToChannel } from '@/util/channel-logging.js';
 import { parseCustomId } from '@/util/custom-id.js';
 import { isUserInServer, isUserModerator } from '@/util/member.js';
+import { getShowcaseLogChannel, parseShowcaseMessage } from './util.js';
 
 export const deleteShowcase: ButtonSubmitInteraction = {
   commandName: 'delete_showcase',
@@ -26,7 +28,48 @@ export const deleteShowcase: ButtonSubmitInteraction = {
     }
 
     try {
+      const forumPost =
+        interaction.channel?.type === ChannelType.PublicThread ? interaction.channel : null;
+      if (forumPost === null) {
+        await interaction.reply({
+          content: '❌ This command can only be used in a forum post.',
+          flags: MessageFlags.Ephemeral,
+        });
+        return;
+      }
+      if (forumPost === null) {
+        await interaction.reply({
+          content: '❌ This command can only be used in a forum post.',
+          flags: MessageFlags.Ephemeral,
+        });
+        return;
+      }
+
+      const message = await forumPost.fetchStarterMessage();
+      if (!message) {
+        await interaction.reply({
+          content: '❌ Could not find the showcase message to delete.',
+          flags: MessageFlags.Ephemeral,
+        });
+        return;
+      }
+
+      const { projectName } = parseShowcaseMessage(message.content);
       await interaction.channel?.delete();
+      const logChannel = getShowcaseLogChannel(interaction.guild);
+      await logToChannel({
+        channel: logChannel,
+        content: {
+          type: 'embed',
+          embed: new EmbedBuilder()
+            .setTitle('Showcase Deleted')
+            .setDescription(
+              `**Project Name:** ${projectName}\n**Deleted By:** <@${interactionUser.id}>`
+            )
+            .setColor(Colors.Red)
+            .setAuthor({ name: interactionUser.tag, iconURL: interactionUser.displayAvatarURL() }),
+        },
+      });
     } catch (error) {
       console.error('Error deleting showcase:', error);
       await interaction.reply({