src/core/BaseCommand.ts
import { emojis } from '#utils/Constants.js';
import { MetadataHandler } from '#main/core/FileLoader.js';
import { InteractionFunction } from '#main/decorators/RegisterInteractionHandler.js';
import type { TranslationKeys } from '#types/TranslationKeys.d.ts';
import { InfoEmbed } from '#utils/EmbedUtils.js';
import { supportedLocaleCodes, t } from '#utils/Locale.js';
import Logger from '#utils/Logger.js';
import { getReplyMethod } from '#utils/Utils.js';
import {
type ActionRowData,
type APIActionRowComponent,
type APIApplicationCommandSubcommandGroupOption,
type APIApplicationCommandSubcommandOption,
type APIMessageActionRowComponent,
type AutocompleteInteraction,
type ChatInputCommandInteraction,
type ColorResolvable,
type ContextMenuCommandInteraction,
type InteractionResponse,
type JSONEncodable,
type Message,
type MessageActionRowComponentBuilder,
type MessageActionRowComponentData,
type MessageComponentInteraction,
type ModalSubmitInteraction,
type RepliableInteraction,
type RESTPostAPIChatInputApplicationCommandsJSONBody,
type RESTPostAPIContextMenuApplicationCommandsJSONBody,
Collection,
Interaction,
time,
} from 'discord.js';
export type CmdInteraction = ChatInputCommandInteraction | ContextMenuCommandInteraction;
export type CmdData =
| RESTPostAPIChatInputApplicationCommandsJSONBody
| RESTPostAPIContextMenuApplicationCommandsJSONBody
| APIApplicationCommandSubcommandGroupOption
| APIApplicationCommandSubcommandOption;
export default abstract class BaseCommand {
abstract readonly data: CmdData;
readonly staffOnly?: boolean;
readonly cooldown?: number;
readonly description?: string;
static readonly subcommands?: Collection<string, BaseCommand>;
abstract execute(interaction: CmdInteraction): Promise<unknown>;
// optional methods
async autocomplete?(interaction: AutocompleteInteraction): Promise<unknown>;
async handleComponents?(interaction: MessageComponentInteraction): Promise<unknown>;
async handleModals?(interaction: ModalSubmitInteraction): Promise<unknown>;
async checkOrSetCooldown(interaction: RepliableInteraction): Promise<boolean> {
const remainingCooldown = await this.getRemainingCooldown(interaction);
if (remainingCooldown) {
const { userManager } = interaction.client;
const locale = await userManager.getUserLocale(interaction.user.id);
await this.sendCooldownError(interaction, remainingCooldown, locale);
return true;
}
await this.setUserCooldown(interaction);
return false;
}
async sendCooldownError(
interaction: RepliableInteraction,
remainingCooldown: number,
locale: supportedLocaleCodes,
): Promise<void> {
const waitUntil = Math.round((Date.now() + remainingCooldown) / 1000);
await interaction.reply({
content: t('errors.cooldown', locale, {
time: `${time(waitUntil, 'T')} (${time(waitUntil, 'R')})`,
emoji: emojis.no,
}),
ephemeral: true,
});
}
async getRemainingCooldown(interaction: RepliableInteraction): Promise<number> {
let remainingCooldown: number | undefined;
const { commandCooldowns } = interaction.client;
if (interaction.isChatInputCommand()) {
const subcommand = interaction.options.getSubcommand(false);
const subcommandGroup = interaction.options.getSubcommandGroup(false);
remainingCooldown = await commandCooldowns.getRemainingCooldown(
`${interaction.user.id}-${interaction.commandName}${
subcommandGroup ? `-${subcommandGroup}` : ''
}${subcommand ? `-${subcommand}` : ''}`,
);
}
else if (interaction.isContextMenuCommand()) {
remainingCooldown = await commandCooldowns.getRemainingCooldown(
`${interaction.user.id}-${interaction.commandName}`,
);
}
return remainingCooldown || 0;
}
async setUserCooldown(interaction: RepliableInteraction): Promise<void> {
if (!this.cooldown) return;
const { commandCooldowns } = interaction.client;
if (interaction.isChatInputCommand()) {
const subcommand = interaction.options.getSubcommand(false);
const subcommandGroup = interaction.options.getSubcommandGroup(false);
const id = `${interaction.user.id}-${interaction.commandName}${
subcommandGroup ? `-${subcommandGroup}` : ''
}${subcommand ? `-${subcommand}` : ''}`;
await commandCooldowns.setCooldown(id, this.cooldown);
}
else if (interaction.isContextMenuCommand()) {
await commandCooldowns.setCooldown(
`${interaction.user.id}-${interaction.commandName}`,
this.cooldown,
);
}
}
async replyEmbed<K extends keyof TranslationKeys>(
interaction: RepliableInteraction | MessageComponentInteraction,
desc: K | (string & NonNullable<unknown>),
opts?: {
t?: { [Key in TranslationKeys[K]]: string };
content?: string;
title?: string;
color?: ColorResolvable;
components?: readonly (
| JSONEncodable<APIActionRowComponent<APIMessageActionRowComponent>>
| ActionRowData<MessageActionRowComponentData | MessageActionRowComponentBuilder>
| APIActionRowComponent<APIMessageActionRowComponent>
)[];
ephemeral?: boolean;
edit?: boolean;
},
): Promise<InteractionResponse | Message> {
let description = desc as string;
if (t(desc as K, 'en')) {
const locale = await this.getLocale(interaction);
description = t(desc as K, locale, opts?.t);
}
const embed = new InfoEmbed().setDescription(description).setTitle(opts?.title);
const message = { content: opts?.content, embeds: [embed], components: opts?.components };
if (opts?.edit) return await interaction.editReply(message);
const methodName = getReplyMethod(interaction);
return await interaction[methodName]({ ...message, ephemeral: opts?.ephemeral });
}
build(
fileName: string,
opts: {
commandsMap: Collection<string, BaseCommand>;
interactionsMap: Collection<string, InteractionFunction>;
},
): void {
if (Object.getPrototypeOf(this.constructor) === BaseCommand) {
opts.commandsMap.set(this.data.name, this);
this.loadCommandInteractions(this, opts.interactionsMap);
}
else {
const parentCommand = Object.getPrototypeOf(this.constructor) as typeof BaseCommand;
parentCommand.subcommands?.set(fileName.replace('.js', ''), this);
this.loadCommandInteractions(this, opts.interactionsMap);
}
}
private loadCommandInteractions(
command: BaseCommand,
map: Collection<string, InteractionFunction>,
): void {
Logger.debug(`Adding interactions for command: ${command.data.name}`);
MetadataHandler.loadMetadata(command, map);
Logger.debug(`Finished adding interactions for command: ${command.data.name}`);
}
protected async getLocale(
interaction: Interaction | MessageComponentInteraction,
): Promise<supportedLocaleCodes> {
const { userManager } = interaction.client;
return await userManager.getUserLocale(interaction.user.id);
}
}