Update API Scheme to Layer 196, from TDLib

SpEcHiDe · SpEcHiDe · commit 2eb540bc3c6e · 2025-01-02T18:52:27.000+01:00
diff --git a/compiler/api/source/main_api.tl b/compiler/api/source/main_api.tl
diff --git a/docs/source/releases/changes-in-this-fork.rst b/docs/source/releases/changes-in-this-fork.rst
@@ -21,6 +21,15 @@ Breaking Changes in this Fork
 Changes in this Fork
 =====================
 
++------------------------+
+| Scheme layer used: 196 |
++------------------------+
+
+- Added the parameters ``can_be_upgraded``, ``was_refunded``, ``prepaid_upgrade_star_count`` in :obj:`~pyrogram.types.UserGift`.
+- Renamed the parameter ``only_in_channels`` to ``chat_type_filter`` in the :meth:`~pyrogram.Client.search_global_count` and :meth:`~pyrogram.Client.search_global`.
+- Removed ``sender_user_id`` parameter from :meth:`~pyrogram.Client.sell_gift` and :meth:`~pyrogram.Client.toggle_gift_is_saved`.
+- View `new and changed <https://telegramplayground.github.io/TG-APIs/TL/diff/tdlib.html?from=195&to=196>`__ `raw API methods <https://telegramplayground.github.io/TG-APIs/TL/diff/tdesktop.html?from=195&to=196>`__.
+
 +------------------------+
 | Scheme layer used: 195 |
 +------------------------+
diff --git a/pyrogram/enums/chat_type.py b/pyrogram/enums/chat_type.py
@@ -31,7 +31,7 @@ class ChatType(AutoName):
     "Chat is a private chat with a bot"
 
     GROUP = auto()
-    "Chat is a basic group"
+    "Chat is a group"
 
     SUPERGROUP = auto()
     "Chat is a supergroup"
diff --git a/pyrogram/methods/business/get_user_gifts.py b/pyrogram/methods/business/get_user_gifts.py
@@ -70,7 +70,7 @@ async def get_user_gifts(
                     offset=offset,
                     limit=limit
                 ),
-                sleep_threshold=max(60, self.sleep_threshold)
+                sleep_threshold=60
             )
 
             users = {u.id: u for u in r.users}
diff --git a/pyrogram/methods/business/sell_gift.py b/pyrogram/methods/business/sell_gift.py
@@ -26,19 +26,13 @@
 class SellGift:
     async def sell_gift(
         self: "pyrogram.Client",
-        sender_user_id: Union[int, str],
         message_id: int
     ) -> bool:
         """Sells a gift received by the current user for Telegram Stars.
 
         .. include:: /_includes/usable-by/users.rst
 
         Parameters:
-            sender_user_id (``int`` | ``str``):
-                Unique identifier (int) or username (str) of the user that sent the gift.
-                For your personal cloud (Saved Messages) you can simply use "me" or "self".
-                For a contact that exists in your Telegram address book you can use his phone number (str).
-
             message_id (``int``):
                 Unique identifier of the message with the gift in the chat with the user.
 
@@ -49,19 +43,12 @@ async def sell_gift(
             .. code-block:: python
 
                 # Convert gift
-                app.sell_gift(sender_user_id=user_id, message_id=123)
+                app.sell_gift(message_id=123)
 
         """
-        peer = await self.resolve_peer(sender_user_id)
-
-        if not isinstance(peer, (raw.types.InputPeerUser, raw.types.InputPeerSelf)):
-            raise ValueError("sender_user_id must belong to a user.")
 
-        r = await self.invoke(
+        return await self.invoke(
             raw.functions.payments.ConvertStarGift(
-                user_id=peer,
                 msg_id=message_id
             )
         )
-
-        return r
diff --git a/pyrogram/methods/business/toggle_gift_is_saved.py b/pyrogram/methods/business/toggle_gift_is_saved.py
@@ -26,7 +26,6 @@
 class ToggleGiftIsSaved:
     async def toggle_gift_is_saved(
         self: "pyrogram.Client",
-        sender_user_id: Union[int, str],
         message_id: int,
         is_saved: bool
     ) -> bool:
@@ -35,11 +34,6 @@ async def toggle_gift_is_saved(
         .. include:: /_includes/usable-by/users.rst
 
         Parameters:
-            sender_user_id (``int`` | ``str``):
-                Unique identifier (int) or username (str) of the target user that sent the gift.
-                For your personal cloud (Saved Messages) you can simply use "me" or "self".
-                For a contact that exists in your Telegram address book you can use his phone number (str).
-
             message_id (``int``):
                 Unique message identifier of the message with the gift in the chat with the user.
 
@@ -53,19 +47,12 @@ async def toggle_gift_is_saved(
             .. code-block:: python
 
                 # Hide gift
-                app.toggle_gift_is_saved(sender_user_id=user_id, message_id=123, is_saved=False)
+                app.toggle_gift_is_saved(message_id=123, is_saved=False)
         """
-        peer = await self.resolve_peer(sender_user_id)
-
-        if not isinstance(peer, (raw.types.InputPeerUser, raw.types.InputPeerSelf)):
-            raise ValueError("sender_user_id must belong to a user.")
 
-        r = await self.invoke(
+        return await self.invoke(
             raw.functions.payments.SaveStarGift(
-                user_id=peer,
                 msg_id=message_id,
                 unsave=not is_saved
             )
         )
-
-        return r
diff --git a/pyrogram/methods/messages/search_global.py b/pyrogram/methods/messages/search_global.py
@@ -19,9 +19,7 @@
 from typing import AsyncGenerator, Optional
 
 import pyrogram
-from pyrogram import raw, enums
-from pyrogram import types
-from pyrogram import utils
+from pyrogram import raw, enums, types, utils
 
 
 class SearchGlobal:
@@ -31,7 +29,7 @@ async def search_global(
         filter: "enums.MessagesFilter" = enums.MessagesFilter.EMPTY,
         limit: int = 0,
         chat_list: int = 0,
-        only_in_channels: bool = False,
+        chat_type_filter: "enums.ChatType" = None,
     ) -> Optional[AsyncGenerator["types.Message", None]]:
         """Search messages globally from all of your chats.
 
@@ -60,9 +58,8 @@ async def search_global(
             chat_list (``int``, *optional*):
                 Chat list in which to search messages; Only Main (0) and Archive (1) chat lists are supported. Defaults to (0) Main chat list.
 
-            only_in_channels (``bool``, *optional*):
-                True, if should search only in joined channels.
-                Defaults to False. All available chats are searched.
+            chat_type_filter (:obj:`~pyrogram.enums.ChatType`, *optional*):
+                Additional filter for type of the chat (:obj:`~pyrogram.enums.ChatType.PRIVATE`, :obj:`~pyrogram.enums.ChatType.GROUP`, :obj:`~pyrogram.enums.ChatType.CHANNEL`) of the searched messages; pass None to search for messages in all chats.
 
         Returns:
             ``Generator``: A generator yielding :obj:`~pyrogram.types.Message` objects.
@@ -97,13 +94,16 @@ async def search_global(
                         q=query,
                         filter=filter.value(),
                         min_date=0,
+                        # TODO
                         max_date=0,
                         offset_rate=offset_date,
                         offset_peer=offset_peer,
                         offset_id=offset_id,
                         limit=limit,
                         folder_id=chat_list,
-                        broadcasts_only=only_in_channels
+                        broadcasts_only=(chat_type_filter == enums.ChatType.CHANNEL) if chat_type_filter else None,
+                        groups_only=(chat_type_filter == enums.ChatType.GROUP) if chat_type_filter else None,
+                        users_only=(chat_type_filter == enums.ChatType.PRIVATE) if chat_type_filter else None,
                     ),
                     sleep_threshold=60
                 ),
diff --git a/pyrogram/methods/messages/search_global_count.py b/pyrogram/methods/messages/search_global_count.py
@@ -26,7 +26,7 @@ async def search_global_count(
         query: str = "",
         filter: "enums.MessagesFilter" = enums.MessagesFilter.EMPTY,
         chat_list: int = 0,
-        only_in_channels: bool = False,
+        chat_type_filter: "enums.ChatType" = None,
     ) -> int:
         """Get the count of messages resulting from a global search.
 
@@ -45,9 +45,8 @@ async def search_global_count(
             chat_list (``int``, *optional*):
                 Chat list in which to search messages; Only Main (0) and Archive (1) chat lists are supported. Defaults to (0) Main chat list.
 
-            only_in_channels (``bool``, *optional*):
-                True, if should search only in joined channels.
-                Defaults to False. All available chats are searched.
+            chat_type_filter (:obj:`~pyrogram.enums.ChatType`, *optional*):
+                Additional filter for type of the chat (:obj:`~pyrogram.enums.ChatType.PRIVATE`, :obj:`~pyrogram.enums.ChatType.GROUP`, :obj:`~pyrogram.enums.ChatType.CHANNEL`) of the searched messages; pass None to search for messages in all chats.
 
         Returns:
             ``int``: On success, the messages count is returned.
@@ -63,7 +62,9 @@ async def search_global_count(
                 offset_id=0,
                 limit=1,
                 folder_id=chat_list,
-                broadcasts_only=only_in_channels
+                broadcasts_only=(chat_type_filter == enums.ChatType.CHANNEL) if chat_type_filter else None,
+                groups_only=(chat_type_filter == enums.ChatType.GROUP) if chat_type_filter else None,
+                users_only=(chat_type_filter == enums.ChatType.PRIVATE) if chat_type_filter else None,
             )
         )
 
diff --git a/pyrogram/types/messages_and_media/user_gift.py b/pyrogram/types/messages_and_media/user_gift.py
@@ -59,6 +59,15 @@ class UserGift(Object):
         was_converted (``bool``, *optional*):
             True, if the gift was converted to Telegram Stars; only for the receiver of the gift.
 
+        can_be_upgraded (``bool``, *optional*):
+            True, if the gift is a regular gift that can be upgraded to a unique gift; only for the receiver of the gift.
+
+        was_refunded (``bool``, *optional*):
+            True, if the gift was refunded and isn't available anymore.
+
+        prepaid_upgrade_star_count (``int``, *optional*):
+            Number of Telegram Stars that were paid by the sender for the ability to upgrade the gift.
+
     """
 
     def __init__(
@@ -75,6 +84,9 @@ def __init__(
         message_id: Optional[int] = None,
         sell_star_count: Optional[int] = None,
         was_converted: Optional[bool] = None,
+        can_be_upgraded: Optional[bool] = None,
+        was_refunded: Optional[bool] = None,
+        prepaid_upgrade_star_count: Optional[int] = None,
     ):
         super().__init__(client)
 
@@ -88,6 +100,9 @@ def __init__(
         self.message_id = message_id
         self.sell_star_count = sell_star_count
         self.was_converted = was_converted
+        self.can_be_upgraded = can_be_upgraded
+        self.was_refunded = was_refunded
+        self.prepaid_upgrade_star_count = prepaid_upgrade_star_count
 
     @staticmethod
     async def _parse(
@@ -150,6 +165,9 @@ async def _parse_action(
             entities=entities,
             sell_star_count=getattr(action, "convert_stars", None),
             was_converted=getattr(action, "converted", None),
+            can_be_upgraded=getattr(action, "can_upgrade", None),
+            was_refunded=getattr(action, "refunded", None),
+            prepaid_upgrade_star_count=getattr(action, "upgrade_stars", None),
             client=client
         )
 

Original file line number	Diff line number	Diff line change
`@@ -70,7 +70,7 @@ async def get_user_gifts(`
`70`	`70`	`offset=offset,`
`71`	`71`	`limit=limit`
`72`	`72`	`),`
`73`		`- sleep_threshold=max(60, self.sleep_threshold)`
	`73`	`+ sleep_threshold=60`
`74`	`74`	`)`
`75`	`75`
`76`	`76`	`users = {u.id: u for u in r.users}`