@wolfstar/plugin-gateway 0.5.0 → 0.6.0

package/dist/esm/index.js

@@ -1,7 +1,7 @@
 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, emojiKey, integrationKey, inviteKey, memberKey, messageKey, presenceKey, roleKey, scheduledEventKey, soundboardSoundKey, stageInstanceKey, stickerKey, threadMemberKey, voiceStateKey } from "@wolfstar/plugin-cache";
+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 { readFile } from "node:fs/promises";
@@ -725,8 +725,9 @@ var PermissionOverwriteManager = class {
 	}
 	async guessType(target, id) {
 		if (typeof target !== "string") return "hoist" in target ? OverwriteType.Role : OverwriteType.Member;
-		if (id === this.guildId) return OverwriteType.Role;
-		return (this.guildId ? await this.client.roles.get(this.guildId, id) : void 0) ? OverwriteType.Role : OverwriteType.Member;
+		if (id === this.guildId || !this.guildId) return OverwriteType.Role;
+		if (this.client.roles.cache) return await this.client.roles.get(this.guildId, id) ? OverwriteType.Role : OverwriteType.Member;
+		return (await this.client.roles.fetchAll(this.guildId)).some((role) => role.id === id) ? OverwriteType.Role : OverwriteType.Member;
 	}
 	async patchCached(update) {
 		const cache = this.client.cache?.channels;
@@ -1755,10 +1756,12 @@ var ThreadChannelMixin = class {
 	}
 	/**
 	* Whether the bot is a member of the thread, like discord.js's `ThreadChannel#joined`: from the thread member cache
-	* when the thread was built by a manager, else whether the payload carries the bot's thread member.
+	* when the thread was built by a manager, else `true` when the payload carries the bot's thread member.
+	*
+	* @returns `null` when it cannot be told: no thread member cache, and no thread member in the payload.
 	*/
 	get joined() {
-		return this[kRelations].joined ?? this[kData].member !== void 0;
+		return this[kRelations].joined ?? (this[kData].member === void 0 ? null : true);
 	}
 	/**
 	* The members of the thread.
@@ -2693,12 +2696,16 @@ function whenCachedMap(ids, get) {
 //#endregion
 //#region src/managers/CachedManager.ts
 /**
-* The base class of every manager: it reads raw data from one of the client's entity caches, falls back to the REST
-* API when asked to, and wraps the result in a {@link StructureMixin | structure}.
+* The base class of every manager, the `BaseManager` of the discord.js RFC #11426: it reads raw data from one of the
+* client's entity caches, falls back to the REST API when asked to, and wraps the result in a
+* {@link StructureMixin | structure} with {@link CachedManager.construct}.
 *
 * @remarks
-* The cache only ever holds raw API data, building structures is always the manager's job. Without a cache, `get`
-* always resolves to `undefined` and `fetch` always hits the API.
+* The cache only ever holds raw API data, building structures is always the manager's job. Without a store for its
+* entity (see the client's `makeCache`), `get` always resolves to `undefined` and `fetch` always hits the API.
+*
+* A failing store (e.g. Redis being unreachable) emits `cacheError` and, with the client's default
+* `cacheErrors: "miss"`, is treated as a cache miss.
 *
 * Every method is asynchronous since the cache can be Redis, except {@link CachedManager.cached}, which reads a
 * synchronous cache (`createInMemoryCache`) without awaiting it.
@@ -2810,13 +2817,14 @@ var CachedManager = class {
 	* @internal
 	*/
 	async _add(data, cache = true, { key = this.keyOf(data) } = {}) {
-		const existing = await this.cache?.get(key);
-		const merged = existing ? {
-			...existing,
-			...data
-		} : data;
-		if (cache) await this.storeRaw(key, merged);
-		return this.hydrate(merged);
+		const store = this.cache;
+		if (store === void 0) return this.hydrate(data);
+		if (!cache) {
+			const existing = await this.guard("get", key, () => store.get(key), void 0);
+			return this.hydrate(mergeValues(existing, data));
+		}
+		const { added } = await this.guard("upsert", key, () => store.upsert(key, data), { added: data });
+		return this.hydrate(added);
 	}
 	/**
 	* Gets the cached structure of the entity raw data describes, or builds one from the data when it is not cached.
@@ -2850,7 +2858,7 @@ var CachedManager = class {
 	}
 	/**
 	* Builds the structure of raw data, resolving its relations from the cache. Without relations to resolve, the same
-	* as {@link CachedManager.createStructure}.
+	* as {@link CachedManager.construct}.
 	*
 	* @param data The raw data.
 	*/
@@ -2866,7 +2874,7 @@ var CachedManager = class {
 	* @internal
 	*/
 	_hydrate(data) {
-		return this.createStructure(data);
+		return this.construct(data);
 	}
 	/**
 	* Gets an entity from the cache, fetching it from the API (and caching it) on a cache miss.
@@ -2899,13 +2907,35 @@ var CachedManager = class {
 		return this.fetch(...args, { force: true });
 	}
 	/**
+	* Wraps raw data in this manager's structure.
+	*
+	* @param data The raw data.
+	* @deprecated Use {@link CachedManager.construct}.
+	*/
+	createStructure(data) {
+		return this.construct(data);
+	}
+	/**
 	* Writes raw data to the cache.
 	*
 	* @param key The cache key of the entity.
 	* @param raw The raw data of the entity.
 	*/
 	async storeRaw(key, raw) {
-		await this.cache?.set(key, raw);
+		const { cache } = this;
+		if (cache) await this.guard("set", key, () => cache.set(key, raw), void 0);
+	}
+	/**
+	* Gets this manager's store when it can enumerate its entries, for the `listCached` methods.
+	*
+	* @returns The store, or `undefined` when this entity is not cached.
+	* @throws {TypeError} When the store cannot enumerate its entries.
+	*/
+	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)`);
+		return cache;
 	}
 	/**
 	* Gets an entity from the cache by its key, synchronously when every cache it reads is.
@@ -2913,7 +2943,34 @@ var CachedManager = class {
 	* @param key The cache key of the entity.
 	*/
 	getByKey(key) {
-		return whenAll([this.cache?.get(key)], ([raw]) => raw === void 0 ? void 0 : this.build(raw));
+		const { cache } = this;
+		return whenAll([cache ? this.guard("get", key, () => cache.get(key), void 0) : void 0], ([raw]) => raw === void 0 ? void 0 : this.build(raw));
+	}
+	/**
+	* Runs a cache operation, reporting its failure through `cacheError`. With the client's `cacheErrors: "miss"`, a
+	* failure resolves to `fallback`, otherwise it is rethrown. Synchronous when the operation is.
+	*
+	* @param operation The operation, for `cacheError`.
+	* @param key The key of the entry, for `cacheError`.
+	* @param run Runs the operation.
+	* @param fallback What a failure resolves to under `cacheErrors: "miss"`.
+	*/
+	guard(operation, key, run, fallback) {
+		const fail = (error) => {
+			this.client.emit("cacheError", error, {
+				entity: this.entity,
+				key,
+				operation
+			});
+			if (this.client.cacheErrors === "throw") throw error;
+			return fallback;
+		};
+		try {
+			const result = run();
+			return isPromiseLike(result) ? result.catch(fail) : result;
+		} catch (error) {
+			return fail(error);
+		}
 	}
 	/**
 	* Builds the structure of raw data with {@link CachedManager._hydrate}, bound to this manager's client.
@@ -2967,7 +3024,7 @@ var ChannelManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "channels");
 	}
-	createStructure(data) {
+	construct(data) {
 		return createChannel(data);
 	}
 	keyOf(data) {
@@ -2997,15 +3054,15 @@ var ChannelManager = class extends CachedManager {
 		return whenAll([
 			parentId && depth < MaxParentDepth ? this.cache?.get(parentId) : void 0,
 			recipient ? client.users._resolveData(recipient) : void 0,
-			data.type === ChannelType.GuildStageVoice && guildId ? client.cache?.stageInstances.get(stageInstanceKey(guildId, data.id)) : void 0,
-			thread ? client.cache?.threadMembers.get(threadMemberKey(data.id, client.user?.id ?? client.id)) : void 0
+			data.type === ChannelType.GuildStageVoice && guildId ? client.cache?.stageInstances?.get(stageInstanceKey(guildId, data.id)) : void 0,
+			thread ? client.cache?.threadMembers?.get(threadMemberKey(data.id, client.user?.id ?? client.id)) : void 0
 		], ([parentData, resolvedRecipient, stageData, me]) => whenAll([parentData ? this._hydrateInGuild(parentData, guild, depth + 1) : null], ([parent]) => {
 			const relations = {
 				guild,
 				parent
 			};
 			if (recipient) relations.recipient = resolvedRecipient ?? null;
-			if (thread && client.cache) relations.joined = me !== void 0;
+			if (thread && client.cache?.threadMembers) relations.joined = me !== void 0;
 			const channel = bindClient(createChannel(data, relations), client);
 			if (data.type === ChannelType.GuildStageVoice) relations.stageInstance = stageData ? bindClient(new StageInstance(stageData, {
 				guild,
@@ -3051,7 +3108,7 @@ var ChannelManager = class extends CachedManager {
 	* @param raw The raw channel.
 	*/
 	async storeRaw(channelId, raw) {
-		if (isThreadChannelType(raw.type)) await this.client.cache?.threads.set(channelId, raw);
+		if (isThreadChannelType(raw.type)) await this.client.cache?.threads?.set(channelId, raw);
 		else await this.cache?.set(channelId, raw);
 	}
 	/**
@@ -3341,7 +3398,7 @@ var Guild = class extends AnonymousGuild {
 		const resolved = this[kRelations][name];
 		if (resolved !== void 0) return resolved;
 		const channelId = this[kData][GuildChannelFields[name]];
-		if (!channelId || this.client.cache?.channels.synchronous !== true) return null;
+		if (!channelId || this.client.cache?.channels?.synchronous !== true) return null;
 		try {
 			return this.client.channels.cached(channelId) ?? null;
 		} catch {
@@ -5552,7 +5609,7 @@ var AutoModerationRuleManager = class extends CachedManager {
 		super(client, "autoModerationRules");
 		this.guildId = guildId;
 	}
-	createStructure(data) {
+	construct(data) {
 		return new AutoModerationRule(data);
 	}
 	keyOf(data) {
@@ -5684,7 +5741,7 @@ var GuildBanManager = class extends CachedManager {
 		super(client, "bans");
 		this.guildId = guildId;
 	}
-	createStructure(data) {
+	construct(data) {
 		return new GuildBan(data);
 	}
 	keyOf(data) {
@@ -5844,7 +5901,7 @@ var GuildIntegrationManager = class extends CachedManager {
 		super(client, "integrations");
 		this.guildId = guildId;
 	}
-	createStructure(data) {
+	construct(data) {
 		return new Integration(data);
 	}
 	keyOf(data) {
@@ -5914,7 +5971,7 @@ var GuildScheduledEventManager = class extends CachedManager {
 		super(client, "scheduledEvents");
 		this.guildId = guildId;
 	}
-	createStructure(data) {
+	construct(data) {
 		return new GuildScheduledEvent(data);
 	}
 	keyOf(data) {
@@ -6125,7 +6182,7 @@ var GuildSoundboardSoundManager = class extends CachedManager {
 		super(client, "soundboardSounds");
 		this.guildId = guildId;
 	}
-	createStructure(data) {
+	construct(data) {
 		return new SoundboardSound(data);
 	}
 	keyOf(data) {
@@ -6228,7 +6285,7 @@ var StageInstanceManager = class extends CachedManager {
 		super(client, "stageInstances");
 		this.guildId = guildId;
 	}
-	createStructure(data) {
+	construct(data) {
 		return new StageInstance(data);
 	}
 	keyOf(data) {
@@ -6308,7 +6365,7 @@ var GuildEmojiManager = class extends CachedManager {
 		super(client, "emojis");
 		this.guildId = guildId;
 	}
-	createStructure(data) {
+	construct(data) {
 		return new GuildEmoji(data);
 	}
 	keyOf(data) {
@@ -6391,9 +6448,12 @@ var GuildEmojiManager = class extends CachedManager {
 	* @remarks
 	* It enumerates the whole entity cache, which a Redis store answers from its index: prefer `fetchAll` when the
 	* cache may be incomplete.
+	*
+	* @returns The cached entries, `[]` when this entity is not cached.
+	* @throws {TypeError} When the store cannot enumerate its entries.
 	*/
 	async listCached() {
-		const cache = this.cache;
+		const cache = this.iterableCache();
 		if (!cache) return [];
 		const prefix = `${this.guildId}:`;
 		const keys = (await cache.keys()).filter((key) => key.startsWith(prefix));
@@ -6428,7 +6488,7 @@ var GuildInviteManager = class extends CachedManager {
 		super(client, "invites");
 		this.guildId = guildId;
 	}
-	createStructure(data) {
+	construct(data) {
 		return new GuildInvite(data);
 	}
 	keyOf(data) {
@@ -6536,7 +6596,7 @@ var GuildStickerManager = class extends CachedManager {
 		super(client, "stickers");
 		this.guildId = guildId;
 	}
-	createStructure(data) {
+	construct(data) {
 		return new Sticker(data);
 	}
 	keyOf(data) {
@@ -6620,9 +6680,12 @@ var GuildStickerManager = class extends CachedManager {
 	* @remarks
 	* It enumerates the whole entity cache, which a Redis store answers from its index: prefer `fetchAll` when the
 	* cache may be incomplete.
+	*
+	* @returns The cached entries, `[]` when this entity is not cached.
+	* @throws {TypeError} When the store cannot enumerate its entries.
 	*/
 	async listCached() {
-		const cache = this.cache;
+		const cache = this.iterableCache();
 		if (!cache) return [];
 		const prefix = `${this.guildId}:`;
 		const keys = (await cache.keys()).filter((key) => key.startsWith(prefix));
@@ -6652,7 +6715,7 @@ var GuildManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "guilds");
 	}
-	createStructure(data) {
+	construct(data) {
 		return new Guild(data);
 	}
 	keyOf(data) {
@@ -6684,7 +6747,7 @@ var GuildManager = class extends CachedManager {
 	* @internal
 	*/
 	_getShallow(guildId) {
-		return whenAll([this.cache?.get(guildId)], ([raw]) => raw === void 0 ? void 0 : bindClient(this.createStructure(raw), this.client));
+		return whenAll([this.cache?.get(guildId)], ([raw]) => raw === void 0 ? void 0 : bindClient(this.construct(raw), this.client));
 	}
 	resolveKey(guildId) {
 		return guildId;
@@ -7151,7 +7214,12 @@ var GuildMemberRoleManager = class {
 	*/
 	async fetch() {
 		const ids = [...this.#roleIds, this.guildId];
-		return (await Promise.all(ids.map((id) => this.client.roles.fetch(this.guildId, id)))).toSorted((a, b) => b.comparePositionTo(a));
+		let roles = (await Promise.all(ids.map((id) => this.client.roles.get(this.guildId, id)))).filter((role) => role !== void 0);
+		if (roles.length !== ids.length) {
+			const wanted = new Set(ids);
+			roles = (await this.client.roles.fetchAll(this.guildId)).filter((role) => wanted.has(role.id));
+		}
+		return roles.toSorted((a, b) => b.comparePositionTo(a));
 	}
 	/**
 	* Fetches the member's highest role, `@everyone` when they have no other.
@@ -8175,7 +8243,7 @@ var GuildMemberManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "members");
 	}
-	createStructure(data) {
+	construct(data) {
 		return new GuildMember(data);
 	}
 	keyOf(data) {
@@ -8206,8 +8274,8 @@ var GuildMemberManager = class extends CachedManager {
 		return whenAll([
 			data.user ? client.users._resolveData(data.user) : void 0,
 			this.cachedGuild(data.guild_id),
-			key ? client.cache?.voiceStates.get(key) : void 0,
-			key ? client.cache?.presences.get(key) : void 0
+			key ? client.cache?.voiceStates?.get(key) : void 0,
+			key ? client.cache?.presences?.get(key) : void 0
 		], ([user, guild, voiceData, presenceData]) => {
 			const relations = {
 				user,
@@ -8215,18 +8283,16 @@ var GuildMemberManager = class extends CachedManager {
 			};
 			const member = bindClient(new GuildMember(data, relations), client);
 			return whenAll([voiceData?.channel_id ? client.channels._get(voiceData.channel_id) : void 0], ([channel]) => {
-				if (key && client.cache) {
-					relations.voice = voiceData ? bindClient(new VoiceState(voiceData, {
-						member,
-						guild,
-						channel: channel ?? null
-					}), client) : null;
-					relations.presence = presenceData ? bindClient(new Presence(presenceData, {
-						user: user ?? null,
-						member,
-						guild
-					}), client) : null;
-				}
+				if (key && client.cache?.voiceStates) relations.voice = voiceData ? bindClient(new VoiceState(voiceData, {
+					member,
+					guild,
+					channel: channel ?? null
+				}), client) : null;
+				if (key && client.cache?.presences) relations.presence = presenceData ? bindClient(new Presence(presenceData, {
+					user: user ?? null,
+					member,
+					guild
+				}), client) : null;
 				return member;
 			});
 		});
@@ -9430,7 +9496,7 @@ var Message = class Message extends Message$1 {
 		const resolved = this[kRelations].thread;
 		if (resolved) return resolved;
 		const { thread } = this[kData];
-		return thread ? this.client.threads.createStructure(thread) : null;
+		return thread ? this.client.threads.construct(thread) : null;
 	}
 	/**
 	* The content with user, role, and channel mentions replaced by names, and `@everyone`/`@here` defused, like
@@ -9668,7 +9734,7 @@ var MessageManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "messages");
 	}
-	createStructure(data) {
+	construct(data) {
 		return new Message(data);
 	}
 	keyOf(data) {
@@ -9693,7 +9759,7 @@ var MessageManager = class extends CachedManager {
 	_hydrate(data) {
 		const { author, member, guild_id: guildId } = data;
 		return whenAll([
-			data.webhook_id ? this.client.users.createStructure(author) : this.client.users._resolveData(author),
+			data.webhook_id ? this.client.users.construct(author) : this.client.users._resolveData(author),
 			member && guildId ? this.client.members._resolveData({
 				...member,
 				user: author,
@@ -10201,7 +10267,7 @@ var RoleManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "roles");
 	}
-	createStructure(data) {
+	construct(data) {
 		return new Role(data);
 	}
 	keyOf(data) {
@@ -10769,7 +10835,7 @@ var VoiceStateManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "voiceStates");
 	}
-	createStructure(data) {
+	construct(data) {
 		return new VoiceState(data);
 	}
 	keyOf(data) {
@@ -10798,10 +10864,12 @@ var VoiceStateManager = class extends CachedManager {
 	* Lists the cached voice states of a guild.
 	*
 	* @param guildId The ID of the guild.
+	* @returns The cached entries, `[]` when this entity is not cached.
+	* @throws {TypeError} When the store cannot enumerate its entries.
 	*/
 	async listCached(guildId) {
 		const prefix = `${guildId}:`;
-		const entries = await this.cache?.entries() ?? [];
+		const entries = await this.iterableCache()?.entries() ?? [];
 		return Promise.all(entries.filter(([key]) => key.startsWith(prefix)).map(([, raw]) => this.hydrate(raw)));
 	}
 	async fetchRaw(guildId, userId) {
@@ -10827,7 +10895,7 @@ var PresenceManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "presences");
 	}
-	createStructure(data) {
+	construct(data) {
 		return new Presence(data);
 	}
 	keyOf(data) {
@@ -10851,14 +10919,16 @@ var PresenceManager = class extends CachedManager {
 	* Lists the cached presences of a guild.
 	*
 	* @param guildId The ID of the guild.
+	* @returns The cached entries, `[]` when this entity is not cached.
+	* @throws {TypeError} When the store cannot enumerate its entries.
 	*/
 	async listCached(guildId) {
 		const prefix = `${guildId}:`;
-		const entries = await this.cache?.entries() ?? [];
+		const entries = await this.iterableCache()?.entries() ?? [];
 		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 (user ${userId} of guild ${guildId} is not cached)`));
+		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`));
 	}
 };
 
@@ -10871,7 +10941,7 @@ var ThreadManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "threads");
 	}
-	createStructure(data) {
+	construct(data) {
 		return createChannel(data);
 	}
 	keyOf(data) {
@@ -11062,7 +11132,7 @@ var ThreadMemberManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "threadMembers");
 	}
-	createStructure(data) {
+	construct(data) {
 		return new ThreadMember(data);
 	}
 	keyOf(data) {
@@ -11176,7 +11246,7 @@ var UserManager = class extends CachedManager {
 	constructor(client) {
 		super(client, "users");
 	}
-	createStructure(data) {
+	construct(data) {
 		return new User(data);
 	}
 	keyOf(data) {
@@ -11207,7 +11277,7 @@ var UserManager = class extends CachedManager {
 	async deleteDM(userId) {
 		const channel = await this.createDM(userId);
 		await this.client.api.channels.delete(channel.id);
-		await this.client.cache?.channels.delete(channel.id);
+		await this.client.cache?.channels?.delete(channel.id);
 		return channel;
 	}
 	/**
@@ -11673,6 +11743,7 @@ let GatewayEvents = /* @__PURE__ */ function(GatewayEvents) {
 	GatewayEvents["ShardResume"] = "shardResume";
 	GatewayEvents["ShardClose"] = "shardClose";
 	GatewayEvents["ShardError"] = "shardError";
+	GatewayEvents["CacheError"] = "cacheError";
 	GatewayEvents["GuildCreate"] = "guildCreate";
 	GatewayEvents["GuildUpdate"] = "guildUpdate";
 	GatewayEvents["GuildDelete"] = "guildDelete";
@@ -11705,9 +11776,11 @@ let GatewayEvents = /* @__PURE__ */ function(GatewayEvents) {
 	GatewayEvents["GuildRoleUpdate"] = "guildRoleUpdate";
 	GatewayEvents["GuildRoleDelete"] = "guildRoleDelete";
 	GatewayEvents["UserUpdate"] = "userUpdate";
+	GatewayEvents["GuildEmojisUpdate"] = "guildEmojisUpdate";
 	GatewayEvents["EmojiCreate"] = "emojiCreate";
 	GatewayEvents["EmojiUpdate"] = "emojiUpdate";
 	GatewayEvents["EmojiDelete"] = "emojiDelete";
+	GatewayEvents["GuildStickersUpdate"] = "guildStickersUpdate";
 	GatewayEvents["StickerCreate"] = "stickerCreate";
 	GatewayEvents["StickerUpdate"] = "stickerUpdate";
 	GatewayEvents["StickerDelete"] = "stickerDelete";
@@ -12174,32 +12247,48 @@ const DispatchHandlers = {
 * The table of the dispatches that turn into several events, diffed against the cache.
 *
 * @remarks
-* Without a cache there is nothing to diff against, so these dispatches only reach `raw`.
+* Their aggregate event (e.g. `guildEmojisUpdate`) is always emitted. Without a cache there is nothing to diff
+* against, so the granular events are not.
 */
 const MultiDispatchHandlers = {
 	[GatewayDispatchEvents.GuildEmojisUpdate]: {
-		before: (client, data) => client.guilds.emojis(data.guild_id).listCached(),
+		before: (client, data) => cachedList(client.cache?.emojis, () => client.guilds.emojis(data.guild_id).listCached()),
 		emit: async (client, data, previous) => {
-			if (!client.cache || !previous) return [];
 			const emojis = client.guilds.emojis(data.guild_id);
-			return diff(previous, await Promise.all(data.emojis.map((emoji) => emojis.hydrate({
+			const current = await Promise.all(data.emojis.map((emoji) => emojis.hydrate({
 				...emoji,
 				guild_id: data.guild_id
-			}))), "emojiCreate", "emojiUpdate", "emojiDelete");
+			})));
+			const events = [[
+				"guildEmojisUpdate",
+				data.guild_id,
+				current
+			]];
+			if (!previous) return events;
+			return events.concat(diff(previous, current, "emojiCreate", "emojiUpdate", "emojiDelete"));
 		}
 	},
 	[GatewayDispatchEvents.GuildStickersUpdate]: {
-		before: (client, data) => client.guilds.stickers(data.guild_id).listCached(),
+		before: (client, data) => cachedList(client.cache?.stickers, () => client.guilds.stickers(data.guild_id).listCached()),
 		emit: async (client, data, previous) => {
-			if (!client.cache || !previous) return [];
 			const stickers = client.guilds.stickers(data.guild_id);
-			return diff(previous, await Promise.all(data.stickers.map((sticker) => stickers.hydrate({
+			const current = await Promise.all(data.stickers.map((sticker) => stickers.hydrate({
 				...sticker,
 				guild_id: data.guild_id
-			}))), "stickerCreate", "stickerUpdate", "stickerDelete");
+			})));
+			const events = [[
+				"guildStickersUpdate",
+				data.guild_id,
+				current
+			]];
+			if (!previous) return events;
+			return events.concat(diff(previous, current, "stickerCreate", "stickerUpdate", "stickerDelete"));
 		}
 	}
 };
+async function cachedList(store, list) {
+	return store && isIterableCache(store) ? list() : void 0;
+}
 function diff(previous, current, create, update, remove) {
 	const before = new Map(previous.map((value) => [value.id, value]));
 	const events = [];
@@ -12646,6 +12735,10 @@ var GatewayClient = class extends Client {
 	*/
 	cacheFailure;
 	/**
+	* What the managers do when a cache read or write fails, see {@link GatewayClientOptions.cacheErrors}.
+	*/
+	cacheErrors;
+	/**
 	* See {@link GatewayClientOptions.dispatchTimeout}.
 	*/
 	dispatchTimeout;
@@ -12675,7 +12768,8 @@ var GatewayClient = class extends Client {
 		super(options);
 		container.gatewayClient = this;
 		this.rest = container.rest;
-		this.cache = options.cache;
+		this.cache = resolveCache(options);
+		this.cacheErrors = options.cacheErrors ?? "miss";
 		this.cacheFailure = options.cacheFailure ?? "skip";
 		this.dispatchTimeout = options.dispatchTimeout === void 0 ? 3e4 : options.dispatchTimeout;
 		this.partials = Object.freeze([...options.partials ?? []]);
@@ -12962,6 +13056,8 @@ var GatewayClient = class extends Client {
 	* They are the guilds the bot left while it was disconnected, or while the process was down with a persistent
 	* cache. Discord does not replay those removals on a new session, so the cache would otherwise keep them forever.
 	*
+	* It needs a guilds cache able to enumerate its entries, and is skipped without one.
+	*
 	* It is best effort: any failure (cache unreachable, unknown shard count) is reported through `error` and stops the
 	* reconciliation, keeping the remaining guilds, but never fails `READY` itself.
 	*
@@ -12976,8 +13072,9 @@ var GatewayClient = class extends Client {
 		}
 	}
 	async dropUnlistedGuilds(data, shardId) {
-		if (!this.cache) return;
-		const cached = await this.cache.guilds.keys();
+		const guilds = this.cache?.guilds;
+		if (!guilds || !isIterableCache(guilds)) return;
+		const cached = await guilds.keys();
 		if (cached.length === 0) return;
 		const count = data.shard?.[1] ?? this.#shardCount ?? await this.gateway.getShardCount();
 		const listed = new Set(data.guilds.map((guild) => guild.id));
@@ -13030,6 +13127,20 @@ var GatewayClient = class extends Client {
 		else this.logger.error(`[Gateway] [Shard ${shardId}] Failed to process ${type}:`, error);
 	}
 };
+/**
+* Builds the cache of a client out of its options: the stores of `makeCache` (or `cache`), wrapped by `policies`.
+* `undefined` when no entity kind is cached.
+*/
+function resolveCache(options) {
+	const { makeCache, cache, policies } = options;
+	const source = makeCache ?? (cache ? (entity) => cache[entity] : void 0);
+	if (!source) return void 0;
+	const resolved = source === makeCache || policies ? createCache({
+		makeCache: source,
+		policies
+	}) : cache;
+	return Object.keys(resolved).length === 0 ? void 0 : resolved;
+}
 
 //#endregion
 //#region src/util/decorators.ts
@@ -13069,5 +13180,5 @@ function RegisterAsGatewayListener(event, options = {}) {
 }
 
 //#endregion
-export { Action, ActionsManager, Activity, ActivityFlagsBitField, AnnouncementChannel, AnnouncementThreadChannel, AnonymousGuild, AppliedTagsMixin, Attachment, AttachmentFlagsBitField, AutoModerationActionExecution, AutoModerationRule, AutoModerationRuleManager, BaseChannel, BaseChannelMixin, BaseInvite, BitField, CachedManager, 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, 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 };
 //# sourceMappingURL=index.js.map