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

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";
@@ -51,6 +51,113 @@ var EventGatewayListener = class extends Listener {
 	}
 };
 
+//#endregion
+//#region src/errors/Messages.ts
+/**
+* The message of every {@link GatewayErrorCode}: a string, or a function formatting the arguments passed to the
+* error's constructor.
+*/
+const GatewayErrorMessages = {
+	ClientSessionStoreConflict: "sessionStore replaces gateway.retrieveSessionInfo and gateway.updateSessionInfo, pass one or the other",
+	ClientNotConstructed: "No GatewayClient has been constructed yet",
+	DispatchHandlerConflict: (event) => `Dispatch event "${event}" is registered in both DispatchHandlers and MultiDispatchHandlers`,
+	DispatchTimeout: (type, shardId, partition, timeout) => `Processing ${type} on shard ${shardId} (${partition ?? "barrier"}) took longer than ${timeout}ms`,
+	SessionStoreFailed: (operation, shardId) => `Cannot ${operation === "get" ? "read" : "write"} the session of shard ${shardId} in the session store`,
+	SessionStoreTimeout: (timeout) => `Timed out after ${timeout}ms`,
+	CacheAsynchronous: (entity) => `The ${entity} cache is asynchronous, use get instead of cached`,
+	CacheRelationsAsynchronous: (entity) => `The relations of the ${entity} cache are read from an asynchronous cache, use get instead of cached`,
+	CacheNotIterable: (entity) => `The ${entity} cache cannot enumerate its entries (it has no keys/values/entries)`,
+	CacheKeyUnresolvable: (entity, reason) => `Cannot key a ${entity} ${reason}`,
+	IdUnresolvable: "Cannot resolve an ID from a structure without one",
+	ChannelGuildUnknown: (channelId) => `Channel ${channelId} has no known guild`,
+	ChannelTypeChanged: (channelId, from, to) => `Channel ${channelId} changed type from ${from} to ${to}`,
+	ChannelLockPermissionsConflict: "Pass either lockPermissions or permissionOverwrites, not both",
+	GuildChannelOrphan: (channelId) => `Channel ${channelId} has no category to sync its permissions with`,
+	ThreadParentUnknown: (threadId) => `Thread ${threadId} has no known parent`,
+	ThreadOwnerUnknown: (threadId) => `Thread ${threadId} has no known owner`,
+	ThreadMemberIdsMissing: (action) => `A thread member without a thread or user ID cannot be ${action}`,
+	GuildIntegrationNotFound: (guildId, integrationId) => `The guild ${guildId} has no integration ${integrationId}`,
+	GuildMemberUserUnknown: "This member has no user data: its ID is unknown",
+	GuildMembersQueryConflict: "Cannot request members by both query and userIds",
+	GuildMembersUserIdsLimit: "Cannot request more than 100 members by their IDs",
+	MemberFetchNonceLength: "The nonce of a members request cannot exceed 32 bytes",
+	GuildMembersNoncePending: (nonce) => `A members request with the nonce "${nonce}" is pending already`,
+	GuildMembersTimeout: (guildId, nonce, timeout) => `Requesting the members of guild ${guildId} (${nonce}) took longer than ${timeout}ms`,
+	GuildMembersRateLimited: (guildId, nonce, retryAfter) => `Requesting the members of guild ${guildId} (${nonce}) is rate limited, retry after ${retryAfter}ms`,
+	PresenceNotFetchable: (guildId, userId) => `Presences cannot be fetched from the API, they are only received from the gateway (user ${userId} of guild ${guildId} is not cached); enable the presences cache to read them later`,
+	InviteGuildUnknown: (code) => `Invite ${code} has no known guild`,
+	EmojiEmpty: "Cannot resolve an empty string to an emoji",
+	EmojiType: "Cannot resolve an emoji without an ID nor a name",
+	NotGuildSticker: "Only guild stickers can be edited or deleted",
+	NotGuildSoundboardSound: "Default soundboard sounds cannot be changed",
+	MessageContentType: "The content of a message must be a string",
+	MessageNonceLength: "A message nonce must be at most 25 characters long",
+	MessageNonceType: "A message nonce must be an integer",
+	MessageForwardChannelMissing: "Forwarding a message by ID needs its channel",
+	MessageReferenceMissing: (messageId) => `Message ${messageId} references no message`,
+	MessagePollMissing: (messageId) => `Message ${messageId} has no poll`,
+	AttachmentDownloadFailed: (url, status) => `Could not download ${url}: ${status}`,
+	VoiceStateNotOwn: "Only the bot's own voice state can request to speak",
+	VoiceStateGuildUnknown: "This voice state does not belong to a guild",
+	WebhookTokenUnavailable: (webhookId) => `Webhook ${webhookId} has no token to post with`
+};
+
+//#endregion
+//#region src/errors/GatewayError.ts
+/**
+* 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}.
+*/
+var GatewayError = class extends Error {
+	/**
+	* The code of the error.
+	*/
+	code;
+	constructor(code, ...args) {
+		super(formatMessage(code, args));
+		this.code = code;
+		setName(this, new.target, code);
+	}
+};
+/**
+* A {@link TypeError} carrying a {@link GatewayErrorCode}, like discord.js's `DiscordjsTypeError`.
+*/
+var GatewayTypeError = class extends TypeError {
+	/**
+	* The code of the error.
+	*/
+	code;
+	constructor(code, ...args) {
+		super(formatMessage(code, args));
+		this.code = code;
+		setName(this, new.target, code);
+	}
+};
+/**
+* A {@link RangeError} carrying a {@link GatewayErrorCode}, like discord.js's `DiscordjsRangeError`.
+*/
+var GatewayRangeError = class extends RangeError {
+	/**
+	* The code of the error.
+	*/
+	code;
+	constructor(code, ...args) {
+		super(formatMessage(code, args));
+		this.code = code;
+		setName(this, new.target, code);
+	}
+};
+function formatMessage(code, args) {
+	const message = GatewayErrorMessages[code];
+	return typeof message === "function" ? message(...args) : message;
+}
+function setName(error, target, code) {
+	error.name = `${target.name} [${code}]`;
+	Error.captureStackTrace?.(error, target);
+}
+
 //#endregion
 //#region src/util/channels.ts
 /**
@@ -60,7 +167,7 @@ var EventGatewayListener = class extends Listener {
 */
 function resolveId(value) {
 	const id = typeof value === "string" ? value : value.id;
-	if (!id) throw new TypeError("Cannot resolve an ID from a structure without one");
+	if (!id) throw new GatewayTypeError("IdUnresolvable");
 	return id;
 }
 /**
@@ -210,7 +317,7 @@ function Mixin(target, mixins) {
 */
 function getGatewayClient() {
 	const { client } = container;
-	if (!client || !("gateway" in client)) throw new Error("No GatewayClient has been constructed yet");
+	if (!client || !("gateway" in client)) throw new GatewayError("ClientNotConstructed");
 	return client;
 }
 
@@ -521,7 +628,7 @@ var BaseChannelMixin = class {
 	*/
 	async fetch() {
 		const data = await this.client.api.channels.get(this.id);
-		if (data.type !== this.type) throw new TypeError(`Channel ${this.id} changed type from ${this.type} to ${data.type}`);
+		if (data.type !== this.type) throw new GatewayTypeError("ChannelTypeChanged", this.id, this.type, data.type);
 		return this[kPatch](data);
 	}
 };
@@ -833,7 +940,7 @@ async function computePermissionsIn(channel, target) {
 		resolved = await client.channels.fetch(data.parent_id);
 		data = resolved.toJSON();
 	}
-	if (!data.guild_id) throw new Error(`Channel ${resolved.id} has no known guild`);
+	if (!data.guild_id) throw new GatewayError("ChannelGuildUnknown", resolved.id);
 	return computeTargetPermissions(data.guild_id, data.permission_overwrites ?? [], target);
 }
 
@@ -889,7 +996,7 @@ var ChannelPermissionMixin = class {
 	*/
 	async setPosition(position, options = {}) {
 		const { guild_id: guildId } = this[kData];
-		if (!guildId) throw new Error(`Channel ${this.id} has no known guild`);
+		if (!guildId) throw new GatewayError("ChannelGuildUnknown", this.id);
 		const target = options.relative ? this.position + position : position;
 		await this.client.guilds.channels(guildId).setPositions([{
 			channel: this.id,
@@ -922,7 +1029,7 @@ var ChannelPermissionMixin = class {
 	* @param reason The reason for the audit log.
 	*/
 	lockPermissions(reason) {
-		if (!this[kData].parent_id) throw new Error(`Channel ${this.id} has no category to sync its permissions with`);
+		if (!this[kData].parent_id) throw new GatewayError("GuildChannelOrphan", this.id);
 		return editChannel(this, {
 			lockPermissions: true,
 			reason
@@ -945,7 +1052,7 @@ var ChannelPermissionMixin = class {
 	*/
 	async fetchPermissionsFor(target) {
 		const { guild_id: guildId, permission_overwrites: overwrites = [] } = this[kData];
-		if (!guildId) throw new Error(`Channel ${this.id} has no known guild`);
+		if (!guildId) throw new GatewayError("ChannelGuildUnknown", this.id);
 		return computeTargetPermissions(guildId, overwrites, target);
 	}
 };
@@ -1002,7 +1109,7 @@ var ChannelThreadManager = class {
 	* Fetches the active threads of the channel, and caches them.
 	*/
 	async fetchActive() {
-		if (!this.guildId) throw new Error(`Channel ${this.channelId} has no known guild`);
+		if (!this.guildId) throw new GatewayError("ChannelGuildUnknown", this.channelId);
 		const { threads, members } = await this.client.threads.fetchActive(this.guildId);
 		const own = threads.filter((thread) => thread.parentId === this.channelId);
 		const ids = new Set(own.map((thread) => thread.id));
@@ -1125,7 +1232,7 @@ var GuildChannelMixin = class {
 	*/
 	async clone(options = {}) {
 		const { guildId } = this;
-		if (!guildId) throw new Error(`Channel ${this.id} has no known guild`);
+		if (!guildId) throw new GatewayError("ChannelGuildUnknown", this.id);
 		const data = this[kData];
 		return this.client.guilds.channels(guildId).create({
 			name: data.name ?? "",
@@ -1323,7 +1430,7 @@ var MessagePayload = class MessagePayload {
 		const { content } = this.options;
 		if (content === null) return this.isEdit ? "" : void 0;
 		if (content === void 0) return void 0;
-		if (typeof content !== "string") throw new TypeError("The content of a message must be a string");
+		if (typeof content !== "string") throw new GatewayTypeError("MessageContentType");
 		return content;
 	}
 	/**
@@ -1380,8 +1487,8 @@ var MessagePayload = class MessagePayload {
 	}
 	resolveNonce(nonce) {
 		if (nonce === void 0) return void 0;
-		if (typeof nonce === "string" && nonce.length > 25) throw new RangeError("A message nonce must be at most 25 characters long");
-		if (typeof nonce === "number" && !Number.isInteger(nonce)) throw new RangeError("A message nonce must be an integer");
+		if (typeof nonce === "string" && nonce.length > 25) throw new GatewayRangeError("MessageNonceLength");
+		if (typeof nonce === "number" && !Number.isInteger(nonce)) throw new GatewayRangeError("MessageNonceType");
 		return nonce;
 	}
 	resolveList(values) {
@@ -1404,7 +1511,7 @@ var MessagePayload = class MessagePayload {
 		if (forward) {
 			const { message, channel, guild } = forward;
 			const channelId = typeof message === "string" ? MessagePayload.id(channel) : message.channelId;
-			if (!channelId) throw new TypeError("Forwarding a message by ID needs its channel");
+			if (!channelId) throw new GatewayTypeError("MessageForwardChannelMissing");
 			return {
 				type: MessageReferenceType.Forward,
 				message_id: typeof message === "string" ? message : message.id,
@@ -1537,7 +1644,7 @@ async function resolveBuffer(attachment) {
 	if (typeof attachment === "string") {
 		if (/^https?:\/\//.test(attachment)) {
 			const response = await fetch(attachment);
-			if (!response.ok) throw new Error(`Could not download ${attachment}: ${response.status}`);
+			if (!response.ok) throw new GatewayError("AttachmentDownloadFailed", attachment, response.status);
 			return {
 				data: new Uint8Array(await response.arrayBuffer()),
 				contentType: response.headers.get("content-type") ?? void 0
@@ -1815,7 +1922,7 @@ var ThreadChannelMixin = class {
 	*/
 	fetchStarterMessage() {
 		const { parent_id: parentId } = this[kData];
-		if (!parentId) throw new Error(`Thread ${this.id} has no known parent`);
+		if (!parentId) throw new GatewayError("ThreadParentUnknown", this.id);
 		return this.client.messages.fetch(parentId, this.id);
 	}
 	/**
@@ -1823,7 +1930,7 @@ var ThreadChannelMixin = class {
 	*/
 	fetchOwner() {
 		const { owner_id: ownerId } = this[kData];
-		if (!ownerId) throw new Error(`Thread ${this.id} has no known owner`);
+		if (!ownerId) throw new GatewayError("ThreadOwnerUnknown", this.id);
 		return this.client.threadMembers.fetch(this.id, ownerId);
 	}
 };
@@ -2477,7 +2584,7 @@ var StageChannel = class extends StageChannel$1 {
 	*/
 	createStageInstance(options) {
 		const { guildId } = this;
-		if (!guildId) return Promise.reject(/* @__PURE__ */ new Error(`Channel ${this.id} has no known guild`));
+		if (!guildId) return Promise.reject(new GatewayError("ChannelGuildUnknown", this.id));
 		return this.client.guilds.stageInstances(guildId).create(this.id, options);
 	}
 };
@@ -2771,11 +2878,11 @@ var CachedManager = class {
 	cached(...args) {
 		const { cache } = this;
 		if (cache === void 0) return void 0;
-		if (cache.synchronous !== true) throw new TypeError(`The ${this.entity} cache is asynchronous, use get instead of cached`);
+		if (cache.synchronous !== true) throw new GatewayTypeError("CacheAsynchronous", this.entity);
 		const value = this._get(...args);
 		if (isPromiseLike(value)) {
 			value.catch(() => void 0);
-			throw new TypeError(`The relations of the ${this.entity} cache are read from an asynchronous cache, use get instead of cached`);
+			throw new GatewayTypeError("CacheRelationsAsynchronous", this.entity);
 		}
 		return value;
 	}
@@ -2934,7 +3041,7 @@ var CachedManager = class {
 	iterableCache() {
 		const { cache } = this;
 		if (cache === void 0) return void 0;
-		if (!isIterableCache(cache)) throw new TypeError(`The ${this.entity} cache cannot enumerate its entries (it has no keys/values/entries)`);
+		if (!isIterableCache(cache)) throw new GatewayTypeError("CacheNotIterable", this.entity);
 		return cache;
 	}
 	/**
@@ -3118,7 +3225,7 @@ var ChannelManager = class extends CachedManager {
 	* @param options The fields to edit, and the reason for the audit log.
 	*/
 	async edit(channelId, options) {
-		if (options.lockPermissions && options.permissionOverwrites) throw new TypeError("Pass either lockPermissions or permissionOverwrites, not both");
+		if (options.lockPermissions && options.permissionOverwrites) throw new GatewayTypeError("ChannelLockPermissionsConflict");
 		const body = toChannelBody(options);
 		if (options.lockPermissions) {
 			const parentId = options.parent === void 0 ? overwriteHolder(await this.fetch(channelId)).parent_id ?? null : options.parent && resolveId(options.parent);
@@ -4112,13 +4219,13 @@ var ReactionEmoji = class extends Emoji {
 				const { animated, name, id } = custom.groups;
 				return `${animated ? "a:" : ""}${name}:${id}`;
 			}
-			if (!decoded) throw new TypeError("Cannot resolve an empty string to an emoji");
+			if (!decoded) throw new GatewayTypeError("EmojiEmpty");
 			return encodeURIComponent(decoded);
 		}
 		const { id, name, animated } = emoji;
 		if (id) return `${animated ? "a:" : ""}${name ?? "_"}:${id}`;
 		if (name) return encodeURIComponent(name);
-		throw new TypeError("Cannot resolve an emoji without an ID nor a name");
+		throw new GatewayTypeError("EmojiType");
 	}
 	/**
 	* Resolves anything {@link EmojiIdentifierResolvable} to the ID and name pair of welcome screens and onboarding.
@@ -4753,7 +4860,7 @@ var GuildInvite = class extends BaseInvite {
 	*/
 	async delete(reason) {
 		const { guildId } = this;
-		if (!guildId) throw new Error(`Invite ${this.code} has no known guild`);
+		if (!guildId) throw new GatewayError("InviteGuildUnknown", this.code);
 		await this.client.guilds.invites(guildId).delete(this.code, reason);
 		return this;
 	}
@@ -4889,7 +4996,7 @@ var Sticker = class extends Sticker$1 {
 	}
 	requireGuildId() {
 		const { guildId } = this;
-		if (!guildId) throw new Error("Only guild stickers can be edited or deleted");
+		if (!guildId) throw new GatewayError("NotGuildSticker");
 		return guildId;
 	}
 };
@@ -4972,7 +5079,7 @@ var WebhookMixin = class {
 	*/
 	requireToken() {
 		const { token } = this;
-		if (!token) throw new Error(`Webhook ${this.id} has no token to post with`);
+		if (!token) throw new GatewayError("WebhookTokenUnavailable", this.id);
 		return token;
 	}
 };
@@ -5949,7 +6056,7 @@ var GuildIntegrationManager = class extends CachedManager {
 	}
 	async fetchRaw(integrationId) {
 		const integration = (await this.list()).find(({ id }) => id === integrationId);
-		if (!integration) throw new RangeError(`The guild ${this.guildId} has no integration ${integrationId}`);
+		if (!integration) throw new GatewayRangeError("GuildIntegrationNotFound", this.guildId, integrationId);
 		return integration;
 	}
 	async list() {
@@ -6165,7 +6272,7 @@ var SoundboardSound = class extends SoundboardSound$1 {
 	}
 	withGuild(action) {
 		const { guildId } = this;
-		if (!guildId) return Promise.reject(/* @__PURE__ */ new Error("Default soundboard sounds cannot be changed"));
+		if (!guildId) return Promise.reject(new GatewayError("NotGuildSoundboardSound"));
 		return action(guildId);
 	}
 };
@@ -7675,7 +7782,7 @@ var GuildMember = class extends Structure {
 	}
 	requireId() {
 		const { id } = this;
-		if (id === null) throw new Error("This member has no user data: its ID is unknown");
+		if (id === null) throw new GatewayError("GuildMemberUserUnknown");
 		return id;
 	}
 };
@@ -8084,7 +8191,7 @@ var VoiceState = class extends VoiceState$1 {
 	*/
 	async edit(options) {
 		const target = this.resolveTarget();
-		if (target !== "@me" && options.requestToSpeak !== void 0) throw new Error("Only the bot's own voice state can request to speak");
+		if (target !== "@me" && options.requestToSpeak !== void 0) throw new GatewayError("VoiceStateNotOwn");
 		const requestToSpeakTimestamp = options.requestToSpeak ? (/* @__PURE__ */ new Date()).toISOString() : options.requestToSpeak === false ? null : void 0;
 		const body = {
 			channel_id: this.channelId ?? void 0,
@@ -8112,7 +8219,7 @@ var VoiceState = class extends VoiceState$1 {
 	}
 	requireGuildId() {
 		const { guildId } = this;
-		if (!guildId) throw new Error("This voice state does not belong to a guild");
+		if (!guildId) throw new GatewayError("VoiceStateGuildUnknown");
 		return guildId;
 	}
 	resolveTarget() {
@@ -8132,7 +8239,7 @@ Mixin(VoiceState, [StructureMixin]);
 * event order is preserved. The error only reports that the partition is stuck, usually on a slow or unreachable
 * cache.
 */
-var DispatchTimeoutError = class extends Error {
+var DispatchTimeoutError = class extends GatewayError {
 	/**
 	* The type of the slow dispatch, e.g. `MESSAGE_CREATE`.
 	*/
@@ -8150,8 +8257,7 @@ var DispatchTimeoutError = class extends Error {
 	*/
 	timeout;
 	constructor(type, shardId, partition, timeout) {
-		super(`Processing ${type} on shard ${shardId} (${partition ?? "barrier"}) took longer than ${timeout}ms`);
-		this.name = "DispatchTimeoutError";
+		super("DispatchTimeout", type, shardId, partition, timeout);
 		this.type = type;
 		this.shardId = shardId;
 		this.partition = partition;
@@ -8164,7 +8270,7 @@ var DispatchTimeoutError = class extends Error {
 * @remarks
 * The request is dropped: chunks arriving later still update the cache and emit `guildMembersChunk`.
 */
-var GuildMembersTimeoutError = class extends Error {
+var GuildMembersTimeoutError = class extends GatewayError {
 	/**
 	* The ID of the guild whose members were requested.
 	*/
@@ -8178,8 +8284,7 @@ var GuildMembersTimeoutError = class extends Error {
 	*/
 	timeout;
 	constructor(guildId, nonce, timeout) {
-		super(`Requesting the members of guild ${guildId} (${nonce}) took longer than ${timeout}ms`);
-		this.name = "GuildMembersTimeoutError";
+		super("GuildMembersTimeout", guildId, nonce, timeout);
 		this.guildId = guildId;
 		this.nonce = nonce;
 		this.timeout = timeout;
@@ -8188,7 +8293,7 @@ var GuildMembersTimeoutError = class extends Error {
 /**
 * Thrown by `GuildMemberManager#request` when Discord answers with `RATE_LIMITED` instead of the members' chunks.
 */
-var GuildMembersRateLimitError = class extends Error {
+var GuildMembersRateLimitError = class extends GatewayError {
 	/**
 	* The ID of the guild whose members were requested.
 	*/
@@ -8202,8 +8307,7 @@ var GuildMembersRateLimitError = class extends Error {
 	*/
 	retryAfter;
 	constructor(guildId, nonce, retryAfter) {
-		super(`Requesting the members of guild ${guildId} (${nonce}) is rate limited, retry after ${retryAfter}ms`);
-		this.name = "GuildMembersRateLimitError";
+		super("GuildMembersRateLimited", guildId, nonce, retryAfter);
 		this.guildId = guildId;
 		this.nonce = nonce;
 		this.retryAfter = retryAfter;
@@ -8216,7 +8320,7 @@ var GuildMembersRateLimitError = class 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`.
 */
-var GatewaySessionStoreError = class extends Error {
+var GatewaySessionStoreError = class extends GatewayError {
 	/**
 	* Whether the store failed to read (`"get"`) or write (`"set"`) the session.
 	*/
@@ -8226,8 +8330,8 @@ var GatewaySessionStoreError = class extends Error {
 	*/
 	shardId;
 	constructor(operation, shardId, cause) {
-		super(`Cannot ${operation === "get" ? "read" : "write"} the session of shard ${shardId} in the session store`, { cause });
-		this.name = "GatewaySessionStoreError";
+		super("SessionStoreFailed", operation, shardId);
+		this.cause = cause;
 		this.operation = operation;
 		this.shardId = shardId;
 	}
@@ -8247,7 +8351,7 @@ var GuildMemberManager = class extends CachedManager {
 		return new GuildMember(data);
 	}
 	keyOf(data) {
-		if (!data.user) throw new TypeError("Cannot key a member without its user");
+		if (!data.user) throw new GatewayTypeError("CacheKeyUnresolvable", "member", "without its user");
 		return this.resolveKey(data.guild_id, data.user.id);
 	}
 	/**
@@ -8351,9 +8455,9 @@ var GuildMemberManager = class extends CachedManager {
 		const { query, limit = 0, presences, time = 12e4 } = options;
 		const userIds = options.userIds?.length ? options.userIds : void 0;
 		const nonce = options.nonce ?? randomBytes(16).toString("hex");
-		if (query !== void 0 && userIds !== void 0) throw new TypeError("Cannot request members by both query and userIds");
-		if (userIds && userIds.length > 100) throw new RangeError("Cannot request more than 100 members by their IDs");
-		if (Buffer.byteLength(nonce) > 32) throw new RangeError("The nonce of a members request cannot exceed 32 bytes");
+		if (query !== void 0 && userIds !== void 0) throw new GatewayTypeError("GuildMembersQueryConflict");
+		if (userIds && userIds.length > 100) throw new GatewayRangeError("GuildMembersUserIdsLimit");
+		if (Buffer.byteLength(nonce) > 32) throw new GatewayRangeError("MemberFetchNonceLength");
 		const d = userIds ? {
 			guild_id: guildId,
 			user_ids: [...userIds],
@@ -8368,7 +8472,7 @@ var GuildMemberManager = class extends CachedManager {
 		};
 		const shardCount = BigInt(await this.client.gateway.getShardCount());
 		const shardId = Number((BigInt(guildId) >> 22n) % shardCount);
-		if (this.#requests.has(nonce)) throw new Error(`A members request with the nonce "${nonce}" is pending already`);
+		if (this.#requests.has(nonce)) throw new GatewayError("GuildMembersNoncePending", nonce);
 		let request;
 		const promise = new Promise((resolve, reject) => {
 			request = {
@@ -8855,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
 /**
@@ -9250,7 +10132,7 @@ var Poll = class extends Poll$1 {
 	*/
 	async fetch() {
 		const { poll } = (await this.client.messages.fetch(this.channelId, this.messageId, { force: true })).toJSON();
-		if (!poll) throw new Error(`Message ${this.messageId} has no poll`);
+		if (!poll) throw new GatewayError("MessagePollMissing", this.messageId);
 		return this[kPatch](poll);
 	}
 	get question() {
@@ -9403,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)`.
@@ -9564,7 +10447,7 @@ var Message = class Message extends Message$1 {
 	*/
 	async fetchReference() {
 		const reference = this.reference;
-		if (!reference?.message_id) throw new Error(`Message ${this.id} references no message`);
+		if (!reference?.message_id) throw new GatewayError("MessageReferenceMissing", this.id);
 		return this.client.messages.fetch(reference.channel_id ?? this.channelId, reference.message_id);
 	}
 	/**
@@ -10839,7 +11722,7 @@ var VoiceStateManager = class extends CachedManager {
 		return new VoiceState(data);
 	}
 	keyOf(data) {
-		if (!data.guild_id) throw new TypeError("Cannot key a voice state outside of a guild");
+		if (!data.guild_id) throw new GatewayTypeError("CacheKeyUnresolvable", "voice state", "outside of a guild");
 		return this.resolveKey(data.guild_id, data.user_id);
 	}
 	resolveKey(guildId, userId) {
@@ -10928,7 +11811,7 @@ var PresenceManager = class extends CachedManager {
 		return Promise.all(entries.filter(([key]) => key.startsWith(prefix)).map(([, raw]) => this.hydrate(raw)));
 	}
 	fetchRaw(guildId, userId) {
-		return Promise.reject(/* @__PURE__ */ new Error(`Presences cannot be fetched from the API, they are only received from the gateway (user ${userId} of guild ${guildId} is not cached); enable the presences cache to read them later`));
+		return Promise.reject(new GatewayError("PresenceNotFetchable", guildId, userId));
 	}
 };
 
@@ -11077,7 +11960,7 @@ var ThreadMember = class extends Structure {
 	*/
 	async fetch() {
 		const { threadId, id } = this;
-		if (!threadId || !id) throw new Error("A thread member without a thread or user ID cannot be fetched");
+		if (!threadId || !id) throw new GatewayError("ThreadMemberIdsMissing", "fetched");
 		const member = await this.client.threadMembers.fetch(threadId, id, { force: true });
 		return this[kPatch](member.toJSON());
 	}
@@ -11117,7 +12000,7 @@ var ThreadMember = class extends Structure {
 	*/
 	async remove() {
 		const { id, threadId } = this;
-		if (!id || !threadId) throw new Error("Cannot remove a thread member without its IDs");
+		if (!id || !threadId) throw new GatewayError("ThreadMemberIdsMissing", "removed");
 		await this.client.threadMembers.remove(threadId, id);
 		return this;
 	}
@@ -11136,7 +12019,7 @@ var ThreadMemberManager = class extends CachedManager {
 		return new ThreadMember(data);
 	}
 	keyOf(data) {
-		if (!data.id || !data.user_id) throw new TypeError("Cannot key a thread member without its IDs");
+		if (!data.id || !data.user_id) throw new GatewayTypeError("CacheKeyUnresolvable", "thread member", "without its IDs");
 		return this.resolveKey(data.id, data.user_id);
 	}
 	resolveKey(threadId, userId) {
@@ -12479,7 +13362,7 @@ var ActionsManager = class {
 	constructor(client) {
 		for (const [event, handler] of Object.entries(DispatchHandlers)) if (handler) this.#actions.set(event, new DispatchAction(client, handler));
 		for (const [event, handler] of Object.entries(MultiDispatchHandlers)) if (handler) {
-			if (this.#actions.has(event)) throw new Error(`Dispatch event "${event}" is registered in both DispatchHandlers and MultiDispatchHandlers`);
+			if (this.#actions.has(event)) throw new GatewayError("DispatchHandlerConflict", event);
 			this.#actions.set(event, new MultiDispatchAction(client, handler));
 		}
 	}
@@ -12642,7 +13525,7 @@ var GatewaySessionMirror = class {
 			if (this.#timeout === null) return await read;
 			const timeout = this.#timeout;
 			return await Promise.race([read, new Promise((_, reject) => {
-				timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`Timed out after ${timeout}ms`)), timeout);
+				timer = setTimeout(() => reject(new GatewayError("SessionStoreTimeout", timeout)), timeout);
 			})]);
 		} catch (error) {
 			this.#onError(new GatewaySessionStoreError("get", shardId, error));
@@ -13107,7 +13990,7 @@ var GatewayClient = class extends Client {
 	}
 	sessionCallbacks(options) {
 		const { sessionStore, gateway } = options;
-		if (sessionStore && (gateway?.retrieveSessionInfo || gateway?.updateSessionInfo)) throw new TypeError("sessionStore replaces gateway.retrieveSessionInfo and gateway.updateSessionInfo, pass one or the other");
+		if (sessionStore && (gateway?.retrieveSessionInfo || gateway?.updateSessionInfo)) throw new GatewayTypeError("ClientSessionStoreConflict");
 		let retrieve = gateway?.retrieveSessionInfo ?? DefaultWebSocketManagerOptions.retrieveSessionInfo;
 		let update = gateway?.updateSessionInfo ?? DefaultWebSocketManagerOptions.updateSessionInfo;
 		if (sessionStore) {
@@ -13142,6 +14025,24 @@ function resolveCache(options) {
 	return Object.keys(resolved).length === 0 ? void 0 : resolved;
 }
 
+//#endregion
+//#region src/errors/ErrorCodes.ts
+/**
+* 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) {
+*     // ...
+*   }
+* }
+* ```
+*/
+const GatewayErrorCodes = Object.freeze(Object.fromEntries(Object.keys(GatewayErrorMessages).map((code) => [code, code])));
+
 //#endregion
 //#region src/util/decorators.ts
 /**
@@ -13180,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, GatewayEvents, GatewaySessionStoreError, 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