@wolfstar/plugin-gateway 0.7.0-next-20260928135015 → 0.7.0

package/dist/esm/index.js

@@ -2,8 +2,8 @@ import { Client, Listener, container } from "@wolfstar/http-framework";
 import { CloseCodes, DefaultWebSocketManagerOptions, WebSocketManager, WebSocketShardEvents, WebSocketShardStatus } from "@discordjs/ws";
 import { Client as Client$1 } from "@discordjs/core";
 import { applyGatewayDispatch, autoModerationRuleKey, banKey, createCache, emojiKey, integrationKey, inviteKey, isIterableCache, memberKey, mergeValues, messageKey, presenceKey, roleKey, scheduledEventKey, soundboardSoundKey, stageInstanceKey, stickerKey, threadMemberKey, voiceStateKey } from "@wolfstar/plugin-cache";
-import { ActivityType, AuditLogEvent, ChannelType, FormattingPatterns, GatewayDispatchEvents, GatewayIntentBits, GatewayOpcodes, GuildFeature, GuildMemberFlags, GuildPremiumTier, GuildScheduledEventStatus, GuildSystemChannelFlags, GuildWidgetStyle, InviteType, MessageFlags, MessageReferenceType, MessageType, OverwriteType, PermissionFlagsBits, PresenceUpdateStatus, RoleFlags, RouteBases, Routes, StickerFormatType, UserFlags, WebhookType } from "discord-api-types/v10";
-import { 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, 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, 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 { ActivityType, AuditLogEvent, ButtonStyle, ChannelType, ComponentType, FormattingPatterns, GatewayDispatchEvents, GatewayIntentBits, GatewayOpcodes, GuildFeature, GuildMemberFlags, GuildPremiumTier, GuildScheduledEventStatus, GuildSystemChannelFlags, GuildWidgetStyle, InviteType, MessageFlags, MessageReferenceType, MessageType, OverwriteType, PermissionFlagsBits, PresenceUpdateStatus, RoleFlags, RouteBases, Routes, SeparatorSpacingSize, StickerFormatType, UserFlags, WebhookType } from "discord-api-types/v10";
+import { 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, 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, 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 { readFile } from "node:fs/promises";
 import { basename } from "node:path";
 import { CDN, DiscordAPIError } from "@discordjs/rest";
@@ -8959,6 +8959,784 @@ function definedEntries(value) {
 	return Object.entries(value).filter(([, entry]) => entry !== void 0);
 }
 
+//#endregion
+//#region src/structures/components/Component.ts
+/**
+* The members every component of this package shares, mixed into each of them.
+*/
+var ComponentMixin = class {
+	/**
+	* 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) {
+		return isDeepEqual(this.toJSON(), other instanceof Component ? other.toJSON() : other);
+	}
+};
+/**
+* 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.
+*/
+var Component = class Component extends Component$1 {
+	/**
+	* 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) {
+		if (this !== Component) return Function.prototype[Symbol.hasInstance].call(this, value);
+		return value instanceof Component$1 && kRelations in value;
+	}
+	/**
+	* @param data The raw component.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+};
+Mixin(Component, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/ActionRow.ts
+/**
+* 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.
+*/
+var ActionRow = class extends ActionRowComponent {
+	/**
+	* @param data The raw action row.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* The components in this action row.
+	*/
+	get components() {
+		return this[kData].components.map((component) => createComponent(component));
+	}
+};
+Mixin(ActionRow, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/ChannelSelectMenuComponent.ts
+/**
+* A select menu of channels: `@discordjs/structures`' `ChannelSelectMenuComponent`, like discord.js'.
+*/
+var ChannelSelectMenuComponent = class extends ChannelSelectMenuComponent$1 {
+	/**
+	* @param data The raw select menu.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* Whether the select menu is disabled.
+	*/
+	get disabled() {
+		return this[kData].disabled ?? false;
+	}
+	/**
+	* The values selected by default.
+	*/
+	get defaultValues() {
+		return this[kData].default_values ?? [];
+	}
+};
+Mixin(ChannelSelectMenuComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/CheckboxComponent.ts
+/**
+* A modal component for a binary choice.
+*/
+var CheckboxComponent = class extends Component {
+	/**
+	* The custom ID of the checkbox.
+	*/
+	get customId() {
+		return this[kData].custom_id;
+	}
+	/**
+	* Whether the checkbox is checked by default.
+	*/
+	get default() {
+		return this[kData].default ?? false;
+	}
+};
+
+//#endregion
+//#region src/structures/components/CheckboxGroupComponent.ts
+/**
+* A modal component to pick any of its options.
+*/
+var CheckboxGroupComponent = class extends Component {
+	/**
+	* The custom ID of the checkbox group.
+	*/
+	get customId() {
+		return this[kData].custom_id;
+	}
+	/**
+	* The options of the checkbox group.
+	*/
+	get options() {
+		return this[kData].options;
+	}
+	/**
+	* The minimum number of options to pick, `1` by default.
+	*/
+	get minValues() {
+		return this[kData].min_values ?? 1;
+	}
+	/**
+	* The maximum number of options to pick, the number of options by default.
+	*/
+	get maxValues() {
+		return this[kData].max_values ?? this.options.length;
+	}
+	/**
+	* Whether picking options is required to submit the modal, `true` by default.
+	*/
+	get required() {
+		return this[kData].required ?? true;
+	}
+};
+
+//#endregion
+//#region src/structures/components/ContainerComponent.ts
+/**
+* A container visually grouping components, like an embed: `@discordjs/structures`' `ContainerComponent`, with its
+* components like discord.js'.
+*/
+var ContainerComponent = class extends ContainerComponent$1 {
+	/**
+	* @param data The raw container.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* The components in this container.
+	*/
+	get components() {
+		return this[kData].components.map((component) => createComponent(component));
+	}
+	/**
+	* The accent color of the container, `null` when it has none.
+	*/
+	get accentColor() {
+		return this[kData].accent_color ?? null;
+	}
+	/**
+	* The accent color as a `#rrggbb` string, `null` when the container has none.
+	*/
+	get hexAccentColor() {
+		const { accentColor } = this;
+		return accentColor === null ? null : `#${accentColor.toString(16).padStart(6, "0")}`;
+	}
+	/**
+	* Whether the container is marked as a spoiler.
+	*/
+	get spoiler() {
+		return this[kData].spoiler ?? false;
+	}
+};
+Mixin(ContainerComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/UnfurledMediaItem.ts
+/**
+* A media item of a thumbnail, file, or media gallery component: `@discordjs/structures`' `UnfurledMediaItem`, like
+* discord.js'.
+*/
+var UnfurledMediaItem = class extends UnfurledMediaItem$1 {
+	/**
+	* @param data The raw media item.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+};
+Mixin(UnfurledMediaItem, [StructureMixin]);
+
+//#endregion
+//#region src/structures/components/FileComponent.ts
+/**
+* An attached file: `@discordjs/structures`' `FileComponent`, with its media like discord.js'.
+*/
+var FileComponent = class extends FileComponent$1 {
+	/**
+	* @param data The raw file component.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* The file, an `attachment://` reference to an attachment of the message.
+	*/
+	get file() {
+		return new UnfurledMediaItem(this[kData].file);
+	}
+	/**
+	* Whether the file is marked as a spoiler.
+	*/
+	get spoiler() {
+		return this[kData].spoiler ?? false;
+	}
+};
+Mixin(FileComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/FileUploadComponent.ts
+/**
+* A file upload field of a modal: `@discordjs/structures`' `FileUploadComponent`, like discord.js'.
+*/
+var FileUploadComponent = class extends FileUploadComponent$1 {
+	/**
+	* @param data The raw file upload.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* The types of files that can be uploaded, any when empty.
+	*/
+	get fileTypes() {
+		return this[kData].file_types ?? [];
+	}
+};
+Mixin(FileUploadComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/InteractiveButtonComponent.ts
+/**
+* A button sending an interaction when clicked, of the `Primary`, `Secondary`, `Success`, or `Danger` style:
+* `@discordjs/structures`' `InteractiveButtonComponent`, with discord.js' `ButtonComponent` helpers.
+*/
+var InteractiveButtonComponent = class extends InteractiveButtonComponent$1 {
+	/**
+	* @param data The raw button.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* Whether the button is disabled.
+	*/
+	get disabled() {
+		return this[kData].disabled ?? false;
+	}
+	/**
+	* The emoji on the button.
+	*/
+	get emoji() {
+		return this[kData].emoji ?? null;
+	}
+};
+Mixin(InteractiveButtonComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/LabelComponent.ts
+/**
+* A modal component associating a label and a description with another component, like discord.js' `LabelComponent`.
+*/
+var LabelComponent = class extends Component {
+	/**
+	* The label.
+	*/
+	get label() {
+		return this[kData].label;
+	}
+	/**
+	* The description of the label.
+	*/
+	get description() {
+		return this[kData].description ?? null;
+	}
+	/**
+	* The component the label is for.
+	*/
+	get component() {
+		return createComponent(this[kData].component);
+	}
+};
+
+//#endregion
+//#region src/structures/components/LinkButtonComponent.ts
+/**
+* A button of the `Link` style, opening a URL: `@discordjs/structures`' `LinkButtonComponent`, with discord.js'
+* `ButtonComponent` helpers.
+*/
+var LinkButtonComponent = class extends LinkButtonComponent$1 {
+	/**
+	* @param data The raw button.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* Whether the button is disabled.
+	*/
+	get disabled() {
+		return this[kData].disabled ?? false;
+	}
+	/**
+	* The emoji on the button.
+	*/
+	get emoji() {
+		return this[kData].emoji ?? null;
+	}
+};
+Mixin(LinkButtonComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/MediaGalleryItem.ts
+/**
+* An item of a media gallery component: `@discordjs/structures`' `MediaGalleryItem`, with its media like discord.js'.
+*/
+var MediaGalleryItem = class extends MediaGalleryItem$1 {
+	/**
+	* @param data The raw media gallery item.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* The media of the item.
+	*/
+	get media() {
+		return new UnfurledMediaItem(this[kData].media);
+	}
+	/**
+	* The description of the item.
+	*/
+	get description() {
+		return this[kData].description ?? void 0;
+	}
+	/**
+	* Whether the item is marked as a spoiler.
+	*/
+	get spoiler() {
+		return this[kData].spoiler ?? false;
+	}
+};
+Mixin(MediaGalleryItem, [StructureMixin]);
+
+//#endregion
+//#region src/structures/components/MediaGalleryComponent.ts
+/**
+* A gallery of images and videos: `@discordjs/structures`' `MediaGalleryComponent`, with its items like discord.js'.
+*/
+var MediaGalleryComponent = class extends MediaGalleryComponent$1 {
+	/**
+	* @param data The raw media gallery.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* The items of the gallery.
+	*/
+	get items() {
+		return this[kData].items.map((item) => new MediaGalleryItem(item));
+	}
+};
+Mixin(MediaGalleryComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/MentionableSelectMenuComponent.ts
+/**
+* A select menu of users and roles: `@discordjs/structures`' `MentionableSelectMenuComponent`, like discord.js'.
+*/
+var MentionableSelectMenuComponent = class extends MentionableSelectMenuComponent$1 {
+	/**
+	* @param data The raw select menu.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* Whether the select menu is disabled.
+	*/
+	get disabled() {
+		return this[kData].disabled ?? false;
+	}
+	/**
+	* The values selected by default.
+	*/
+	get defaultValues() {
+		return this[kData].default_values ?? [];
+	}
+};
+Mixin(MentionableSelectMenuComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/PremiumButtonComponent.ts
+/**
+* A button of the `Premium` style, purchasing a SKU: `@discordjs/structures`' `PremiumButtonComponent`.
+*/
+var PremiumButtonComponent = class extends PremiumButtonComponent$1 {
+	/**
+	* @param data The raw button.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* Whether the button is disabled.
+	*/
+	get disabled() {
+		return this[kData].disabled ?? false;
+	}
+};
+Mixin(PremiumButtonComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/RadioGroupComponent.ts
+/**
+* A modal component to pick one of its options.
+*/
+var RadioGroupComponent = class extends Component {
+	/**
+	* The custom ID of the radio group.
+	*/
+	get customId() {
+		return this[kData].custom_id;
+	}
+	/**
+	* The options of the radio group.
+	*/
+	get options() {
+		return this[kData].options;
+	}
+	/**
+	* Whether picking an option is required to submit the modal, `true` by default.
+	*/
+	get required() {
+		return this[kData].required ?? true;
+	}
+};
+
+//#endregion
+//#region src/structures/components/RoleSelectMenuComponent.ts
+/**
+* A select menu of roles: `@discordjs/structures`' `RoleSelectMenuComponent`, like discord.js'.
+*/
+var RoleSelectMenuComponent = class extends RoleSelectMenuComponent$1 {
+	/**
+	* @param data The raw select menu.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* Whether the select menu is disabled.
+	*/
+	get disabled() {
+		return this[kData].disabled ?? false;
+	}
+	/**
+	* The values selected by default.
+	*/
+	get defaultValues() {
+		return this[kData].default_values ?? [];
+	}
+};
+Mixin(RoleSelectMenuComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/SectionComponent.ts
+/**
+* Text displayed alongside an accessory: `@discordjs/structures`' `SectionComponent`, with its components and accessory
+* like discord.js'.
+*/
+var SectionComponent = class extends SectionComponent$1 {
+	/**
+	* @param data The raw section.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* The text components in this section.
+	*/
+	get components() {
+		return this[kData].components.map((component) => createComponent(component));
+	}
+	/**
+	* The button or thumbnail shown next to the section.
+	*/
+	get accessory() {
+		return createComponent(this[kData].accessory);
+	}
+};
+Mixin(SectionComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/SeparatorComponent.ts
+/**
+* Vertical padding between components: `@discordjs/structures`' `SeparatorComponent`, with Discord's defaults like
+* discord.js'.
+*/
+var SeparatorComponent = class extends SeparatorComponent$1 {
+	/**
+	* @param data The raw separator.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* The size of the padding, `Small` by default.
+	*/
+	get spacing() {
+		return this[kData].spacing ?? SeparatorSpacingSize.Small;
+	}
+	/**
+	* Whether a divider line is shown, `true` by default.
+	*/
+	get divider() {
+		return this[kData].divider ?? true;
+	}
+};
+Mixin(SeparatorComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/StringSelectMenuComponent.ts
+/**
+* A select menu of predefined text options: `@discordjs/structures`' `StringSelectMenuComponent`, like discord.js'.
+*/
+var StringSelectMenuComponent = class extends StringSelectMenuComponent$1 {
+	/**
+	* @param data The raw select menu.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* Whether the select menu is disabled.
+	*/
+	get disabled() {
+		return this[kData].disabled ?? false;
+	}
+	/**
+	* The options of the select menu.
+	*/
+	get options() {
+		return this[kData].options;
+	}
+};
+Mixin(StringSelectMenuComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/TextDisplayComponent.ts
+/**
+* Markdown text: `@discordjs/structures`' `TextDisplayComponent`, like discord.js'.
+*/
+var TextDisplayComponent = class extends TextDisplayComponent$1 {
+	/**
+	* @param data The raw text display.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+};
+Mixin(TextDisplayComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/TextInputComponent.ts
+/**
+* A text field of a modal: `@discordjs/structures`' `TextInputComponent`, like discord.js'.
+*/
+var TextInputComponent = class extends TextInputComponent$1 {
+	/**
+	* @param data The raw text input.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+};
+Mixin(TextInputComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/ThumbnailComponent.ts
+/**
+* A small image, used as the accessory of a section: `@discordjs/structures`' `ThumbnailComponent`, with its media like
+* discord.js'.
+*/
+var ThumbnailComponent = class extends ThumbnailComponent$1 {
+	/**
+	* @param data The raw thumbnail.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* The media of the thumbnail.
+	*/
+	get media() {
+		return new UnfurledMediaItem(this[kData].media);
+	}
+	/**
+	* The description of the thumbnail.
+	*/
+	get description() {
+		return this[kData].description ?? void 0;
+	}
+	/**
+	* Whether the thumbnail is marked as a spoiler.
+	*/
+	get spoiler() {
+		return this[kData].spoiler ?? false;
+	}
+};
+Mixin(ThumbnailComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/structures/components/UserSelectMenuComponent.ts
+/**
+* A select menu of users: `@discordjs/structures`' `UserSelectMenuComponent`, like discord.js'.
+*/
+var UserSelectMenuComponent = class extends UserSelectMenuComponent$1 {
+	/**
+	* @param data The raw select menu.
+	* @param relations The related structures, resolved from the cache.
+	*/
+	constructor(data, relations = {}) {
+		super(data);
+		initStructure(this, data, relations);
+	}
+	/**
+	* Whether the select menu is disabled.
+	*/
+	get disabled() {
+		return this[kData].disabled ?? false;
+	}
+	/**
+	* The values selected by default.
+	*/
+	get defaultValues() {
+		return this[kData].default_values ?? [];
+	}
+};
+Mixin(UserSelectMenuComponent, [StructureMixin, ComponentMixin]);
+
+//#endregion
+//#region src/util/components.ts
+function createComponent(data) {
+	if (data instanceof Component) return data;
+	return buildComponent(data);
+}
+function buildComponent(data) {
+	switch (data.type) {
+		case ComponentType.ActionRow: return new ActionRow(data);
+		case ComponentType.Button: switch (data.style) {
+			case ButtonStyle.Link: return new LinkButtonComponent(data);
+			case ButtonStyle.Premium: return new PremiumButtonComponent(data);
+			default: return new InteractiveButtonComponent(data);
+		}
+		case ComponentType.StringSelect: return new StringSelectMenuComponent(data);
+		case ComponentType.TextInput: return new TextInputComponent(data);
+		case ComponentType.UserSelect: return new UserSelectMenuComponent(data);
+		case ComponentType.RoleSelect: return new RoleSelectMenuComponent(data);
+		case ComponentType.MentionableSelect: return new MentionableSelectMenuComponent(data);
+		case ComponentType.ChannelSelect: return new ChannelSelectMenuComponent(data);
+		case ComponentType.Section: return new SectionComponent(data);
+		case ComponentType.TextDisplay: return new TextDisplayComponent(data);
+		case ComponentType.Thumbnail: return new ThumbnailComponent(data);
+		case ComponentType.MediaGallery: return new MediaGalleryComponent(data);
+		case ComponentType.File: return new FileComponent(data);
+		case ComponentType.Separator: return new SeparatorComponent(data);
+		case ComponentType.Container: return new ContainerComponent(data);
+		case ComponentType.Label: return new LabelComponent(data);
+		case ComponentType.FileUpload: return new FileUploadComponent(data);
+		case ComponentType.RadioGroup: return new RadioGroupComponent(data);
+		case ComponentType.CheckboxGroup: return new CheckboxGroupComponent(data);
+		case ComponentType.Checkbox: return new CheckboxComponent(data);
+		default: return new Component(data);
+	}
+}
+/**
+* Gets the components of a component tree that can have a custom ID: the children of action rows and labels, the
+* components and accessory of sections, recursively through containers.
+*
+* @param component The component, or raw component data.
+*/
+function extractInteractiveComponents(component) {
+	const node = component;
+	switch (node.type) {
+		case ComponentType.ActionRow: return node.components;
+		case ComponentType.Section: return [...node.components, node.accessory];
+		case ComponentType.Container: return node.components.flatMap(extractInteractiveComponents);
+		case ComponentType.Label: return [node.component];
+		default: return [component];
+	}
+}
+/**
+* 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.
+*/
+function findComponentByCustomId(components, customId) {
+	return components.flatMap(extractInteractiveComponents).find((component) => {
+		const node = component;
+		return (component instanceof Component ? node.customId : node.custom_id) === customId;
+	}) ?? null;
+}
+
 //#endregion
 //#region src/structures/messages/Attachment.ts
 /**
@@ -9507,10 +10285,11 @@ var Message = class Message extends Message$1 {
 		return (this[kData].embeds ?? []).map((embed) => new Embed(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() {
-		return this[kData].components ?? [];
+		return (this[kData].components ?? []).map((component) => createComponent(component));
 	}
 	/**
 	* The raw sticker items of the message; fetch a full sticker with `client.fetchSticker(id)`.
@@ -13302,5 +14081,5 @@ function RegisterAsGatewayListener(event, options = {}) {
 }
 
 //#endregion
-export { Action, ActionsManager, Activity, ActivityFlagsBitField, AnnouncementChannel, AnnouncementThreadChannel, AnonymousGuild, AppliedTagsMixin, Attachment, AttachmentFlagsBitField, AutoModerationActionExecution, AutoModerationRule, AutoModerationRuleManager, BaseChannel, BaseChannelMixin, BaseInvite, CachedManager as BaseManager, CachedManager, BitField, CategoryChannel, Channel, ChannelFlagsBitField, ChannelManager, ChannelMessageManager, ChannelOwnerMixin, ChannelParentMixin, ChannelPermissionMixin, ChannelSlowmodeMixin, ChannelThreadManager, ChannelThreadsMixin, ChannelTopicMixin, ChannelWebhooksMixin, ClientUser, DMChannel, DMChannelMixin, DispatchAction, DispatchHandlers, DispatchQueue, DispatchTimeoutError, Embed, Emoji, EventGatewayListener, ForumChannel, GatewayClient, GatewayError, GatewayErrorCodes, GatewayErrorMessages, GatewayEvents, GatewayRangeError, GatewaySessionStoreError, GatewayTypeError, GroupDMChannel, GroupDMInvite, GroupDMMixin, Guild, GuildAuditLogsEntry, GuildBan, GuildBanManager, GuildChannelFields, GuildChannelManager, GuildChannelMixin, GuildEmoji, GuildEmojiManager, GuildEmojiRoleManager, GuildIntegrationManager, GuildInvite, GuildInviteManager, GuildManager, GuildMember, GuildMemberFlagsBitField, GuildMemberManager, GuildMemberRoleManager, GuildMembersRateLimitError, GuildMembersTimeoutError, GuildOnboarding, GuildOnboardingPrompt, GuildOnboardingPromptOption, GuildPreview, GuildScheduledEvent, GuildScheduledEventManager, GuildSoundboardSoundManager, GuildStickerManager, GuildTemplate, GuildTemplateManager, Integration, IntentsBitField, InviteGuild, MediaChannel, Message, MessageFlagsBitField, MessageManager, MessageMentions, MessagePayload, MessageReaction, Mixin, MultiDispatchAction, MultiDispatchHandlers, NumberFlagsBitField, Partials, PermissionOverwriteManager, PermissionOverwrites, PermissionsBitField, Poll, PollAnswer, Presence, PresenceManager, PrivateThreadChannel, PublicThreadChannel, ReactionEmoji, ReactionManager, ReactionUserManager, RegisterAsGatewayListener, RichPresenceAssets, Role, RoleFlagsBitField, RoleManager, SoundboardSound, StageChannel, StageInstance, StageInstanceManager, Sticker, StickerPack, Structure, StructureMixin, SystemChannelFlagsBitField, TextChannel, TextChannelMixin, ThreadChannelMemberManager, ThreadChannelMixin, ThreadManager, ThreadMember, ThreadMemberManager, ThreadOnlyChannelMixin, Typing, User, UserFlagsBitField, UserManager, VoiceChannel, VoiceChannelMixin, VoiceState, VoiceStateManager, Webhook, WebhookManager, WebhookMixin, WelcomeScreen, Widget, WidgetMember, bindClient, compareRolePositions, computeChannelPermissions, computeGuildPermissions, computePermissionsIn, computeTargetPermissions, createChannel, createInvite, dispatchPartition, getGatewayClient, initStructure, isDeepEqual, isThreadChannelType, kClient, kClone, kData, kPatch, kPatchRelations, kRelations, resolveId, resolveOverwriteOptions, snowflakeTimestamp, toAPIOverwrite, toChannelBody };
+export { Action, ActionRow, ActionsManager, Activity, ActivityFlagsBitField, AnnouncementChannel, AnnouncementThreadChannel, AnonymousGuild, AppliedTagsMixin, Attachment, AttachmentFlagsBitField, AutoModerationActionExecution, AutoModerationRule, AutoModerationRuleManager, BaseChannel, BaseChannelMixin, BaseInvite, CachedManager as BaseManager, CachedManager, BitField, CategoryChannel, Channel, ChannelFlagsBitField, ChannelManager, ChannelMessageManager, ChannelOwnerMixin, ChannelParentMixin, ChannelPermissionMixin, ChannelSelectMenuComponent, ChannelSlowmodeMixin, ChannelThreadManager, ChannelThreadsMixin, ChannelTopicMixin, ChannelWebhooksMixin, CheckboxComponent, CheckboxGroupComponent, ClientUser, Component, ComponentMixin, ContainerComponent, DMChannel, DMChannelMixin, DispatchAction, DispatchHandlers, DispatchQueue, DispatchTimeoutError, Embed, Emoji, EventGatewayListener, FileComponent, FileUploadComponent, ForumChannel, GatewayClient, GatewayError, GatewayErrorCodes, GatewayErrorMessages, GatewayEvents, GatewayRangeError, GatewaySessionStoreError, GatewayTypeError, GroupDMChannel, GroupDMInvite, GroupDMMixin, Guild, GuildAuditLogsEntry, GuildBan, GuildBanManager, GuildChannelFields, GuildChannelManager, GuildChannelMixin, GuildEmoji, GuildEmojiManager, GuildEmojiRoleManager, GuildIntegrationManager, GuildInvite, GuildInviteManager, GuildManager, GuildMember, GuildMemberFlagsBitField, GuildMemberManager, GuildMemberRoleManager, GuildMembersRateLimitError, GuildMembersTimeoutError, GuildOnboarding, GuildOnboardingPrompt, GuildOnboardingPromptOption, GuildPreview, GuildScheduledEvent, GuildScheduledEventManager, GuildSoundboardSoundManager, GuildStickerManager, GuildTemplate, GuildTemplateManager, Integration, IntentsBitField, InteractiveButtonComponent, InviteGuild, LabelComponent, LinkButtonComponent, MediaChannel, MediaGalleryComponent, MediaGalleryItem, MentionableSelectMenuComponent, Message, MessageFlagsBitField, MessageManager, MessageMentions, MessagePayload, MessageReaction, Mixin, MultiDispatchAction, MultiDispatchHandlers, NumberFlagsBitField, Partials, PermissionOverwriteManager, PermissionOverwrites, PermissionsBitField, Poll, PollAnswer, PremiumButtonComponent, Presence, PresenceManager, PrivateThreadChannel, PublicThreadChannel, RadioGroupComponent, ReactionEmoji, ReactionManager, ReactionUserManager, RegisterAsGatewayListener, RichPresenceAssets, Role, RoleFlagsBitField, RoleManager, RoleSelectMenuComponent, SectionComponent, SeparatorComponent, SoundboardSound, StageChannel, StageInstance, StageInstanceManager, Sticker, StickerPack, StringSelectMenuComponent, Structure, StructureMixin, SystemChannelFlagsBitField, TextChannel, TextChannelMixin, TextDisplayComponent, TextInputComponent, ThreadChannelMemberManager, ThreadChannelMixin, ThreadManager, ThreadMember, ThreadMemberManager, ThreadOnlyChannelMixin, ThumbnailComponent, Typing, UnfurledMediaItem, User, UserFlagsBitField, UserManager, UserSelectMenuComponent, VoiceChannel, VoiceChannelMixin, VoiceState, VoiceStateManager, Webhook, WebhookManager, WebhookMixin, WelcomeScreen, Widget, WidgetMember, bindClient, compareRolePositions, computeChannelPermissions, computeGuildPermissions, computePermissionsIn, computeTargetPermissions, createChannel, createComponent, createInvite, dispatchPartition, findComponentByCustomId, getGatewayClient, initStructure, isDeepEqual, isThreadChannelType, kClient, kClone, kData, kPatch, kPatchRelations, kRelations, resolveId, resolveOverwriteOptions, snowflakeTimestamp, toAPIOverwrite, toChannelBody };
 //# sourceMappingURL=index.js.map