feat: add on_raw_member_update event

Author: Soheab

CHANGELOG.md

@@ -17,6 +17,8 @@ These changes are available on the `master` branch, but have not yet been releas
 - Added `Attachment.read_chunked` and added optional `chunksize` argument to
   `Attachment.save` for retrieving attachments in chunks.
   ([#2956](https://github.com/Pycord-Development/pycord/pull/2956))
+- Added a new event called `on_raw_member_update` that is dispatched when a member is updated,
+  regardless of cache status. ([#3011](https://github.com/Pycord-Development/pycord/pull/3011))
 
 ### Changed
 

discord/member.py

@@ -64,6 +64,7 @@
     from .types.member import Member as MemberPayload
     from .types.member import MemberWithUser as MemberWithUserPayload
     from .types.member import UserWithMember as UserWithMemberPayload
+    from .types.member import MemberUpdateEvent as MemberUpdateEventPayload
     from .types.user import User as UserPayload
     from .types.voice import GuildVoiceState as GuildVoiceStatePayload
     from .types.voice import VoiceState as VoiceStatePayload
@@ -424,27 +425,28 @@ async def _get_channel(self):
         ch = await self.create_dm()
         return ch
 
-    def _update(self, data: MemberPayload) -> None:
+    def _update(self, data: MemberPayload | MemberUpdateEventPayload) -> None:
         # the nickname change is optional,
         # if it isn't in the payload then it didn't change
         try:
-            self.nick = data["nick"]
+            self.nick = data["nick"]  # type: ignore # handled by the type-except
         except KeyError:
             pass
 
         try:
-            self.pending = data["pending"]
+            self.pending = data["pending"]  # type: ignore # handled by the type-except
         except KeyError:
             pass
 
         self.premium_since = utils.parse_time(data.get("premium_since"))
-        self._roles = utils.SnowflakeList(map(int, data["roles"]))
+        self._roles = utils.SnowflakeList(map(int, data["roles"]))  # type: ignore # the API is the same
         self._avatar = data.get("avatar")
         self._banner = data.get("banner")
         self.communication_disabled_until = utils.parse_time(
             data.get("communication_disabled_until")
         )
         self.flags = MemberFlags._from_value(data.get("flags", 0))
+        self.joined_at = utils.parse_time(data.get("joined_at")) or self.joined_at
 
     def _presence_update(
         self, data: PartialPresenceUpdate, user: UserPayload

discord/raw_models.py

@@ -68,6 +68,7 @@
         TypingEvent,
         VoiceChannelStatusUpdateEvent,
     )
+    from .types.member import MemberUpdateEvent
     from .user import User
 
 
@@ -90,6 +91,7 @@
     "RawVoiceChannelStatusUpdateEvent",
     "RawMessagePollVoteEvent",
     "RawSoundboardSoundDeleteEvent",
+    "RawMemberUpdateEvent",
 )
 
 
@@ -870,3 +872,28 @@ 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
+
+
+class RawMemberUpdateEvent(_RawReprMixin):
+    """Represents the payload for a :func:`on_raw_member_update` event.
+
+    .. versionadded:: 2.7
+
+    Attributes
+    ----------
+    data: :class:`dict`
+        The raw data sent by the `gateway <https://discord.com/developers/docs/topics/gateway-events#guild-member-update>`_
+    cached_member: Optional[:class:`Member`]
+        The cached member, if found in the internal member cache.
+    member: :class:`Member`
+        The new member object after the update.
+    """
+
+    __slots__ = ("guild_id", "user_id", "data", "cached_member", "member")
+
+    def __init__(self, data: MemberUpdateEvent, member: Member) -> None:
+        self.guild_id: int = int(data["guild_id"])
+        self.user_id: int = int(data["user"]["id"])
+        self.data: MemberUpdateEvent = data
+        self.cached_member: Member | None = None
+        self.member: Member = member

discord/state.py

@@ -90,6 +90,7 @@
     from .types.sticker import GuildSticker as GuildStickerPayload
     from .types.user import User as UserPayload
     from .voice_client import VoiceClient
+    from .types.member import MemberUpdateEvent
 
     T = TypeVar("T")
     CS = TypeVar("CS", bound="ConnectionState")
@@ -910,9 +911,11 @@ def parse_message_poll_vote_add(self, data) -> None:
                 if answer.id in counts:
                     counts[answer.id].count += 1
                 else:
-                    counts[answer.id] = PollAnswerCount(
-                        {"id": answer.id, "count": 1, "me_voted": False}
-                    )
+                    counts[answer.id] = PollAnswerCount({
+                        "id": answer.id,
+                        "count": 1,
+                        "me_voted": False,
+                    })
         if poll is not None and user is not None:
             answer = poll.get_answer(raw.answer_id)
             if answer is not None:
@@ -1322,7 +1325,7 @@ def parse_guild_member_remove(self, data) -> None:
             )
         self.dispatch("raw_member_remove", raw)
 
-    def parse_guild_member_update(self, data) -> None:
+    def parse_guild_member_update(self, data: MemberUpdateEvent) -> None:
         guild = self._get_guild(int(data["guild_id"]))
         user = data["user"]
         user_id = int(user["id"])
@@ -1333,29 +1336,38 @@ def parse_guild_member_update(self, data) -> None:
             )
             return
 
-        member = guild.get_member(user_id)
-        if member is not None:
-            old_member = Member._copy(member)
-            member._update(data)
-            user_update = member._update_inner_user(user)
+        if not self.member_cache_flags.joined:
+            old_member = guild._members.pop(user_id, None)
+        else:
+            old_member = guild.get_member(user_id)
+
+        old_member = Member._copy(old_member) if old_member is not None else None
+
+        if old_member is not None:
+            new_member = old_member
+            new_member._update(data)
+
+            # handle user_update if necessary
+            user_update = old_member._update_inner_user(user)
             if user_update:
                 self.dispatch("user_update", user_update[0], user_update[1])
 
-            self.dispatch("member_update", old_member, member)
+            self.dispatch("member_update", old_member, new_member)
         else:
-            if self.member_cache_flags.joined:
-                member = Member(data=data, guild=guild, state=self)
+            new_member = Member(guild=guild, data=data, state=self)  # type: ignore
 
+            if self.member_cache_flags.joined:
                 # Force an update on the inner user if necessary
-                user_update = member._update_inner_user(user)
+                user_update = new_member._update_inner_user(user)
                 if user_update:
                     self.dispatch("user_update", user_update[0], user_update[1])
 
-                guild._add_member(member)
-            _log.debug(
-                "GUILD_MEMBER_UPDATE referencing an unknown member ID: %s. Discarding.",
-                user_id,
-            )
+                print("adding new member to cache:", new_member)
+                guild._add_member(new_member)
+
+        raw = RawMemberUpdateEvent(data, new_member)
+        raw.cached_member = old_member
+        self.dispatch("raw_member_update", raw)
 
     def parse_guild_emojis_update(self, data) -> None:
         guild = self._get_guild(int(data["guild_id"]))

discord/types/member.py

@@ -23,9 +23,9 @@
 DEALINGS IN THE SOFTWARE.
 """
 
-from typing import TypedDict
+from typing import NotRequired, TypedDict
 
-from .snowflake import SnowflakeList
+from .snowflake import Snowflake, SnowflakeList
 from .user import User
 
 
@@ -66,3 +66,20 @@ class MemberWithUser(_OptionalMemberWithUser):
 
 class UserWithMember(User, total=False):
     member: _OptionalMemberWithUser
+
+
+class MemberUpdateEvent(TypedDict):
+    guild_id: Snowflake
+    user: User
+    roles: list[Snowflake]
+    nick: NotRequired[str | None]
+    avatar: NotRequired[str | None]
+    banner: NotRequired[str | None]
+    joined_at: NotRequired[str | None]
+    premium_since: NotRequired[str | None]
+    deaf: NotRequired[bool | None]
+    mute: NotRequired[bool | None]
+    pending: NotRequired[bool | None]
+    communication_disabled_until: NotRequired[str | None]
+    flags: NotRequired[int | None]
+    avatar_decoration_data: NotRequired[dict | None]