Added payload files

payloads/common.ts

@@ -0,0 +1,104 @@
+import type { LocaleString } from '../rest/common';
+
+/**
+ * https://discord.com/developers/docs/topics/permissions#permissions-bitwise-permission-flags
+ *
+ * These flags are exported as `BigInt`s and NOT numbers. Wrapping them in `Number()`
+ * may cause issues, try to use BigInts as much as possible or modules that can
+ * replicate them in some way
+ */
+export const PermissionFlagsBits = {
+	CreateInstantInvite: BigInt(1) << BigInt(0),
+	KickMembers: BigInt(1) << BigInt(1),
+	BanMembers: BigInt(1) << BigInt(2),
+	Administrator: BigInt(1) << BigInt(3),
+	ManageChannels: BigInt(1) << BigInt(4),
+	ManageGuild: BigInt(1) << BigInt(5),
+	AddReactions: BigInt(1) << BigInt(6),
+	ViewAuditLog: BigInt(1) << BigInt(7),
+	PrioritySpeaker: BigInt(1) << BigInt(8),
+	Stream: BigInt(1) << BigInt(9),
+	ViewChannel: BigInt(1) << BigInt(10),
+	SendMessages: BigInt(1) << BigInt(11),
+	SendTTSMessages: BigInt(1) << BigInt(12),
+	ManageMessages: BigInt(1) << BigInt(13),
+	EmbedLinks: BigInt(1) << BigInt(14),
+	AttachFiles: BigInt(1) << BigInt(15),
+	ReadMessageHistory: BigInt(1) << BigInt(16),
+	MentionEveryone: BigInt(1) << BigInt(17),
+	UseExternalEmojis: BigInt(1) << BigInt(18),
+	ViewGuildInsights: BigInt(1) << BigInt(19),
+	Connect: BigInt(1) << BigInt(20),
+	Speak: BigInt(1) << BigInt(21),
+	MuteMembers: BigInt(1) << BigInt(22),
+	DeafenMembers: BigInt(1) << BigInt(23),
+	MoveMembers: BigInt(1) << BigInt(24),
+	UseVAD: BigInt(1) << BigInt(25),
+	ChangeNickname: BigInt(1) << BigInt(26),
+	ManageNicknames: BigInt(1) << BigInt(27),
+	ManageRoles: BigInt(1) << BigInt(28),
+	ManageWebhooks: BigInt(1) << BigInt(29),
+	ManageEmojisAndStickers: BigInt(1) << BigInt(30),
+	UseApplicationCommands: BigInt(1) << BigInt(31),
+	RequestToSpeak: BigInt(1) << BigInt(32),
+	ManageEvents: BigInt(1) << BigInt(33),
+	ManageThreads: BigInt(1) << BigInt(34),
+	CreatePublicThreads: BigInt(1) << BigInt(35),
+	CreatePrivateThreads: BigInt(1) << BigInt(36),
+	UseExternalStickers: BigInt(1) << BigInt(37),
+	SendMessagesInThreads: BigInt(1) << BigInt(38),
+	UseEmbeddedActivities: BigInt(1) << BigInt(39),
+	ModerateMembers: BigInt(1) << BigInt(40),
+} as const;
+
+/**
+ * Freeze the object of bits, preventing any modifications to it
+ * @internal
+ */
+Object.freeze(PermissionFlagsBits);
+
+export type LocalizationMap = Partial<Record<LocaleString, string | null>>;
+
+/**
+ * https://discord.com/developers/docs/topics/opcodes-and-status-codes#json
+ */
+export interface RESTError {
+	code: number;
+	message: string;
+	errors?: RESTErrorData;
+}
+
+export interface RESTErrorFieldInformation {
+	code: string;
+	message: string;
+}
+
+export interface RESTErrorGroupWrapper {
+	_errors: RESTErrorData[];
+}
+
+export type RESTErrorData = RESTErrorGroupWrapper | RESTErrorFieldInformation | { [k: string]: RESTErrorData } | string;
+
+/**
+ * https://discord.com/developers/docs/topics/rate-limits#exceeding-a-rate-limit-rate-limit-response-structure
+ */
+export interface RESTRateLimit {
+	/**
+	 * An error code for some limits
+	 *
+	 * {@link RESTJSONErrorCodes}
+	 */
+	code?: number;
+	/**
+	 * A value indicating if you are being globally rate limited or not
+	 */
+	global: boolean;
+	/**
+	 * A message saying you are being rate limited.
+	 */
+	message: string;
+	/**
+	 * The number of seconds to wait before submitting another request.
+	 */
+	retry_after: number;
+}

payloads/index.ts

@@ -0,0 +1,4 @@
+// This file exports all the payloads available in the recommended API version
+// Thereby, things MAY break in the future. Try sticking to imports from a specific version
+
+export * from './v9/index';

payloads/v9/_interactions/_applicationCommands/_chatInput/attachment.ts

@@ -0,0 +1,11 @@
+import type { APIApplicationCommandOptionBase, APIInteractionDataOptionBase } from './base';
+import type { ApplicationCommandOptionType } from './shared';
+import type { Snowflake } from '../../../../../globals';
+
+export type APIApplicationCommandAttachmentOption =
+	APIApplicationCommandOptionBase<ApplicationCommandOptionType.Attachment>;
+
+export type APIApplicationCommandInteractionDataAttachmentOption = APIInteractionDataOptionBase<
+	ApplicationCommandOptionType.Attachment,
+	Snowflake
+>;

payloads/v9/_interactions/_applicationCommands/_chatInput/base.ts

@@ -0,0 +1,29 @@
+import type { APIApplicationCommandOptionChoice, ApplicationCommandOptionType } from './shared';
+import type { LocalizationMap } from '../../../../../v9';
+
+export interface APIApplicationCommandOptionBase<Type extends ApplicationCommandOptionType> {
+	type: Type;
+	name: string;
+	name_localizations?: LocalizationMap | null;
+	description: string;
+	description_localizations?: LocalizationMap | null;
+	required?: boolean;
+}
+
+export interface APIInteractionDataOptionBase<T extends ApplicationCommandOptionType, D> {
+	name: string;
+	type: T;
+	value: D;
+}
+
+export type APIApplicationCommandOptionWithAutocompleteOrChoicesWrapper<
+	Base extends APIApplicationCommandOptionBase<ApplicationCommandOptionType>,
+	ChoiceType extends APIApplicationCommandOptionChoice,
+> =
+	| (Base & {
+			autocomplete: true;
+	  })
+	| (Base & {
+			autocomplete?: false;
+			choices?: ChoiceType[];
+	  });

payloads/v9/_interactions/_applicationCommands/_chatInput/boolean.ts

@@ -0,0 +1,9 @@
+import type { APIApplicationCommandOptionBase, APIInteractionDataOptionBase } from './base';
+import type { ApplicationCommandOptionType } from './shared';
+
+export type APIApplicationCommandBooleanOption = APIApplicationCommandOptionBase<ApplicationCommandOptionType.Boolean>;
+
+export type APIApplicationCommandInteractionDataBooleanOption = APIInteractionDataOptionBase<
+	ApplicationCommandOptionType.Boolean,
+	boolean
+>;

payloads/v9/_interactions/_applicationCommands/_chatInput/channel.ts

@@ -0,0 +1,14 @@
+import type { APIApplicationCommandOptionBase, APIInteractionDataOptionBase } from './base';
+import type { ApplicationCommandOptionType } from './shared';
+import type { Snowflake } from '../../../../../globals';
+import type { ChannelType } from '../../../channel';
+
+export interface APIApplicationCommandChannelOption
+	extends APIApplicationCommandOptionBase<ApplicationCommandOptionType.Channel> {
+	channel_types?: Exclude<ChannelType, ChannelType.DM | ChannelType.GroupDM>[];
+}
+
+export type APIApplicationCommandInteractionDataChannelOption = APIInteractionDataOptionBase<
+	ApplicationCommandOptionType.Channel,
+	Snowflake
+>;

payloads/v9/_interactions/_applicationCommands/_chatInput/integer.ts

@@ -0,0 +1,28 @@
+import type {
+	APIApplicationCommandOptionBase,
+	APIApplicationCommandOptionWithAutocompleteOrChoicesWrapper,
+	APIInteractionDataOptionBase,
+} from './base';
+import type { APIApplicationCommandOptionChoice, ApplicationCommandOptionType } from './shared';
+
+interface APIApplicationCommandIntegerOptionBase
+	extends APIApplicationCommandOptionBase<ApplicationCommandOptionType.Integer> {
+	/**
+	 * If the option is an `INTEGER` or `NUMBER` type, the minimum value permitted.
+	 */
+	min_value?: number;
+	/**
+	 * If the option is an `INTEGER` or `NUMBER` type, the maximum value permitted.
+	 */
+	max_value?: number;
+}
+
+export type APIApplicationCommandIntegerOption = APIApplicationCommandOptionWithAutocompleteOrChoicesWrapper<
+	APIApplicationCommandIntegerOptionBase,
+	APIApplicationCommandOptionChoice<number>
+>;
+
+export interface APIApplicationCommandInteractionDataIntegerOption
+	extends APIInteractionDataOptionBase<ApplicationCommandOptionType.Integer, number> {
+	focused?: boolean;
+}

payloads/v9/_interactions/_applicationCommands/_chatInput/mentionable.ts

@@ -0,0 +1,11 @@
+import type { APIApplicationCommandOptionBase, APIInteractionDataOptionBase } from './base';
+import type { ApplicationCommandOptionType } from './shared';
+import type { Snowflake } from '../../../../../globals';
+
+export type APIApplicationCommandMentionableOption =
+	APIApplicationCommandOptionBase<ApplicationCommandOptionType.Mentionable>;
+
+export type APIApplicationCommandInteractionDataMentionableOption = APIInteractionDataOptionBase<
+	ApplicationCommandOptionType.Mentionable,
+	Snowflake
+>;

payloads/v9/_interactions/_applicationCommands/_chatInput/number.ts

@@ -0,0 +1,28 @@
+import type {
+	APIApplicationCommandOptionBase,
+	APIApplicationCommandOptionWithAutocompleteOrChoicesWrapper,
+	APIInteractionDataOptionBase,
+} from './base';
+import type { APIApplicationCommandOptionChoice, ApplicationCommandOptionType } from './shared';
+
+interface APIApplicationCommandNumberOptionBase
+	extends APIApplicationCommandOptionBase<ApplicationCommandOptionType.Number> {
+	/**
+	 * If the option is an `INTEGER` or `NUMBER` type, the minimum value permitted.
+	 */
+	min_value?: number;
+	/**
+	 * If the option is an `INTEGER` or `NUMBER` type, the maximum value permitted.
+	 */
+	max_value?: number;
+}
+
+export type APIApplicationCommandNumberOption = APIApplicationCommandOptionWithAutocompleteOrChoicesWrapper<
+	APIApplicationCommandNumberOptionBase,
+	APIApplicationCommandOptionChoice<number>
+>;
+
+export interface APIApplicationCommandInteractionDataNumberOption
+	extends APIInteractionDataOptionBase<ApplicationCommandOptionType.Number, number> {
+	focused?: boolean;
+}

payloads/v9/_interactions/_applicationCommands/_chatInput/role.ts

@@ -0,0 +1,10 @@
+import type { APIApplicationCommandOptionBase, APIInteractionDataOptionBase } from './base';
+import type { ApplicationCommandOptionType } from './shared';
+import type { Snowflake } from '../../../../../globals';
+
+export type APIApplicationCommandRoleOption = APIApplicationCommandOptionBase<ApplicationCommandOptionType.Role>;
+
+export type APIApplicationCommandInteractionDataRoleOption = APIInteractionDataOptionBase<
+	ApplicationCommandOptionType.Role,
+	Snowflake
+>;

payloads/v9/_interactions/_applicationCommands/_chatInput/shared.ts

@@ -0,0 +1,27 @@
+import type { LocalizationMap } from '../../../../../v9';
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-type
+ */
+export enum ApplicationCommandOptionType {
+	Subcommand = 1,
+	SubcommandGroup,
+	String,
+	Integer,
+	Boolean,
+	User,
+	Channel,
+	Role,
+	Mentionable,
+	Number,
+	Attachment,
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-choice-structure
+ */
+export interface APIApplicationCommandOptionChoice<ValueType = string | number> {
+	name: string;
+	name_localizations?: LocalizationMap | null;
+	value: ValueType;
+}

payloads/v9/_interactions/_applicationCommands/_chatInput/string.ts

@@ -0,0 +1,28 @@
+import type {
+	APIApplicationCommandOptionBase,
+	APIApplicationCommandOptionWithAutocompleteOrChoicesWrapper,
+	APIInteractionDataOptionBase,
+} from './base';
+import type { APIApplicationCommandOptionChoice, ApplicationCommandOptionType } from './shared';
+
+interface APIApplicationCommandStringOptionBase
+	extends APIApplicationCommandOptionBase<ApplicationCommandOptionType.String> {
+	/**
+	 * For option type `STRING`, the minimum allowed length (minimum of `0`, maximum of `6000`).
+	 */
+	min_length?: number;
+	/**
+	 * For option type `STRING`, the maximum allowed length (minimum of `1`, maximum of `6000`).
+	 */
+	max_length?: number;
+}
+
+export type APIApplicationCommandStringOption = APIApplicationCommandOptionWithAutocompleteOrChoicesWrapper<
+	APIApplicationCommandStringOptionBase,
+	APIApplicationCommandOptionChoice<string>
+>;
+
+export interface APIApplicationCommandInteractionDataStringOption
+	extends APIInteractionDataOptionBase<ApplicationCommandOptionType.String, string> {
+	focused?: boolean;
+}

payloads/v9/_interactions/_applicationCommands/_chatInput/subcommand.ts

@@ -0,0 +1,14 @@
+import type { APIApplicationCommandOptionBase } from './base';
+import type { ApplicationCommandOptionType } from './shared';
+import type { APIApplicationCommandBasicOption, APIApplicationCommandInteractionDataBasicOption } from '../chatInput';
+
+export interface APIApplicationCommandSubcommandOption
+	extends APIApplicationCommandOptionBase<ApplicationCommandOptionType.Subcommand> {
+	options?: APIApplicationCommandBasicOption[];
+}
+
+export interface APIApplicationCommandInteractionDataSubcommandOption {
+	name: string;
+	type: ApplicationCommandOptionType.Subcommand;
+	options?: APIApplicationCommandInteractionDataBasicOption[];
+}

payloads/v9/_interactions/_applicationCommands/_chatInput/subcommandGroup.ts

@@ -0,0 +1,17 @@
+import type { APIApplicationCommandOptionBase } from './base';
+import type { ApplicationCommandOptionType } from './shared';
+import type {
+	APIApplicationCommandInteractionDataSubcommandOption,
+	APIApplicationCommandSubcommandOption,
+} from './subcommand';
+
+export interface APIApplicationCommandSubcommandGroupOption
+	extends APIApplicationCommandOptionBase<ApplicationCommandOptionType.SubcommandGroup> {
+	options?: APIApplicationCommandSubcommandOption[];
+}
+
+export interface APIApplicationCommandInteractionDataSubcommandGroupOption {
+	name: string;
+	type: ApplicationCommandOptionType.SubcommandGroup;
+	options: APIApplicationCommandInteractionDataSubcommandOption[];
+}

payloads/v9/_interactions/_applicationCommands/_chatInput/user.ts

@@ -0,0 +1,10 @@
+import type { APIApplicationCommandOptionBase, APIInteractionDataOptionBase } from './base';
+import type { ApplicationCommandOptionType } from './shared';
+import type { Snowflake } from '../../../../../globals';
+
+export type APIApplicationCommandUserOption = APIApplicationCommandOptionBase<ApplicationCommandOptionType.User>;
+
+export type APIApplicationCommandInteractionDataUserOption = APIInteractionDataOptionBase<
+	ApplicationCommandOptionType.User,
+	Snowflake
+>;

payloads/v9/_interactions/_applicationCommands/chatInput.ts

@@ -0,0 +1,130 @@
+import type {
+	APIApplicationCommandAttachmentOption,
+	APIApplicationCommandInteractionDataAttachmentOption,
+} from './_chatInput/attachment';
+import type {
+	APIApplicationCommandBooleanOption,
+	APIApplicationCommandInteractionDataBooleanOption,
+} from './_chatInput/boolean';
+import type {
+	APIApplicationCommandChannelOption,
+	APIApplicationCommandInteractionDataChannelOption,
+} from './_chatInput/channel';
+import type {
+	APIApplicationCommandIntegerOption,
+	APIApplicationCommandInteractionDataIntegerOption,
+} from './_chatInput/integer';
+import type {
+	APIApplicationCommandInteractionDataMentionableOption,
+	APIApplicationCommandMentionableOption,
+} from './_chatInput/mentionable';
+import type {
+	APIApplicationCommandInteractionDataNumberOption,
+	APIApplicationCommandNumberOption,
+} from './_chatInput/number';
+import type {
+	APIApplicationCommandInteractionDataRoleOption,
+	APIApplicationCommandRoleOption,
+} from './_chatInput/role';
+import type {
+	APIApplicationCommandInteractionDataStringOption,
+	APIApplicationCommandStringOption,
+} from './_chatInput/string';
+import type {
+	APIApplicationCommandInteractionDataSubcommandOption,
+	APIApplicationCommandSubcommandOption,
+} from './_chatInput/subcommand';
+import type {
+	APIApplicationCommandInteractionDataSubcommandGroupOption,
+	APIApplicationCommandSubcommandGroupOption,
+} from './_chatInput/subcommandGroup';
+import type {
+	APIApplicationCommandInteractionDataUserOption,
+	APIApplicationCommandUserOption,
+} from './_chatInput/user';
+import type { APIBaseApplicationCommandInteractionData } from './internals';
+import type { APIInteractionDataResolved } from '../../index';
+import type { APIApplicationCommandInteractionWrapper, ApplicationCommandType } from '../applicationCommands';
+import type { APIDMInteractionWrapper, APIGuildInteractionWrapper } from '../base';
+
+export * from './_chatInput/attachment';
+export * from './_chatInput/base';
+export * from './_chatInput/boolean';
+export * from './_chatInput/channel';
+export * from './_chatInput/integer';
+export * from './_chatInput/mentionable';
+export * from './_chatInput/number';
+export * from './_chatInput/role';
+export * from './_chatInput/shared';
+export * from './_chatInput/string';
+export * from './_chatInput/subcommand';
+export * from './_chatInput/subcommandGroup';
+export * from './_chatInput/user';
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure
+ */
+export type APIApplicationCommandBasicOption =
+	| APIApplicationCommandStringOption
+	| APIApplicationCommandIntegerOption
+	| APIApplicationCommandBooleanOption
+	| APIApplicationCommandUserOption
+	| APIApplicationCommandChannelOption
+	| APIApplicationCommandRoleOption
+	| APIApplicationCommandMentionableOption
+	| APIApplicationCommandNumberOption
+	| APIApplicationCommandAttachmentOption;
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure
+ */
+export type APIApplicationCommandOption =
+	| APIApplicationCommandSubcommandOption
+	| APIApplicationCommandSubcommandGroupOption
+	| APIApplicationCommandBasicOption;
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-interaction-data-option-structure
+ */
+export type APIApplicationCommandInteractionDataOption =
+	| APIApplicationCommandInteractionDataSubcommandOption
+	| APIApplicationCommandInteractionDataSubcommandGroupOption
+	| APIApplicationCommandInteractionDataBasicOption;
+
+export type APIApplicationCommandInteractionDataBasicOption =
+	| APIApplicationCommandInteractionDataStringOption
+	| APIApplicationCommandInteractionDataIntegerOption
+	| APIApplicationCommandInteractionDataBooleanOption
+	| APIApplicationCommandInteractionDataUserOption
+	| APIApplicationCommandInteractionDataChannelOption
+	| APIApplicationCommandInteractionDataRoleOption
+	| APIApplicationCommandInteractionDataMentionableOption
+	| APIApplicationCommandInteractionDataNumberOption
+	| APIApplicationCommandInteractionDataAttachmentOption;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-data
+ */
+export interface APIChatInputApplicationCommandInteractionData
+	extends APIBaseApplicationCommandInteractionData<ApplicationCommandType.ChatInput> {
+	options?: APIApplicationCommandInteractionDataOption[];
+	resolved?: APIInteractionDataResolved;
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIChatInputApplicationCommandInteraction =
+	APIApplicationCommandInteractionWrapper<APIChatInputApplicationCommandInteractionData>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIChatInputApplicationCommandDMInteraction =
+	APIDMInteractionWrapper<APIChatInputApplicationCommandInteraction>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIChatInputApplicationCommandGuildInteraction =
+	APIGuildInteractionWrapper<APIChatInputApplicationCommandInteraction>;

payloads/v9/_interactions/_applicationCommands/contextMenu.ts

@@ -0,0 +1,91 @@
+import type { APIBaseApplicationCommandInteractionData } from './internals';
+import type { Snowflake } from '../../../../globals';
+import type { APIMessage } from '../../channel';
+import type { APIApplicationCommandInteractionWrapper, ApplicationCommandType } from '../applicationCommands';
+import type { APIDMInteractionWrapper, APIGuildInteractionWrapper, APIUserInteractionDataResolved } from '../base';
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-data
+ */
+export interface APIUserApplicationCommandInteractionData
+	extends APIBaseApplicationCommandInteractionData<ApplicationCommandType.User> {
+	target_id: Snowflake;
+	resolved: APIUserInteractionDataResolved;
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-data
+ */
+export interface APIMessageApplicationCommandInteractionData
+	extends APIBaseApplicationCommandInteractionData<ApplicationCommandType.Message> {
+	target_id: Snowflake;
+	resolved: APIMessageApplicationCommandInteractionDataResolved;
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-resolved-data-structure
+ */
+export interface APIMessageApplicationCommandInteractionDataResolved {
+	messages: Record<Snowflake, APIMessage>;
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-data
+ */
+export type APIContextMenuInteractionData =
+	| APIUserApplicationCommandInteractionData
+	| APIMessageApplicationCommandInteractionData;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIUserApplicationCommandInteraction =
+	APIApplicationCommandInteractionWrapper<APIUserApplicationCommandInteractionData>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIUserApplicationCommandDMInteraction = APIDMInteractionWrapper<APIUserApplicationCommandInteraction>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIUserApplicationCommandGuildInteraction =
+	APIGuildInteractionWrapper<APIUserApplicationCommandInteraction>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIMessageApplicationCommandInteraction =
+	APIApplicationCommandInteractionWrapper<APIMessageApplicationCommandInteractionData>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIMessageApplicationCommandDMInteraction =
+	APIDMInteractionWrapper<APIMessageApplicationCommandInteraction>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIMessageApplicationCommandGuildInteraction =
+	APIGuildInteractionWrapper<APIMessageApplicationCommandInteraction>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIContextMenuInteraction = APIUserApplicationCommandInteraction | APIMessageApplicationCommandInteraction;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIContextMenuDMInteraction =
+	| APIUserApplicationCommandDMInteraction
+	| APIMessageApplicationCommandDMInteraction;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIContextMenuGuildInteraction =
+	| APIUserApplicationCommandGuildInteraction
+	| APIMessageApplicationCommandGuildInteraction;

payloads/v9/_interactions/_applicationCommands/internals.ts

@@ -0,0 +1,9 @@
+import type { Snowflake } from '../../../../globals';
+import type { ApplicationCommandType } from '../applicationCommands';
+
+export interface APIBaseApplicationCommandInteractionData<Type extends ApplicationCommandType> {
+	id: Snowflake;
+	type: Type;
+	name: string;
+	guild_id?: Snowflake;
+}

payloads/v9/_interactions/_applicationCommands/permissions.ts

@@ -0,0 +1,58 @@
+import type { Snowflake } from '../../../../globals';
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-guild-application-command-permissions-structure
+ */
+export interface APIGuildApplicationCommandPermissions {
+	/**
+	 * The id of the command or the application id if that permission applies to all commands
+	 */
+	id: Snowflake;
+	/**
+	 * The id of the application the command belongs to
+	 */
+	application_id: Snowflake;
+	/**
+	 * The id of the guild
+	 */
+	guild_id: Snowflake;
+	/**
+	 * The permissions for the command in the guild
+	 */
+	permissions: APIApplicationCommandPermission[];
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permissions-structure
+ */
+export interface APIApplicationCommandPermission {
+	/**
+	 * The id of the role, user or channel. Can also be a permission constant
+	 */
+	id: Snowflake;
+	/**
+	 * Role, user or channel
+	 */
+	type: ApplicationCommandPermissionType;
+	/**
+	 * `true` to allow, `false`, to disallow
+	 */
+	permission: boolean;
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permission-type
+ */
+export enum ApplicationCommandPermissionType {
+	Role = 1,
+	User,
+	Channel,
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permissions-constants
+ */
+export const APIApplicationCommandPermissionsConstant = {
+	Everyone: (guildId: string | bigint): Snowflake => String(guildId),
+	AllChannels: (guildId: string | bigint): Snowflake => String(BigInt(guildId) - BigInt(1)),
+};

payloads/v9/_interactions/applicationCommands.ts

@@ -0,0 +1,138 @@
+import type {
+	APIApplicationCommandOption,
+	APIChatInputApplicationCommandDMInteraction,
+	APIChatInputApplicationCommandGuildInteraction,
+	APIChatInputApplicationCommandInteraction,
+	APIChatInputApplicationCommandInteractionData,
+} from './_applicationCommands/chatInput';
+import type {
+	APIContextMenuDMInteraction,
+	APIContextMenuGuildInteraction,
+	APIContextMenuInteraction,
+	APIContextMenuInteractionData,
+} from './_applicationCommands/contextMenu';
+import type { APIBaseInteraction } from './base';
+import type { InteractionType } from './responses';
+import type { Permissions, Snowflake } from '../../../globals';
+import type { LocalizationMap } from '../../../v9';
+
+export * from './_applicationCommands/chatInput';
+export * from './_applicationCommands/contextMenu';
+export * from './_applicationCommands/permissions';
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-object
+ */
+export interface APIApplicationCommand {
+	/**
+	 * Unique id of the command
+	 */
+	id: Snowflake;
+	/**
+	 * Type of the command
+	 */
+	type: ApplicationCommandType;
+	/**
+	 * Unique id of the parent application
+	 */
+	application_id: Snowflake;
+	/**
+	 * Guild id of the command, if not global
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * 1-32 character name; `CHAT_INPUT` command names must be all lowercase matching `^[-_\p{L}\p{N}\p{sc=Deva}\p{sc=Thai}]{1,32}$`
+	 */
+	name: string;
+	/**
+	 * Localization dictionary for the name field. Values follow the same restrictions as name
+	 */
+	name_localizations?: LocalizationMap | null;
+	/**
+	 * The localized name
+	 */
+	name_localized?: string;
+	/**
+	 * 1-100 character description for `CHAT_INPUT` commands, empty string for `USER` and `MESSAGE` commands
+	 */
+	description: string;
+	/**
+	 * Localization dictionary for the description field. Values follow the same restrictions as description
+	 */
+	description_localizations?: LocalizationMap | null;
+	/**
+	 * The localized description
+	 */
+	description_localized?: string;
+	/**
+	 * The parameters for the `CHAT_INPUT` command, max 25
+	 */
+	options?: APIApplicationCommandOption[];
+	/**
+	 * Set of permissions represented as a bitset
+	 */
+	default_member_permissions: Permissions | null;
+	/**
+	 * Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible
+	 */
+	dm_permission?: boolean;
+	/**
+	 * Whether the command is enabled by default when the app is added to a guild
+	 *
+	 * If missing, this property should be assumed as `true`
+	 * @deprecated Use `dm_permission` and/or `default_member_permissions` instead
+	 */
+	default_permission?: boolean;
+	/**
+	 * Indicates whether the command is age-restricted, defaults to `false`
+	 */
+	nsfw?: boolean;
+	/**
+	 * Autoincrementing version identifier updated during substantial record changes
+	 */
+	version: Snowflake;
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-types
+ */
+export enum ApplicationCommandType {
+	ChatInput = 1,
+	User,
+	Message,
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-data
+ */
+export type APIApplicationCommandInteractionData =
+	| APIChatInputApplicationCommandInteractionData
+	| APIContextMenuInteractionData;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIApplicationCommandInteractionWrapper<Data extends APIApplicationCommandInteractionData> =
+	APIBaseInteraction<InteractionType.ApplicationCommand, Data> &
+		Required<
+			Pick<APIBaseInteraction<InteractionType.ApplicationCommand, Data>, 'channel_id' | 'data' | 'app_permissions'>
+		>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIApplicationCommandInteraction = APIChatInputApplicationCommandInteraction | APIContextMenuInteraction;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIApplicationCommandDMInteraction =
+	| APIChatInputApplicationCommandDMInteraction
+	| APIContextMenuDMInteraction;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIApplicationCommandGuildInteraction =
+	| APIChatInputApplicationCommandGuildInteraction
+	| APIContextMenuGuildInteraction;

payloads/v9/_interactions/autocomplete.ts

@@ -0,0 +1,33 @@
+import type {
+	APIBaseInteraction,
+	APIChatInputApplicationCommandInteractionData,
+	APIDMInteractionWrapper,
+	APIGuildInteractionWrapper,
+	InteractionType,
+} from '../index';
+
+export type APIApplicationCommandAutocompleteInteraction = APIBaseInteraction<
+	InteractionType.ApplicationCommandAutocomplete,
+	APIChatInputApplicationCommandInteractionData
+> &
+	Required<
+		Pick<
+			APIBaseInteraction<
+				InteractionType.ApplicationCommandAutocomplete,
+				Required<Pick<APIChatInputApplicationCommandInteractionData, 'options'>>
+			>,
+			'data'
+		>
+	>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIApplicationCommandAutocompleteDMInteraction =
+	APIDMInteractionWrapper<APIApplicationCommandAutocompleteInteraction>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIApplicationCommandAutocompleteGuildInteraction =
+	APIGuildInteractionWrapper<APIApplicationCommandAutocompleteInteraction>;

payloads/v9/_interactions/base.ts

@@ -0,0 +1,174 @@
+import type { InteractionType } from './responses';
+import type { Permissions, Snowflake } from '../../../globals';
+import type { APIRole, LocaleString } from '../../../v9';
+import type { APIAttachment, APIMessage, APIPartialChannel, APIThreadMetadata } from '../channel';
+import type { APIGuildMember } from '../guild';
+import type { APIUser } from '../user';
+
+export type PartialAPIMessageInteractionGuildMember = Pick<
+	APIGuildMember,
+	| 'roles'
+	| 'premium_since'
+	| 'pending'
+	| 'nick'
+	| 'mute'
+	| 'joined_at'
+	| 'deaf'
+	| 'communication_disabled_until'
+	| 'avatar'
+>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#message-interaction-object
+ */
+export interface APIMessageInteraction {
+	/**
+	 * ID of the interaction
+	 */
+	id: Snowflake;
+	/**
+	 * The type of interaction
+	 */
+	type: InteractionType;
+	/**
+	 * The name of the application command, including subcommands and subcommand groups
+	 */
+	name: string;
+	/**
+	 * The user who invoked the interaction
+	 */
+	user: APIUser;
+	/**
+	 * The guild member who invoked the interaction, only sent in MESSAGE_CREATE events
+	 */
+	member?: PartialAPIMessageInteractionGuildMember;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild#guild-member-object
+ */
+export interface APIInteractionGuildMember extends APIGuildMember {
+	permissions: Permissions;
+	user: APIUser;
+}
+
+// INTERACTIONS RECEIVED
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export interface APIBaseInteraction<Type extends InteractionType, Data> {
+	/**
+	 * ID of the interaction
+	 */
+	id: Snowflake;
+	/**
+	 * ID of the application this interaction is for
+	 */
+	application_id: Snowflake;
+	/**
+	 * The type of interaction
+	 */
+	type: Type;
+	/**
+	 * The command data payload
+	 */
+	data?: Data;
+	/**
+	 * The guild it was sent from
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * The channel it was sent from
+	 */
+	channel_id?: Snowflake;
+	/**
+	 * Guild member data for the invoking user, including permissions
+	 *
+	 * **This is only sent when an interaction is invoked in a guild**
+	 */
+	member?: APIInteractionGuildMember;
+	/**
+	 * User object for the invoking user, if invoked in a DM
+	 */
+	user?: APIUser;
+	/**
+	 * A continuation token for responding to the interaction
+	 */
+	token: string;
+	/**
+	 * Read-only property, always `1`
+	 */
+	version: 1;
+	/**
+	 * For components, the message they were attached to
+	 */
+	message?: APIMessage;
+	/**
+	 * Bitwise set of permissions the app or bot has within the channel the interaction was sent from
+	 */
+	app_permissions?: Permissions;
+	/**
+	 * The selected language of the invoking user
+	 */
+	locale: LocaleString;
+	/**
+	 * The guild's preferred locale, if invoked in a guild
+	 */
+	guild_locale?: LocaleString;
+}
+
+export type APIDMInteractionWrapper<Original extends APIBaseInteraction<InteractionType, unknown>> = Omit<
+	Original,
+	'member' | 'guild_id'
+> &
+	Required<Pick<Original, 'user'>>;
+
+export type APIGuildInteractionWrapper<Original extends APIBaseInteraction<InteractionType, unknown>> = Omit<
+	Original,
+	'user'
+> &
+	Required<Pick<Original, 'member' | 'guild_id'>>;
+
+/**
+ * https://discord.com/developers/docs/resources/channel#channel-object
+ */
+export interface APIInteractionDataResolvedChannel extends Required<APIPartialChannel> {
+	thread_metadata?: APIThreadMetadata | null;
+	permissions: Permissions;
+	parent_id?: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild#guild-member-object
+ */
+export interface APIInteractionDataResolvedGuildMember extends Omit<APIGuildMember, 'user' | 'deaf' | 'mute'> {
+	permissions: Permissions;
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-resolved-data-structure
+ */
+export interface APIInteractionDataResolved {
+	users?: Record<Snowflake, APIUser>;
+	roles?: Record<Snowflake, APIRole>;
+	members?: Record<Snowflake, APIInteractionDataResolvedGuildMember>;
+	channels?: Record<Snowflake, APIInteractionDataResolvedChannel>;
+	attachments?: Record<Snowflake, APIAttachment>;
+}
+
+/**
+ * @deprecated Renamed to `APIInteractionDataResolved`
+ */
+export type APIChatInputApplicationCommandInteractionDataResolved = APIInteractionDataResolved;
+
+/**
+ * `users` and optional `members` from APIInteractionDataResolved, for user commands and user selects
+ */
+export type APIUserInteractionDataResolved = Required<Pick<APIInteractionDataResolved, 'users'>> &
+	Pick<APIInteractionDataResolved, 'members'>;
+
+/**
+ * @deprecated Renamed to `APIUserInteractionDataResolved`
+ */
+export type APIUserApplicationCommandInteractionDataResolved = APIUserInteractionDataResolved;

payloads/v9/_interactions/messageComponents.ts

@@ -0,0 +1,97 @@
+import type {
+	APIDMInteractionWrapper,
+	APIGuildInteractionWrapper,
+	APIInteractionDataResolved,
+	APIUserInteractionDataResolved,
+} from './base';
+import type { Snowflake } from '../../../globals';
+import type { ComponentType } from '../channel';
+import type { APIBaseInteraction, InteractionType } from '../interactions';
+
+export type APIMessageComponentInteraction = APIBaseInteraction<
+	InteractionType.MessageComponent,
+	APIMessageComponentInteractionData
+> &
+	Required<
+		Pick<
+			APIBaseInteraction<InteractionType.MessageComponent, APIMessageComponentInteractionData>,
+			'channel_id' | 'data' | 'app_permissions' | 'message'
+		>
+	>;
+
+export type APIMessageComponentButtonInteraction = APIBaseInteraction<
+	InteractionType.MessageComponent,
+	APIMessageButtonInteractionData
+> &
+	Required<
+		Pick<
+			APIBaseInteraction<InteractionType.MessageComponent, APIMessageButtonInteractionData>,
+			'channel_id' | 'data' | 'app_permissions' | 'message'
+		>
+	>;
+
+export type APIMessageComponentSelectMenuInteraction = APIBaseInteraction<
+	InteractionType.MessageComponent,
+	APIMessageSelectMenuInteractionData
+> &
+	Required<
+		Pick<
+			APIBaseInteraction<InteractionType.MessageComponent, APIMessageSelectMenuInteractionData>,
+			'channel_id' | 'data' | 'app_permissions' | 'message'
+		>
+	>;
+
+export type APIMessageComponentInteractionData = APIMessageButtonInteractionData | APIMessageSelectMenuInteractionData;
+
+export interface APIMessageComponentBaseInteractionData<CType extends ComponentType> {
+	/**
+	 * The `custom_id` of the component
+	 */
+	custom_id: string;
+	/**
+	 * The type of the component
+	 */
+	component_type: CType;
+}
+
+export type APIMessageButtonInteractionData = APIMessageComponentBaseInteractionData<ComponentType.Button>;
+
+export interface APIMessageStringSelectInteractionData
+	extends APIMessageComponentBaseInteractionData<ComponentType.StringSelect> {
+	values: string[];
+}
+
+export interface APIMessageUserSelectInteractionData
+	extends APIMessageComponentBaseInteractionData<ComponentType.UserSelect> {
+	values: Snowflake[];
+	resolved: APIUserInteractionDataResolved;
+}
+
+export interface APIMessageRoleSelectInteractionData
+	extends APIMessageComponentBaseInteractionData<ComponentType.RoleSelect> {
+	values: Snowflake[];
+	resolved: Required<Pick<APIInteractionDataResolved, 'roles'>>;
+}
+
+export interface APIMessageMentionableSelectInteractionData
+	extends APIMessageComponentBaseInteractionData<ComponentType.MentionableSelect> {
+	values: Snowflake[];
+	resolved: Pick<APIInteractionDataResolved, 'users' | 'members' | 'roles'>;
+}
+
+export interface APIMessageChannelSelectInteractionData
+	extends APIMessageComponentBaseInteractionData<ComponentType.ChannelSelect> {
+	values: Snowflake[];
+	resolved: Required<Pick<APIInteractionDataResolved, 'channels'>>;
+}
+
+export type APIMessageSelectMenuInteractionData =
+	| APIMessageStringSelectInteractionData
+	| APIMessageUserSelectInteractionData
+	| APIMessageRoleSelectInteractionData
+	| APIMessageMentionableSelectInteractionData
+	| APIMessageChannelSelectInteractionData;
+
+export type APIMessageComponentDMInteraction = APIDMInteractionWrapper<APIMessageComponentInteraction>;
+
+export type APIMessageComponentGuildInteraction = APIGuildInteractionWrapper<APIMessageComponentInteraction>;

payloads/v9/_interactions/modalSubmit.ts

@@ -0,0 +1,49 @@
+import type { APIActionRowComponent, APIModalActionRowComponent } from '../channel';
+import type {
+	APIBaseInteraction,
+	APIDMInteractionWrapper,
+	APIGuildInteractionWrapper,
+	ComponentType,
+	InteractionType,
+} from '../index';
+
+export interface ModalSubmitComponent {
+	type: ComponentType;
+	custom_id: string;
+	value: string;
+}
+
+export interface ModalSubmitActionRowComponent
+	extends Omit<APIActionRowComponent<APIModalActionRowComponent>, 'components'> {
+	components: ModalSubmitComponent[];
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-modal-submit-data-structure
+ */
+export interface APIModalSubmission {
+	/**
+	 * A developer-defined identifier for the component, max 100 characters
+	 */
+	custom_id: string;
+	/**
+	 * A list of child components
+	 */
+	components: ModalSubmitActionRowComponent[];
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIModalSubmitInteraction = APIBaseInteraction<InteractionType.ModalSubmit, APIModalSubmission> &
+	Required<Pick<APIBaseInteraction<InteractionType.ModalSubmit, APIModalSubmission>, 'data'>>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIModalSubmitDMInteraction = APIDMInteractionWrapper<APIModalSubmitInteraction>;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIModalSubmitGuildInteraction = APIGuildInteractionWrapper<APIModalSubmitInteraction>;

payloads/v9/_interactions/ping.ts

@@ -0,0 +1,4 @@
+import type { APIBaseInteraction } from './base';
+import type { InteractionType } from './responses';
+
+export type APIPingInteraction = Omit<APIBaseInteraction<InteractionType.Ping, never>, 'locale'>;

payloads/v9/_interactions/responses.ts

@@ -0,0 +1,124 @@
+import type { APIApplicationCommandOptionChoice } from './applicationCommands';
+import type { RESTPostAPIWebhookWithTokenJSONBody } from '../../../v9';
+import type { APIActionRowComponent, APIModalActionRowComponent } from '../channel';
+import type { MessageFlags } from '../index';
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-type
+ */
+export enum InteractionType {
+	Ping = 1,
+	ApplicationCommand,
+	MessageComponent,
+	ApplicationCommandAutocomplete,
+	ModalSubmit,
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object
+ */
+export type APIInteractionResponse =
+	| APIInteractionResponsePong
+	| APIInteractionResponseChannelMessageWithSource
+	| APIInteractionResponseDeferredChannelMessageWithSource
+	| APIInteractionResponseDeferredMessageUpdate
+	| APIInteractionResponseUpdateMessage
+	| APIApplicationCommandAutocompleteResponse
+	| APIModalInteractionResponse;
+
+export interface APIInteractionResponsePong {
+	type: InteractionResponseType.Pong;
+}
+
+export interface APIApplicationCommandAutocompleteResponse {
+	type: InteractionResponseType.ApplicationCommandAutocompleteResult;
+	data: APICommandAutocompleteInteractionResponseCallbackData;
+}
+
+export interface APIModalInteractionResponse {
+	type: InteractionResponseType.Modal;
+	data: APIModalInteractionResponseCallbackData;
+}
+
+export interface APIInteractionResponseChannelMessageWithSource {
+	type: InteractionResponseType.ChannelMessageWithSource;
+	data: APIInteractionResponseCallbackData;
+}
+
+export interface APIInteractionResponseDeferredChannelMessageWithSource {
+	type: InteractionResponseType.DeferredChannelMessageWithSource;
+	data?: Pick<APIInteractionResponseCallbackData, 'flags'>;
+}
+
+export interface APIInteractionResponseDeferredMessageUpdate {
+	type: InteractionResponseType.DeferredMessageUpdate;
+}
+
+export interface APIInteractionResponseUpdateMessage {
+	type: InteractionResponseType.UpdateMessage;
+	data?: APIInteractionResponseCallbackData;
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-type
+ */
+export enum InteractionResponseType {
+	/**
+	 * ACK a `Ping`
+	 */
+	Pong = 1,
+	/**
+	 * Respond to an interaction with a message
+	 */
+	ChannelMessageWithSource = 4,
+	/**
+	 * ACK an interaction and edit to a response later, the user sees a loading state
+	 */
+	DeferredChannelMessageWithSource,
+	/**
+	 * ACK a button interaction and update it to a loading state
+	 */
+	DeferredMessageUpdate,
+	/**
+	 * ACK a button interaction and edit the message to which the button was attached
+	 */
+	UpdateMessage,
+	/**
+	 * For autocomplete interactions
+	 */
+	ApplicationCommandAutocompleteResult,
+	/**
+	 * Respond to an interaction with an modal for a user to fill-out
+	 */
+	Modal,
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-data-structure
+ */
+export type APIInteractionResponseCallbackData = Omit<
+	RESTPostAPIWebhookWithTokenJSONBody,
+	'username' | 'avatar_url'
+> & { flags?: MessageFlags };
+
+export interface APICommandAutocompleteInteractionResponseCallbackData {
+	choices?: APIApplicationCommandOptionChoice[];
+}
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-modal
+ */
+export interface APIModalInteractionResponseCallbackData {
+	/**
+	 * A developer-defined identifier for the component, max 100 characters
+	 */
+	custom_id: string;
+	/**
+	 * The title of the popup modal
+	 */
+	title: string;
+	/**
+	 * Between 1 and 5 (inclusive) components that make up the modal
+	 */
+	components: APIActionRowComponent<APIModalActionRowComponent>[];
+}

payloads/v9/application.ts

@@ -0,0 +1,252 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/application
+ */
+
+import type { OAuth2Scopes } from './oauth2';
+import type { APITeam } from './teams';
+import type { APIUser } from './user';
+import type { Permissions, Snowflake } from '../../globals';
+import type { LocalizationMap } from '../common';
+
+/**
+ * https://discord.com/developers/docs/resources/application#application-object
+ */
+export interface APIApplication {
+	/**
+	 * The id of the app
+	 */
+	id: Snowflake;
+	/**
+	 * The name of the app
+	 */
+	name: string;
+	/**
+	 * The icon hash of the app
+	 */
+	icon: string | null;
+	/**
+	 * The description of the app
+	 */
+	description: string;
+	/**
+	 * An array of rpc origin urls, if rpc is enabled
+	 */
+	rpc_origins?: string[];
+	/**
+	 * When `false` only app owner can join the app's bot to guilds
+	 */
+	bot_public: boolean;
+	/**
+	 * When `true` the app's bot will only join upon completion of the full oauth2 code grant flow
+	 */
+	bot_require_code_grant: boolean;
+	/**
+	 * The url of the application's terms of service
+	 */
+	terms_of_service_url?: string;
+	/**
+	 * The url of the application's privacy policy
+	 */
+	privacy_policy_url?: string;
+	/**
+	 * Partial user object containing info on the owner of the application
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 */
+	owner?: APIUser;
+	/**
+	 * An empty string
+	 *
+	 * @deprecated This field will be removed in v11
+	 */
+	summary: string;
+	/**
+	 * The hexadecimal encoded key for verification in interactions and the GameSDK's GetTicket function
+	 *
+	 * See https://discord.com/developers/docs/game-sdk/applications#getticket
+	 */
+	verify_key: string;
+	/**
+	 * The team this application belongs to
+	 *
+	 * See https://discord.com/developers/docs/topics/teams#data-models-team-object
+	 */
+	team: APITeam | null;
+	/**
+	 * If this application is a game sold on Discord, this field will be the guild to which it has been linked
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * If this application is a game sold on Discord, this field will be the id of the "Game SKU" that is created, if exists
+	 */
+	primary_sku_id?: Snowflake;
+	/**
+	 * If this application is a game sold on Discord, this field will be the URL slug that links to the store page
+	 */
+	slug?: string;
+	/**
+	 * If this application is a game sold on Discord, this field will be the hash of the image on store embeds
+	 */
+	cover_image?: string;
+	/**
+	 * The application's public flags
+	 *
+	 * See https://discord.com/developers/docs/resources/application#application-object-application-flags
+	 */
+	flags: ApplicationFlags;
+	/**
+	 * Up to 5 tags describing the content and functionality of the application
+	 */
+	tags?: [string, string?, string?, string?, string?];
+	/**
+	 * Settings for the application's default in-app authorization link, if enabled
+	 */
+	install_params?: APIApplicationInstallParams;
+	/**
+	 * The application's default custom authorization link, if enabled
+	 */
+	custom_install_url?: string;
+	/**
+	 * The application's role connection verification entry point,
+	 * which when configured will render the app as a verification method in the guild role verification configuration
+	 */
+	role_connections_verification_url?: string;
+}
+
+export interface APIApplicationInstallParams {
+	scopes: OAuth2Scopes[];
+	permissions: Permissions;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/application#application-object-application-flags
+ */
+export enum ApplicationFlags {
+	/**
+	 * @unstable
+	 */
+	EmbeddedReleased = 1 << 1,
+	/**
+	 * @unstable
+	 */
+	ManagedEmoji = 1 << 2,
+	/**
+	 * @unstable
+	 */
+	GroupDMCreate = 1 << 4,
+	/**
+	 * @unstable
+	 */
+	RPCHasConnected = 1 << 11,
+	/**
+	 * Intent required for bots in 100 or more servers to receive `presence_update` events
+	 */
+	GatewayPresence = 1 << 12,
+	/**
+	 * Intent required for bots in under 100 servers to receive `presence_update` events, found in Bot Settings
+	 */
+	GatewayPresenceLimited = 1 << 13,
+	/**
+	 * Intent required for bots in 100 or more servers to receive member-related events like `guild_member_add`.
+	 * See list of member-related events [under `GUILD_MEMBERS`](https://discord.com/developers/docs/topics/gateway#list-of-intents)
+	 */
+	GatewayGuildMembers = 1 << 14,
+	/**
+	 * Intent required for bots in under 100 servers to receive member-related events like `guild_member_add`, found in Bot Settings.
+	 * See list of member-related events [under `GUILD_MEMBERS`](https://discord.com/developers/docs/topics/gateway#list-of-intents)
+	 */
+	GatewayGuildMembersLimited = 1 << 15,
+	/**
+	 * Indicates unusual growth of an app that prevents verification
+	 */
+	VerificationPendingGuildLimit = 1 << 16,
+	/**
+	 * Indicates if an app is embedded within the Discord client (currently unavailable publicly)
+	 */
+	Embedded = 1 << 17,
+	/**
+	 * Intent required for bots in 100 or more servers to receive [message content](https://support-dev.discord.com/hc/en-us/articles/4404772028055)
+	 */
+	GatewayMessageContent = 1 << 18,
+	/**
+	 * Intent required for bots in under 100 servers to receive [message content](https://support-dev.discord.com/hc/en-us/articles/4404772028055),
+	 * found in Bot Settings
+	 */
+	GatewayMessageContentLimited = 1 << 19,
+	/**
+	 * @unstable
+	 */
+	EmbeddedFirstParty = 1 << 20,
+	/**
+	 * Indicates if an app has registered global [application commands](https://discord.com/developers/docs/interactions/application-commands)
+	 */
+	ApplicationCommandBadge = 1 << 23,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object-application-role-connection-metadata-structure
+ */
+export interface APIApplicationRoleConnectionMetadata {
+	/**
+	 * Type of metadata value
+	 */
+	type: ApplicationRoleConnectionMetadataType;
+	/**
+	 * Dictionary key for the metadata field (must be `a-z`, `0-9`, or `_` characters; 1-50 characters)
+	 */
+	key: string;
+	/**
+	 * Name of the metadata field (1-100 characters)
+	 */
+	name: string;
+	/**
+	 * Translations of the name
+	 */
+	name_localizations?: LocalizationMap;
+	/**
+	 * Description of the metadata field (1-200 characters)
+	 */
+	description: string;
+	/**
+	 * Translations of the description
+	 */
+	description_localizations?: LocalizationMap;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object-application-role-connection-metadata-type
+ */
+export enum ApplicationRoleConnectionMetadataType {
+	/**
+	 * The metadata value (`integer`) is less than or equal to the guild's configured value (`integer`)
+	 */
+	IntegerLessThanOrEqual = 1,
+	/**
+	 * The metadata value (`integer`) is greater than or equal to the guild's configured value (`integer`)
+	 */
+	IntegerGreaterThanOrEqual,
+	/**
+	 * The metadata value (`integer`) is equal to the guild's configured value (`integer`)
+	 */
+	IntegerEqual,
+	/**
+	 * The metadata value (`integer`) is not equal to the guild's configured value (`integer`)
+	 */
+	IntegerNotEqual,
+	/**
+	 * The metadata value (`ISO8601 string`) is less than or equal to the guild's configured value (`integer`; days before current date)
+	 */
+	DatetimeLessThanOrEqual,
+	/**
+	 * The metadata value (`ISO8601 string`) is greater than or equal to the guild's configured value (`integer`; days before current date)
+	 */
+	DatetimeGreaterThanOrEqual,
+	/**
+	 * The metadata value (`integer`) is equal to the guild's configured value (`integer`; `1`)
+	 */
+	BooleanEqual,
+	/**
+	 * The metadata value (`integer`) is not equal to the guild's configured value (`integer`; `1`)
+	 */
+	BooleanNotEqual,
+}

payloads/v9/auditLog.ts

@@ -0,0 +1,811 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/audit-log
+ */
+
+import type {
+	APIAutoModerationAction,
+	APIAutoModerationRule,
+	APIAutoModerationRuleTriggerMetadata,
+	AutoModerationRuleEventType,
+	AutoModerationRuleTriggerType,
+} from './autoModeration';
+import type { APIChannel, APIOverwrite } from './channel';
+import type {
+	APIGuildIntegration,
+	GuildDefaultMessageNotifications,
+	GuildExplicitContentFilter,
+	GuildMFALevel,
+	GuildVerificationLevel,
+	IntegrationExpireBehavior,
+} from './guild';
+import type {
+	APIGuildScheduledEvent,
+	GuildScheduledEventEntityType,
+	GuildScheduledEventStatus,
+} from './guildScheduledEvent';
+import type { APIApplicationCommand } from './interactions';
+import type { APIRole } from './permissions';
+import type { StageInstancePrivacyLevel } from './stageInstance';
+import type { StickerFormatType } from './sticker';
+import type { APIUser } from './user';
+import type { APIWebhook } from './webhook';
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/resources/audit-log#audit-log-object-audit-log-structure
+ */
+export interface APIAuditLog {
+	/**
+	 * List of application commands found in the audit log
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands#application-command-object
+	 */
+	application_commands: APIApplicationCommand[];
+	/**
+	 * Webhooks found in the audit log
+	 *
+	 * See https://discord.com/developers/docs/resources/webhook#webhook-object
+	 */
+	webhooks: APIWebhook[];
+	/**
+	 * Users found in the audit log
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 */
+	users: APIUser[];
+	/**
+	 * Audit log entries
+	 *
+	 * See https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object
+	 */
+	audit_log_entries: APIAuditLogEntry[];
+	/**
+	 * List of auto moderation rules referenced in the audit log
+	 *
+	 * See https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object
+	 */
+	auto_moderation_rules: APIAutoModerationRule[];
+	/**
+	 * Partial integration objects
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#integration-object
+	 */
+	integrations: APIGuildIntegration[];
+	/**
+	 * Threads found in the audit log
+	 *
+	 * Threads referenced in THREAD_CREATE and THREAD_UPDATE events are included in the threads map, since archived threads might not be kept in memory by clients.
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	threads: APIChannel[];
+	/**
+	 * The guild scheduled events in the audit log
+	 *
+	 * See https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object
+	 */
+	guild_scheduled_events: APIGuildScheduledEvent[];
+}
+
+/**
+ * https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-audit-log-entry-structure
+ */
+export interface APIAuditLogEntry {
+	/**
+	 * ID of the affected entity (webhook, user, role, etc.)
+	 */
+	target_id: string | null;
+	/**
+	 * Changes made to the `target_id`
+	 *
+	 * See https://discord.com/developers/docs/resources/audit-log#audit-log-change-object
+	 */
+	changes?: APIAuditLogChange[];
+	/**
+	 * The user who made the changes
+	 *
+	 * This can be `null` in some cases (webhooks deleting themselves by using their own token, for example)
+	 */
+	user_id: Snowflake | null;
+	/**
+	 * ID of the entry
+	 */
+	id: Snowflake;
+	/**
+	 * Type of action that occurred
+	 *
+	 * See https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-audit-log-events
+	 */
+	action_type: AuditLogEvent;
+	/**
+	 * Additional info for certain action types
+	 *
+	 * See https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-optional-audit-entry-info
+	 */
+	options?: APIAuditLogOptions;
+	/**
+	 * The reason for the change (0-512 characters)
+	 */
+	reason?: string;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-audit-log-events
+ */
+export enum AuditLogEvent {
+	GuildUpdate = 1,
+
+	ChannelCreate = 10,
+	ChannelUpdate,
+	ChannelDelete,
+	ChannelOverwriteCreate,
+	ChannelOverwriteUpdate,
+	ChannelOverwriteDelete,
+
+	MemberKick = 20,
+	MemberPrune,
+	MemberBanAdd,
+	MemberBanRemove,
+	MemberUpdate,
+	MemberRoleUpdate,
+	MemberMove,
+	MemberDisconnect,
+	BotAdd,
+
+	RoleCreate = 30,
+	RoleUpdate,
+	RoleDelete,
+
+	InviteCreate = 40,
+	InviteUpdate,
+	InviteDelete,
+
+	WebhookCreate = 50,
+	WebhookUpdate,
+	WebhookDelete,
+
+	EmojiCreate = 60,
+	EmojiUpdate,
+	EmojiDelete,
+
+	MessageDelete = 72,
+	MessageBulkDelete,
+	MessagePin,
+	MessageUnpin,
+
+	IntegrationCreate = 80,
+	IntegrationUpdate,
+	IntegrationDelete,
+	StageInstanceCreate,
+	StageInstanceUpdate,
+	StageInstanceDelete,
+
+	StickerCreate = 90,
+	StickerUpdate,
+	StickerDelete,
+
+	GuildScheduledEventCreate = 100,
+	GuildScheduledEventUpdate,
+	GuildScheduledEventDelete,
+
+	ThreadCreate = 110,
+	ThreadUpdate,
+	ThreadDelete,
+
+	ApplicationCommandPermissionUpdate = 121,
+
+	AutoModerationRuleCreate = 140,
+	AutoModerationRuleUpdate,
+	AutoModerationRuleDelete,
+	AutoModerationBlockMessage,
+	AutoModerationFlagToChannel,
+	AutoModerationUserCommunicationDisabled,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-optional-audit-entry-info
+ */
+export interface APIAuditLogOptions {
+	/**
+	 * Name of the Auto Moderation rule that was triggered
+	 *
+	 * Present from:
+	 * - AUTO_MODERATION_BLOCK_MESSAGE
+	 * - AUTO_MODERATION_FLAG_TO_CHANNEL
+	 * - AUTO_MODERATION_USER_COMMUNICATION_DISABLED
+	 */
+	auto_moderation_rule_name?: string;
+	/**
+	 * Trigger type of the Auto Moderation rule that was triggered
+	 *
+	 * Present from:
+	 * - AUTO_MODERATION_BLOCK_MESSAGE
+	 * - AUTO_MODERATION_FLAG_TO_CHANNEL
+	 * - AUTO_MODERATION_USER_COMMUNICATION_DISABLED
+	 */
+	auto_moderation_rule_trigger_type?: AuditLogRuleTriggerType;
+	/**
+	 * Number of days after which inactive members were kicked
+	 *
+	 * Present from:
+	 * - MEMBER_PRUNE
+	 */
+	delete_member_days?: string;
+	/**
+	 * Number of members removed by the prune
+	 *
+	 * Present from:
+	 * - MEMBER_PRUNE
+	 */
+	members_removed?: string;
+
+	/**
+	 * Channel in which the entities were targeted
+	 *
+	 * Present from:
+	 * - MEMBER_MOVE
+	 * - MESSAGE_PIN
+	 * - MESSAGE_UNPIN
+	 * - MESSAGE_DELETE
+	 * - STAGE_INSTANCE_CREATE
+	 * - STAGE_INSTANCE_UPDATE
+	 * - STAGE_INSTANCE_DELETE
+	 * - AUTO_MODERATION_BLOCK_MESSAGE
+	 * - AUTO_MODERATION_FLAG_TO_CHANNEL
+	 * - AUTO_MODERATION_USER_COMMUNICATION_DISABLED
+	 */
+	channel_id?: Snowflake;
+
+	/**
+	 * ID of the message that was targeted
+	 *
+	 * Present from:
+	 * - MESSAGE_PIN
+	 * - MESSAGE_UNPIN
+	 */
+	message_id?: Snowflake;
+
+	/**
+	 * Number of entities that were targeted
+	 *
+	 * Present from:
+	 * - MESSAGE_DELETE
+	 * - MESSAGE_BULK_DELETE
+	 * - MEMBER_DISCONNECT
+	 * - MEMBER_MOVE
+	 */
+	count?: string;
+
+	/**
+	 * ID of the overwritten entity
+	 *
+	 * Present from:
+	 * - CHANNEL_OVERWRITE_CREATE
+	 * - CHANNEL_OVERWRITE_UPDATE
+	 * - CHANNEL_OVERWRITE_DELETE
+	 */
+	id?: Snowflake;
+
+	/**
+	 * Type of overwritten entity - "0" for "role" or "1" for "member"
+	 *
+	 * Present from:
+	 * - CHANNEL_OVERWRITE_CREATE
+	 * - CHANNEL_OVERWRITE_UPDATE
+	 * - CHANNEL_OVERWRITE_DELETE
+	 *
+	 * {@link AuditLogOptionsType}
+	 */
+	type?: AuditLogOptionsType;
+
+	/**
+	 * Name of the role
+	 *
+	 * Present from:
+	 * - CHANNEL_OVERWRITE_CREATE
+	 * - CHANNEL_OVERWRITE_UPDATE
+	 * - CHANNEL_OVERWRITE_DELETE
+	 *
+	 * **Present only if the {@link APIAuditLogOptions#type entry type} is "0"**
+	 */
+	role_name?: string;
+}
+
+export enum AuditLogOptionsType {
+	Role = '0',
+	Member = '1',
+}
+
+export type AuditLogRuleTriggerType = `${AutoModerationRuleTriggerType}`;
+
+/**
+ * https://discord.com/developers/docs/resources/audit-log#audit-log-change-object-audit-log-change-structure
+ */
+export type APIAuditLogChange =
+	| APIAuditLogChangeKeyName
+	| APIAuditLogChangeKeyDescription
+	| APIAuditLogChangeKeyIconHash
+	| APIAuditLogChangeKeyImageHash
+	| APIAuditLogChangeKeySplashHash
+	| APIAuditLogChangeKeyDiscoverySplashHash
+	| APIAuditLogChangeKeyBannerHash
+	| APIAuditLogChangeKeyOwnerId
+	| APIAuditLogChangeKeyRegion
+	| APIAuditLogChangeKeyPreferredLocale
+	| APIAuditLogChangeKeyAFKChannelId
+	| APIAuditLogChangeKeyAFKTimeout
+	| APIAuditLogChangeKeyRulesChannelId
+	| APIAuditLogChangeKeyPublicUpdatesChannelId
+	| APIAuditLogChangeKeyMFALevel
+	| APIAuditLogChangeKeyVerificationLevel
+	| APIAuditLogChangeKeyExplicitContentFilter
+	| APIAuditLogChangeKeyDefaultMessageNotifications
+	| APIAuditLogChangeKeyVanityURLCode
+	| APIAuditLogChangeKey$Add
+	| APIAuditLogChangeKey$Remove
+	| APIAuditLogChangeKeyPruneDeleteDays
+	| APIAuditLogChangeKeyWidgetEnabled
+	| APIAuditLogChangeKeyWidgetChannelId
+	| APIAuditLogChangeKeySystemChannelId
+	| APIAuditLogChangeKeyPosition
+	| APIAuditLogChangeKeyTopic
+	| APIAuditLogChangeKeyBitrate
+	| APIAuditLogChangeKeyPermissionOverwrites
+	| APIAuditLogChangeKeyNSFW
+	| APIAuditLogChangeKeyApplicationId
+	| APIAuditLogChangeKeyRateLimitPerUser
+	| APIAuditLogChangeKeyPermissions
+	| APIAuditLogChangeKeyColor
+	| APIAuditLogChangeKeyHoist
+	| APIAuditLogChangeKeyMentionable
+	| APIAuditLogChangeKeyAllow
+	| APIAuditLogChangeKeyDeny
+	| APIAuditLogChangeKeyCode
+	| APIAuditLogChangeKeyChannelId
+	| APIAuditLogChangeKeyInviterId
+	| APIAuditLogChangeKeyMaxUses
+	| APIAuditLogChangeKeyUses
+	| APIAuditLogChangeKeyMaxAge
+	| APIAuditLogChangeKeyTemporary
+	| APIAuditLogChangeKeyDeaf
+	| APIAuditLogChangeKeyMute
+	| APIAuditLogChangeKeyNick
+	| APIAuditLogChangeKeyAvatarHash
+	| APIAuditLogChangeKeyId
+	| APIAuditLogChangeKeyType
+	| APIAuditLogChangeKeyEnableEmoticons
+	| APIAuditLogChangeKeyExpireBehavior
+	| APIAuditLogChangeKeyExpireGracePeriod
+	| APIAuditLogChangeKeyUserLimit
+	| APIAuditLogChangeKeyPrivacyLevel
+	| APIAuditLogChangeKeyTags
+	| APIAuditLogChangeKeyFormatType
+	| APIAuditLogChangeKeyAsset
+	| APIAuditLogChangeKeyAvailable
+	| APIAuditLogChangeKeyGuildId
+	| APIAuditLogChangeKeyArchived
+	| APIAuditLogChangeKeyLocked
+	| APIAuditLogChangeKeyAutoArchiveDuration
+	| APIAuditLogChangeKeyDefaultAutoArchiveDuration
+	| APIAuditLogChangeKeyEntityType
+	| APIAuditLogChangeKeyStatus
+	| APIAuditLogChangeKeyLocation
+	| APIAuditLogChangeKeyCommunicationDisabledUntil
+	| APIAuditLogChangeKeyTriggerType
+	| APIAuditLogChangeKeyEventType
+	| APIAuditLogChangeKeyTriggerMetadata
+	| APIAuditLogChangeKeyActions
+	| APIAuditLogChangeKeyEnabled
+	| APIAuditLogChangeKeyExemptRoles
+	| APIAuditLogChangeKeyExemptChannels;
+
+/**
+ * Returned when an entity's name is changed
+ */
+export type APIAuditLogChangeKeyName = AuditLogChangeData<'name', string>;
+
+/**
+ * Returned when a guild's or sticker's or guild scheduled event's description is changed
+ */
+export type APIAuditLogChangeKeyDescription = AuditLogChangeData<'description', string>;
+
+/**
+ * Returned when a guild's icon is changed
+ */
+export type APIAuditLogChangeKeyIconHash = AuditLogChangeData<'icon_hash', string>;
+
+/**
+ * Returned when a guild's scheduled event's cover image is changed
+ */
+export type APIAuditLogChangeKeyImageHash = AuditLogChangeData<'image_hash', string>;
+
+/**
+ * Returned when a guild's splash is changed
+ */
+export type APIAuditLogChangeKeySplashHash = AuditLogChangeData<'splash_hash', string>;
+
+/**
+ * Returned when a guild's discovery splash is changed
+ */
+export type APIAuditLogChangeKeyDiscoverySplashHash = AuditLogChangeData<'discovery_splash_hash', string>;
+
+/**
+ * Returned when a guild's banner hash is changed
+ */
+export type APIAuditLogChangeKeyBannerHash = AuditLogChangeData<'banner_hash', string>;
+
+/**
+ * Returned when a guild's owner_id is changed
+ */
+export type APIAuditLogChangeKeyOwnerId = AuditLogChangeData<'owner_id', Snowflake>;
+
+/**
+ * Returned when a guild's region is changed
+ */
+export type APIAuditLogChangeKeyRegion = AuditLogChangeData<'region', string>;
+
+/**
+ * Returned when a guild's preferred_locale is changed
+ */
+export type APIAuditLogChangeKeyPreferredLocale = AuditLogChangeData<'preferred_locale', string>;
+
+/**
+ * Returned when a guild's afk_channel_id is changed
+ */
+export type APIAuditLogChangeKeyAFKChannelId = AuditLogChangeData<'afk_channel_id', Snowflake>;
+
+/**
+ * Returned when a guild's afk_timeout is changed
+ */
+export type APIAuditLogChangeKeyAFKTimeout = AuditLogChangeData<'afk_timeout', number>;
+
+/**
+ * Returned when a guild's rules_channel_id is changed
+ */
+export type APIAuditLogChangeKeyRulesChannelId = AuditLogChangeData<'rules_channel_id', string>;
+
+/**
+ * Returned when a guild's public_updates_channel_id is changed
+ */
+export type APIAuditLogChangeKeyPublicUpdatesChannelId = AuditLogChangeData<'public_updates_channel_id', string>;
+
+/**
+ * Returned when a guild's mfa_level is changed
+ */
+export type APIAuditLogChangeKeyMFALevel = AuditLogChangeData<'mfa_level', GuildMFALevel>;
+
+/**
+ * Returned when a guild's verification_level is changed
+ */
+export type APIAuditLogChangeKeyVerificationLevel = AuditLogChangeData<'verification_level', GuildVerificationLevel>;
+
+/**
+ * Returned when a guild's explicit_content_filter is changed
+ */
+export type APIAuditLogChangeKeyExplicitContentFilter = AuditLogChangeData<
+	'explicit_content_filter',
+	GuildExplicitContentFilter
+>;
+
+/**
+ * Returned when a guild's default_message_notifications is changed
+ */
+export type APIAuditLogChangeKeyDefaultMessageNotifications = AuditLogChangeData<
+	'default_message_notifications',
+	GuildDefaultMessageNotifications
+>;
+
+/**
+ * Returned when a guild's vanity_url_code is changed
+ */
+export type APIAuditLogChangeKeyVanityURLCode = AuditLogChangeData<'vanity_url_code', string>;
+
+/**
+ * Returned when new role(s) are added
+ */
+export type APIAuditLogChangeKey$Add = AuditLogChangeData<'$add', APIRole[]>;
+
+/**
+ * Returned when role(s) are removed
+ */
+export type APIAuditLogChangeKey$Remove = AuditLogChangeData<'$remove', APIRole[]>;
+
+/**
+ * Returned when there is a change in number of days after which inactive and role-unassigned members are kicked
+ */
+export type APIAuditLogChangeKeyPruneDeleteDays = AuditLogChangeData<'prune_delete_days', number>;
+
+/**
+ * Returned when a guild's widget is enabled
+ */
+export type APIAuditLogChangeKeyWidgetEnabled = AuditLogChangeData<'widget_enabled', boolean>;
+
+/**
+ * Returned when a guild's widget_channel_id is changed
+ */
+export type APIAuditLogChangeKeyWidgetChannelId = AuditLogChangeData<'widget_channel_id', Snowflake>;
+
+/**
+ * Returned when a guild's system_channel_id is changed
+ */
+export type APIAuditLogChangeKeySystemChannelId = AuditLogChangeData<'system_channel_id', Snowflake>;
+
+/**
+ * Returned when a channel's position is changed
+ */
+export type APIAuditLogChangeKeyPosition = AuditLogChangeData<'position', number>;
+
+/**
+ * Returned when a channel's topic is changed
+ */
+export type APIAuditLogChangeKeyTopic = AuditLogChangeData<'topic', string>;
+
+/**
+ * Returned when a voice channel's bitrate is changed
+ */
+export type APIAuditLogChangeKeyBitrate = AuditLogChangeData<'bitrate', number>;
+
+/**
+ * Returned when a channel's permission overwrites is changed
+ */
+export type APIAuditLogChangeKeyPermissionOverwrites = AuditLogChangeData<'permission_overwrites', APIOverwrite[]>;
+
+/**
+ * Returned when a channel's NSFW restriction is changed
+ */
+export type APIAuditLogChangeKeyNSFW = AuditLogChangeData<'nsfw', boolean>;
+
+/**
+ * The application ID of the added or removed Webhook or Bot
+ */
+export type APIAuditLogChangeKeyApplicationId = AuditLogChangeData<'application_id', Snowflake>;
+
+/**
+ * Returned when a channel's amount of seconds a user has to wait before sending another message
+ * is changed
+ */
+export type APIAuditLogChangeKeyRateLimitPerUser = AuditLogChangeData<'rate_limit_per_user', number>;
+
+/**
+ * Returned when a permission bitfield is changed
+ */
+export type APIAuditLogChangeKeyPermissions = AuditLogChangeData<'permissions', string>;
+
+/**
+ * Returned when a role's color is changed
+ */
+export type APIAuditLogChangeKeyColor = AuditLogChangeData<'color', number>;
+
+/**
+ * Represents a change where the key is a snowflake.
+ * Currently, the only known instance of this is returned when permissions for a command were updated (<insert name of object here>)
+ */
+export type APIAuditLogChangeKeySnowflake = AuditLogChangeData<Snowflake, unknown>;
+
+/**
+ * Returned when a role's hoist status is changed
+ */
+export type APIAuditLogChangeKeyHoist = AuditLogChangeData<'hoist', boolean>;
+
+/**
+ * Returned when a role's mentionable status is changed
+ */
+export type APIAuditLogChangeKeyMentionable = AuditLogChangeData<'mentionable', boolean>;
+
+/**
+ * Returned when an overwrite's allowed permissions bitfield is changed
+ */
+export type APIAuditLogChangeKeyAllow = AuditLogChangeData<'allow', string>;
+
+/**
+ * Returned when an overwrite's denied permissions bitfield is changed
+ */
+export type APIAuditLogChangeKeyDeny = AuditLogChangeData<'deny', string>;
+
+/**
+ * Returned when an invite's code is changed
+ */
+export type APIAuditLogChangeKeyCode = AuditLogChangeData<'code', string>;
+
+/**
+ * Returned when an invite's or guild scheduled event's channel_id is changed
+ */
+export type APIAuditLogChangeKeyChannelId = AuditLogChangeData<'channel_id', Snowflake>;
+
+/**
+ * Returned when an invite's inviter_id is changed
+ */
+export type APIAuditLogChangeKeyInviterId = AuditLogChangeData<'inviter_id', Snowflake>;
+
+/**
+ * Returned when an invite's max_uses is changed
+ */
+export type APIAuditLogChangeKeyMaxUses = AuditLogChangeData<'max_uses', number>;
+
+/**
+ * Returned when an invite's uses is changed
+ */
+export type APIAuditLogChangeKeyUses = AuditLogChangeData<'uses', number>;
+
+/**
+ * Returned when an invite's max_age is changed
+ */
+export type APIAuditLogChangeKeyMaxAge = AuditLogChangeData<'max_age', number>;
+
+/**
+ * Returned when an invite's temporary status is changed
+ */
+export type APIAuditLogChangeKeyTemporary = AuditLogChangeData<'temporary', boolean>;
+
+/**
+ * Returned when a user's deaf status is changed
+ */
+export type APIAuditLogChangeKeyDeaf = AuditLogChangeData<'deaf', boolean>;
+
+/**
+ * Returned when a user's mute status is changed
+ */
+export type APIAuditLogChangeKeyMute = AuditLogChangeData<'mute', boolean>;
+
+/**
+ * Returned when a user's nick is changed
+ */
+export type APIAuditLogChangeKeyNick = AuditLogChangeData<'nick', string>;
+
+/**
+ * Returned when a user's avatar_hash is changed
+ */
+export type APIAuditLogChangeKeyAvatarHash = AuditLogChangeData<'avatar_hash', string>;
+
+/**
+ * The ID of the changed entity - sometimes used in conjunction with other keys
+ */
+export type APIAuditLogChangeKeyId = AuditLogChangeData<'id', Snowflake>;
+
+/**
+ * The type of entity created
+ */
+export type APIAuditLogChangeKeyType = AuditLogChangeData<'type', number | string>;
+
+/**
+ * Returned when an integration's enable_emoticons is changed
+ */
+export type APIAuditLogChangeKeyEnableEmoticons = AuditLogChangeData<'enable_emoticons', boolean>;
+
+/**
+ * Returned when an integration's expire_behavior is changed
+ */
+export type APIAuditLogChangeKeyExpireBehavior = AuditLogChangeData<'expire_behavior', IntegrationExpireBehavior>;
+
+/**
+ * Returned when an integration's expire_grace_period is changed
+ */
+export type APIAuditLogChangeKeyExpireGracePeriod = AuditLogChangeData<'expire_grace_period', number>;
+
+/**
+ * Returned when a voice channel's user_limit is changed
+ */
+export type APIAuditLogChangeKeyUserLimit = AuditLogChangeData<'user_limit', number>;
+
+/**
+ * Returned when privacy level of a stage instance or guild scheduled event is changed
+ */
+export type APIAuditLogChangeKeyPrivacyLevel = AuditLogChangeData<'privacy_level', StageInstancePrivacyLevel>;
+
+/**
+ * Returned when a sticker's related emoji is changed
+ */
+export type APIAuditLogChangeKeyTags = AuditLogChangeData<'tags', string>;
+
+/**
+ * Returned when a sticker's format_type is changed
+ */
+export type APIAuditLogChangeKeyFormatType = AuditLogChangeData<'format_type', StickerFormatType>;
+
+/**
+ * Empty string
+ */
+export type APIAuditLogChangeKeyAsset = AuditLogChangeData<'asset', ''>;
+
+/**
+ * Returned when a sticker's availability is changed
+ */
+export type APIAuditLogChangeKeyAvailable = AuditLogChangeData<'available', boolean>;
+
+/**
+ * Returned when a sticker's guild_id is changed
+ */
+export type APIAuditLogChangeKeyGuildId = AuditLogChangeData<'guild_id', Snowflake>;
+
+/*
+ * Returned when a thread's archive status is changed
+ */
+export type APIAuditLogChangeKeyArchived = AuditLogChangeData<'archived', boolean>;
+
+/*
+ * Returned when a thread's lock status is changed
+ */
+export type APIAuditLogChangeKeyLocked = AuditLogChangeData<'locked', boolean>;
+
+/*
+ * Returned when a thread's auto archive duration is changed
+ */
+export type APIAuditLogChangeKeyAutoArchiveDuration = AuditLogChangeData<'auto_archive_duration', number>;
+
+/*
+ * Returned when a channel's default auto archive duration for newly created threads is changed
+ */
+export type APIAuditLogChangeKeyDefaultAutoArchiveDuration = AuditLogChangeData<
+	'default_auto_archive_duration',
+	number
+>;
+
+/**
+ * Returned when entity type of a guild scheduled event is changed
+ */
+export type APIAuditLogChangeKeyEntityType = AuditLogChangeData<'entity_type', GuildScheduledEventEntityType>;
+
+/**
+ * Returned when status of a guild scheduled event is changed
+ */
+export type APIAuditLogChangeKeyStatus = AuditLogChangeData<'status', GuildScheduledEventStatus>;
+
+/**
+ * Returned when location of a guild scheduled event is changed
+ */
+export type APIAuditLogChangeKeyLocation = AuditLogChangeData<'location', string>;
+
+/**
+ * Returned when a user's timeout is changed
+ */
+export type APIAuditLogChangeKeyCommunicationDisabledUntil = AuditLogChangeData<'communication_disabled_until', string>;
+
+/**
+ * Returned when an auto moderation rule's trigger type is changed (only in rule creation or deletion)
+ */
+export type APIAuditLogChangeKeyTriggerType = AuditLogChangeData<'trigger_type', AutoModerationRuleTriggerType>;
+
+/**
+ * Returned when an auto moderation rule's event type is changed
+ */
+export type APIAuditLogChangeKeyEventType = AuditLogChangeData<'event_type', AutoModerationRuleEventType>;
+
+/**
+ * Returned when an auto moderation rule's trigger metadata is changed
+ */
+export type APIAuditLogChangeKeyTriggerMetadata = AuditLogChangeData<
+	'trigger_metadata',
+	APIAutoModerationRuleTriggerMetadata
+>;
+
+/**
+ * Returned when an auto moderation rule's actions is changed
+ */
+export type APIAuditLogChangeKeyActions = AuditLogChangeData<'actions', APIAutoModerationAction[]>;
+
+/**
+ * Returned when an auto moderation rule's enabled status is changed
+ */
+export type APIAuditLogChangeKeyEnabled = AuditLogChangeData<'enabled', boolean>;
+
+/**
+ * Returned when an auto moderation rule's exempt roles is changed
+ */
+export type APIAuditLogChangeKeyExemptRoles = AuditLogChangeData<'exempt_roles', Snowflake[]>;
+
+/**
+ * Returned when an auto moderation rule's exempt channels is changed
+ */
+export type APIAuditLogChangeKeyExemptChannels = AuditLogChangeData<'exempt_channels', Snowflake[]>;
+
+interface AuditLogChangeData<K extends string, D> {
+	key: K;
+	/**
+	 * The new value
+	 *
+	 * If `new_value` is not present in the change object, while `old_value` is,
+	 * that means the property that was changed has been reset, or set to `null`
+	 */
+	new_value?: D;
+	old_value?: D;
+}

payloads/v9/autoModeration.ts

@@ -0,0 +1,203 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/auto-moderation
+ */
+
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-auto-moderation-rule-structure
+ */
+export interface APIAutoModerationRule {
+	/**
+	 * The id of this rule
+	 */
+	id: Snowflake;
+	/**
+	 * The guild which this rule belongs to
+	 */
+	guild_id: Snowflake;
+	/**
+	 * The rule name
+	 */
+	name: string;
+	/**
+	 * The user id who created this rule
+	 */
+	creator_id: Snowflake;
+	/**
+	 * The rule event type
+	 */
+	event_type: AutoModerationRuleEventType;
+	/**
+	 * The rule trigger type
+	 */
+	trigger_type: AutoModerationRuleTriggerType;
+	/**
+	 * The rule trigger metadata
+	 */
+	trigger_metadata: APIAutoModerationRuleTriggerMetadata;
+	/**
+	 * The actions which will execute when this rule is triggered
+	 */
+	actions: APIAutoModerationAction[];
+	/**
+	 * Whether this rule is enabled
+	 */
+	enabled: boolean;
+	/**
+	 * The role ids that shouldn't be affected by this rule (Maximum of 20)
+	 */
+	exempt_roles: Snowflake[];
+	/**
+	 * The channel ids that shouldn't be affected by this rule (Maximum of 50)
+	 */
+	exempt_channels: Snowflake[];
+}
+
+/**
+ * https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types
+ */
+export enum AutoModerationRuleTriggerType {
+	/**
+	 * Check if content contains words from a user defined list of keywords (Maximum of 3 per guild)
+	 */
+	Keyword = 1,
+	/**
+	 * Check if content represents generic spam (Maximum of 1 per guild)
+	 */
+	Spam = 3,
+	/**
+	 * Check if content contains words from internal pre-defined wordsets (Maximum of 1 per guild)
+	 */
+	KeywordPreset,
+	/**
+	 * Check if content contains more mentions than allowed (Maximum of 1 per guild)
+	 */
+	MentionSpam,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata
+ */
+export interface APIAutoModerationRuleTriggerMetadata {
+	/**
+	 * Substrings which will be searched for in content (Maximum of 1000)
+	 *
+	 * A keyword can be a phrase which contains multiple words. Wildcard symbols can be used to customize how each string will be matched. Each keyword must be 30 characters or less
+	 * See [keyword matching strategies](https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-keyword-matching-strategies)
+	 *
+	 * Associated trigger type: {@link AutoModerationRuleTriggerType.Keyword}
+	 */
+	keyword_filter?: string[];
+	/**
+	 * The internally pre-defined wordsets which will be searched for in content
+	 *
+	 * Associated trigger type: {@link AutoModerationRuleTriggerType.KeywordPreset}
+	 */
+	presets?: AutoModerationRuleKeywordPresetType[];
+	/**
+	 * Substrings which will be exempt from triggering the preset trigger type (Maximum of 1000)
+	 *
+	 * A allowed-word can be a phrase which contains multiple words. Wildcard symbols can be used to customize how each string will be matched. Each keyword must be 30 characters or less
+	 * See [keyword matching strategies](https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-keyword-matching-strategies)
+	 *
+	 * Associated trigger type: {@link AutoModerationRuleTriggerType.KeywordPreset}
+	 */
+	allow_list?: string[];
+	/**
+	 * Regular expression patterns which will be matched against content (Maximum of 10)
+	 *
+	 * Only Rust flavored regex is currently supported (Maximum of 75 characters)
+	 *
+	 * Associated trigger type: {@link AutoModerationRuleTriggerType.Keyword}
+	 */
+	regex_patterns?: string[];
+	/**
+	 * Total number of mentions (role & user) allowed per message (Maximum of 50)
+	 *
+	 * Associated trigger type: {@link AutoModerationRuleTriggerType.MentionSpam}
+	 */
+	mention_total_limit?: number;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-keyword-preset-types
+ */
+export enum AutoModerationRuleKeywordPresetType {
+	/**
+	 * Words that may be considered forms of swearing or cursing
+	 */
+	Profanity = 1,
+	/**
+	 * Words that refer to sexually explicit behavior or activity
+	 */
+	SexualContent,
+	/**
+	 * Personal insults or words that may be considered hate speech
+	 */
+	Slurs,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-event-types
+ */
+export enum AutoModerationRuleEventType {
+	/**
+	 * When a member sends or edits a message in the guild
+	 */
+	MessageSend = 1,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-action-object-auto-moderation-action-structure
+ */
+export interface APIAutoModerationAction {
+	/**
+	 * The action type
+	 */
+	type: AutoModerationActionType;
+	/**
+	 * Additional metadata needed during execution for this specific action type
+	 *
+	 * Will only be omitted if the action type is {@link AutoModerationActionType.BlockMessage}
+	 */
+	metadata?: APIAutoModerationActionMetadata;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-action-object-action-types
+ */
+export enum AutoModerationActionType {
+	/**
+	 * Blocks the content of a message according to the rule
+	 */
+	BlockMessage = 1,
+	/**
+	 * Logs user content to a specified channel
+	 */
+	SendAlertMessage,
+	/**
+	 * Timeout user for specified duration, this action type can be set if the bot has `MODERATE_MEMBERS` permission
+	 */
+	Timeout,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-action-object-action-metadata
+ */
+export interface APIAutoModerationActionMetadata {
+	/**
+	 * Channel to which user content should be logged
+	 *
+	 * Associated action type: {@link AutoModerationActionType.SendAlertMessage}
+	 */
+	channel_id?: Snowflake;
+	/**
+	 * Timeout duration in seconds (Maximum of 4 weeks - 2419200 seconds)
+	 *
+	 * Only available if using {@link AutoModerationRuleTriggerType.Keyword}
+	 *
+	 * Associated action type: {@link AutoModerationActionType.Timeout}
+	 */
+	duration_seconds?: number;
+}

payloads/v9/emoji.ts

@@ -0,0 +1,51 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/emoji
+ */
+
+import type { APIRole } from './permissions';
+import type { APIUser } from './user';
+import type { Snowflake } from '../../globals';
+
+/**
+ * Not documented but mentioned
+ */
+export interface APIPartialEmoji {
+	/**
+	 * Emoji id
+	 */
+	id: Snowflake | null;
+	/**
+	 * Emoji name (can be null only in reaction emoji objects)
+	 */
+	name: string | null;
+	/**
+	 * Whether this emoji is animated
+	 */
+	animated?: boolean;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/emoji#emoji-object-emoji-structure
+ */
+export interface APIEmoji extends APIPartialEmoji {
+	/**
+	 * Roles this emoji is whitelisted to
+	 */
+	roles?: APIRole['id'][];
+	/**
+	 * User that created this emoji
+	 */
+	user?: APIUser;
+	/**
+	 * Whether this emoji must be wrapped in colons
+	 */
+	require_colons?: boolean;
+	/**
+	 * Whether this emoji is managed
+	 */
+	managed?: boolean;
+	/**
+	 * Whether this emoji can be used, may be false due to loss of Server Boosts
+	 */
+	available?: boolean;
+}

payloads/v9/gateway.ts

@@ -0,0 +1,378 @@
+/**
+ * Types extracted from
+ *  - https://discord.com/developers/docs/topics/gateway
+ *  - https://discord.com/developers/docs/topics/gateway-events
+ */
+
+import type { APIChannel, APIThreadMember } from './channel';
+import type { APIEmoji } from './emoji';
+import type { APIUser } from './user';
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/topics/gateway#get-gateway
+ */
+export interface APIGatewayInfo {
+	/**
+	 * The WSS URL that can be used for connecting to the gateway
+	 */
+	url: string;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway#get-gateway-bot
+ */
+export interface APIGatewayBotInfo extends APIGatewayInfo {
+	/**
+	 * The recommended number of shards to use when connecting
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway#sharding
+	 */
+	shards: number;
+	/**
+	 * Information on the current session start limit
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway#session-start-limit-object
+	 */
+	session_start_limit: APIGatewaySessionStartLimit;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway#session-start-limit-object
+ */
+export interface APIGatewaySessionStartLimit {
+	/**
+	 * The total number of session starts the current user is allowed
+	 */
+	total: number;
+	/**
+	 * The remaining number of session starts the current user is allowed
+	 */
+	remaining: number;
+	/**
+	 * The number of milliseconds after which the limit resets
+	 */
+	reset_after: number;
+	/**
+	 * The number of identify requests allowed per 5 seconds
+	 */
+	max_concurrency: number;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#presence-update-presence-update-event-fields
+ */
+export interface GatewayPresenceUpdate {
+	/**
+	 * The user presence is being updated for
+	 *
+	 * **The user object within this event can be partial, the only field which must be sent is the `id` field,
+	 * everything else is optional.**
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 */
+	user: Partial<APIUser> & Pick<APIUser, 'id'>;
+	/**
+	 * ID of the guild
+	 */
+	guild_id: Snowflake;
+	/**
+	 * Either "idle", "dnd", "online", or "offline"
+	 */
+	status?: PresenceUpdateStatus;
+	/**
+	 * User's current activities
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway-events#activity-object
+	 */
+	activities?: GatewayActivity[];
+	/**
+	 * User's platform-dependent status
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway-events#client-status-object
+	 */
+	client_status?: GatewayPresenceClientStatus;
+}
+
+export enum PresenceUpdateStatus {
+	Online = 'online',
+	DoNotDisturb = 'dnd',
+	Idle = 'idle',
+	/**
+	 * Invisible and shown as offline
+	 */
+	Invisible = 'invisible',
+	Offline = 'offline',
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#client-status-object
+ */
+export interface GatewayPresenceClientStatus {
+	/**
+	 * The user's status set for an active desktop (Windows, Linux, Mac) application session
+	 */
+	desktop?: PresenceUpdateStatus;
+	/**
+	 * The user's status set for an active mobile (iOS, Android) application session
+	 */
+	mobile?: PresenceUpdateStatus;
+	/**
+	 * The user's status set for an active web (browser, bot account) application session
+	 */
+	web?: PresenceUpdateStatus;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-structure
+ */
+export interface GatewayActivity {
+	/**
+	 * The activity's id
+	 */
+	id: string;
+	/**
+	 * The activity's name
+	 */
+	name: string;
+	/**
+	 * Activity type
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-types
+	 */
+	type: ActivityType;
+	/**
+	 * Stream url, is validated when type is `1`
+	 */
+	url?: string | null;
+	/**
+	 * Unix timestamp of when the activity was added to the user's session
+	 */
+	created_at: number;
+	/**
+	 * Unix timestamps for start and/or end of the game
+	 */
+	timestamps?: GatewayActivityTimestamps;
+	sync_id?: string;
+	/**
+	 * {@link ActivityPlatform}
+	 */
+	platform?: string;
+	/**
+	 * Application id for the game
+	 */
+	application_id?: Snowflake;
+	/**
+	 * What the player is currently doing
+	 */
+	details?: string | null;
+	/**
+	 * The user's current party status
+	 */
+	state?: string | null;
+	/**
+	 * The emoji used for a custom status
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-emoji
+	 */
+	emoji?: GatewayActivityEmoji;
+	session_id?: string;
+	/**
+	 * Information for the current party of the player
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-party
+	 */
+	party?: GatewayActivityParty;
+	/**
+	 * Images for the presence and their hover texts
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-assets
+	 */
+	assets?: GatewayActivityAssets;
+	/**
+	 * Secrets for Rich Presence joining and spectating
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-secrets
+	 */
+	secrets?: GatewayActivitySecrets;
+	/**
+	 * Whether or not the activity is an instanced game session
+	 */
+	instance?: boolean;
+	/**
+	 * Activity flags `OR`d together, describes what the payload includes
+	 *
+	 * See https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-flags
+	 *
+	 * See https://en.wikipedia.org/wiki/Bit_field
+	 */
+	flags?: ActivityFlags;
+	/**
+	 * The custom buttons shown in the Rich Presence (max 2)
+	 */
+	buttons?: string[] | GatewayActivityButton[];
+}
+
+/**
+ * @unstable This enum is currently not documented by Discord but has known values which we will try to keep up to date.
+ * Values might be added or removed without a major version bump.
+ */
+export enum ActivityPlatform {
+	Desktop = 'desktop',
+	Xbox = 'xbox',
+	Samsung = 'samsung',
+	IOS = 'ios',
+	Android = 'android',
+	Embedded = 'embedded',
+	PS4 = 'ps4',
+	PS5 = 'ps5',
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-types
+ */
+export enum ActivityType {
+	/**
+	 * Playing {game}
+	 */
+	Playing,
+	/**
+	 * Streaming {details}
+	 */
+	Streaming,
+	/**
+	 * Listening to {name}
+	 */
+	Listening,
+	/**
+	 * Watching {details}
+	 */
+	Watching,
+	/**
+	 * {emoji} {details}
+	 */
+	Custom,
+	/**
+	 * Competing in {name}
+	 */
+	Competing,
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-timestamps
+ */
+export interface GatewayActivityTimestamps {
+	/**
+	 * Unix time (in milliseconds) of when the activity started
+	 */
+	start?: number;
+	/**
+	 * Unix time (in milliseconds) of when the activity ends
+	 */
+	end?: number;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-emoji
+ */
+export type GatewayActivityEmoji = Partial<Pick<APIEmoji, 'id' | 'animated'>> & Pick<APIEmoji, 'name'>;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-party
+ */
+export interface GatewayActivityParty {
+	/**
+	 * The id of the party
+	 */
+	id?: string;
+	/**
+	 * Used to show the party's current and maximum size
+	 */
+	size?: [current_size: number, max_size: number];
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-assets
+ */
+export type GatewayActivityAssets = Partial<
+	Record<'large_image' | 'large_text' | 'small_image' | 'small_text', string>
+>;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-secrets
+ */
+export type GatewayActivitySecrets = Partial<Record<'join' | 'spectate' | 'match', string>>;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#activity-object-activity-flags
+ */
+export enum ActivityFlags {
+	Instance = 1 << 0,
+	Join = 1 << 1,
+	Spectate = 1 << 2,
+	JoinRequest = 1 << 3,
+	Sync = 1 << 4,
+	Play = 1 << 5,
+	PartyPrivacyFriends = 1 << 6,
+	PartyPrivacyVoiceChannel = 1 << 7,
+	Embedded = 1 << 8,
+}
+
+export interface GatewayActivityButton {
+	/**
+	 * The text shown on the button (1-32 characters)
+	 */
+	label: string;
+	/**
+	 * The url opened when clicking the button (1-512 characters)
+	 */
+	url: string;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#thread-list-sync-thread-list-sync-event-fields
+ */
+export interface GatewayThreadListSync {
+	/**
+	 * ID of the guild
+	 */
+	guild_id: Snowflake;
+	/**
+	 * The ids of all the parent channels whose threads are being synced, otherwise the entire guild
+	 */
+	channel_ids?: Snowflake[];
+	/**
+	 * Array of the synced threads
+	 */
+	threads: APIChannel[];
+	/**
+	 * The member objects for the client user in each joined thread that was synced
+	 */
+	members: APIThreadMember[];
+}
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#thread-members-update-thread-members-update-event-fields
+ */
+export interface GatewayThreadMembersUpdate {
+	/**
+	 * The id of the thread for which members are being synced
+	 */
+	id: Snowflake;
+	/**
+	 * The id of the guild that the thread is in
+	 */
+	guild_id: Snowflake;
+	/**
+	 * The approximate member count of the thread, does not count above 50 even if there are more members
+	 */
+	member_count: number;
+	/**
+	 * The members that were added to the thread
+	 */
+	added_members?: APIThreadMember[];
+	/**
+	 * The ids of the members that were removed from the thread
+	 */
+	removed_member_ids?: Snowflake[];
+}

payloads/v9/guildScheduledEvent.ts

@@ -0,0 +1,152 @@
+import type { APIGuildMember } from './guild';
+import type { APIUser } from './user';
+import type { Snowflake } from '../../globals';
+
+interface APIGuildScheduledEventBase<Type extends GuildScheduledEventEntityType> {
+	/**
+	 * The id of the guild event
+	 */
+	id: Snowflake;
+	/**
+	 * The guild id which the scheduled event belongs to
+	 */
+	guild_id: Snowflake;
+	/**
+	 * The channel id in which the scheduled event will be hosted, or `null` if entity type is `EXTERNAL`
+	 */
+	channel_id: Snowflake | null;
+	/**
+	 * The id of the user that created the scheduled event
+	 */
+	creator_id?: Snowflake | null;
+	/**
+	 * The name of the scheduled event
+	 */
+	name: string;
+	/**
+	 * The description of the scheduled event
+	 */
+	description?: string | null;
+	/**
+	 * The time the scheduled event will start
+	 */
+	scheduled_start_time: string;
+	/**
+	 * The time at which the guild event will end, or `null` if the event does not have a scheduled time to end
+	 */
+	scheduled_end_time: string | null;
+	/**
+	 * The privacy level of the scheduled event
+	 */
+	privacy_level: GuildScheduledEventPrivacyLevel;
+	/**
+	 * The status of the scheduled event
+	 */
+	status: GuildScheduledEventStatus;
+	/**
+	 * The type of hosting entity associated with the scheduled event
+	 */
+	entity_type: Type;
+	/**
+	 * The id of the hosting entity associated with the scheduled event
+	 */
+	entity_id: Snowflake | null;
+	/**
+	 * The entity metadata for the scheduled event
+	 */
+	entity_metadata: APIGuildScheduledEventEntityMetadata | null;
+	/**
+	 * The user that created the scheduled event
+	 */
+	creator?: APIUser;
+	/**
+	 * The number of users subscribed to the scheduled event
+	 */
+	user_count?: number;
+	/**
+	 * The cover image of the scheduled event
+	 */
+	image?: string | null;
+}
+
+export interface APIStageInstanceGuildScheduledEvent
+	extends APIGuildScheduledEventBase<GuildScheduledEventEntityType.StageInstance> {
+	channel_id: Snowflake;
+	entity_metadata: null;
+}
+
+export interface APIVoiceGuildScheduledEvent extends APIGuildScheduledEventBase<GuildScheduledEventEntityType.Voice> {
+	channel_id: Snowflake;
+	entity_metadata: null;
+}
+
+export interface APIExternalGuildScheduledEvent
+	extends APIGuildScheduledEventBase<GuildScheduledEventEntityType.External> {
+	channel_id: null;
+	entity_metadata: Required<APIGuildScheduledEventEntityMetadata>;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-structure
+ */
+export type APIGuildScheduledEvent =
+	| APIStageInstanceGuildScheduledEvent
+	| APIVoiceGuildScheduledEvent
+	| APIExternalGuildScheduledEvent;
+
+/**
+ * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-entity-metadata
+ */
+export interface APIGuildScheduledEventEntityMetadata {
+	/**
+	 * The location of the scheduled event
+	 */
+	location?: string;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-entity-types
+ */
+export enum GuildScheduledEventEntityType {
+	StageInstance = 1,
+	Voice,
+	External,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-status
+ */
+export enum GuildScheduledEventStatus {
+	Scheduled = 1,
+	Active,
+	Completed,
+	Canceled,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-privacy-level
+ */
+export enum GuildScheduledEventPrivacyLevel {
+	/**
+	 * The scheduled event is only accessible to guild members
+	 */
+	GuildOnly = 2,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-user-object-guild-scheduled-event-user-structure
+ */
+export interface APIGuildScheduledEventUser {
+	/**
+	 * The scheduled event id which the user subscribed to
+	 */
+	guild_scheduled_event_id: Snowflake;
+	/**
+	 * The user which subscribed to the event
+	 */
+	user: APIUser;
+	/**
+	 * The guild member data for this user for the guild which this event belongs to, if any
+	 */
+	member?: APIGuildMember;
+}

payloads/v9/index.ts

@@ -0,0 +1,20 @@
+export * from '../common';
+export * from './application';
+export * from './auditLog';
+export * from './autoModeration';
+export * from './channel';
+export * from './emoji';
+export * from './gateway';
+export * from './guild';
+export * from './guildScheduledEvent';
+export * from './interactions';
+export * from './invite';
+export * from './oauth2';
+export * from './permissions';
+export * from './stageInstance';
+export * from './sticker';
+export * from './teams';
+export * from './template';
+export * from './user';
+export * from './voice';
+export * from './webhook';

payloads/v9/interactions.ts

@@ -0,0 +1,57 @@
+import type {
+	APIApplicationCommandDMInteraction,
+	APIApplicationCommandGuildInteraction,
+	APIApplicationCommandInteraction,
+} from './_interactions/applicationCommands';
+import type {
+	APIApplicationCommandAutocompleteDMInteraction,
+	APIApplicationCommandAutocompleteGuildInteraction,
+	APIApplicationCommandAutocompleteInteraction,
+} from './_interactions/autocomplete';
+import type {
+	APIMessageComponentDMInteraction,
+	APIMessageComponentGuildInteraction,
+	APIMessageComponentInteraction,
+} from './_interactions/messageComponents';
+import type {
+	APIModalSubmitDMInteraction,
+	APIModalSubmitGuildInteraction,
+	APIModalSubmitInteraction,
+} from './_interactions/modalSubmit';
+import type { APIPingInteraction } from './_interactions/ping';
+
+export * from './_interactions/applicationCommands';
+export * from './_interactions/autocomplete';
+export * from './_interactions/base';
+export * from './_interactions/messageComponents';
+export * from './_interactions/modalSubmit';
+export * from './_interactions/ping';
+export * from './_interactions/responses';
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIInteraction =
+	| APIPingInteraction
+	| APIApplicationCommandInteraction
+	| APIMessageComponentInteraction
+	| APIApplicationCommandAutocompleteInteraction
+	| APIModalSubmitInteraction;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIDMInteraction =
+	| APIApplicationCommandDMInteraction
+	| APIMessageComponentDMInteraction
+	| APIApplicationCommandAutocompleteDMInteraction
+	| APIModalSubmitDMInteraction;
+
+/**
+ * https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object
+ */
+export type APIGuildInteraction =
+	| APIApplicationCommandGuildInteraction
+	| APIMessageComponentGuildInteraction
+	| APIApplicationCommandAutocompleteGuildInteraction
+	| APIModalSubmitGuildInteraction;

payloads/v9/invite.ts

@@ -0,0 +1,126 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/invite
+ */
+
+import type { APIApplication } from './application';
+import type { APIPartialChannel } from './channel';
+import type { APIGuild } from './guild';
+import type { APIGuildScheduledEvent } from './guildScheduledEvent';
+import type { APIInviteStageInstance } from './stageInstance';
+import type { APIUser } from './user';
+
+export type APIInviteGuild = Pick<
+	APIGuild,
+	| 'id'
+	| 'name'
+	| 'splash'
+	| 'banner'
+	| 'icon'
+	| 'vanity_url_code'
+	| 'description'
+	| 'features'
+	| 'verification_level'
+	| 'nsfw_level'
+	| 'premium_subscription_count'
+>;
+
+/**
+ * https://discord.com/developers/docs/resources/invite#invite-object
+ */
+export interface APIInvite {
+	/**
+	 * The invite code (unique ID)
+	 */
+	code: string;
+	/**
+	 * The guild this invite is for
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-object
+	 */
+	guild?: APIInviteGuild;
+	/**
+	 * The channel this invite is for
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#channel-object
+	 */
+	channel: Required<APIPartialChannel> | null;
+	/**
+	 * The user who created the invite
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 */
+	inviter?: APIUser;
+	/**
+	 * The type of target for this voice channel invite
+	 *
+	 * See https://discord.com/developers/docs/resources/invite#invite-object-invite-target-types
+	 */
+	target_type?: InviteTargetType;
+	/**
+	 * The user whose stream to display for this voice channel stream invite
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 */
+	target_user?: APIUser;
+	/**
+	 * The embedded application to open for this voice channel embedded application invite
+	 *
+	 * See https://discord.com/developers/docs/resources/application#application-object
+	 */
+	target_application?: Partial<APIApplication>;
+	/**
+	 * Approximate count of online members, returned from the `GET /invites/<code>` endpoint when `with_counts` is `true`
+	 */
+	approximate_presence_count?: number;
+	/**
+	 * Approximate count of total members, returned from the `GET /invites/<code>` endpoint when `with_counts` is `true`
+	 */
+	approximate_member_count?: number;
+	/**
+	 * The expiration date of this invite, returned from the `GET /invites/<code>` endpoint when `with_expiration` is `true`
+	 */
+	expires_at?: string | null;
+	/**
+	 * The stage instance data if there is a public stage instance in the stage channel this invite is for
+	 * @deprecated
+	 */
+	stage_instance?: APIInviteStageInstance;
+	/**
+	 * The guild scheduled event data, returned from the `GET /invites/<code>` endpoint when `guild_scheduled_event_id` is a valid guild scheduled event id
+	 */
+	guild_scheduled_event?: APIGuildScheduledEvent;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/invite#invite-object-invite-target-types
+ */
+export enum InviteTargetType {
+	Stream = 1,
+	EmbeddedApplication,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/invite#invite-metadata-object
+ */
+export interface APIExtendedInvite extends APIInvite {
+	/**
+	 * Number of times this invite has been used
+	 */
+	uses: number;
+	/**
+	 * Max number of times this invite can be used
+	 */
+	max_uses: number;
+	/**
+	 * Duration (in seconds) after which the invite expires
+	 */
+	max_age: number;
+	/**
+	 * Whether this invite only grants temporary membership
+	 */
+	temporary: boolean;
+	/**
+	 * When this invite was created
+	 */
+	created_at: string;
+}

payloads/v9/oauth2.ts

@@ -0,0 +1,132 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/topics/oauth2
+ */
+
+export enum OAuth2Scopes {
+	/**
+	 * For oauth2 bots, this puts the bot in the user's selected guild by default
+	 */
+	Bot = 'bot',
+	/**
+	 * Allows [/users/@me/connections](https://discord.com/developers/docs/resources/user#get-user-connections)
+	 * to return linked third-party accounts
+	 *
+	 * See https://discord.com/developers/docs/resources/user#get-user-connections
+	 */
+	Connections = 'connections',
+	/**
+	 * Allows your app to see information about the user's DMs and group DMs - requires Discord approval
+	 */
+	DMChannelsRead = 'dm_channels.read',
+	/**
+	 * Enables [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) to return an `email`
+	 *
+	 * See https://discord.com/developers/docs/resources/user#get-current-user
+	 */
+	Email = 'email',
+	/**
+	 * Allows [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) without `email`
+	 *
+	 * See https://discord.com/developers/docs/resources/user#get-current-user
+	 */
+	Identify = 'identify',
+	/**
+	 * Allows [/users/@me/guilds](https://discord.com/developers/docs/resources/user#get-current-user-guilds)
+	 * to return basic information about all of a user's guilds
+	 *
+	 * See https://discord.com/developers/docs/resources/user#get-current-user-guilds
+	 */
+	Guilds = 'guilds',
+	/**
+	 * Allows [/guilds/{guild.id}/members/{user.id}](https://discord.com/developers/docs/resources/guild#add-guild-member)
+	 * to be used for joining users to a guild
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#add-guild-member
+	 */
+	GuildsJoin = 'guilds.join',
+	/**
+	 * Allows /users/@me/guilds/{guild.id}/member to return a user's member information in a guild
+	 *
+	 * See https://discord.com/developers/docs/resources/user#get-current-user-guild-member
+	 */
+	GuildsMembersRead = 'guilds.members.read',
+	/**
+	 * Allows your app to join users to a group dm
+	 *
+	 * See https://discord.com/developers/docs/resources/channel#group-dm-add-recipient
+	 */
+	GroupDMJoins = 'gdm.join',
+	/**
+	 * For local rpc server api access, this allows you to read messages from all client channels
+	 * (otherwise restricted to channels/guilds your app creates)
+	 */
+	MessagesRead = 'messages.read',
+	/**
+	 * Allows your app to update a user's connection and metadata for the app
+	 */
+	RoleConnectionsWrite = 'role_connections.write',
+	/**
+	 * For local rpc server access, this allows you to control a user's local Discord client - requires Discord approval
+	 */
+	RPC = 'rpc',
+	/**
+	 * For local rpc server api access, this allows you to receive notifications pushed out to the user - requires Discord approval
+	 */
+	RPCNotificationsRead = 'rpc.notifications.read',
+	/**
+	 * This generates a webhook that is returned in the oauth token response for authorization code grants
+	 */
+	WebhookIncoming = 'webhook.incoming',
+	/**
+	 * Allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval
+	 */
+	Voice = 'voice',
+	/**
+	 * Allows your app to upload/update builds for a user's applications - requires Discord approval
+	 */
+	ApplicationsBuildsUpload = 'applications.builds.upload',
+	/**
+	 * Allows your app to read build data for a user's applications
+	 */
+	ApplicationsBuildsRead = 'applications.builds.read',
+	/**
+	 * Allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications
+	 */
+	ApplicationsStoreUpdate = 'applications.store.update',
+	/**
+	 * Allows your app to read entitlements for a user's applications
+	 */
+	ApplicationsEntitlements = 'applications.entitlements',
+	/**
+	 * Allows your app to know a user's friends and implicit relationships - requires Discord approval
+	 */
+	RelationshipsRead = 'relationships.read',
+	/**
+	 * Allows your app to fetch data from a user's "Now Playing/Recently Played" list - requires Discord approval
+	 */
+	ActivitiesRead = 'activities.read',
+	/**
+	 * Allows your app to update a user's activity - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER)
+	 *
+	 * See https://discord.com/developers/docs/game-sdk/activities
+	 */
+	ActivitiesWrite = 'activities.write',
+	/**
+	 * Allows your app to use Application Commands in a guild
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
+	 */
+	ApplicationsCommands = 'applications.commands',
+	/**
+	 * Allows your app to update its Application Commands via this bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
+	 */
+	ApplicationsCommandsUpdate = 'applications.commands.update',
+	/**
+	 * Allows your app to update permissions for its commands using a Bearer token - client credentials grant only
+	 *
+	 * See https://discord.com/developers/docs/interactions/application-commands
+	 */
+	ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
+}

payloads/v9/permissions.ts

@@ -0,0 +1,87 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/topics/permissions
+ */
+
+import type { Permissions, Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/topics/permissions#role-object
+ */
+export interface APIRole {
+	/**
+	 * Role id
+	 */
+	id: Snowflake;
+	/**
+	 * Role name
+	 */
+	name: string;
+	/**
+	 * Integer representation of hexadecimal color code
+	 */
+	color: number;
+	/**
+	 * If this role is pinned in the user listing
+	 */
+	hoist: boolean;
+	/**
+	 * The role icon hash
+	 */
+	icon?: string | null;
+	/**
+	 * The role unicode emoji as a standard emoji
+	 */
+	unicode_emoji?: string | null;
+	/**
+	 * Position of this role
+	 */
+	position: number;
+	/**
+	 * Permission bit set
+	 *
+	 * See https://en.wikipedia.org/wiki/Bit_field
+	 */
+	permissions: Permissions;
+	/**
+	 * Whether this role is managed by an integration
+	 */
+	managed: boolean;
+	/**
+	 * Whether this role is mentionable
+	 */
+	mentionable: boolean;
+	/**
+	 * The tags this role has
+	 */
+	tags?: APIRoleTags;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/permissions#role-object-role-tags-structure
+ */
+export interface APIRoleTags {
+	/**
+	 * The id of the bot this role belongs to
+	 */
+	bot_id?: Snowflake;
+	/**
+	 * Whether this is the guild's premium subscriber role
+	 */
+	premium_subscriber?: null;
+	/**
+	 * The id of the integration this role belongs to
+	 */
+	integration_id?: Snowflake;
+	/**
+	 * The id of this role's subscription sku and listing
+	 */
+	subscription_listing_id?: Snowflake;
+	/**
+	 * Whether this role is available for purchase
+	 */
+	available_for_purchase?: null;
+	/**
+	 * Whether this role is a guild's linked role
+	 */
+	guild_connections?: null;
+}

payloads/v9/stageInstance.ts

@@ -0,0 +1,79 @@
+import type { APIGuildMember } from './guild';
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/resources/stage-instance#stage-instance-object
+ */
+export interface APIStageInstance {
+	/**
+	 * The id of the stage instance
+	 */
+	id: Snowflake;
+	/**
+	 * The guild id of the associated stage channel
+	 */
+	guild_id: Snowflake;
+	/**
+	 * The id of the associated stage channel
+	 */
+	channel_id: Snowflake;
+	/**
+	 * The topic of the stage instance (1-120 characters)
+	 */
+	topic: string;
+	/**
+	 * The privacy level of the stage instance
+	 *
+	 * See https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-privacy-level
+	 */
+	privacy_level: StageInstancePrivacyLevel;
+	/**
+	 * Whether or not stage discovery is disabled
+	 * @deprecated
+	 */
+	discoverable_disabled: boolean;
+	/**
+	 * The id of the scheduled event for this stage instance
+	 */
+	guild_scheduled_event_id?: Snowflake;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-privacy-level
+ */
+export enum StageInstancePrivacyLevel {
+	/**
+	 * The stage instance is visible publicly, such as on stage discovery
+	 * @deprecated
+	 */
+	Public = 1,
+	/**
+	 * The stage instance is visible to only guild members
+	 */
+	GuildOnly,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/invite#invite-stage-instance-object-invite-stage-instance-structure
+ * @deprecated
+ */
+export interface APIInviteStageInstance {
+	/**
+	 * The topic of the stage instance (1-120 characters)
+	 */
+	topic: string;
+	/**
+	 * The number of users in the stage
+	 */
+	participant_count: number;
+	/**
+	 * The number of users speaking in the stage
+	 */
+	speaker_count: number;
+	/**
+	 * The members speaking in the stage
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object-guild-member-structure
+	 */
+	members: APIGuildMember[];
+}

payloads/v9/sticker.ts

@@ -0,0 +1,128 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/sticker
+ */
+
+import type { APIUser } from './user';
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/resources/sticker#sticker-object
+ */
+export interface APISticker {
+	/**
+	 * ID of the sticker
+	 */
+	id: Snowflake;
+	/**
+	 * For standard stickers, ID of the pack the sticker is from
+	 */
+	pack_id?: Snowflake;
+	/**
+	 * Name of the sticker
+	 */
+	name: string;
+	/**
+	 * Description of the sticker
+	 */
+	description: string | null;
+	/**
+	 * For guild stickers, the Discord name of a unicode emoji representing the sticker's expression. for standard stickers, a comma-separated list of related expressions.
+	 */
+	tags: string;
+	/**
+	 * Previously the sticker asset hash, now an empty string
+	 * @deprecated
+	 */
+	asset?: '';
+	/**
+	 * Type of sticker
+	 *
+	 * See https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-types
+	 */
+	type: StickerType;
+	/**
+	 * Type of sticker format
+	 *
+	 * See https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-format-types
+	 */
+	format_type: StickerFormatType;
+	/**
+	 * Whether this guild sticker can be used, may be false due to loss of Server Boosts
+	 */
+	available?: boolean;
+	/**
+	 * ID of the guild that owns this sticker
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * The user that uploaded the guild sticker
+	 */
+	user?: APIUser;
+	/**
+	 * The standard sticker's sort order within its pack
+	 */
+	sort_value?: number;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-types
+ */
+export enum StickerType {
+	/**
+	 * An official sticker in a pack, part of Nitro or in a removed purchasable pack
+	 */
+	Standard = 1,
+	/**
+	 * A sticker uploaded to a guild for the guild's members
+	 */
+	Guild,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-format-types
+ */
+export enum StickerFormatType {
+	PNG = 1,
+	APNG,
+	Lottie,
+	GIF,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/sticker#sticker-item-object
+ */
+export type APIStickerItem = Pick<APISticker, 'id' | 'name' | 'format_type'>;
+
+/**
+ * https://discord.com/developers/docs/resources/sticker#sticker-pack-object
+ */
+export interface APIStickerPack {
+	/**
+	 * ID of the sticker pack
+	 */
+	id: Snowflake;
+	/**
+	 * The stickers in the pack
+	 */
+	stickers: APISticker[];
+	/**
+	 * Name of the sticker pack
+	 */
+	name: string;
+	/**
+	 * ID of the pack's SKU
+	 */
+	sku_id: Snowflake;
+	/**
+	 * ID of a sticker in the pack which is shown as the pack's icon
+	 */
+	cover_sticker_id?: Snowflake;
+	/**
+	 * Description of the sticker pack
+	 */
+	description: string;
+	/**
+	 * ID of the sticker pack's banner image
+	 */
+	banner_asset_id?: Snowflake;
+}

payloads/v9/teams.ts

@@ -0,0 +1,66 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/topics/teams
+ */
+
+import type { APIUser } from './user';
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/topics/teams#data-models-team-object
+ */
+export interface APITeam {
+	/**
+	 * A hash of the image of the team's icon
+	 */
+	icon: string | null;
+	/**
+	 * The unique id of the team
+	 */
+	id: Snowflake;
+	/**
+	 * The members of the team
+	 */
+	members: APITeamMember[];
+	/**
+	 * The name of the team
+	 */
+	name: string;
+	/**
+	 * The user id of the current team owner
+	 */
+	owner_user_id: Snowflake;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/teams#data-models-team-member-object
+ */
+export interface APITeamMember {
+	/**
+	 * The user's membership state on the team
+	 *
+	 * See https://discord.com/developers/docs/topics/teams#data-models-membership-state-enum
+	 */
+	membership_state: TeamMemberMembershipState;
+	/**
+	 * Will always be `["*"]`
+	 */
+	permissions: ['*'];
+	/**
+	 * The id of the parent team of which they are a member
+	 */
+	team_id: Snowflake;
+	/**
+	 * The avatar, discriminator, id, and username of the user
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 */
+	user: APIUser;
+}
+
+/**
+ * https://discord.com/developers/docs/topics/teams#data-models-membership-state-enum
+ */
+export enum TeamMemberMembershipState {
+	Invited = 1,
+	Accepted,
+}

payloads/v9/template.ts

@@ -0,0 +1,65 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/guild-template
+ */
+
+import type { APIUser } from './user';
+import type { Snowflake } from '../../globals';
+import type { RESTPostAPIGuildsJSONBody } from '../../rest/v9/index';
+
+/**
+ * https://discord.com/developers/docs/resources/guild-template#template-object
+ */
+export interface APITemplate {
+	/**
+	 * The template code (unique ID)
+	 */
+	code: string;
+	/**
+	 * Template name
+	 */
+	name: string;
+	/**
+	 * The description for the template
+	 */
+	description: string | null;
+	/**
+	 * Number of times this template has been used
+	 */
+	usage_count: number;
+	/**
+	 * The ID of the user who created the template
+	 */
+	creator_id: Snowflake;
+	/**
+	 * The user who created the template
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 */
+	creator: APIUser;
+	/**
+	 * When this template was created
+	 */
+	created_at: string;
+	/**
+	 * When this template was last synced to the source guild
+	 */
+	updated_at: string;
+	/**
+	 * The ID of the guild this template is based on
+	 */
+	source_guild_id: Snowflake;
+	/**
+	 * The guild snapshot this template contains
+	 */
+	serialized_source_guild: APITemplateSerializedSourceGuild;
+	/**
+	 * Whether the template has unsynced changes
+	 */
+	is_dirty: boolean | null;
+}
+
+export interface APITemplateSerializedSourceGuild extends Omit<RESTPostAPIGuildsJSONBody, 'icon'> {
+	description: string | null;
+	preferred_locale: string;
+	icon_hash: string | null;
+}

payloads/v9/user.ts

@@ -0,0 +1,347 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/user
+ */
+
+import type { APIGuildIntegration } from './guild';
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/resources/user#user-object
+ */
+export interface APIUser {
+	/**
+	 * The user's id
+	 */
+	id: Snowflake;
+	/**
+	 * The user's username, not unique across the platform
+	 */
+	username: string;
+	/**
+	 * The user's 4-digit discord-tag
+	 */
+	discriminator: string;
+	/**
+	 * The user's avatar hash
+	 *
+	 * See https://discord.com/developers/docs/reference#image-formatting
+	 */
+	avatar: string | null;
+	/**
+	 * Whether the user belongs to an OAuth2 application
+	 */
+	bot?: boolean;
+	/**
+	 * Whether the user is an Official Discord System user (part of the urgent message system)
+	 */
+	system?: boolean;
+	/**
+	 * Whether the user has two factor enabled on their account
+	 */
+	mfa_enabled?: boolean;
+	/**
+	 * The user's banner hash
+	 *
+	 * See https://discord.com/developers/docs/reference#image-formatting
+	 */
+	banner?: string | null;
+	/**
+	 * The user's banner color encoded as an integer representation of hexadecimal color code
+	 */
+	accent_color?: number | null;
+	/**
+	 * The user's chosen language option
+	 */
+	locale?: string;
+	/**
+	 * Whether the email on this account has been verified
+	 */
+	verified?: boolean;
+	/**
+	 * The user's email
+	 */
+	email?: string | null;
+	/**
+	 * The flags on a user's account
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object-user-flags
+	 */
+	flags?: UserFlags;
+	/**
+	 * The type of Nitro subscription on a user's account
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object-premium-types
+	 */
+	premium_type?: UserPremiumType;
+	/**
+	 * The public flags on a user's account
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object-user-flags
+	 */
+	public_flags?: UserFlags;
+	theme_colors?: number;
+	pronouns?: string;
+	bio?: string;
+	premium_since?: string;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/user#user-object-user-flags
+ */
+export enum UserFlags {
+	/**
+	 * Discord Employee
+	 */
+	Staff = 1 << 0,
+	/**
+	 * Partnered Server Owner
+	 */
+	Partner = 1 << 1,
+	/**
+	 * HypeSquad Events Member
+	 */
+	Hypesquad = 1 << 2,
+	/**
+	 * Bug Hunter Level 1
+	 */
+	BugHunterLevel1 = 1 << 3,
+	/**
+	 * House Bravery Member
+	 */
+	HypeSquadOnlineHouse1 = 1 << 6,
+	/**
+	 * House Brilliance Member
+	 */
+	HypeSquadOnlineHouse2 = 1 << 7,
+	/**
+	 * House Balance Member
+	 */
+	HypeSquadOnlineHouse3 = 1 << 8,
+	/**
+	 * Early Nitro Supporter
+	 */
+	PremiumEarlySupporter = 1 << 9,
+	/**
+	 * User is a [team](https://discord.com/developers/docs/topics/teams)
+	 */
+	TeamPseudoUser = 1 << 10,
+	/**
+	 * Bug Hunter Level 2
+	 */
+	BugHunterLevel2 = 1 << 14,
+	/**
+	 * Verified Bot
+	 */
+	VerifiedBot = 1 << 16,
+	/**
+	 * Early Verified Bot Developer
+	 */
+	VerifiedDeveloper = 1 << 17,
+	/**
+	 * Moderator Programs Alumni
+	 */
+	CertifiedModerator = 1 << 18,
+	/**
+	 * Bot uses only [HTTP interactions](https://discord.com/developers/docs/interactions/receiving-and-responding#receiving-an-interaction) and is shown in the online member list
+	 */
+	BotHTTPInteractions = 1 << 19,
+	/**
+	 * User has been identified as spammer
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
+	 */
+	Spammer = 1 << 20,
+	/**
+	 * User is an [Active Developer](https://support-dev.discord.com/hc/articles/10113997751447)
+	 */
+	ActiveDeveloper = 1 << 22,
+	/**
+	 * User's account has been [quarantined](https://support.discord.com/hc/articles/6461420677527) based on recent activity
+	 *
+	 * @unstable This user flag is currently not documented by Discord but has a known value which we will try to keep up to date.
+	 *
+	 * @privateRemarks
+	 *
+	 * This value would be 1 << 44, but bit shifting above 1 << 30 requires bigints
+	 */
+	Quarantined = 17592186044416,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/user#user-object-premium-types
+ */
+export enum UserPremiumType {
+	None,
+	NitroClassic,
+	Nitro,
+	NitroBasic,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/user#connection-object
+ */
+export interface APIConnection {
+	/**
+	 * ID of the connection account
+	 */
+	id: string;
+	/**
+	 * The username of the connection account
+	 */
+	name: string;
+	/**
+	 * The service of the connection
+	 *
+	 * See https://discord.com/developers/docs/resources/user#connection-object-services
+	 */
+	type: ConnectionService;
+	/**
+	 * Whether the connection is revoked
+	 */
+	revoked?: boolean;
+	/**
+	 * An array of partial server integrations
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#integration-object
+	 */
+	integrations?: Partial<APIGuildIntegration>[];
+	/**
+	 * Whether the connection is verified
+	 */
+	verified: boolean;
+	/**
+	 * Whether friend sync is enabled for this connection
+	 */
+	friend_sync: boolean;
+	/**
+	 * Whether activities related to this connection will be shown in presence updates
+	 */
+	show_activity: boolean;
+	/**
+	 * Whether this connection supports console voice transfer
+	 */
+	two_way_link: boolean;
+	/**
+	 * Visibility of this connection
+	 *
+	 * See https://discord.com/developers/docs/resources/user#connection-object-visibility-types
+	 */
+	visibility: ConnectionVisibility;
+}
+
+export enum ConnectionService {
+	BattleNet = 'battlenet',
+	eBay = 'ebay',
+	EpicGames = 'epicgames',
+	Facebook = 'facebook',
+	GitHub = 'github',
+	Instagram = 'instagram',
+	LeagueOfLegends = 'leagueoflegends',
+	PlayStationNetwork = 'playstation',
+	Reddit = 'reddit',
+	RiotGames = 'riotgames',
+	PayPal = 'paypal',
+	Spotify = 'spotify',
+	Skype = 'skype',
+	Steam = 'steam',
+	TikTok = 'tiktok',
+	Twitch = 'twitch',
+	Twitter = 'twitter',
+	Xbox = 'xbox',
+	YouTube = 'youtube',
+}
+
+export enum ConnectionVisibility {
+	/**
+	 * Invisible to everyone except the user themselves
+	 */
+	None,
+	/**
+	 * Visible to everyone
+	 */
+	Everyone,
+}
+
+/**
+ * https://discord.com/developers/docs/resources/user#application-role-connection-object-application-role-connection-structure
+ */
+export interface APIApplicationRoleConnection {
+	/**
+	 * The vanity name of the platform a bot has connected (max 50 characters)
+	 */
+	platform_name: string | null;
+	/**
+	 * The username on the platform a bot has connected (max 100 characters)
+	 */
+	platform_username: string | null;
+	/**
+	 * Object mapping application role connection metadata keys to their `string`-ified value (max 100 characters) for the user on the platform a bot has connected
+	 */
+	metadata: Record<string, string | number>;
+}
+
+export interface APIUserSettings {
+	index: string;
+	afk_timeout: number;
+	allow_accessibility_detection: boolean;
+	animate_emoji: boolean;
+	animate_stickers: number;
+	contact_sync_enabled: boolean;
+	convert_emoticons: boolean;
+	custom_status: APICustomStatus | null;
+	default_guilds_restricted: boolean;
+	detect_platform_accounts: boolean;
+	developer_mode: boolean;
+	disable_games_tab: boolean;
+	enable_tts_command: boolean;
+	explicit_content_filter: number;
+	friend_source_flags: APIFriendSourceFlags;
+	gateway_connected: boolean;
+	gif_auto_play: boolean;
+	guild_folders: APIGuildFolder[];
+	guild_positions: string[];
+	inline_attachment_media: boolean;
+	inline_embed_media: boolean;
+	locale: string;
+	message_display_compact: boolean;
+	native_phone_integration_enabled: boolean;
+	render_embeds: boolean;
+	render_reactions: boolean;
+	restricted_guilds: string[];
+	show_current_game: boolean;
+	status: 'online' | 'offline' | 'dnd' | 'idle' | 'invisible';
+	stream_notifications_enabled: boolean;
+	theme: 'dark' | 'light';
+	timezone_offset: number;
+}
+
+export interface APICustomStatus {
+	emoji_id?: string;
+	emoji_name?: string;
+	expires_at?: number;
+	text?: string;
+}
+
+export interface APIGuildFolder {
+	color: number;
+	guild_ids: string[];
+	id: number;
+	name: string;
+}
+
+export interface APIFriendSourceFlags {
+	all: boolean;
+}
+
+export enum APIRelationshipType {
+	outgoing = 4,
+	incoming = 3,
+	blocked = 2,
+	friends = 1,
+}
+
+export interface APIRelationship {
+	id: Snowflake;
+	user: APIUser;
+	type: APIRelationshipType;
+}

payloads/v9/voice.ts

@@ -0,0 +1,92 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/voice
+ */
+
+import type { APIGuildMember } from './guild';
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/resources/voice#voice-state-object
+ */
+export interface GatewayVoiceState {
+	/**
+	 * The guild id this voice state is for
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * The channel id this user is connected to
+	 */
+	channel_id: Snowflake | null;
+	/**
+	 * The user id this voice state is for
+	 */
+	user_id: Snowflake;
+	/**
+	 * The guild member this voice state is for
+	 *
+	 * See https://discord.com/developers/docs/resources/guild#guild-member-object
+	 */
+	member?: APIGuildMember;
+	/**
+	 * The session id for this voice state
+	 */
+	session_id: string;
+	/**
+	 * Whether this user is deafened by the server
+	 */
+	deaf: boolean;
+	/**
+	 * Whether this user is muted by the server
+	 */
+	mute: boolean;
+	/**
+	 * Whether this user is locally deafened
+	 */
+	self_deaf: boolean;
+	/**
+	 * Whether this user is locally muted
+	 */
+	self_mute: boolean;
+	/**
+	 * Whether this user is streaming using "Go Live"
+	 */
+	self_stream?: boolean;
+	/**
+	 * Whether this user's camera is enabled
+	 */
+	self_video: boolean;
+	/**
+	 * Whether this user is muted by the current user
+	 */
+	suppress: boolean;
+	/**
+	 * The time at which the user requested to speak
+	 */
+	request_to_speak_timestamp: string | null;
+}
+
+/**
+ * https://discord.com/developers/docs/resources/voice#voice-region-object
+ */
+export interface APIVoiceRegion {
+	/**
+	 * Unique ID for the region
+	 */
+	id: string;
+	/**
+	 * Name of the region
+	 */
+	name: string;
+	/**
+	 * `true` for a single server that is closest to the current user's client
+	 */
+	optimal: boolean;
+	/**
+	 * Whether this is a deprecated voice region (avoid switching to these)
+	 */
+	deprecated: boolean;
+	/**
+	 * Whether this is a custom voice region (used for events/etc)
+	 */
+	custom: boolean;
+}

payloads/v9/webhook.ts

@@ -0,0 +1,79 @@
+/**
+ * Types extracted from https://discord.com/developers/docs/resources/webhook
+ */
+
+import type { APIPartialChannel, APIPartialGuild, APIUser } from './index';
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/resources/webhook#webhook-object
+ */
+export interface APIWebhook {
+	/**
+	 * The id of the webhook
+	 */
+	id: Snowflake;
+	/**
+	 * The type of the webhook
+	 *
+	 * See https://discord.com/developers/docs/resources/webhook#webhook-object-webhook-types
+	 */
+	type: WebhookType;
+	/**
+	 * The guild id this webhook is for
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * The channel id this webhook is for
+	 */
+	channel_id: Snowflake;
+	/**
+	 * The user this webhook was created by (not returned when getting a webhook with its token)
+	 *
+	 * See https://discord.com/developers/docs/resources/user#user-object
+	 */
+	user?: APIUser;
+	/**
+	 * The default name of the webhook
+	 */
+	name: string | null;
+	/**
+	 * The default avatar of the webhook
+	 */
+	avatar: string | null;
+	/**
+	 * The secure token of the webhook (returned for Incoming Webhooks)
+	 */
+	token?: string;
+	/**
+	 * The bot/OAuth2 application that created this webhook
+	 */
+	application_id: Snowflake | null;
+	/**
+	 * The guild of the channel that this webhook is following (returned for Channel Follower Webhooks)
+	 */
+	source_guild?: APIPartialGuild;
+	/**
+	 * The channel that this webhook is following (returned for Channel Follower Webhooks)
+	 */
+	source_channel?: APIPartialChannel;
+	/**
+	 * The url used for executing the webhook (returned by the webhooks OAuth2 flow)
+	 */
+	url?: string;
+}
+
+export enum WebhookType {
+	/**
+	 * Incoming Webhooks can post messages to channels with a generated token
+	 */
+	Incoming = 1,
+	/**
+	 * Channel Follower Webhooks are internal webhooks used with Channel Following to post new messages into channels
+	 */
+	ChannelFollower,
+	/**
+	 * Application webhooks are webhooks used with Interactions
+	 */
+	Application,
+}