poixpixel-discord-bot/src/commands/util/help.ts

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;