help.ts

import { CommandData, ChatInputCommand } from 'commandkit';
import { redEmbedColor } from '@/feature-flags/red-embed-color';
import { toMessageRoute, toSlashRoute } from '@/utils/hierarchical-demo';
import { Colors } from 'discord.js';

export const command: CommandData = {
  name: 'help',
  description: 'This is a help command.',
};

function $botVersion(): string {
  'use macro';
  const { join } = require('node:path');
  const path = join(process.cwd(), 'package.json');
  return require(path).version;
}

export const chatInput: ChatInputCommand = async (ctx) => {
  const showRedColor = await redEmbedColor();

  const { interaction } = ctx;
  await interaction.deferReply();

  const botVersion = $botVersion();

  let i = 1;
  const commands = ctx.commandkit.commandHandler
    .getCommandsArray()
    .map((c) => {
      const cmdName = c.data.command.name;
      const cmd = c.discordId
        ? `</${cmdName}:${c.discordId}>`
        : `**\`/${cmdName}\`**`;
      return `${i++}. ${cmd} - ${c.command.category ?? 'N/A'}`;
    })
    .join('\n');

  const hierarchicalRoutes = ctx.commandkit.commandHandler
    .getRuntimeCommandsArray()
    .map((command) => {
      return (
        (command.data.command as Record<string, any>).__routeKey ??
        command.data.command.name
      );
    })
    .filter((route) => route.includes('.'))
    .sort()
    .map((route) => `${toSlashRoute(route)} | ${toMessageRoute(route)}`)
    .join('\n');

  return interaction.editReply({
    embeds: [
      {
        title: 'Help',
        description: commands,
        fields: hierarchicalRoutes
          ? [
              {
                name: 'Hierarchical Routes',
                value: hierarchicalRoutes,
              },
              {
                name: 'Hierarchical Middleware',
                value:
                  'Global middleware always runs first. Hierarchical leaves then use only the current directory `+middleware` and any same-directory `+<command>.middleware`.',
              },
            ]
          : undefined,
        footer: {
          text: `Bot Version: ${botVersion} | Shard ID ${interaction.guild?.shardId ?? 'N/A'}`,
        },
        color: showRedColor ? Colors.Red : Colors.Blurple,
        timestamp: new Date().toISOString(),
      },
    ],
  });
};