feat(message): implement message forwarding

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,11 @@ 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`.
+
         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",
 )
 
 
@@ -1414,6 +1415,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")