🌟 feat: add onboarding command

Author: hmd-ali

src/commands/index.ts

@@ -2,12 +2,21 @@ 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 { onboardingCommand } from './onboarding/index.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, repelCommand, cacheMessages]
+  [
+    pingCommand,
+    guidesCommand,
+    docsCommands,
+    tipsCommands,
+    repelCommand,
+    cacheMessages,
+    onboardingCommand,
+  ]
     .flat()
     .map((cmd) => [cmd.data.name, cmd])
 );

src/commands/onboarding/index.ts

@@ -0,0 +1,65 @@
+import { ApplicationCommandType, MessageFlags } from 'discord.js';
+import { config } from '../../env.js';
+import { createCommand } from '../../util/commands.js';
+import { containerComponent } from './component.js';
+
+export const onboardingCommand = createCommand({
+  data: {
+    name: 'onboarding',
+    description: 'Manage onboarding settings',
+    type: ApplicationCommandType.ChatInput,
+  },
+  execute: async (interaction) => {
+    const guild = interaction.guild;
+    if (!guild) {
+      await interaction.reply({
+        content: 'This command can only be used in a server.',
+        flags: MessageFlags.Ephemeral,
+      });
+      return;
+    }
+    const onboardingRole = guild.roles.cache.get(config.onboarding.roleId);
+    if (!onboardingRole) {
+      await interaction.reply({
+        content: 'Onboarding role not found. Please check the configuration.',
+        flags: MessageFlags.Ephemeral,
+      });
+      return;
+    }
+    const onboardingChannel = guild.channels.cache.get(config.onboarding.channelId);
+    if (!onboardingChannel || !onboardingChannel.isSendable()) {
+      await interaction.reply({
+        content:
+          'Onboarding channel not found or is not a text channel. Please check the configuration.',
+        flags: MessageFlags.Ephemeral,
+      });
+      return;
+    }
+
+    const onboardingMessage = await interaction.reply({
+      components: [containerComponent],
+      flags: MessageFlags.IsComponentsV2,
+    });
+
+    const collector = onboardingMessage.createMessageComponentCollector({});
+
+    collector.on('collect', async (componentInteraction) => {
+      if (componentInteraction.customId === 'onboarding_add_role') {
+        const member = await guild.members.fetch(componentInteraction.user.id);
+        const hasRole = member.roles.cache.has(onboardingRole.id);
+        if (hasRole) {
+          await componentInteraction.reply({
+            content: `You already have the ${onboardingRole.name} role.`,
+            flags: MessageFlags.Ephemeral,
+          });
+        } else {
+          await member.roles.add(onboardingRole);
+          await componentInteraction.reply({
+            content: `You have been given the ${onboardingRole.name} role!`,
+            flags: MessageFlags.Ephemeral,
+          });
+        }
+      }
+    });
+  },
+});