🐛 Add types and raw delete event

Author: Paillat-dev

discord/guild.py

@@ -626,7 +626,7 @@ async def create_sound(
         volume: float = 1.0,
         emoji: PartialEmoji | GuildEmoji | str | None = None,
         reason: str | None = None,
-    ):
+    ) -> SoundboardSound:
         """|coro|
         Creates a :class:`SoundboardSound` in the guild.
         You must have :attr:`Permissions.manage_expressions` permission to use this.

discord/http.py

@@ -3191,7 +3191,7 @@ def delete_sound(
             reason=reason,
         )
 
-    def get_default_sounds(self):
+    def get_default_sounds(self) -> Response[list[SoundboardSoundPayload]]:
         return self.request(Route("GET", "/soundboard-default-sounds"))
 
     def create_guild_sound(
@@ -3234,7 +3234,7 @@ def get_guild_sound(
 
     def edit_guild_sound(
         self, guild_id: Snowflake, sound_id: Snowflake, *, reason: str | None, **payload
-    ):
+    ) -> Response[SoundboardSoundPayload]:
         keys = (
             "name",
             "volume",
@@ -3257,7 +3257,7 @@ def edit_guild_sound(
 
     def send_soundboard_sound(
         self, channel_id: int, sound: PartialSoundboardSound
-    ) -> None:
+    ) -> Response[None]:
         payload = {
             "sound_id": sound.id,
         }

discord/raw_models.py

@@ -87,6 +87,7 @@
     "RawAuditLogEntryEvent",
     "RawVoiceChannelStatusUpdateEvent",
     "RawMessagePollVoteEvent",
+    "RawSoundboardSoundDeleteEvent",
 )
 
 
@@ -847,3 +848,14 @@ def __init__(self, data: MessagePollVoteEvent, added: bool) -> None:
             self.guild_id: int | None = int(data["guild_id"])
         except KeyError:
             self.guild_id: int | None = None
+
+
+class RawSoundboardSoundDeleteEvent(_RawReprMixin):
+    """Represents the payload for a :func:`on_raw_soundboard_sound_delete`"""
+
+    __slots__ = ("sound_id", "guild_id", "data")
+
+    def __init__(self, data: PartialSoundboardSound) -> None:
+        self.sound_id: int = int(data["sound_id"])
+        self.guild_id: int = int(data["guild_id"])
+        self.data: PartialSoundboardSound = data

discord/state.py

@@ -87,7 +87,7 @@
     from .types.guild import Guild as GuildPayload
     from .types.message import Message as MessagePayload
     from .types.poll import Poll as PollPayload
-    from .types.soundboard import SounboardSound as SoundboardSoundPayload
+    from .types.soundboard import SoundboardSoundDeletePayload
     from .types.sticker import GuildSticker as GuildStickerPayload
     from .types.user import User as UserPayload
     from .voice_client import VoiceClient
@@ -2061,17 +2061,20 @@ def parse_guild_soundboard_sound_delete(self, data):
         if sound is not None:
             self._remove_sound(sound)
             self.dispatch("soundboard_sound_delete", sound)
+        self.dispatch(
+            "raw_soundboard_sound_delete", RawSoundboardSoundDeleteEvent(data)
+        )
 
-    async def _add_default_sounds(self):
+    async def _add_default_sounds(self) -> None:
         default_sounds = await self.http.get_default_sounds()
         for default_sound in default_sounds:
             sound = SoundboardSound(state=self, http=self.http, data=default_sound)
             self._add_sound(sound)
 
-    def _add_sound(self, sound: SoundboardSound):
+    def _add_sound(self, sound: SoundboardSound) -> None:
         self._sounds[sound.id] = sound
 
-    def _remove_sound(self, sound: SoundboardSound):
+    def _remove_sound(self, sound: SoundboardSound) -> None:
         self._sounds.pop(sound.id, None)
 
     @property

docs/api/events.rst

@@ -1442,6 +1442,15 @@ Soundboard Sound
         :param sound: The soundboard sound that was deleted.
         :type sound: :class:`SoundboardSound`
 
+.. function:: on_raw_soundboard_sound_delete(payload)
+
+        Called when a soundboard sound is deleted.
+
+        .. versionadded:: 2.7
+
+        :param payload: The raw event payload data.
+        :type payload: :class:`RawSoundboardSoundDeleteEvent`
+
 .. function:: on_soundboard_sound_create(sound)
 
         Called when a soundboard sound is created.