mirror of
https://github.com/discordeno/discordeno.git
synced 2026-06-02 08:50:07 +00:00
b00504ce07
* perf(plugins/helpers,rest,site,template)!: uppercase rest methods There is no need for us to pass the methods in lower case and then use the `toUpperCase()` method everywhere. Therefore this PR changes every lowercase method to be uppercase (eg. `"get"` => `"GET"`). * template is old version
103 lines
4.8 KiB
TypeScript
103 lines
4.8 KiB
TypeScript
import type { Bot } from "../../../bot.ts";
|
|
import { ApplicationCommandOption, ApplicationCommandTypes, Localization } from "../../../mod.ts";
|
|
import { DiscordApplicationCommand, DiscordApplicationCommandOption } from "../../../types/discord.ts";
|
|
import { AtLeastOne, PermissionStrings } from "../../../types/shared.ts";
|
|
|
|
/**
|
|
* There are two kinds of Application Commands: global commands and guild commands. Global commands are available for every guild that adds your app; guild commands are specific to the guild you specify when making them. Command names are unique per application within each scope (global and guild). That means:
|
|
*
|
|
* - Your app **cannot** have two global commands with the same name
|
|
* - Your app **cannot** have two guild commands within the same name **on the same guild**
|
|
* - Your app **can** have a global and guild command with the same name
|
|
* - Multiple apps **can** have commands with the same names
|
|
*
|
|
* Global commands are cached for **1 hour**. That means that new global commands will fan out slowly across all guilds, and will be guaranteed to be updated in an hour.
|
|
* Guild commands update **instantly**. We recommend you use guild commands for quick testing, and global commands when they're ready for public use.
|
|
*/
|
|
export async function createApplicationCommand(
|
|
bot: Bot,
|
|
options: CreateApplicationCommand | CreateContextApplicationCommand,
|
|
guildId?: bigint,
|
|
) {
|
|
const result = await bot.rest.runMethod<DiscordApplicationCommand>(
|
|
bot.rest,
|
|
"POST",
|
|
guildId
|
|
? bot.constants.routes.COMMANDS_GUILD(bot.applicationId, guildId)
|
|
: bot.constants.routes.COMMANDS(bot.applicationId),
|
|
isContextApplicationCommand(options)
|
|
? { name: options.name, name_localizations: options.nameLocalizations, type: options.type }
|
|
: {
|
|
name: options.name,
|
|
name_localizations: options.nameLocalizations,
|
|
description: options.description,
|
|
description_localizations: options.descriptionLocalizations,
|
|
type: options.type,
|
|
options: options.options ? makeOptionsForCommand(options.options) : undefined,
|
|
default_member_permissions: options.defaultMemberPermissions
|
|
? bot.utils.calculateBits(options.defaultMemberPermissions)
|
|
: undefined,
|
|
dm_permission: options.dmPermission,
|
|
},
|
|
);
|
|
|
|
return bot.transformers.applicationCommand(bot, result);
|
|
}
|
|
|
|
export function makeOptionsForCommand(options: ApplicationCommandOption[]): DiscordApplicationCommandOption[] {
|
|
return options.map((option) => ({
|
|
type: option.type,
|
|
name: option.name,
|
|
name_localizations: option.nameLocalizations,
|
|
description: option.description,
|
|
description_localizations: option.descriptionLocalizations,
|
|
required: option.required,
|
|
choices: option.choices?.map((choice) => ({
|
|
name: choice.name,
|
|
name_localizations: choice.nameLocalizations,
|
|
value: choice.value,
|
|
})),
|
|
options: option.options ? makeOptionsForCommand(option.options) : undefined,
|
|
channel_types: option.channelTypes,
|
|
autocomplete: option.autocomplete,
|
|
min_value: option.minValue,
|
|
max_value: option.maxValue,
|
|
}));
|
|
}
|
|
|
|
/** https://discord.com/developers/docs/interactions/application-commands#endpoints-json-params */
|
|
export interface CreateApplicationCommand {
|
|
/** 1-31 character name matching lowercase `^[\w-]{1,32}$` */
|
|
name: string;
|
|
/** Localization object for the `name` field. Values follow the same restrictions as `name` */
|
|
nameLocalizations?: Localization;
|
|
/** 1-100 character description */
|
|
description: string;
|
|
/** Localization object for the `description` field. Values follow the same restrictions as `description` */
|
|
descriptionLocalizations?: Localization;
|
|
/** The type of the command */
|
|
type?: ApplicationCommandTypes;
|
|
/** The parameters for the command */
|
|
options?: ApplicationCommandOption[];
|
|
/** Set of permissions represented as a bit set */
|
|
defaultMemberPermissions?: PermissionStrings[];
|
|
/** Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible. */
|
|
dmPermission?: boolean;
|
|
}
|
|
|
|
/** https://discord.com/developers/docs/interactions/application-commands#endpoints-json-params */
|
|
export interface CreateContextApplicationCommand {
|
|
/** 1-31 character name matching lowercase `^[\w-]{1,32}$` */
|
|
name: string;
|
|
/** Localization object for the `name` field. Values follow the same restrictions as `name` */
|
|
nameLocalizations?: Localization;
|
|
/** The type of the command */
|
|
type: ApplicationCommandTypes.Message | ApplicationCommandTypes.User;
|
|
}
|
|
|
|
export function isContextApplicationCommand(
|
|
cmd: AtLeastOne<CreateContextApplicationCommand> | AtLeastOne<CreateApplicationCommand>,
|
|
): cmd is AtLeastOne<CreateContextApplicationCommand> {
|
|
return cmd.type === ApplicationCommandTypes.Message || cmd.type === ApplicationCommandTypes.User;
|
|
}
|