(fix): Type Hinting of pin_chat_message

Author: SpEcHiDe

pyrogram/methods/chats/pin_chat_message.py

@@ -32,7 +32,7 @@ async def pin_chat_message(
         disable_notification: bool = False,
         both_sides: bool = False,
         business_connection_id: str = None,
-    ) -> "types.Message":
+    ) -> Union["types.Message", bool]:
         """Pin a message in a group, channel or your own chat.
         You must be an administrator in the chat for this to work and must have the "can_pin_messages" admin right in
         the supergroup or "can_edit_messages" admin right in the channel.
@@ -58,7 +58,8 @@ async def pin_chat_message(
                 Unique identifier of the business connection on behalf of which the message will be pinned.
 
         Returns:
-            :obj:`~pyrogram.types.Message`: On success, the service message is returned.
+            :obj:`~pyrogram.types.Message` | ``bool``: On success, the service message is returned (when applicable),
+            otherwise, in case a message object couldn't be returned, True is returned.
 
         Example:
             .. code-block:: python
@@ -131,3 +132,4 @@ async def pin_chat_message(
                     raw_reply_to_message=i.reply_to_message,
                     replies=0
                 )
+        return True

pyrogram/types/messages_and_media/message.py

@@ -5613,7 +5613,7 @@ async def vote(
             options=option
         )
 
-    async def pin(self, disable_notification: bool = False, both_sides: bool = False) -> "types.Message":
+    async def pin(self, disable_notification: bool = False, both_sides: bool = False) -> Union["Message", bool]:
         """Bound method *pin* of :obj:`~pyrogram.types.Message`.
 
         Use as a shortcut for:
@@ -5640,7 +5640,8 @@ async def pin(self, disable_notification: bool = False, both_sides: bool = False
                 Applicable to private chats only. Defaults to False.
 
         Returns:
-            :obj:`~pyrogram.types.Message`: On success, the service message is returned.
+            :obj:`~pyrogram.types.Message` | ``bool``: On success, the service message is returned (when applicable),
+            otherwise, in case a message object couldn't be returned, True is returned.
 
         Raises:
             RPCError: In case of a Telegram RPC error.