feat: added config and help commands

src/commands/util/help.ts

@@ -0,0 +1,271 @@
+import {
+  SlashCommandBuilder,
+  EmbedBuilder,
+  ActionRowBuilder,
+  StringSelectMenuBuilder,
+  StringSelectMenuOptionBuilder,
+  ComponentType,
+} from 'discord.js';
+
+import { OptionsCommand } from '@/types/CommandTypes.js';
+import { ExtendedClient } from '@/structures/ExtendedClient.js';
+
+const DOC_BASE_URL = 'https://docs.poixpixel.ahmadk953.org/';
+const getDocUrl = (location: string) =>
+  `${DOC_BASE_URL}?utm_source=discord&utm_medium=bot&utm_campaign=help_command&utm_content=${location}`;
+
+const command: OptionsCommand = {
+  data: new SlashCommandBuilder()
+    .setName('help')
+    .setDescription('Shows a list of all available commands')
+    .addStringOption((option) =>
+      option
+        .setName('command')
+        .setDescription('Get detailed help for a specific command')
+        .setRequired(false),
+    ),
+
+  execute: async (interaction) => {
+    try {
+      await interaction.deferReply();
+
+      const client = interaction.client as ExtendedClient;
+      const commandName = interaction.options.getString('command');
+
+      if (commandName) {
+        return handleSpecificCommand(interaction, client, commandName);
+      }
+
+      const categories = new Map();
+
+      for (const [name, cmd] of client.commands) {
+        const category = getCategoryFromCommand(name);
+
+        if (!categories.has(category)) {
+          categories.set(category, []);
+        }
+
+        categories.get(category).push({
+          name,
+          description: cmd.data.toJSON().description,
+        });
+      }
+
+      const embed = new EmbedBuilder()
+        .setColor('#0099ff')
+        .setTitle('Poixpixel Bot Commands')
+        .setDescription(
+          '**Welcome to Poixpixel Discord Bot!**\n\n' +
+            'Select a category from the dropdown menu below to see available commands.\n\n' +
+            `📚 **Documentation:** [Visit Our Documentation](${getDocUrl('main_description')})`,
+        )
+        .setThumbnail(client.user!.displayAvatarURL())
+        .setFooter({
+          text: 'Use /help [command] for detailed info about a command',
+        });
+
+      const categoryEmojis: Record<string, string> = {
+        fun: '🎮',
+        moderation: '🛡️',
+        util: '🔧',
+        testing: '🧪',
+      };
+
+      Array.from(categories.keys()).forEach((category) => {
+        const emoji = categoryEmojis[category] || '📁';
+        embed.addFields({
+          name: `${emoji} ${category.charAt(0).toUpperCase() + category.slice(1)}`,
+          value: `Use the dropdown to see ${category} commands`,
+          inline: true,
+        });
+      });
+
+      embed.addFields({
+        name: '📚 Documentation',
+        value: `[Click here to access our full documentation](${getDocUrl('main_footer_field')})`,
+        inline: false,
+      });
+
+      const selectMenu =
+        new ActionRowBuilder<StringSelectMenuBuilder>().addComponents(
+          new StringSelectMenuBuilder()
+            .setCustomId('help_category_select')
+            .setPlaceholder('Select a command category')
+            .addOptions(
+              Array.from(categories.keys()).map((category) => {
+                const emoji = categoryEmojis[category] || '📁';
+                return new StringSelectMenuOptionBuilder()
+                  .setLabel(
+                    category.charAt(0).toUpperCase() + category.slice(1),
+                  )
+                  .setDescription(`View ${category} commands`)
+                  .setValue(category)
+                  .setEmoji(emoji);
+              }),
+            ),
+        );
+
+      const message = await interaction.editReply({
+        embeds: [embed],
+        components: [selectMenu],
+      });
+
+      const collector = message.createMessageComponentCollector({
+        componentType: ComponentType.StringSelect,
+        time: 60000,
+      });
+
+      collector.on('collect', async (i) => {
+        if (i.user.id !== interaction.user.id) {
+          await i.reply({
+            content: 'You cannot use this menu.',
+            ephemeral: true,
+          });
+          return;
+        }
+
+        const selectedCategory = i.values[0];
+        const commands = categories.get(selectedCategory);
+        const emoji = categoryEmojis[selectedCategory] || '📁';
+
+        const categoryEmbed = new EmbedBuilder()
+          .setColor('#0099ff')
+          .setTitle(
+            `${emoji} ${selectedCategory.charAt(0).toUpperCase() + selectedCategory.slice(1)} Commands`,
+          )
+          .setDescription('Here are all the commands in this category:')
+          .setFooter({
+            text: 'Use /help [command] for detailed info about a command',
+          });
+
+        commands.forEach((cmd: any) => {
+          categoryEmbed.addFields({
+            name: `/${cmd.name}`,
+            value: cmd.description || 'No description available',
+            inline: false,
+          });
+        });
+
+        categoryEmbed.addFields({
+          name: '📚 Documentation',
+          value: `[Click here to access our full documentation](${getDocUrl(`category_${selectedCategory}`)})`,
+          inline: false,
+        });
+
+        await i.update({ embeds: [categoryEmbed], components: [selectMenu] });
+      });
+
+      collector.on('end', () => {
+        interaction.editReply({ components: [] }).catch(console.error);
+      });
+    } catch (error) {
+      console.error('Error in help command:', error);
+      await interaction.editReply({
+        content: 'An error occurred while processing your request.',
+      });
+    }
+  },
+};
+
+/**
+ * Handle showing help for a specific command
+ */
+async function handleSpecificCommand(
+  interaction: any,
+  client: ExtendedClient,
+  commandName: string,
+) {
+  const cmd = client.commands.get(commandName);
+
+  if (!cmd) {
+    return interaction.reply({
+      content: `Command \`${commandName}\` not found.`,
+      ephemeral: true,
+    });
+  }
+
+  const embed = new EmbedBuilder()
+    .setColor('#0099ff')
+    .setTitle(`Help: /${commandName}`)
+    .setDescription(cmd.data.toJSON().description || 'No description available')
+    .addFields({
+      name: 'Category',
+      value: getCategoryFromCommand(commandName),
+      inline: true,
+    })
+    .setFooter({
+      text: `Poixpixel Discord Bot • Documentation: ${getDocUrl(`cmd_footer_${commandName}`)}`,
+    });
+
+  const options = cmd.data.toJSON().options;
+  if (options && options.length > 0) {
+    if (options[0].type === 1) {
+      embed.addFields({
+        name: 'Subcommands',
+        value: options
+          .map((opt: any) => `\`${opt.name}\`: ${opt.description}`)
+          .join('\n'),
+        inline: false,
+      });
+    } else {
+      embed.addFields({
+        name: 'Options',
+        value: options
+          .map(
+            (opt: any) =>
+              `\`${opt.name}\`: ${opt.description} ${opt.required ? '(Required)' : '(Optional)'}`,
+          )
+          .join('\n'),
+        inline: false,
+      });
+    }
+  }
+
+  embed.addFields({
+    name: '📚 Documentation',
+    value: `[Click here to access our full documentation](${getDocUrl(`cmd_field_${commandName}`)})`,
+    inline: false,
+  });
+
+  return interaction.reply({ embeds: [embed] });
+}
+
+/**
+ * Get the category of a command based on its name
+ */
+function getCategoryFromCommand(commandName: string): string {
+  const commandCategories: Record<string, string> = {
+    achievement: 'fun',
+    fact: 'fun',
+    rank: 'fun',
+    counting: 'fun',
+    giveaway: 'fun',
+    leaderboard: 'fun',
+
+    ban: 'moderation',
+    kick: 'moderation',
+    mute: 'moderation',
+    unmute: 'moderation',
+    warn: 'moderation',
+    unban: 'moderation',
+
+    ping: 'util',
+    server: 'util',
+    userinfo: 'util',
+    members: 'util',
+    rules: 'util',
+    restart: 'util',
+    reconnect: 'util',
+    xp: 'util',
+    recalculatelevels: 'util',
+    help: 'util',
+    config: 'util',
+
+    testjoin: 'testing',
+    testleave: 'testing',
+  };
+
+  return commandCategories[commandName.toLowerCase()] || 'other';
+}
+
+export default command;