Pytdbot 0.9.9__tar.gz → 0.9.10.dev0__tar.gz

{pytdbot-0.9.9 → pytdbot-0.9.10.dev0}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022-2025 Pytdbot, AYMENJD
+Copyright (c) 2022-2026 Pytdbot, AYMENJD
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{pytdbot-0.9.9 → pytdbot-0.9.10.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Pytdbot
-Version: 0.9.9
+Version: 0.9.10.dev0
 Summary: Easy-to-use asynchronous TDLib wrapper for Python.
 Home-page: https://github.com/pytdbot/client
 Author: AYMEN Mohammed
@@ -30,7 +30,7 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.58-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
+# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.60-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
 
 <a href="https://cupofton.pages.dev/donate?a=UQCeySURtYxvqF2jNXlsFrXuTEqPjJhGx8uoev6tUbD_HELL&n=AYMEN&t=5&c=You+deserve+a+Cup+of+TON+for+Pytdbot%2521" target="_blank" rel="noopener">
     <img src="https://cupofton.pages.dev/assets/badge-1.svg" alt="Buy me a Cup of TON" style="width: 600px; height: auto;">

{pytdbot-0.9.9 → pytdbot-0.9.10.dev0}/Pytdbot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Pytdbot
-Version: 0.9.9
+Version: 0.9.10.dev0
 Summary: Easy-to-use asynchronous TDLib wrapper for Python.
 Home-page: https://github.com/pytdbot/client
 Author: AYMEN Mohammed
@@ -30,7 +30,7 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.58-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
+# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.60-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
 
 <a href="https://cupofton.pages.dev/donate?a=UQCeySURtYxvqF2jNXlsFrXuTEqPjJhGx8uoev6tUbD_HELL&n=AYMEN&t=5&c=You+deserve+a+Cup+of+TON+for+Pytdbot%2521" target="_blank" rel="noopener">
     <img src="https://cupofton.pages.dev/assets/badge-1.svg" alt="Buy me a Cup of TON" style="width: 600px; height: auto;">

{pytdbot-0.9.9 → pytdbot-0.9.10.dev0}/README.md

@@ -1,4 +1,4 @@
-# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.58-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
+# Pytdbot [![Version](https://img.shields.io/pypi/v/Pytdbot?style=flat&logo=pypi)](https://pypi.org/project/Pytdbot) [![TDLib version](https://img.shields.io/badge/TDLib-v1.8.60-blue?logo=telegram)](https://github.com/tdlib/td) [![Downloads](https://static.pepy.tech/personalized-badge/pytdbot?period=month&units=none&left_color=grey&right_color=brightgreen&left_text=Downloads)](https://pepy.tech/project/pytdbot) [![Telegram Chat](https://img.shields.io/badge/Pytdbot%20chat-blue?logo=telegram&label=Telegram)](https://t.me/pytdbotchat)
 
 <a href="https://cupofton.pages.dev/donate?a=UQCeySURtYxvqF2jNXlsFrXuTEqPjJhGx8uoev6tUbD_HELL&n=AYMEN&t=5&c=You+deserve+a+Cup+of+TON+for+Pytdbot%2521" target="_blank" rel="noopener">
     <img src="https://cupofton.pages.dev/assets/badge-1.svg" alt="Buy me a Cup of TON" style="width: 600px; height: auto;">

{pytdbot-0.9.9 → pytdbot-0.9.10.dev0}/pytdbot/__init__.py

@@ -13,8 +13,8 @@ __all__ = [
     "Client",
 ]
 
-__version__ = "0.9.9"
-__copyright__ = "Copyright (c) 2022-2025 Pytdbot, AYMENJD"
+__version__ = "0.9.10dev0"
+__copyright__ = "Copyright (c) 2022-2026 Pytdbot, AYMENJD"
 __license__ = "MIT License"
 
 VERSION = __version__

{pytdbot-0.9.9 → pytdbot-0.9.10.dev0}/pytdbot/client.py

@@ -203,6 +203,7 @@ class Client(Decorators, Methods):
         self._current_handlers = {}
         self._results: Dict[str, asyncio.Future] = {}
         self._workers_tasks = None
+        self.__wait_login: asyncio.Event = None
         self.__rabbitmq_iterator_task = None
         self.__authorization_state = None
         self.__cache = {"is_coro_filter": {}}
@@ -309,8 +310,13 @@ class Client(Decorators, Methods):
             {"@type": "cancelScheduledEvent", "event_id": event_id}
         )
 
-    async def start(self) -> None:
-        r"""Start pytdbot client"""
+    async def start(self, wait_login: bool = True) -> None:
+        r"""Start pytdbot client
+
+        Parameters:
+            wait_login (``bool``, *optional*):
+                Whether to wait until the client is logged in. For bots only. Default is ``True``
+        """
 
         if not self.is_running:
             self.logger.info("Starting pytdbot client...")
@@ -318,6 +324,8 @@ class Client(Decorators, Methods):
             if self.is_rabbitmq:
                 await self.__start_rabbitmq()
             elif not self.client_manager:
+                self.__wait_login = asyncio.Event() if not self.user_bot else None
+
                 self.client_manager = ClientManager(
                     self, self.lib_path, self.td_verbosity, loop=self.loop
                 )
@@ -351,6 +359,9 @@ class Client(Decorators, Methods):
             self.getOption("version")
         )  # Ping TDLib to start processing updates
 
+        if wait_login and self.__wait_login:
+            await self.__wait_login.wait()
+
     def add_handler(
         self,
         update_type: Union[Type["pytdbot.types.Update"], str],
@@ -1048,6 +1059,9 @@ class Client(Decorators, Methods):
             if isinstance(self.me, types.Error):
                 self.logger.error(f"Get me error: {self.me.message}")
 
+            if self.__wait_login:
+                self.__wait_login.set()
+
             self.logger.info(
                 f"Logged in as {self.me.first_name} "
                 f"{str(self.me.id) if not self.me.usernames else '@' + self.me.usernames.editable_username}"

{pytdbot-0.9.9 → pytdbot-0.9.10.dev0}/pytdbot/handlers/td_updates.py

@@ -8625,6 +8625,65 @@ class Updates:
 
         return decorator
 
+    def on_updateStakeDiceState(
+        self: "pytdbot.Client" = None,
+        filters: "pytdbot.filters.Filter" = None,
+        position: int = None,
+        timeout: float = None,
+    ) -> Callable:
+        r"""The stake dice state has changed
+
+        Parameters:
+            filters (:class:`pytdbot.filters.Filter`, *optional*):
+                An update filter
+
+            position (``int``, *optional*):
+                The function position in handlers list. Default is ``None`` (append)
+
+            timeout (``float``, *optional*):
+                Max execution time for the handler before it timeout. Default is ``None``
+
+        Raises:
+            :py:class:`TypeError`
+        """
+
+        def decorator(func: Callable) -> Callable:
+            if hasattr(func, "_handler"):
+                return func
+            elif isinstance(self, pytdbot.Client):
+                if iscoroutinefunction(func):
+                    self.add_handler(
+                        update_type="updateStakeDiceState",
+                        func=func,
+                        filters=filters,
+                        position=position,
+                        inner_object=False,
+                        timeout=timeout,
+                    )
+                else:
+                    raise TypeError("Handler must be async")
+            elif isinstance(self, pytdbot.filters.Filter):
+                func._handler = Handler(
+                    func=func,
+                    update_type="updateStakeDiceState",
+                    filter=self,
+                    position=position,
+                    inner_object=False,
+                    timeout=timeout,
+                )
+            else:
+                func._handler = Handler(
+                    func=func,
+                    update_type="updateStakeDiceState",
+                    filter=filters,
+                    position=position,
+                    inner_object=False,
+                    timeout=timeout,
+                )
+            return func
+
+        return decorator
+
     def on_updateAnimatedEmojiMessageClicked(
         self: "pytdbot.Client" = None,
         filters: "pytdbot.filters.Filter" = None,

{pytdbot-0.9.9 → pytdbot-0.9.10.dev0}/pytdbot/methods/td_functions.py

@@ -275,6 +275,62 @@ class TDLibFunctions:
             {"@type": "requestQrCodeAuthentication", "other_user_ids": other_user_ids}
         )
 
+    async def getAuthenticationPasskeyParameters(
+        self,
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Text"]:
+        r"""Returns parameters for authentication using a passkey as JSON\-serialized string
+
+        Returns:
+            :class:`~pytdbot.types.Text`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "getAuthenticationPasskeyParameters",
+            }
+        )
+
+    async def checkAuthenticationPasskey(
+        self,
+        credential_id: str = "",
+        client_data: str = "",
+        authenticator_data: bytes = b"",
+        signature: bytes = b"",
+        user_handle: bytes = b"",
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
+        r"""Checks a passkey to log in to the corresponding account\. Call getAuthenticationPasskeyParameters to get parameters for the passkey\. Works only when the current authorization state is authorizationStateWaitPhoneNumber or authorizationStateWaitOtherDeviceConfirmation, or if there is no pending authentication query and the current authorization state is authorizationStateWaitPremiumPurchase, authorizationStateWaitEmailAddress, authorizationStateWaitEmailCode, authorizationStateWaitCode, authorizationStateWaitRegistration, or authorizationStateWaitPassword
+
+        Parameters:
+            credential_id (:class:`str`):
+                Base64url\-encoded identifier of the credential
+
+            client_data (:class:`str`):
+                JSON\-encoded client data
+
+            authenticator_data (:class:`bytes`):
+                Authenticator data of the application that created the credential
+
+            signature (:class:`bytes`):
+                Cryptographic signature of the credential
+
+            user_handle (:class:`bytes`):
+                User handle of the passkey
+
+        Returns:
+            :class:`~pytdbot.types.Ok`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "checkAuthenticationPasskey",
+                "credential_id": credential_id,
+                "client_data": client_data,
+                "authenticator_data": authenticator_data,
+                "signature": signature,
+                "user_handle": user_handle,
+            }
+        )
+
     async def registerUser(
         self,
         first_name: str = "",
@@ -1074,7 +1130,7 @@ class TDLibFunctions:
     async def getRepliedMessage(
         self, chat_id: int = 0, message_id: int = 0
     ) -> Union["pytdbot.types.Error", "pytdbot.types.Message"]:
-        r"""Returns information about a non\-bundled message that is replied by a given message\. Also, returns the pinned message for messagePinMessage, the game message for messageGameScore, the invoice message for messagePaymentSuccessful, the message with a previously set same background for messageChatSetBackground, the giveaway message for messageGiveawayCompleted, the checklist message for messageChecklistTasksDone, messageChecklistTasksAdded, the message with suggested post information for messageSuggestedPostApprovalFailed, messageSuggestedPostApproved, messageSuggestedPostDeclined, messageSuggestedPostPaid, messageSuggestedPostRefunded, the message with the regular gift that was upgraded for messageUpgradedGift with origin of the type upgradedGiftOriginUpgrade, and the topic creation message for topic messages without non\-bundled replied message\. Returns a 404 error if the message doesn't exist
+        r"""Returns information about a non\-bundled message that is replied by a given message\. Also, returns the pinned message for messagePinMessage, the game message for messageGameScore, the invoice message for messagePaymentSuccessful, the message with a previously set same background for messageChatSetBackground, the giveaway message for messageGiveawayCompleted, the checklist message for messageChecklistTasksDone, messageChecklistTasksAdded, the message with suggested post information for messageSuggestedPostApprovalFailed, messageSuggestedPostApproved, messageSuggestedPostDeclined, messageSuggestedPostPaid, messageSuggestedPostRefunded, the message with the regular gift that was upgraded for messageUpgradedGift with origin of the type upgradedGiftOriginUpgrade, the message with gift purchase offer for messageUpgradedGiftPurchaseOfferRejected, and the topic creation message for topic messages without non\-bundled replied message\. Returns a 404 error if the message doesn't exist
 
         Parameters:
             chat_id (:class:`int`):
@@ -3524,7 +3580,7 @@ class TDLibFunctions:
                 Identifier of the message
 
             to_language_code (:class:`str`):
-                Language code of the language to which the message is translated\. Must be one of \"af\", \"sq\", \"am\", \"ar\", \"hy\", \"az\", \"eu\", \"be\", \"bn\", \"bs\", \"bg\", \"ca\", \"ceb\", \"zh\-CN\", \"zh\", \"zh\-Hans\", \"zh\-TW\", \"zh\-Hant\", \"co\", \"hr\", \"cs\", \"da\", \"nl\", \"en\", \"eo\", \"et\", \"fi\", \"fr\", \"fy\", \"gl\", \"ka\", \"de\", \"el\", \"gu\", \"ht\", \"ha\", \"haw\", \"he\", \"iw\", \"hi\", \"hmn\", \"hu\", \"is\", \"ig\", \"id\", \"in\", \"ga\", \"it\", \"ja\", \"jv\", \"kn\", \"kk\", \"km\", \"rw\", \"ko\", \"ku\", \"ky\", \"lo\", \"la\", \"lv\", \"lt\", \"lb\", \"mk\", \"mg\", \"ms\", \"ml\", \"mt\", \"mi\", \"mr\", \"mn\", \"my\", \"ne\", \"no\", \"ny\", \"or\", \"ps\", \"fa\", \"pl\", \"pt\", \"pa\", \"ro\", \"ru\", \"sm\", \"gd\", \"sr\", \"st\", \"sn\", \"sd\", \"si\", \"sk\", \"sl\", \"so\", \"es\", \"su\", \"sw\", \"sv\", \"tl\", \"tg\", \"ta\", \"tt\", \"te\", \"th\", \"tr\", \"tk\", \"uk\", \"ur\", \"ug\", \"uz\", \"vi\", \"cy\", \"xh\", \"yi\", \"ji\", \"yo\", \"zu\"
+                Language code of the language to which the message is translated\. See translateText\.to\_language\_code for the list of supported values
 
         Returns:
             :class:`~pytdbot.types.FormattedText`
@@ -3539,6 +3595,37 @@ class TDLibFunctions:
             }
         )
 
+    async def summarizeMessage(
+        self,
+        chat_id: int = 0,
+        message_id: int = 0,
+        translate_to_language_code: str = "",
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.FormattedText"]:
+        r"""Summarizes content of the message with non\-empty summary\_language\_code
+
+        Parameters:
+            chat_id (:class:`int`):
+                Identifier of the chat to which the message belongs
+
+            message_id (:class:`int`):
+                Identifier of the message
+
+            translate_to_language_code (:class:`str`):
+                Pass a language code to which the summary will be translated; may be empty if translation isn't needed\. See translateText\.to\_language\_code for the list of supported values
+
+        Returns:
+            :class:`~pytdbot.types.FormattedText`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "summarizeMessage",
+                "chat_id": chat_id,
+                "message_id": message_id,
+                "translate_to_language_code": translate_to_language_code,
+            }
+        )
+
     async def recognizeSpeech(
         self, chat_id: int = 0, message_id: int = 0
     ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
@@ -5222,7 +5309,7 @@ class TDLibFunctions:
     async def transferBusinessAccountStars(
         self, business_connection_id: str = "", star_count: int = 0
     ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
-        r"""Transfer Telegram Stars from the business account to the business bot; for bots only
+        r"""Transfers Telegram Stars from the business account to the business bot; for bots only
 
         Parameters:
             business_connection_id (:class:`str`):
@@ -5988,6 +6075,77 @@ class TDLibFunctions:
             }
         )
 
+    async def getPasskeyParameters(
+        self,
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Text"]:
+        r"""Returns parameters for creating of a new passkey as JSON\-serialized string
+
+        Returns:
+            :class:`~pytdbot.types.Text`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "getPasskeyParameters",
+            }
+        )
+
+    async def addLoginPasskey(
+        self, client_data: str = "", attestation_object: bytes = b""
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Passkey"]:
+        r"""Adds a passkey allowed to be used for the login by the current user and returns the added passkey\. Call getPasskeyParameters to get parameters for creating of the passkey
+
+        Parameters:
+            client_data (:class:`str`):
+                JSON\-encoded client data
+
+            attestation_object (:class:`bytes`):
+                Passkey attestation object
+
+        Returns:
+            :class:`~pytdbot.types.Passkey`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "addLoginPasskey",
+                "client_data": client_data,
+                "attestation_object": attestation_object,
+            }
+        )
+
+    async def getLoginPasskeys(
+        self,
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Passkeys"]:
+        r"""Returns the list of passkeys allowed to be used for the login by the current user
+
+        Returns:
+            :class:`~pytdbot.types.Passkeys`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "getLoginPasskeys",
+            }
+        )
+
+    async def removeLoginPasskey(
+        self, passkey_id: str = ""
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
+        r"""Removes a passkey from the list of passkeys allowed to be used for the login by the current user
+
+        Parameters:
+            passkey_id (:class:`str`):
+                Unique identifier of the passkey to remove
+
+        Returns:
+            :class:`~pytdbot.types.Ok`
+        """
+
+        return await self.invoke(
+            {"@type": "removeLoginPasskey", "passkey_id": passkey_id}
+        )
+
     async def getEmojiReaction(
         self, emoji: str = ""
     ) -> Union["pytdbot.types.Error", "pytdbot.types.EmojiReaction"]:
@@ -9693,6 +9851,21 @@ class TDLibFunctions:
             }
         )
 
+    async def getStakeDiceState(
+        self,
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.StakeDiceState"]:
+        r"""Returns the current state of stake dice
+
+        Returns:
+            :class:`~pytdbot.types.StakeDiceState`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "getStakeDiceState",
+            }
+        )
+
     async def getSavedNotificationSound(
         self, notification_sound_id: int = 0
     ) -> Union["pytdbot.types.Error", "pytdbot.types.NotificationSounds"]:
@@ -9921,7 +10094,7 @@ class TDLibFunctions:
     async def readChatList(
         self, chat_list: "pytdbot.types.ChatList" = None
     ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
-        r"""Traverse all chats in a chat list and marks all messages in the chats as read
+        r"""Traverses all chats in a chat list and marks all messages in the chats as read
 
         Parameters:
             chat_list (:class:`~pytdbot.types.ChatList`):
@@ -11406,7 +11579,7 @@ class TDLibFunctions:
         file_type: "pytdbot.types.FileType" = None,
         priority: int = 0,
     ) -> Union["pytdbot.types.Error", "pytdbot.types.File"]:
-        r"""Preliminary uploads a file to the cloud before sending it in a message, which can be useful for uploading of being recorded voice and video notes\. In all other cases there is no need to preliminary upload a file\. Updates updateFile will be used to notify about upload progress\. The upload will not be completed until the file is sent in a message
+        r"""Preliminarily uploads a file to the cloud before sending it in a message, which can be useful for uploading of being recorded voice and video notes\. In all other cases there is no need to preliminary upload a file\. Updates updateFile will be used to notify about upload progress\. The upload will not be completed until the file is sent in a message
 
         Parameters:
             file (:class:`~pytdbot.types.InputFile`):
@@ -11743,7 +11916,7 @@ class TDLibFunctions:
     async def setApplicationVerificationToken(
         self, verification_id: int = 0, token: str = ""
     ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
-        r"""Application or reCAPTCHA verification has been completed\. Can be called before authorization
+        r"""Informs TDLib that application or reCAPTCHA verification has been completed\. Can be called before authorization
 
         Parameters:
             verification_id (:class:`int`):
@@ -14475,6 +14648,37 @@ class TDLibFunctions:
             }
         )
 
+    async def getStickerOutlineSvgPath(
+        self,
+        sticker_file_id: int = 0,
+        for_animated_emoji: bool = False,
+        for_clicked_animated_emoji_message: bool = False,
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Text"]:
+        r"""Returns outline of a sticker as an SVG path\. This is an offline method\. Returns an empty string if the outline isn't known
+
+        Parameters:
+            sticker_file_id (:class:`int`):
+                File identifier of the sticker
+
+            for_animated_emoji (:class:`bool`):
+                Pass true to get the outline scaled for animated emoji
+
+            for_clicked_animated_emoji_message (:class:`bool`):
+                Pass true to get the outline scaled for clicked animated emoji message
+
+        Returns:
+            :class:`~pytdbot.types.Text`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "getStickerOutlineSvgPath",
+                "sticker_file_id": sticker_file_id,
+                "for_animated_emoji": for_animated_emoji,
+                "for_clicked_animated_emoji_message": for_clicked_animated_emoji_message,
+            }
+        )
+
     async def getStickers(
         self,
         sticker_type: "pytdbot.types.StickerType" = None,
@@ -15060,7 +15264,7 @@ class TDLibFunctions:
     async def getKeywordEmojis(
         self, text: str = "", input_language_codes: List[str] = None
     ) -> Union["pytdbot.types.Error", "pytdbot.types.Emojis"]:
-        r"""Return emojis matching the keyword\. Supported only if the file database is enabled\. Order of results is unspecified
+        r"""Returns emojis matching the keyword\. Supported only if the file database is enabled\. Order of results is unspecified
 
         Parameters:
             text (:class:`str`):
@@ -15804,7 +16008,7 @@ class TDLibFunctions:
     async def checkPhoneNumberCode(
         self, code: str = ""
     ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
-        r"""Check the authentication code and completes the request for which the code was sent if appropriate
+        r"""Checks the authentication code and completes the request for which the code was sent if appropriate
 
         Parameters:
             code (:class:`str`):
@@ -16367,7 +16571,7 @@ class TDLibFunctions:
     async def deleteBotMediaPreviews(
         self, bot_user_id: int = 0, language_code: str = "", file_ids: List[int] = None
     ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
-        r"""Delete media previews from the list of media previews of a bot
+        r"""Deletes media previews from the list of media previews of a bot
 
         Parameters:
             bot_user_id (:class:`int`):
@@ -17947,6 +18151,23 @@ class TDLibFunctions:
 
         return await self.invoke({"@type": "getGiftUpgradePreview", "gift_id": gift_id})
 
+    async def getGiftUpgradeVariants(
+        self, gift_id: int = 0
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.GiftUpgradeVariants"]:
+        r"""Returns all possible variants of upgraded gifts for a regular gift
+
+        Parameters:
+            gift_id (:class:`int`):
+                Identifier of the gift
+
+        Returns:
+            :class:`~pytdbot.types.GiftUpgradeVariants`
+        """
+
+        return await self.invoke(
+            {"@type": "getGiftUpgradeVariants", "gift_id": gift_id}
+        )
+
     async def upgradeGift(
         self,
         business_connection_id: str = "",
@@ -18105,6 +18326,71 @@ class TDLibFunctions:
             }
         )
 
+    async def sendGiftPurchaseOffer(
+        self,
+        owner_id: "pytdbot.types.MessageSender" = None,
+        gift_name: str = "",
+        price: "pytdbot.types.GiftResalePrice" = None,
+        duration: int = 0,
+        paid_message_star_count: int = 0,
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
+        r"""Sends an offer to purchase an upgraded gift
+
+        Parameters:
+            owner_id (:class:`~pytdbot.types.MessageSender`):
+                Identifier of the user or the channel chat that currently owns the gift and will receive the offer
+
+            gift_name (:class:`str`):
+                Name of the upgraded gift
+
+            price (:class:`~pytdbot.types.GiftResalePrice`):
+                The price that the user agreed to pay for the gift
+
+            duration (:class:`int`):
+                Duration of the offer, in seconds; must be one of 21600, 43200, 86400, 129600, 172800, or 259200\. Can also be 120 if Telegram test environment is used
+
+            paid_message_star_count (:class:`int`):
+                The number of Telegram Stars the user agreed to pay additionally for sending of the offer message to the current gift owner; pass userFullInfo\.outgoing\_paid\_message\_star\_count for users and 0 otherwise
+
+        Returns:
+            :class:`~pytdbot.types.Ok`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "sendGiftPurchaseOffer",
+                "owner_id": owner_id,
+                "gift_name": gift_name,
+                "price": price,
+                "duration": duration,
+                "paid_message_star_count": paid_message_star_count,
+            }
+        )
+
+    async def processGiftPurchaseOffer(
+        self, message_id: int = 0, accept: bool = False
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
+        r"""Handles a pending gift purchase offer
+
+        Parameters:
+            message_id (:class:`int`):
+                Identifier of the message with the gift purchase offer
+
+            accept (:class:`bool`):
+                Pass true to accept the request; pass false to reject it
+
+        Returns:
+            :class:`~pytdbot.types.Ok`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "processGiftPurchaseOffer",
+                "message_id": message_id,
+                "accept": accept,
+            }
+        )
+
     async def getReceivedGifts(
         self,
         business_connection_id: str = "",
@@ -18262,6 +18548,21 @@ class TDLibFunctions:
             }
         )
 
+    async def getUpgradedGiftsPromotionalAnimation(
+        self,
+    ) -> Union["pytdbot.types.Error", "pytdbot.types.Animation"]:
+        r"""Returns promotional anumation for upgraded gifts
+
+        Returns:
+            :class:`~pytdbot.types.Animation`
+        """
+
+        return await self.invoke(
+            {
+                "@type": "getUpgradedGiftsPromotionalAnimation",
+            }
+        )
+
     async def setGiftResalePrice(
         self, received_gift_id: str = "", price: "pytdbot.types.GiftResalePrice" = None
     ) -> Union["pytdbot.types.Error", "pytdbot.types.Ok"]:
@@ -19163,7 +19464,7 @@ class TDLibFunctions:
     async def canSendMessageToUser(
         self, user_id: int = 0, only_local: bool = False
     ) -> Union["pytdbot.types.Error", "pytdbot.types.CanSendMessageToUserResult"]:
-        r"""Check whether the current user can message another user or try to create a chat with them
+        r"""Checks whether the current user can message another user or try to create a chat with them
 
         Parameters:
             user_id (:class:`int`):
@@ -20909,7 +21210,7 @@ class TDLibFunctions:
     async def checkPremiumGiftCode(
         self, code: str = ""
     ) -> Union["pytdbot.types.Error", "pytdbot.types.PremiumGiftCodeInfo"]:
-        r"""Return information about a Telegram Premium gift code
+        r"""Returns information about a Telegram Premium gift code
 
         Parameters:
             code (:class:`str`):