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

package/dist/esm/index.js

@@ -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 = {
@@ -9250,7 +9354,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() {
@@ -9564,7 +9668,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 +10943,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 +11032,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 +11181,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 +11221,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 +11240,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 +12583,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 +12746,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 +13211,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 +13246,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 +13302,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, 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 };
 //# sourceMappingURL=index.js.map