feat(message): implement message forwarding (#1188)

Signed-off-by: Snipy7374 <[email protected]>
Co-authored-by: shiftinv <[email protected]>

changelog/1187.feature.rst

@@ -0,0 +1 @@
+Add support for message forwarding. New :class:`ForwardedMessage`, new enum :class:`MessageReferenceType`,  new method :func:`Message.forward`, edited :class:`MessageReference` to support message forwarding.

disnake/abc.py

@@ -1604,6 +1604,12 @@ async def send(
 
             .. versionadded:: 1.6
 
+            .. note::
+
+                Passing a :class:`.Message` or :class:`.PartialMessage` will only allow replies. To forward a message
+                you must explicitly transform the message to a :class:`.MessageReference` using :meth:`.Message.to_reference` and specify the :class:`.MessageReferenceType`,
+                or use :meth:`.Message.forward`.
+
         mention_author: Optional[:class:`bool`]
             If set, overrides the :attr:`.AllowedMentions.replied_user` attribute of ``allowed_mentions``.
 

disnake/enums.py

@@ -74,6 +74,7 @@
     "EntitlementType",
     "PollLayoutType",
     "VoiceChannelEffectAnimationType",
+    "MessageReferenceType",
 )
 
 
@@ -1415,6 +1416,13 @@ class VoiceChannelEffectAnimationType(Enum):
     basic = 1
 
 
+class MessageReferenceType(Enum):
+    default = 0
+    """A standard message reference used in message replies."""
+    forward = 1
+    """Reference used to point to a message at a point in time (forward)."""
+
+
 T = TypeVar("T")
 
 

disnake/flags.py

@@ -600,6 +600,7 @@ def __init__(
             crossposted: bool = ...,
             ephemeral: bool = ...,
             failed_to_mention_roles_in_thread: bool = ...,
+            has_snapshot: bool = ...,
             has_thread: bool = ...,
             is_crossposted: bool = ...,
             is_voice_message: bool = ...,
@@ -692,6 +693,16 @@ def is_voice_message(self):
         """
         return 1 << 13
 
+    @flag_value
+    def has_snapshot(self):
+        """:class:`bool`: Returns ``True`` if the message is a forward message.
+
+        Messages with this flag will have only the forward data, and no other content.
+
+        .. versionadded:: 2.10
+        """
+        return 1 << 14
+
 
 class PublicUserFlags(BaseFlags):
     """Wraps up the Discord User Public flags.

disnake/member.py

@@ -387,11 +387,15 @@ def _update_from_message(self, data: MemberPayload) -> None:
 
     @classmethod
     def _try_upgrade(
-        cls, *, data: UserWithMemberPayload, guild: Guild, state: ConnectionState
+        cls,
+        *,
+        data: Union[UserPayload, UserWithMemberPayload],
+        guild: Guild,
+        state: ConnectionState,
     ) -> Union[User, Self]:
         # A User object with a 'member' key
         try:
-            member_data = data.pop("member")
+            member_data = data.pop("member")  # type: ignore
         except KeyError:
             return state.create_user(data)
         else: