@wolfstar/plugin-gateway 0.6.0 → 0.7.0-next-20260928141845

package/dist/esm/index.d.ts

@@ -2,8 +2,8 @@ import { Client, ClientOptions, Listener } from "@wolfstar/http-framework";
 import { OptionalWebSocketManagerOptions, ShardRange, WebSocketManager } from "@discordjs/ws";
 import { API, Client as Client$1 } from "@discordjs/core";
 import { Awaitable, Cache, CacheEntityName, CacheEntityTypes, CacheFactory, CachePolicies, EntityCache, GatewaySessionStore, IterableEntityCache } from "@wolfstar/plugin-cache";
-import { APIAllowedMentions, APIApplication, APIApplicationCommand, APIAttachment, APIAuditLogChange, APIAutoModerationAction, APIAutoModerationRule, APIAutoModerationRuleTriggerMetadata, APIAvatarDecorationData, APIChannel, APIChannelMention, APICollectibles, APIEmbed, APIEmbedAuthor, APIEmbedField, APIEmbedFooter, APIEmbedImage, APIEmbedProvider, APIEmbedThumbnail, APIEmbedVideo, APIEmoji, APIExtendedInvite, APIGuild, APIGuildForumDefaultReactionEmoji, APIGuildForumTag, APIGuildMember, APIGuildOnboarding, APIGuildOnboardingPrompt, APIGuildOnboardingPromptOption, APIGuildPreview, APIGuildScheduledEvent, APIGuildScheduledEventEntityMetadata, APIGuildScheduledEventRecurrenceRule, APIGuildWelcomeScreen, APIGuildWidget, APIGuildWidgetMember, APIIncidentsData, APIInviteChannel, APIInviteGuild, APIMessage, APIMessageTopLevelComponent, APIOverwrite, APIPartialEmoji, APIPoll, APIPollAnswer, APIReaction, APIRole, APIRoleTags, APISoundboardSound, APIStageInstance, APISticker, APIStickerPack, APITemplate, APIThreadChannel, APIThreadMember, APIUser, APIUserPrimaryGuild, APIVoiceRegion, APIWebhook, ActivityFlags, ActivityType, AllowedMentionsTypes, AttachmentFlags, AuditLogEvent, AutoModerationRuleEventType, AutoModerationRuleKeywordPresetType, AutoModerationRuleTriggerType, ChannelFlags, ChannelType, ForumLayoutType, GatewayActivity, GatewayActivityAssets, GatewayActivityUpdateData, GatewayAutoModerationActionExecutionDispatchData, GatewayChannelPinsUpdateDispatchData, GatewayDispatchEvents, GatewayDispatchPayload, GatewayGuildDeleteDispatchData, GatewayGuildIntegrationsUpdateDispatchData, GatewayGuildMemberRemoveDispatchData, GatewayGuildMembersChunkDispatchData, GatewayGuildRoleDeleteDispatchData, GatewayGuildScheduledEventUserAddDispatchData, GatewayGuildScheduledEventUserRemoveDispatchData, GatewayGuildSoundboardSoundDeleteDispatchData, GatewayIntegrationDeleteDispatchData, GatewayIntentBits, GatewayInviteCreateDispatchData, GatewayInviteDeleteDispatchData, GatewayMessageDeleteBulkDispatchData, GatewayMessageDeleteDispatchData, GatewayMessageReactionRemoveAllDispatchData, GatewayPresenceClientStatus, GatewayPresenceUpdateData, GatewayRateLimitedDispatchData, GatewayReadyDispatchData, GatewayThreadDeleteDispatchData, GatewayThreadListSync, GatewayThreadMembersUpdateDispatchData, GatewayTypingStartDispatchData, GatewayVoiceServerUpdateDispatchData, GatewayWebhooksUpdateDispatchData, GuildDefaultMessageNotifications, GuildExplicitContentFilter, GuildMemberFlags, GuildOnboardingMode, GuildOnboardingPromptType, GuildPremiumTier, GuildScheduledEventEntityType, GuildScheduledEventPrivacyLevel, GuildScheduledEventStatus, GuildSystemChannelFlags, GuildVerificationLevel, GuildWidgetStyle, InviteTargetType, InviteType, Locale, MessageFlags, OverwriteType, PermissionFlagsBits, PollLayoutType, PresenceUpdateReceiveStatus, PresenceUpdateStatus, RESTAPIPoll, RESTGetAPIGuildVanityUrlResult, RESTPatchAPIChannelJSONBody, RESTPatchAPIGuildJSONBody, RESTPostAPIChannelMessageJSONBody, RESTPostAPIGuildsJSONBody, ReactionType, RoleFlags, Snowflake, SortOrderType, StageInstancePrivacyLevel, StickerFormatType, ThreadAutoArchiveDuration, ThreadChannelType, UserFlags, VideoQualityMode } from "discord-api-types/v10";
-import { APIActualInvite, Activity as Activity$1, ActivityFlagsBitField as ActivityFlagsBitField$1, AnnouncementChannel as AnnouncementChannel$1, AnnouncementThreadChannel as AnnouncementThreadChannel$1, Attachment as Attachment$1, AttachmentFlagsBitField as AttachmentFlagsBitField$1, AutoModerationRule as AutoModerationRule$1, BitField, BitField as BitField$1, BitFieldResolvable, BitFieldResolvable as BitFieldResolvable$1, CategoryChannel as CategoryChannel$1, Channel as Channel$1, ChannelFlagsBitField as ChannelFlagsBitField$1, DMChannel as DMChannel$1, Embed as Embed$1, Emoji as Emoji$1, ForumChannel as ForumChannel$1, GroupDMChannel as GroupDMChannel$1, Invite, MediaChannel as MediaChannel$1, Message as Message$1, MessageFlagsBitField as MessageFlagsBitField$1, Partialize, PermissionsBitField, Poll as Poll$1, PollAnswer as PollAnswer$1, Presence as Presence$1, PrivateThreadChannel as PrivateThreadChannel$1, PublicThreadChannel as PublicThreadChannel$1, Reaction, SoundboardSound as SoundboardSound$1, StageChannel as StageChannel$1, StageInstance as StageInstance$1, Sticker as Sticker$1, StickerPack as StickerPack$1, Structure as Structure$1, TextChannel as TextChannel$1, User as User$1, VoiceChannel as VoiceChannel$1, VoiceState as VoiceState$1, Webhook as Webhook$1 } from "@discordjs/structures";
+import { APIActionRowComponent, APIAllowedMentions, APIApplication, APIApplicationCommand, APIAttachment, APIAuditLogChange, APIAutoModerationAction, APIAutoModerationRule, APIAutoModerationRuleTriggerMetadata, APIAvatarDecorationData, APIButtonComponentWithCustomId, APIButtonComponentWithSKUId, APIButtonComponentWithURL, APIChannel, APIChannelMention, APIChannelSelectComponent, APICheckboxComponent, APICheckboxGroupComponent, APICheckboxGroupOption, APICollectibles, APIComponentInActionRow, APIContainerComponent, APIEmbed, APIEmbedAuthor, APIEmbedField, APIEmbedFooter, APIEmbedImage, APIEmbedProvider, APIEmbedThumbnail, APIEmbedVideo, APIEmoji, APIExtendedInvite, APIFileComponent, APIFileUploadComponent, APIGuild, APIGuildForumDefaultReactionEmoji, APIGuildForumTag, APIGuildMember, APIGuildOnboarding, APIGuildOnboardingPrompt, APIGuildOnboardingPromptOption, APIGuildPreview, APIGuildScheduledEvent, APIGuildScheduledEventEntityMetadata, APIGuildScheduledEventRecurrenceRule, APIGuildWelcomeScreen, APIGuildWidget, APIGuildWidgetMember, APIIncidentsData, APIInviteChannel, APIInviteGuild, APILabelComponent, APIMediaGalleryComponent, APIMediaGalleryItem, APIMentionableSelectComponent, APIMessage, APIMessageComponent, APIMessageComponentEmoji, APIMessageTopLevelComponent, APIModalComponent, APIOverwrite, APIPartialEmoji, APIPoll, APIPollAnswer, APIRadioGroupComponent, APIRadioGroupOption, APIReaction, APIRole, APIRoleSelectComponent, APIRoleTags, APISectionComponent, APISelectMenuDefaultValue, APISelectMenuOption, APISeparatorComponent, APISoundboardSound, APIStageInstance, APISticker, APIStickerPack, APIStringSelectComponent, APITemplate, APITextDisplayComponent, APITextInputComponent, APIThreadChannel, APIThreadMember, APIThumbnailComponent, APIUnfurledMediaItem, APIUser, APIUserPrimaryGuild, APIUserSelectComponent, APIVoiceRegion, APIWebhook, ActivityFlags, ActivityType, AllowedMentionsTypes, AttachmentFlags, AuditLogEvent, AutoModerationRuleEventType, AutoModerationRuleKeywordPresetType, AutoModerationRuleTriggerType, ButtonStyle, ChannelFlags, ChannelType, FileUploadType, ForumLayoutType, GatewayActivity, GatewayActivityAssets, GatewayActivityUpdateData, GatewayAutoModerationActionExecutionDispatchData, GatewayChannelPinsUpdateDispatchData, GatewayDispatchEvents, GatewayDispatchPayload, GatewayGuildDeleteDispatchData, GatewayGuildIntegrationsUpdateDispatchData, GatewayGuildMemberRemoveDispatchData, GatewayGuildMembersChunkDispatchData, GatewayGuildRoleDeleteDispatchData, GatewayGuildScheduledEventUserAddDispatchData, GatewayGuildScheduledEventUserRemoveDispatchData, GatewayGuildSoundboardSoundDeleteDispatchData, GatewayIntegrationDeleteDispatchData, GatewayIntentBits, GatewayInviteCreateDispatchData, GatewayInviteDeleteDispatchData, GatewayMessageDeleteBulkDispatchData, GatewayMessageDeleteDispatchData, GatewayMessageReactionRemoveAllDispatchData, GatewayPresenceClientStatus, GatewayPresenceUpdateData, GatewayRateLimitedDispatchData, GatewayReadyDispatchData, GatewayThreadDeleteDispatchData, GatewayThreadListSync, GatewayThreadMembersUpdateDispatchData, GatewayTypingStartDispatchData, GatewayVoiceServerUpdateDispatchData, GatewayWebhooksUpdateDispatchData, GuildDefaultMessageNotifications, GuildExplicitContentFilter, GuildMemberFlags, GuildOnboardingMode, GuildOnboardingPromptType, GuildPremiumTier, GuildScheduledEventEntityType, GuildScheduledEventPrivacyLevel, GuildScheduledEventStatus, GuildSystemChannelFlags, GuildVerificationLevel, GuildWidgetStyle, InviteTargetType, InviteType, Locale, MessageFlags, OverwriteType, PermissionFlagsBits, PollLayoutType, PresenceUpdateReceiveStatus, PresenceUpdateStatus, RESTAPIPoll, RESTGetAPIGuildVanityUrlResult, RESTPatchAPIChannelJSONBody, RESTPatchAPIGuildJSONBody, RESTPostAPIChannelMessageJSONBody, RESTPostAPIGuildsJSONBody, ReactionType, RoleFlags, SelectMenuDefaultValueType, SeparatorSpacingSize, Snowflake, SortOrderType, StageInstancePrivacyLevel, StickerFormatType, ThreadAutoArchiveDuration, ThreadChannelType, UserFlags, VideoQualityMode } from "discord-api-types/v10";
+import { APIActualInvite, ActionRowComponent, Activity as Activity$1, ActivityFlagsBitField as ActivityFlagsBitField$1, AnnouncementChannel as AnnouncementChannel$1, AnnouncementThreadChannel as AnnouncementThreadChannel$1, Attachment as Attachment$1, AttachmentFlagsBitField as AttachmentFlagsBitField$1, AutoModerationRule as AutoModerationRule$1, BitField, BitField as BitField$1, BitFieldResolvable, BitFieldResolvable as BitFieldResolvable$1, CategoryChannel as CategoryChannel$1, Channel as Channel$1, ChannelFlagsBitField as ChannelFlagsBitField$1, ChannelSelectMenuComponent as ChannelSelectMenuComponent$1, Component as Component$1, ContainerComponent as ContainerComponent$1, DMChannel as DMChannel$1, Embed as Embed$1, Emoji as Emoji$1, FileComponent as FileComponent$1, FileUploadComponent as FileUploadComponent$1, ForumChannel as ForumChannel$1, GroupDMChannel as GroupDMChannel$1, InteractiveButtonComponent as InteractiveButtonComponent$1, Invite, LinkButtonComponent as LinkButtonComponent$1, MediaChannel as MediaChannel$1, MediaGalleryComponent as MediaGalleryComponent$1, MediaGalleryItem as MediaGalleryItem$1, MentionableSelectMenuComponent as MentionableSelectMenuComponent$1, Message as Message$1, MessageFlagsBitField as MessageFlagsBitField$1, Partialize, PermissionsBitField, Poll as Poll$1, PollAnswer as PollAnswer$1, PremiumButtonComponent as PremiumButtonComponent$1, Presence as Presence$1, PrivateThreadChannel as PrivateThreadChannel$1, PublicThreadChannel as PublicThreadChannel$1, Reaction, RoleSelectMenuComponent as RoleSelectMenuComponent$1, SectionComponent as SectionComponent$1, SeparatorComponent as SeparatorComponent$1, SoundboardSound as SoundboardSound$1, StageChannel as StageChannel$1, StageInstance as StageInstance$1, Sticker as Sticker$1, StickerPack as StickerPack$1, StringSelectMenuComponent as StringSelectMenuComponent$1, Structure as Structure$1, TextChannel as TextChannel$1, TextDisplayComponent as TextDisplayComponent$1, TextInputComponent as TextInputComponent$1, ThumbnailComponent as ThumbnailComponent$1, UnfurledMediaItem as UnfurledMediaItem$1, User as User$1, UserSelectMenuComponent as UserSelectMenuComponent$1, VoiceChannel as VoiceChannel$1, VoiceState as VoiceState$1, Webhook as Webhook$1 } from "@discordjs/structures";
 import { BaseImageURLOptions, EmojiURLOptions, ImageURLOptions, REST, RawFile } from "@discordjs/rest";
 //#region src/util/PermissionsBitField.d.ts
 /**
@@ -3509,6 +3509,596 @@ export declare class ReactionManager {
   removeAll(): Promise<void>;
 }
 //#endregion
+//#region src/structures/components/Component.d.ts
+/**
+ * The raw data of any component, in a message or in a modal.
+ */
+export type APIAnyComponent = APIMessageComponent | APIModalComponent;
+/**
+ * The members every component of this package shares, mixed into each of them.
+ */
+export declare class ComponentMixin {
+  /**
+   * Whether this component has the same data as another one, nested components included.
+   *
+   * @param other The component, or raw component data, to compare with.
+   */
+  equals(other: Component | APIAnyComponent): boolean;
+}
+export interface Component<Data extends APIAnyComponent = APIAnyComponent> extends StructureMixin<Data>, ComponentMixin {}
+/**
+ * A component of a message or a modal: `@discordjs/structures`' `Component`, like discord.js' `Component`.
+ *
+ * @remarks
+ * Each component type has its own class, like `ActionRow` or `ButtonComponent`s, which `createComponent` picks for a raw
+ * component. This class is only instantiated for the types it has no class for. Their raw data is kept as received,
+ * nested components included, so `toJSON` serializes them back to the API.
+ *
+ * @typeParam Data The raw data of the component.
+ */
+export declare class Component<Data extends APIAnyComponent = APIAnyComponent> extends Component$1<Data, ""> {
+  /**
+   * Whether a value is a component of this package. Most components extend `@discordjs/structures`' own rather than
+   * this class, so `instanceof Component` matches any `@discordjs/structures` component carrying
+   * {@link StructureMixin}. Subclasses keep the default `instanceof` behavior.
+   *
+   * @param value The value to check.
+   */
+  static [Symbol.hasInstance](value: unknown): boolean;
+  /**
+   * @param data The raw component.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: Data, relations?: object);
+}
+//#endregion
+//#region src/structures/components/ActionRow.d.ts
+export interface ActionRow<Child extends MessageActionRowComponent | ModalActionRowComponent = MessageActionRowComponent | ModalActionRowComponent> extends StructureMixin<APIActionRowComponent<APIComponentInActionRow>>, ComponentMixin {}
+/**
+ * An action row, holding buttons, a select menu, or a text input: `@discordjs/structures`' `ActionRowComponent`, with
+ * its components like discord.js' `ActionRow`.
+ *
+ * @typeParam Child The components of the row.
+ */
+export declare class ActionRow<Child extends MessageActionRowComponent | ModalActionRowComponent = MessageActionRowComponent | ModalActionRowComponent> extends ActionRowComponent<APIComponentInActionRow, ""> {
+  /**
+   * @param data The raw action row.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIActionRowComponent<APIComponentInActionRow>, relations?: object);
+  /**
+   * The components in this action row.
+   */
+  get components(): Child[];
+}
+//#endregion
+//#region src/structures/components/ChannelSelectMenuComponent.d.ts
+export interface ChannelSelectMenuComponent extends StructureMixin<APIChannelSelectComponent>, ComponentMixin {}
+/**
+ * A select menu of channels: `@discordjs/structures`' `ChannelSelectMenuComponent`, like discord.js'.
+ */
+export declare class ChannelSelectMenuComponent extends ChannelSelectMenuComponent$1<""> {
+  /**
+   * @param data The raw select menu.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIChannelSelectComponent, relations?: object);
+  /**
+   * Whether the select menu is disabled.
+   */
+  get disabled(): boolean;
+  /**
+   * The values selected by default.
+   */
+  get defaultValues(): readonly APISelectMenuDefaultValue<SelectMenuDefaultValueType>[];
+}
+//#endregion
+//#region src/structures/components/CheckboxComponent.d.ts
+/**
+ * A modal component for a binary choice.
+ */
+export declare class CheckboxComponent extends Component<APICheckboxComponent> {
+  /**
+   * The custom ID of the checkbox.
+   */
+  get customId(): string;
+  /**
+   * Whether the checkbox is checked by default.
+   */
+  get default(): boolean;
+}
+//#endregion
+//#region src/structures/components/CheckboxGroupComponent.d.ts
+/**
+ * A modal component to pick any of its options.
+ */
+export declare class CheckboxGroupComponent extends Component<APICheckboxGroupComponent> {
+  /**
+   * The custom ID of the checkbox group.
+   */
+  get customId(): string;
+  /**
+   * The options of the checkbox group.
+   */
+  get options(): readonly APICheckboxGroupOption[];
+  /**
+   * The minimum number of options to pick, `1` by default.
+   */
+  get minValues(): number;
+  /**
+   * The maximum number of options to pick, the number of options by default.
+   */
+  get maxValues(): number;
+  /**
+   * Whether picking options is required to submit the modal, `true` by default.
+   */
+  get required(): boolean;
+}
+//#endregion
+//#region src/structures/components/ContainerComponent.d.ts
+export interface ContainerComponent extends StructureMixin<APIContainerComponent>, ComponentMixin {}
+/**
+ * A container visually grouping components, like an embed: `@discordjs/structures`' `ContainerComponent`, with its
+ * components like discord.js'.
+ */
+export declare class ContainerComponent extends ContainerComponent$1<""> {
+  /**
+   * @param data The raw container.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIContainerComponent, relations?: object);
+  /**
+   * The components in this container.
+   */
+  get components(): ComponentInContainer[];
+  /**
+   * The accent color of the container, `null` when it has none.
+   */
+  get accentColor(): number | null;
+  /**
+   * The accent color as a `#rrggbb` string, `null` when the container has none.
+   */
+  get hexAccentColor(): `#${string}` | null;
+  /**
+   * Whether the container is marked as a spoiler.
+   */
+  get spoiler(): boolean;
+}
+//#endregion
+//#region src/structures/components/UnfurledMediaItem.d.ts
+export interface UnfurledMediaItem extends StructureMixin<APIUnfurledMediaItem> {}
+/**
+ * A media item of a thumbnail, file, or media gallery component: `@discordjs/structures`' `UnfurledMediaItem`, like
+ * discord.js'.
+ */
+export declare class UnfurledMediaItem extends UnfurledMediaItem$1<""> {
+  /**
+   * @param data The raw media item.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIUnfurledMediaItem, relations?: object);
+}
+//#endregion
+//#region src/structures/components/FileComponent.d.ts
+export interface FileComponent extends StructureMixin<APIFileComponent>, ComponentMixin {}
+/**
+ * An attached file: `@discordjs/structures`' `FileComponent`, with its media like discord.js'.
+ */
+export declare class FileComponent extends FileComponent$1<""> {
+  /**
+   * @param data The raw file component.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIFileComponent, relations?: object);
+  /**
+   * The file, an `attachment://` reference to an attachment of the message.
+   */
+  get file(): UnfurledMediaItem;
+  /**
+   * Whether the file is marked as a spoiler.
+   */
+  get spoiler(): boolean;
+}
+//#endregion
+//#region src/structures/components/FileUploadComponent.d.ts
+export interface FileUploadComponent extends StructureMixin<APIFileUploadComponent>, ComponentMixin {}
+/**
+ * A file upload field of a modal: `@discordjs/structures`' `FileUploadComponent`, like discord.js'.
+ */
+export declare class FileUploadComponent extends FileUploadComponent$1<""> {
+  /**
+   * @param data The raw file upload.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIFileUploadComponent, relations?: object);
+  /**
+   * The types of files that can be uploaded, any when empty.
+   */
+  get fileTypes(): readonly FileUploadType[];
+}
+//#endregion
+//#region src/structures/components/InteractiveButtonComponent.d.ts
+export interface InteractiveButtonComponent extends StructureMixin<APIButtonComponentWithCustomId>, ComponentMixin {}
+/**
+ * A button sending an interaction when clicked, of the `Primary`, `Secondary`, `Success`, or `Danger` style:
+ * `@discordjs/structures`' `InteractiveButtonComponent`, with discord.js' `ButtonComponent` helpers.
+ */
+export declare class InteractiveButtonComponent extends InteractiveButtonComponent$1<ButtonStyle.Danger | ButtonStyle.Primary | ButtonStyle.Secondary | ButtonStyle.Success, ""> {
+  /**
+   * @param data The raw button.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIButtonComponentWithCustomId, relations?: object);
+  /**
+   * Whether the button is disabled.
+   */
+  get disabled(): boolean;
+  /**
+   * The emoji on the button.
+   */
+  get emoji(): APIMessageComponentEmoji | null;
+}
+//#endregion
+//#region src/structures/components/LabelComponent.d.ts
+/**
+ * A modal component associating a label and a description with another component, like discord.js' `LabelComponent`.
+ */
+export declare class LabelComponent extends Component<APILabelComponent> {
+  /**
+   * The label.
+   */
+  get label(): string;
+  /**
+   * The description of the label.
+   */
+  get description(): string | null;
+  /**
+   * The component the label is for.
+   */
+  get component(): ComponentInLabel;
+}
+//#endregion
+//#region src/structures/components/LinkButtonComponent.d.ts
+export interface LinkButtonComponent extends StructureMixin<APIButtonComponentWithURL>, ComponentMixin {}
+/**
+ * A button of the `Link` style, opening a URL: `@discordjs/structures`' `LinkButtonComponent`, with discord.js'
+ * `ButtonComponent` helpers.
+ */
+export declare class LinkButtonComponent extends LinkButtonComponent$1<""> {
+  /**
+   * @param data The raw button.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIButtonComponentWithURL, relations?: object);
+  /**
+   * Whether the button is disabled.
+   */
+  get disabled(): boolean;
+  /**
+   * The emoji on the button.
+   */
+  get emoji(): APIMessageComponentEmoji | null;
+}
+//#endregion
+//#region src/structures/components/MediaGalleryItem.d.ts
+export interface MediaGalleryItem extends StructureMixin<APIMediaGalleryItem> {}
+/**
+ * An item of a media gallery component: `@discordjs/structures`' `MediaGalleryItem`, with its media like discord.js'.
+ */
+export declare class MediaGalleryItem extends MediaGalleryItem$1<""> {
+  /**
+   * @param data The raw media gallery item.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIMediaGalleryItem, relations?: object);
+  /**
+   * The media of the item.
+   */
+  get media(): UnfurledMediaItem;
+  /**
+   * The description of the item.
+   */
+  get description(): string | undefined;
+  /**
+   * Whether the item is marked as a spoiler.
+   */
+  get spoiler(): boolean;
+}
+//#endregion
+//#region src/structures/components/MediaGalleryComponent.d.ts
+export interface MediaGalleryComponent extends StructureMixin<APIMediaGalleryComponent>, ComponentMixin {}
+/**
+ * A gallery of images and videos: `@discordjs/structures`' `MediaGalleryComponent`, with its items like discord.js'.
+ */
+export declare class MediaGalleryComponent extends MediaGalleryComponent$1<""> {
+  /**
+   * @param data The raw media gallery.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIMediaGalleryComponent, relations?: object);
+  /**
+   * The items of the gallery.
+   */
+  get items(): MediaGalleryItem[];
+}
+//#endregion
+//#region src/structures/components/MentionableSelectMenuComponent.d.ts
+export interface MentionableSelectMenuComponent extends StructureMixin<APIMentionableSelectComponent>, ComponentMixin {}
+/**
+ * A select menu of users and roles: `@discordjs/structures`' `MentionableSelectMenuComponent`, like discord.js'.
+ */
+export declare class MentionableSelectMenuComponent extends MentionableSelectMenuComponent$1<""> {
+  /**
+   * @param data The raw select menu.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIMentionableSelectComponent, relations?: object);
+  /**
+   * Whether the select menu is disabled.
+   */
+  get disabled(): boolean;
+  /**
+   * The values selected by default.
+   */
+  get defaultValues(): readonly APISelectMenuDefaultValue<SelectMenuDefaultValueType>[];
+}
+//#endregion
+//#region src/structures/components/PremiumButtonComponent.d.ts
+export interface PremiumButtonComponent extends StructureMixin<APIButtonComponentWithSKUId>, ComponentMixin {}
+/**
+ * A button of the `Premium` style, purchasing a SKU: `@discordjs/structures`' `PremiumButtonComponent`.
+ */
+export declare class PremiumButtonComponent extends PremiumButtonComponent$1<""> {
+  /**
+   * @param data The raw button.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIButtonComponentWithSKUId, relations?: object);
+  /**
+   * Whether the button is disabled.
+   */
+  get disabled(): boolean;
+}
+//#endregion
+//#region src/structures/components/RadioGroupComponent.d.ts
+/**
+ * A modal component to pick one of its options.
+ */
+export declare class RadioGroupComponent extends Component<APIRadioGroupComponent> {
+  /**
+   * The custom ID of the radio group.
+   */
+  get customId(): string;
+  /**
+   * The options of the radio group.
+   */
+  get options(): readonly APIRadioGroupOption[];
+  /**
+   * Whether picking an option is required to submit the modal, `true` by default.
+   */
+  get required(): boolean;
+}
+//#endregion
+//#region src/structures/components/RoleSelectMenuComponent.d.ts
+export interface RoleSelectMenuComponent extends StructureMixin<APIRoleSelectComponent>, ComponentMixin {}
+/**
+ * A select menu of roles: `@discordjs/structures`' `RoleSelectMenuComponent`, like discord.js'.
+ */
+export declare class RoleSelectMenuComponent extends RoleSelectMenuComponent$1<""> {
+  /**
+   * @param data The raw select menu.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIRoleSelectComponent, relations?: object);
+  /**
+   * Whether the select menu is disabled.
+   */
+  get disabled(): boolean;
+  /**
+   * The values selected by default.
+   */
+  get defaultValues(): readonly APISelectMenuDefaultValue<SelectMenuDefaultValueType>[];
+}
+//#endregion
+//#region src/structures/components/ThumbnailComponent.d.ts
+export interface ThumbnailComponent extends StructureMixin<APIThumbnailComponent>, ComponentMixin {}
+/**
+ * A small image, used as the accessory of a section: `@discordjs/structures`' `ThumbnailComponent`, with its media like
+ * discord.js'.
+ */
+export declare class ThumbnailComponent extends ThumbnailComponent$1<""> {
+  /**
+   * @param data The raw thumbnail.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIThumbnailComponent, relations?: object);
+  /**
+   * The media of the thumbnail.
+   */
+  get media(): UnfurledMediaItem;
+  /**
+   * The description of the thumbnail.
+   */
+  get description(): string | undefined;
+  /**
+   * Whether the thumbnail is marked as a spoiler.
+   */
+  get spoiler(): boolean;
+}
+//#endregion
+//#region src/structures/components/SectionComponent.d.ts
+export interface SectionComponent extends StructureMixin<APISectionComponent>, ComponentMixin {}
+/**
+ * Text displayed alongside an accessory: `@discordjs/structures`' `SectionComponent`, with its components and accessory
+ * like discord.js'.
+ */
+export declare class SectionComponent extends SectionComponent$1<""> {
+  /**
+   * @param data The raw section.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APISectionComponent, relations?: object);
+  /**
+   * The text components in this section.
+   */
+  get components(): ComponentInSection[];
+  /**
+   * The button or thumbnail shown next to the section.
+   */
+  get accessory(): ButtonComponent | ThumbnailComponent;
+}
+//#endregion
+//#region src/structures/components/SeparatorComponent.d.ts
+export interface SeparatorComponent extends StructureMixin<APISeparatorComponent>, ComponentMixin {}
+/**
+ * Vertical padding between components: `@discordjs/structures`' `SeparatorComponent`, with Discord's defaults like
+ * discord.js'.
+ */
+export declare class SeparatorComponent extends SeparatorComponent$1<""> {
+  /**
+   * @param data The raw separator.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APISeparatorComponent, relations?: object);
+  /**
+   * The size of the padding, `Small` by default.
+   */
+  get spacing(): SeparatorSpacingSize;
+  /**
+   * Whether a divider line is shown, `true` by default.
+   */
+  get divider(): boolean;
+}
+//#endregion
+//#region src/structures/components/StringSelectMenuComponent.d.ts
+export interface StringSelectMenuComponent extends StructureMixin<APIStringSelectComponent>, ComponentMixin {}
+/**
+ * A select menu of predefined text options: `@discordjs/structures`' `StringSelectMenuComponent`, like discord.js'.
+ */
+export declare class StringSelectMenuComponent extends StringSelectMenuComponent$1<""> {
+  /**
+   * @param data The raw select menu.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIStringSelectComponent, relations?: object);
+  /**
+   * Whether the select menu is disabled.
+   */
+  get disabled(): boolean;
+  /**
+   * The options of the select menu.
+   */
+  get options(): readonly APISelectMenuOption[];
+}
+//#endregion
+//#region src/structures/components/TextDisplayComponent.d.ts
+export interface TextDisplayComponent extends StructureMixin<APITextDisplayComponent>, ComponentMixin {}
+/**
+ * Markdown text: `@discordjs/structures`' `TextDisplayComponent`, like discord.js'.
+ */
+export declare class TextDisplayComponent extends TextDisplayComponent$1<""> {
+  /**
+   * @param data The raw text display.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APITextDisplayComponent, relations?: object);
+}
+//#endregion
+//#region src/structures/components/TextInputComponent.d.ts
+export interface TextInputComponent extends StructureMixin<APITextInputComponent>, ComponentMixin {}
+/**
+ * A text field of a modal: `@discordjs/structures`' `TextInputComponent`, like discord.js'.
+ */
+export declare class TextInputComponent extends TextInputComponent$1<""> {
+  /**
+   * @param data The raw text input.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APITextInputComponent, relations?: object);
+}
+//#endregion
+//#region src/structures/components/UserSelectMenuComponent.d.ts
+export interface UserSelectMenuComponent extends StructureMixin<APIUserSelectComponent>, ComponentMixin {}
+/**
+ * A select menu of users: `@discordjs/structures`' `UserSelectMenuComponent`, like discord.js'.
+ */
+export declare class UserSelectMenuComponent extends UserSelectMenuComponent$1<""> {
+  /**
+   * @param data The raw select menu.
+   * @param relations The related structures, resolved from the cache.
+   */
+  constructor(data: APIUserSelectComponent, relations?: object);
+  /**
+   * Whether the select menu is disabled.
+   */
+  get disabled(): boolean;
+  /**
+   * The values selected by default.
+   */
+  get defaultValues(): readonly APISelectMenuDefaultValue<SelectMenuDefaultValueType>[];
+}
+//#endregion
+//#region src/util/components.d.ts
+/**
+ * A button, of any style.
+ */
+export type ButtonComponent = InteractiveButtonComponent | LinkButtonComponent | PremiumButtonComponent;
+/**
+ * A select menu, of any type.
+ */
+export type SelectMenuComponent = ChannelSelectMenuComponent | MentionableSelectMenuComponent | RoleSelectMenuComponent | StringSelectMenuComponent | UserSelectMenuComponent;
+/**
+ * A component of a message's action row.
+ */
+export type MessageActionRowComponent = ButtonComponent | SelectMenuComponent;
+/**
+ * A component of a modal's action row.
+ */
+export type ModalActionRowComponent = TextInputComponent;
+/**
+ * A component of a section.
+ */
+export type ComponentInSection = TextDisplayComponent;
+/**
+ * A component of a container.
+ */
+export type ComponentInContainer = ActionRow<MessageActionRowComponent> | FileComponent | MediaGalleryComponent | SectionComponent | SeparatorComponent | TextDisplayComponent;
+/**
+ * A top-level component of a message.
+ */
+export type MessageTopLevelComponent = ComponentInContainer | ContainerComponent;
+/**
+ * A component of a label.
+ */
+export type ComponentInLabel = CheckboxComponent | CheckboxGroupComponent | FileUploadComponent | RadioGroupComponent | SelectMenuComponent | TextInputComponent;
+/**
+ * The component {@link createComponent} builds for some raw component data, {@link Component} for the types this
+ * package has no class for.
+ *
+ * @typeParam Data The raw component data.
+ */
+export type ComponentOf<Data extends APIAnyComponent> = Data extends APIActionRowComponent<infer Child> ? ActionRow<Extract<ComponentOf<Child>, MessageActionRowComponent | ModalActionRowComponent>> : Data extends APIButtonComponentWithCustomId ? InteractiveButtonComponent : Data extends APIButtonComponentWithURL ? LinkButtonComponent : Data extends APIButtonComponentWithSKUId ? PremiumButtonComponent : Data extends APIStringSelectComponent ? StringSelectMenuComponent : Data extends APIUserSelectComponent ? UserSelectMenuComponent : Data extends APIRoleSelectComponent ? RoleSelectMenuComponent : Data extends APIMentionableSelectComponent ? MentionableSelectMenuComponent : Data extends APIChannelSelectComponent ? ChannelSelectMenuComponent : Data extends APITextInputComponent ? TextInputComponent : Data extends APISectionComponent ? SectionComponent : Data extends APITextDisplayComponent ? TextDisplayComponent : Data extends APIThumbnailComponent ? ThumbnailComponent : Data extends APIMediaGalleryComponent ? MediaGalleryComponent : Data extends APIFileComponent ? FileComponent : Data extends APISeparatorComponent ? SeparatorComponent : Data extends APIContainerComponent ? ContainerComponent : Data extends APILabelComponent ? LabelComponent : Data extends APIFileUploadComponent ? FileUploadComponent : Data extends APIRadioGroupComponent ? RadioGroupComponent : Data extends APICheckboxGroupComponent ? CheckboxGroupComponent : Data extends APICheckboxComponent ? CheckboxComponent : Component;
+/**
+ * Any component of this package.
+ */
+export type AnyComponent = ComponentOf<APIAnyComponent>;
+/**
+ * Builds the component class matching some raw component data, like discord.js' `createComponent`: an `ActionRow` for
+ * an action row, a `LinkButtonComponent` for a link button, and so on. Nested components are built too, when accessed.
+ *
+ * @param data The raw component data, or a component, which is returned as is.
+ * @returns The component.
+ */
+export declare function createComponent<Data extends APIAnyComponent>(data: Data | ComponentOf<Data>): ComponentOf<Data>;
+/**
+ * Finds a component by its custom ID in a component tree, like discord.js' `findComponentByCustomId`.
+ *
+ * @param components The components, or raw component data, to search in, like a message's top-level components.
+ * @param customId The custom ID.
+ * @returns The component, as given, `null` when none has the custom ID.
+ */
+export declare function findComponentByCustomId(components: readonly (AnyComponent | APIAnyComponent)[], customId: string): AnyComponent | APIAnyComponent | null;
+//#endregion
 //#region src/structures/messages/Attachment.d.ts
 export interface Attachment extends StructureMixin<APIAttachment> {}
 /**
@@ -3955,9 +4545,10 @@ export declare class Message extends Message$1<""> {
   get attachments(): Attachment[];
   get embeds(): Embed[];
   /**
-   * The raw components of the message. Build components with `@discordjs/builders`.
+   * The top-level components of the message, like discord.js'. Their `toJSON` returns the raw components; build new
+   * ones with `@discordjs/builders`.
    */
-  get components(): import("discord-api-types/v10").APIMessageTopLevelComponent[];
+  get components(): MessageTopLevelComponent[];
   /**
    * The raw sticker items of the message; fetch a full sticker with `client.fetchSticker(id)`.
    */
@@ -8830,6 +9421,116 @@ export declare namespace EventGatewayListener {
   }
 }
 //#endregion
+//#region src/errors/Messages.d.ts
+/**
+ * The message of every {@link GatewayErrorCode}: a string, or a function formatting the arguments passed to the
+ * error's constructor.
+ */
+export declare const GatewayErrorMessages: {
+  readonly ClientSessionStoreConflict: "sessionStore replaces gateway.retrieveSessionInfo and gateway.updateSessionInfo, pass one or the other";
+  readonly ClientNotConstructed: "No GatewayClient has been constructed yet";
+  readonly DispatchHandlerConflict: (event: string) => string;
+  readonly DispatchTimeout: (type: string, shardId: number, partition: string | null, timeout: number) => string;
+  readonly SessionStoreFailed: (operation: "get" | "set", shardId: number) => string;
+  readonly SessionStoreTimeout: (timeout: number) => string;
+  readonly CacheAsynchronous: (entity: string) => string;
+  readonly CacheRelationsAsynchronous: (entity: string) => string;
+  readonly CacheNotIterable: (entity: string) => string;
+  readonly CacheKeyUnresolvable: (entity: string, reason: string) => string;
+  readonly IdUnresolvable: "Cannot resolve an ID from a structure without one";
+  readonly ChannelGuildUnknown: (channelId: string) => string;
+  readonly ChannelTypeChanged: (channelId: string, from: number, to: number) => string;
+  readonly ChannelLockPermissionsConflict: "Pass either lockPermissions or permissionOverwrites, not both";
+  readonly GuildChannelOrphan: (channelId: string) => string;
+  readonly ThreadParentUnknown: (threadId: string) => string;
+  readonly ThreadOwnerUnknown: (threadId: string) => string;
+  readonly ThreadMemberIdsMissing: (action: string) => string;
+  readonly GuildIntegrationNotFound: (guildId: string, integrationId: string) => string;
+  readonly GuildMemberUserUnknown: "This member has no user data: its ID is unknown";
+  readonly GuildMembersQueryConflict: "Cannot request members by both query and userIds";
+  readonly GuildMembersUserIdsLimit: "Cannot request more than 100 members by their IDs";
+  readonly MemberFetchNonceLength: "The nonce of a members request cannot exceed 32 bytes";
+  readonly GuildMembersNoncePending: (nonce: string) => string;
+  readonly GuildMembersTimeout: (guildId: string, nonce: string, timeout: number) => string;
+  readonly GuildMembersRateLimited: (guildId: string, nonce: string, retryAfter: number) => string;
+  readonly PresenceNotFetchable: (guildId: string, userId: string) => string;
+  readonly InviteGuildUnknown: (code: string) => string;
+  readonly EmojiEmpty: "Cannot resolve an empty string to an emoji";
+  readonly EmojiType: "Cannot resolve an emoji without an ID nor a name";
+  readonly NotGuildSticker: "Only guild stickers can be edited or deleted";
+  readonly NotGuildSoundboardSound: "Default soundboard sounds cannot be changed";
+  readonly MessageContentType: "The content of a message must be a string";
+  readonly MessageNonceLength: "A message nonce must be at most 25 characters long";
+  readonly MessageNonceType: "A message nonce must be an integer";
+  readonly MessageForwardChannelMissing: "Forwarding a message by ID needs its channel";
+  readonly MessageReferenceMissing: (messageId: string) => string;
+  readonly MessagePollMissing: (messageId: string) => string;
+  readonly AttachmentDownloadFailed: (url: string, status: number) => string;
+  readonly VoiceStateNotOwn: "Only the bot's own voice state can request to speak";
+  readonly VoiceStateGuildUnknown: "This voice state does not belong to a guild";
+  readonly WebhookTokenUnavailable: (webhookId: string) => string;
+};
+//#endregion
+//#region src/errors/ErrorCodes.d.ts
+/**
+ * The code of an error thrown by this package, set as its `code`.
+ */
+export type GatewayErrorCode = keyof typeof GatewayErrorMessages;
+/**
+ * Every {@link GatewayErrorCode}, keyed by itself, like discord.js's `DiscordjsErrorCodes`.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await webhook.send("Awoo");
+ * } catch (error) {
+ *   if (error instanceof GatewayError && error.code === GatewayErrorCodes.WebhookTokenUnavailable) {
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare const GatewayErrorCodes: { readonly [Code in GatewayErrorCode]: Code; };
+//#endregion
+//#region src/errors/GatewayError.d.ts
+/**
+ * The arguments the message of `Code` is formatted with, none when the message is a plain string.
+ */
+export type GatewayErrorArgs<Code extends GatewayErrorCode> = (typeof GatewayErrorMessages)[Code] extends ((...args: infer Args) => string) ? Args : [];
+/**
+ * An {@link Error} carrying a {@link GatewayErrorCode}, like discord.js's `DiscordjsError`.
+ *
+ * @remarks
+ * Its `name` is `GatewayError [<code>]`, and its message is the code's entry in {@link GatewayErrorMessages}.
+ */
+export declare class GatewayError<Code extends GatewayErrorCode = GatewayErrorCode> extends Error {
+  /**
+   * The code of the error.
+   */
+  readonly code: Code;
+  constructor(code: Code, ...args: GatewayErrorArgs<Code>);
+}
+/**
+ * A {@link TypeError} carrying a {@link GatewayErrorCode}, like discord.js's `DiscordjsTypeError`.
+ */
+export declare class GatewayTypeError<Code extends GatewayErrorCode = GatewayErrorCode> extends TypeError {
+  /**
+   * The code of the error.
+   */
+  readonly code: Code;
+  constructor(code: Code, ...args: GatewayErrorArgs<Code>);
+}
+/**
+ * A {@link RangeError} carrying a {@link GatewayErrorCode}, like discord.js's `DiscordjsRangeError`.
+ */
+export declare class GatewayRangeError<Code extends GatewayErrorCode = GatewayErrorCode> extends RangeError {
+  /**
+   * The code of the error.
+   */
+  readonly code: Code;
+  constructor(code: Code, ...args: GatewayErrorArgs<Code>);
+}
+//#endregion
 //#region src/structures/invites/GroupDMInvite.d.ts
 /**
  * An invite to a group direct message. Its channel (name, icon, recipients) is exposed as `channel`.
@@ -8952,7 +9653,7 @@ export declare function isDeepEqual(a: unknown, b: unknown): boolean;
  * event order is preserved. The error only reports that the partition is stuck, usually on a slow or unreachable
  * cache.
  */
-export declare class DispatchTimeoutError extends Error {
+export declare class DispatchTimeoutError extends GatewayError<"DispatchTimeout"> {
   /**
    * The type of the slow dispatch, e.g. `MESSAGE_CREATE`.
    */
@@ -8977,7 +9678,7 @@ export declare class DispatchTimeoutError extends Error {
  * @remarks
  * The request is dropped: chunks arriving later still update the cache and emit `guildMembersChunk`.
  */
-export declare class GuildMembersTimeoutError extends Error {
+export declare class GuildMembersTimeoutError extends GatewayError<"GuildMembersTimeout"> {
   /**
    * The ID of the guild whose members were requested.
    */
@@ -8995,7 +9696,7 @@ export declare class GuildMembersTimeoutError extends Error {
 /**
  * Thrown by `GuildMemberManager#request` when Discord answers with `RATE_LIMITED` instead of the members' chunks.
  */
-export declare class GuildMembersRateLimitError extends Error {
+export declare class GuildMembersRateLimitError extends GatewayError<"GuildMembersRateLimited"> {
   /**
    * The ID of the guild whose members were requested.
    */
@@ -9017,7 +9718,7 @@ export declare class GuildMembersRateLimitError extends Error {
  * Neither failure stops the shard: a failed (or timed out) read identifies instead of resuming, and a failed write
  * only means the session may not be resumed after a restart. The store's error is the `cause`.
  */
-export declare class GatewaySessionStoreError extends Error {
+export declare class GatewaySessionStoreError extends GatewayError<"SessionStoreFailed"> {
   /**
    * Whether the store failed to read (`"get"`) or write (`"set"`) the session.
    */