feat(member): implement new voice states endpoints

changelog/1216.feature.rst

@@ -0,0 +1 @@
+Add :meth:`Member.fetch_voice_state` to fetch the :class:`VoiceState` of a member.

disnake/http.py

@@ -984,6 +984,14 @@ def change_nickname(
         }
         return self.request(r, json=payload, reason=reason)
 
+    def get_voice_state(
+        self, guild_id: Snowflake, user_id: Snowflake
+    ) -> Response[voice.GuildVoiceState]:
+        r = Route(
+            "GET", "/guilds/{guild_id}/voice-states/{user_id}", guild_id=guild_id, user_id=user_id
+        )
+        return self.request(r)
+
     def edit_my_voice_state(self, guild_id: Snowflake, payload: Dict[str, Any]) -> Response[None]:
         r = Route("PATCH", "/guilds/{guild_id}/voice-states/@me", guild_id=guild_id)
         return self.request(r, json=payload)

disnake/member.py

@@ -1004,6 +1004,45 @@ async def edit(
             data = await http.edit_member(guild_id, self.id, reason=reason, **payload)
             return Member(data=data, guild=self.guild, state=self._state)
 
+    async def fetch_voice_state(self, *, cache: bool = False) -> VoiceState:
+        """|coro|
+
+        Fetches the :class:`VoiceState` of the member.
+
+        .. versionadded:: 2.10
+
+        .. warning::
+
+            If the :attr:`disnake.Intents.voice_states` is disabled caching this could lead to a memory leak.
+            This could happen because with the intent disabled you don't receive voice state updates, hence
+            the cached voice state could possibly never be removed from the cache.
+
+        Parameters
+        ----------
+        cache: :class:`bool`
+            Whether to cache the fetched voice state. Defaults to ``False``.
+
+        Raises
+        ------
+        NotFound
+            The member for which you tried to fetch a voice state is not
+            connected to a channel in this guild.
+
+        Returns
+        -------
+        :class:`VoiceState`
+            The voice state of the member.
+        """
+        data = await self._state.http.get_voice_state(self.guild.id, self.id)
+        channel_id = utils._get_as_snowflake(data, "channel_id")
+
+        if cache:
+            _, _, after = self.guild._update_voice_state(data, channel_id)
+            return after
+
+        channel: Optional[VocalGuildChannel] = self.guild.get_channel(channel_id)  # type: ignore
+        return VoiceState(data=data, channel=channel)
+
     async def request_to_speak(self) -> None:
         """|coro|