feat(VoiceState): add methods for fetching voice state

packages/core/src/api/guild.ts

@@ -102,6 +102,7 @@ import {
  type RESTPutAPIGuildTemplateSyncResult,
  type Snowflake,
 } from 'discord-api-types/v10';
+import { VoiceAPI } from './voice';
 
 export class GuildsAPI {
  public constructor(private readonly rest: REST) {}
@@ -687,11 +688,12 @@ export class GuildsAPI {
  /**
  * Edits a user's voice state in a guild
  *
- * @see {@link https://discord.com/developers/docs/resources/guild#modify-user-voice-state}
+ * @see {@link https://discord.com/developers/docs/resources/user#modify-user-voice-state}
  * @param guildId - The id of the guild to edit the current user's voice state in
  * @param userId - The id of the user to edit the voice state for
  * @param body - The data for editing the voice state
  * @param options - The options for editing the voice state
+ * @deprecated Use {@link VoiceAPI.editUserVoiceState} instead
  */
  public async editUserVoiceState(
  guildId: Snowflake,
@@ -1298,9 +1300,10 @@ export class GuildsAPI {
  /**
  * Sets the voice state for the current user
  *
- * @see {@link https://discord.com/developers/docs/resources/guild#modify-current-user-voice-state}
+ * @see {@link https://discord.com/developers/docs/resources/voice#modify-current-user-voice-state}
  * @param guildId - The id of the guild
  * @param body - The options for setting the voice state
+ * @deprecated Use {@link VoiceAPI.setVoiceState}
  */
  public async setVoiceState(guildId: Snowflake, body: RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = {}) {
  return this.rest.patch(Routes.guildVoiceState(guildId, '@me'), {

packages/core/src/api/voice.ts

@@ -1,7 +1,16 @@
 /* eslint-disable jsdoc/check-param-names */
 
 import type { RequestData, REST } from '@discordjs/rest';
-import { Routes, type RESTGetAPIVoiceRegionsResult } from 'discord-api-types/v10';
+import {
+ Routes,
+ type Snowflake,
+ type RESTGetAPIVoiceRegionsResult,
+ type RESTGetAPIGuildVoiceStateUserResult,
+ type RESTGetAPIGuildVoiceStateCurrentMemberResult,
+ type RESTPatchAPIGuildVoiceStateUserJSONBody,
+ type RESTPatchAPIGuildVoiceStateCurrentMemberResult,
+ type RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody,
+} from 'discord-api-types/v10';
 
 export class VoiceAPI {
  public constructor(private readonly rest: REST) {}
@@ -15,4 +24,59 @@ export class VoiceAPI {
  public async getVoiceRegions({ signal }: Pick<RequestData, 'signal'> = {}) {
  return this.rest.get(Routes.voiceRegions(), { signal }) as Promise<RESTGetAPIVoiceRegionsResult>;
  }
+
+ /**
+ * Fetches voice state of a user by their id
+ *
+ * @see {@link https://discord.com/developers/docs/resources/voice#get-user-voice-state}
+ * @param options - The options for fetching user voice state
+ */
+ public async getUserVoiceState(guildId: Snowflake, userId: Snowflake, { signal }: Pick<RequestData, 'signal'> = {}) {
+ return this.rest.get(Routes.guildVoiceState(guildId, userId), {
+ signal,
+ }) as Promise<RESTGetAPIGuildVoiceStateUserResult>;
+ }
+
+ /**
+ * Fetches the current user's voice state
+ *
+ * @see {@link https://discord.com/developers/docs/resources/voice#get-current-user-voice-state}
+ * @param options - The options for fetching user voice state
+ */
+ public async getVoiceState(guildId: Snowflake, { signal }: Pick<RequestData, 'signal'> = {}) {
+ return this.rest.get(Routes.guildVoiceState(guildId, '@me'), {
+ signal,
+ }) as Promise<RESTGetAPIGuildVoiceStateCurrentMemberResult>;
+ }
+
+ /**
+ * Edits a user's voice state in a guild
+ *
+ * @see {@link https://discord.com/developers/docs/resources/user#modify-user-voice-state}
+ * @param guildId - The id of the guild to edit the current user's voice state in
+ * @param userId - The id of the user to edit the voice state for
+ * @param body - The data for editing the voice state
+ * @param options - The options for editing the voice state
+ */
+ public async editUserVoiceState(
+ guildId: Snowflake,
+ userId: Snowflake,
+ body: RESTPatchAPIGuildVoiceStateUserJSONBody,
+ { reason, signal }: Pick<RequestData, 'reason' | 'signal'> = {},
+ ) {
+ await this.rest.patch(Routes.guildVoiceState(guildId, userId), { reason, body, signal });
+ }
+
+ /**
+ * Sets the voice state for the current user
+ *
+ * @see {@link https://discord.com/developers/docs/resources/voice#modify-current-user-voice-state}
+ * @param guildId - The id of the guild
+ * @param body - The options for setting the voice state
+ */
+ public async setVoiceState(guildId: Snowflake, body: RESTPatchAPIGuildVoiceStateCurrentMemberJSONBody = {}) {
+ return this.rest.patch(Routes.guildVoiceState(guildId, '@me'), {
+ body,
+ }) as Promise<RESTPatchAPIGuildVoiceStateCurrentMemberResult>;
+ }
 }

packages/discord.js/src/managers/VoiceStateManager.js

@@ -1,5 +1,6 @@
 'use strict';
 
+const { Routes } = require('discord-api-types/v10');
 const CachedManager = require('./CachedManager');
 const VoiceState = require('../structures/VoiceState');
 
@@ -32,6 +33,27 @@ class VoiceStateManager extends CachedManager {
  if (cache) this.cache.set(data.user_id, entry);
  return entry;
  }
+
+ /**
+ * Obtains a user's voice state from discord or from the cache if it's already available.
+ * @param {GuildMemberResolvable} member The member whose voice state is to be fetched
+ * @param {BaseFetchOptions} [options] Additional options for this fetch
+ * @returns {Promise<VoiceState>}
+ * @example
+ * // Fetch a member's voice state
+ * guild.voiceStates.fetch("851588007697580033")
+ * .then(state => console.log(`Member's voice channel: ${state.channel}`))
+ * .catch(console.error);
+ */
+ async fetch(member, { cache = true, force = false } = {}) {
+ const id = this.guild.members.resolveId(member);
+ if (!force) {
+ const existing = this.cache.get(id);
+ if (existing) return existing;
+ }
+ const data = await this.client.rest.get(Routes.guildVoiceState(this.guild.id, id));
+ return this._add(data, cache);
+ }
 }
 
 module.exports = VoiceStateManager;

packages/discord.js/src/structures/VoiceState.js

@@ -250,6 +250,15 @@ class VoiceState extends Base {
  return this;
  }
 
+ /**
+ * Fetches this voice state.
+ * @param {boolean} [force=true] Whether to skip the cache check and request the API
+ * @returns {Promise<VoiceState>}
+ */
+ fetch(force = true) {
+ return this.guild.voiceStates.fetch(this.member, { force });
+ }
+
  /**
  * Toggles the request to speak in the channel.
  * Only applicable for stage channels and for the client's own voice state.

packages/discord.js/typings/index.d.ts

@@ -3589,6 +3589,7 @@ export class VoiceState extends Base {
  public setRequestToSpeak(request?: boolean): Promise<this>;
  public setSuppressed(suppressed?: boolean): Promise<this>;
  public edit(options: VoiceStateEditOptions): Promise<this>;
+ public fetch(force?: boolean): Promise<this>;
 }
 
 // tslint:disable-next-line no-empty-interface
@@ -4591,6 +4592,7 @@ export class UserManager extends CachedManager<Snowflake, User, UserResolvable>
 export class VoiceStateManager extends CachedManager<Snowflake, VoiceState, typeof VoiceState> {
  private constructor(guild: Guild, iterable?: Iterable<RawVoiceStateData>);
  public guild: Guild;
+ public fetch(member: GuildMemberResolvable, options?: BaseFetchOptions): Promise<VoiceState>;
 }
 
 //#endregion

packages/discord.js/typings/rawDataTypes.d.ts

@@ -47,6 +47,7 @@ import {
  APIUnavailableGuild,
  APIUser,
  APIVoiceRegion,
+ APIVoiceState,
  APIWebhook,
  GatewayActivity,
  GatewayActivityAssets,
@@ -62,7 +63,6 @@ import {
  GatewayPresenceUpdate,
  GatewayReadyDispatchData,
  GatewayTypingStartDispatchData,
- GatewayVoiceState,
  RESTAPIPartialCurrentUserGuild,
  RESTGetAPIWebhookWithTokenResult,
  RESTPatchAPIChannelMessageJSONBody,
@@ -194,7 +194,7 @@ export type RawUserData =
 
 export type RawVoiceRegionData = APIVoiceRegion;
 
-export type RawVoiceStateData = GatewayVoiceState | Omit<GatewayVoiceState, 'guild_id'>;
+export type RawVoiceStateData = APIVoiceState | Omit<APIVoiceState, 'guild_id'>;
 
 export type RawWebhookData =
  | APIWebhook