@wolfstar/plugin-gateway 0.10.0 → 0.11.0-next-20261005131555

package/dist/esm/index.js

@@ -8719,6 +8719,12 @@ var GuildMemberRoleManager = class GuildMemberRoleManager extends BaseManager {
 		return this.member.guildId;
 	}
 	/**
+	* Whether the member is partial, see {@link GuildMember.partial}. The roles of a partial member are not known.
+	*/
+	get partial() {
+		return this.member.partial;
+	}
+	/**
 	* The ID of the member's user.
 	*
 	* @throws {GatewayError} `GuildMemberUserUnknown` when the member's payload did not include its user.
@@ -9381,6 +9387,16 @@ var GuildMember = class extends Structure {
 		return this[kData].joined_at === void 0;
 	}
 	/**
+	* Whether the member is partial, see {@link GuildMember.partial}, as a type guard: narrows to {@link PartialGuildMember}.
+	*
+	* @remarks
+	* `joinedAt` stays `Date | null` on a member that is not partial: Discord types `joined_at` as nullable on the
+	* gateway's member payloads, so `partial` alone can not tell that it is a date.
+	*/
+	isPartial() {
+		return this.partial;
+	}
+	/**
 	* Fetches the member from the API and patches this structure with the result.
 	*/
 	async fetch() {
@@ -13630,6 +13646,94 @@ var VoiceStateManager = class extends CachedManager {
 	}
 };
 
+//#endregion
+//#region src/structures/channels/ThreadMember.ts
+/**
+* A member of a thread: a user who joined it, or was added to it.
+*/
+var ThreadMember = class extends Structure {
+	optimizeData(data) {
+		this.optimizeTimestamp("join_timestamp", data.join_timestamp);
+	}
+	/**
+	* @param data The raw thread member.
+	* @param relations The guild member, thread, and user as resolved from the cache, by `client.threadMembers`.
+	*/
+	constructor(data, relations = {}) {
+		super(data, relations);
+	}
+	[kPatch](data) {
+		if (data.member) this.dropRelations("guildMember");
+		return super[kPatch](data);
+	}
+	/**
+	* The ID of the user. Absent only from the thread member the gateway attaches to a thread payload for the bot.
+	*/
+	get id() {
+		return this[kData].user_id ?? null;
+	}
+	get threadId() {
+		return this[kData].id ?? null;
+	}
+	/**
+	* Whether the thread member is partial: built from its IDs alone for an event about an uncached thread member, see
+	* `Partials.ThreadMember`. Only `id`, `threadId`, and `guildId` are reliable then, and {@link ThreadMember.fetch}
+	* completes it.
+	*/
+	get partial() {
+		return this[kData].flags === void 0;
+	}
+	/**
+	* Fetches the thread member from the API and patches this structure with the result.
+	*/
+	async fetch() {
+		const { threadId, id } = this;
+		if (!threadId || !id) throw new GatewayError("ThreadMemberIdsMissing", "fetched");
+		const member = await this.client.threadMembers.fetch(threadId, id, { force: true });
+		return this[kPatch](member.toJSON());
+	}
+	get joinedTimestamp() {
+		return this.optimizedTimestamp("join_timestamp");
+	}
+	get joinedAt() {
+		return new Date(this.joinedTimestamp);
+	}
+	/**
+	* The thread member's notification flags.
+	*/
+	get flags() {
+		return this[kData].flags;
+	}
+	/**
+	* The member of the thread's guild, when known.
+	*/
+	get guildMember() {
+		return this[kRelations].guildMember ?? null;
+	}
+	/**
+	* The thread, from the cache, like discord.js's `ThreadMember#thread`. `null` when it is not cached, or when the
+	* cache is asynchronous.
+	*/
+	get thread() {
+		return this.lazyRelation("thread", (client) => cachedChannel(client, this.threadId));
+	}
+	/**
+	* The user, from the cache, like discord.js's `ThreadMember#user`, else the user of the guild member.
+	*/
+	get user() {
+		return this[kRelations].user ?? this.guildMember?.user ?? null;
+	}
+	/**
+	* Removes the member from the thread.
+	*/
+	async remove() {
+		const { id, threadId } = this;
+		if (!id || !threadId) throw new GatewayError("ThreadMemberIdsMissing", "removed");
+		await this.client.threadMembers.remove(threadId, id);
+		return this;
+	}
+};
+
 //#endregion
 //#region src/managers/PresenceManager.ts
 /**
@@ -13664,6 +13768,50 @@ var PresenceManager = class extends CachedManager {
 		}));
 	}
 	/**
+	* Resolves a {@link PresenceResolvable} to the cached presence of its user in a guild.
+	*
+	* @remarks
+	* A string is a **user ID**, not a cache key: build the key with {@link PresenceManager.resolveKey} to read
+	* `cache.get` directly. It is a pure cache read, no request is made and a miss is `null`; presences only come from
+	* the gateway.
+	*
+	* The guild comes from a member or a message, else from a thread member's member or thread, and otherwise from
+	* `guildId`. A message sent in a direct message belongs to no guild, so it resolves to `null` unless `guildId` is
+	* given.
+	*
+	* @param presence The presence, something holding a user, or a user ID.
+	* @param guildId The guild to look the presence up in, when the value carries none.
+	* @returns The presence, or `null` if it is not cached or its guild is unknown.
+	*/
+	resolve(presence, guildId) {
+		if (presence instanceof Presence) return presence;
+		const userId = this.resolveId(presence);
+		const guild = this.guildOf(presence) ?? guildId ?? null;
+		if (userId === null || guild === null) return null;
+		return whenAll([this.cache.get(this.resolveKey(guild, userId))], ([cached]) => cached ?? null);
+	}
+	/**
+	* Resolves a {@link PresenceResolvable} to a user ID.
+	*
+	* @remarks
+	* This is the ID of the presence's user, like discord.js, and not the cache key {@link PresenceManager.resolveKey}
+	* builds from a guild and a user.
+	*
+	* @param presence The presence, something holding a user, or a user ID.
+	* @returns The user ID, or `null` if the value holds none.
+	*/
+	resolveId(presence) {
+		if (typeof presence === "string") return presence;
+		if (presence instanceof Presence) return presence.userId;
+		if (presence instanceof Message) return presence.author.id || null;
+		return presence.id;
+	}
+	guildOf(presence) {
+		if (presence instanceof GuildMember || presence instanceof Message) return presence.guildId;
+		if (presence instanceof ThreadMember) return presence.guildMember?.guildId ?? presence.thread?.guildId ?? null;
+		return null;
+	}
+	/**
 	* Lists the cached presences of a guild.
 	*
 	* @param guildId The ID of the guild.
@@ -13784,94 +13932,6 @@ var ThreadManager = class extends CachedManager {
 	}
 };
 
-//#endregion
-//#region src/structures/channels/ThreadMember.ts
-/**
-* A member of a thread: a user who joined it, or was added to it.
-*/
-var ThreadMember = class extends Structure {
-	optimizeData(data) {
-		this.optimizeTimestamp("join_timestamp", data.join_timestamp);
-	}
-	/**
-	* @param data The raw thread member.
-	* @param relations The guild member, thread, and user as resolved from the cache, by `client.threadMembers`.
-	*/
-	constructor(data, relations = {}) {
-		super(data, relations);
-	}
-	[kPatch](data) {
-		if (data.member) this.dropRelations("guildMember");
-		return super[kPatch](data);
-	}
-	/**
-	* The ID of the user. Absent only from the thread member the gateway attaches to a thread payload for the bot.
-	*/
-	get id() {
-		return this[kData].user_id ?? null;
-	}
-	get threadId() {
-		return this[kData].id ?? null;
-	}
-	/**
-	* Whether the thread member is partial: built from its IDs alone for an event about an uncached thread member, see
-	* `Partials.ThreadMember`. Only `id`, `threadId`, and `guildId` are reliable then, and {@link ThreadMember.fetch}
-	* completes it.
-	*/
-	get partial() {
-		return this[kData].flags === void 0;
-	}
-	/**
-	* Fetches the thread member from the API and patches this structure with the result.
-	*/
-	async fetch() {
-		const { threadId, id } = this;
-		if (!threadId || !id) throw new GatewayError("ThreadMemberIdsMissing", "fetched");
-		const member = await this.client.threadMembers.fetch(threadId, id, { force: true });
-		return this[kPatch](member.toJSON());
-	}
-	get joinedTimestamp() {
-		return this.optimizedTimestamp("join_timestamp");
-	}
-	get joinedAt() {
-		return new Date(this.joinedTimestamp);
-	}
-	/**
-	* The thread member's notification flags.
-	*/
-	get flags() {
-		return this[kData].flags;
-	}
-	/**
-	* The member of the thread's guild, when known.
-	*/
-	get guildMember() {
-		return this[kRelations].guildMember ?? null;
-	}
-	/**
-	* The thread, from the cache, like discord.js's `ThreadMember#thread`. `null` when it is not cached, or when the
-	* cache is asynchronous.
-	*/
-	get thread() {
-		return this.lazyRelation("thread", (client) => cachedChannel(client, this.threadId));
-	}
-	/**
-	* The user, from the cache, like discord.js's `ThreadMember#user`, else the user of the guild member.
-	*/
-	get user() {
-		return this[kRelations].user ?? this.guildMember?.user ?? null;
-	}
-	/**
-	* Removes the member from the thread.
-	*/
-	async remove() {
-		const { id, threadId } = this;
-		if (!id || !threadId) throw new GatewayError("ThreadMemberIdsMissing", "removed");
-		await this.client.threadMembers.remove(threadId, id);
-		return this;
-	}
-};
-
 //#endregion
 //#region src/managers/ThreadMemberManager.ts
 /**
@@ -14503,7 +14563,8 @@ var Typing = class extends Structure {
 		return this.lazyRelation("guild", (client) => cachedGuild(client, this[kData].guild_id));
 	}
 	/**
-	* The typing member, when the channel is in a guild: the cached member, else the one of the payload.
+	* The typing member, when the channel is in a guild: the cached member, else the one of the payload, else a partial
+	* one with `Partials.GuildMember`.
 	*/
 	get member() {
 		const resolved = this[kRelations].member;