Merge remote-tracking branch 'KurimuzonAkuma/dev' into dev

SychO3 · SychO3 · commit b9df35b63d04 · 2025-11-05T23:50:07.000+08:00
# Conflicts:
#	compiler/errors/source/400_BAD_REQUEST.tsv
#	compiler/errors/source/403_FORBIDDEN.tsv
diff --git a/.github/workflows/python.yml b/.github/workflows/python.yml
@@ -9,7 +9,7 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest]
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - uses: actions/checkout@v4
diff --git a/compiler/docs/compiler.py b/compiler/docs/compiler.py
@@ -449,10 +449,12 @@ def get_title_list(s: str) -> list:
             create_gift_collection
             delete_gift_collection
             drop_gift_original_details
+            edit_star_subscription
             get_gift_collections
             remove_collection_gifts
             reorder_collection_gifts
             reorder_gift_collections
+            reuse_star_subscription
             set_gift_collection_name
             get_gift_upgrade_preview
             get_payment_form
@@ -497,6 +499,7 @@ def get_title_list(s: str) -> list:
             set_bot_commands
             get_bot_commands
             delete_bot_commands
+            edit_user_star_subscription
             set_bot_default_privileges
             get_bot_default_privileges
             set_chat_menu_button
diff --git a/compiler/errors/source/400_BAD_REQUEST.tsv b/compiler/errors/source/400_BAD_REQUEST.tsv
diff --git a/compiler/errors/source/403_FORBIDDEN.tsv b/compiler/errors/source/403_FORBIDDEN.tsv
@@ -1,53 +1,59 @@
 id	message
-ALLOW_PAYMENT_REQUIRED_X	This peer charges {value} [Telegram Stars](https://core.telegram.org/api/stars) per message, but the `allow_paid_stars` was not set or its value is smaller than {value}.
+ALLOW_PAYMENT_REQUIRED_X	The user has enabled paid messages with {value} stars.
 ANONYMOUS_REACTIONS_DISABLED	Sorry, anonymous administrators cannot leave reactions or participate in polls.
-BROADCAST_FORBIDDEN	Channel poll voters and reactions cannot be fetched to prevent deanonymization.
-CHANNEL_PUBLIC_GROUP_NA	channel/supergroup not available.
+BOT_ACCESS_FORBIDDEN	You can't access this bot.
+BOT_OWNER_REQUIRED	You must be the owner of the bot to perform this action.
+BROADCAST_FORBIDDEN	This request can't be used in channels.
+CHANNEL_PUBLIC_GROUP_NA	The channel/supergroup is not available.
 CHAT_ACTION_FORBIDDEN	You cannot execute this action.
-CHAT_ADMIN_INVITE_REQUIRED	You do not have the rights to do this.
+CHAT_ADMIN_INVITE_REQUIRED	You don't have rights to invite other users.
 CHAT_ADMIN_REQUIRED	You must be an admin in this chat to do this.
 CHAT_FORBIDDEN	This chat is not available to the current user.
-CHAT_GUEST_SEND_FORBIDDEN	You join the discussion group before commenting, see [here &raquo;](https://core.telegram.org/api/discussion#requiring-users-to-join-the-group) for more info.
+CHAT_GUEST_SEND_FORBIDDEN	You need to join the discussion group before commenting, see [here »](https://core.telegram.org/api/discussion#requiring-users-to-join-the-group) for more info.
 CHAT_SEND_AUDIOS_FORBIDDEN	You can't send audio messages in this chat.
 CHAT_SEND_DOCS_FORBIDDEN	You can't send documents in this chat.
 CHAT_SEND_GAME_FORBIDDEN	You can't send a game to this chat.
-CHAT_SEND_GIFS_FORBIDDEN	You can't send gifs in this chat.
-CHAT_SEND_INLINE_FORBIDDEN	You can't send inline messages in this group.
-CHAT_SEND_MEDIA_FORBIDDEN	You can't send media in this chat.
+CHAT_SEND_GIFS_FORBIDDEN	You can't send animations in this chat.
+CHAT_SEND_INLINE_FORBIDDEN	You cannot use inline bots to send messages in this chat.
+CHAT_SEND_MEDIA_FORBIDDEN	You can't send media messages in this chat.
 CHAT_SEND_PHOTOS_FORBIDDEN	You can't send photos in this chat.
 CHAT_SEND_PLAIN_FORBIDDEN	You can't send non-media (text) messages in this chat.
 CHAT_SEND_POLL_FORBIDDEN	You can't send polls in this chat.
-CHAT_SEND_ROUNDVIDEOS_FORBIDDEN	You can't send round videos to this chat.
+CHAT_SEND_ROUNDVIDEOS_FORBIDDEN	You can't send video notes in this chat.
 CHAT_SEND_STICKERS_FORBIDDEN	You can't send stickers in this chat.
 CHAT_SEND_VIDEOS_FORBIDDEN	You can't send videos in this chat.
 CHAT_SEND_VOICES_FORBIDDEN	You can't send voice recordings in this chat.
-CHAT_SEND_WEBPAGE_FORBIDDEN	You can't send webpage previews to this chat.
-CHAT_TYPE_INVALID	The specified user type is invalid.
-CHAT_WRITE_FORBIDDEN	You can't write in this chat.
+CHAT_TYPE_INVALID	The specified chat type is invalid.
+CHAT_WRITE_FORBIDDEN	You don't have rights to send messages in this chat.
 EDIT_BOT_INVITE_FORBIDDEN	Normal users can't edit invites that were created by bots.
 GROUPCALL_ALREADY_STARTED	The groupcall has already started, you can join directly using [phone.joinGroupCall](https://core.telegram.org/method/phone.joinGroupCall).
 GROUPCALL_FORBIDDEN	The group call has already ended.
-INLINE_BOT_REQUIRED	Only the inline bot can edit message.
-MESSAGE_AUTHOR_REQUIRED	Message author required.
-MESSAGE_DELETE_FORBIDDEN	You can't delete one of the messages you tried to delete, most likely because it is a service message.
-NOT_ELIGIBLE	The current user is not eligible to join the Peer-to-Peer Login Program.
+INLINE_BOT_REQUIRED	The action must be performed through an inline bot callback.
+LIVE_DISABLED	Story is disabled server-side.
+MESSAGE_AUTHOR_REQUIRED	You are not the author of this message.
+MESSAGE_DELETE_FORBIDDEN	You don't have rights to delete one of the messages you tried to delete, most likely because it is a service message or you are not the author of them.
+NOT_ALLOWED	Not allowed.
+NOT_ELIGIBLE	The current user is not eligible for this action.
 PARTICIPANT_JOIN_MISSING	Trying to enable a presentation, when the user hasn't joined the Video Chat with [phone.joinGroupCall](https://core.telegram.org/method/phone.joinGroupCall).
 PEER_ID_INVALID	The provided peer id is invalid.
 POLL_VOTE_REQUIRED	Cast a vote in the poll before calling this method.
 PREMIUM_ACCOUNT_REQUIRED	A premium account is required to execute this action.
-PRIVACY_PREMIUM_REQUIRED	You need a [Telegram Premium subscription](https://core.telegram.org/api/premium) to send a message to this user.
+PRIVACY_PREMIUM_REQUIRED	The user has restricted from sending messages or this action requires a [Telegram Premium subscription](https://core.telegram.org/api/premium).
 PUBLIC_CHANNEL_MISSING	You can only export group call invite links for public chats or channels.
-RIGHT_FORBIDDEN	Your admin rights do not allow you to do this.
-SENSITIVE_CHANGE_FORBIDDEN	You can't change your sensitive content settings.
-TAKEOUT_REQUIRED	A [takeout](https://core.telegram.org/api/takeout) session needs to be initialized first, [see here &raquo; for more info](https://core.telegram.org/api/takeout).
+RECAPTCHA_CHECK_X	The request can't be completed unless reCAPTCHA verification {value} is performed.
+RIGHT_FORBIDDEN	You don't have enough rights for this action, or you tried to set one or more admin rights that can't be applied to this kind of chat (channel or supergroup).
+SENSITIVE_CHANGE_FORBIDDEN	You can't change your sensitive content settings at this time.
+STARGIFT_CONVERT_BOT_NOT_ALLOWED	You can't convert this gift to stars.
+TAKEOUT_REQUIRED	The method must be invoked inside a [takeout](https://core.telegram.org/api/takeout) session.
 USER_BOT_INVALID	User accounts must provide the `bot` method parameter when calling this method. If there is no such method parameter, this method can only be invoked by bot accounts.
 USER_CHANNELS_TOO_MUCH	One of the users you tried to add is already in too many channels/supergroups.
 USER_DELETED	You can't send this secret message because the other participant deleted their account.
-USER_INVALID	Invalid user provided.
+USER_DISALLOWED_STARGIFTS	You can't send gifts to this user due to their privacy settings.
+USER_INVALID	The provided user is invalid.
 USER_IS_BLOCKED	You were blocked by this user.
 USER_NOT_MUTUAL_CONTACT	The provided user is not a mutual contact.
 USER_NOT_PARTICIPANT	You're not a member of this supergroup/channel.
 USER_PRIVACY_RESTRICTED	The user's privacy settings do not allow you to do this.
-USER_RESTRICTED	You're spamreported, you can't create channels or chats.
+USER_RESTRICTED	You're limited/restricted by telegram. You can't perform this action.
 VOICE_MESSAGES_FORBIDDEN	This user's privacy settings forbid you from sending voice messages.
 YOUR_PRIVACY_RESTRICTED	You cannot fetch the read date of this message because you have disallowed other users to do so for *your* messages; to fix, allow other users to see *your* exact last online date OR purchase a [Telegram Premium](https://core.telegram.org/api/premium) subscription.
diff --git a/pyproject.toml b/pyproject.toml
@@ -24,6 +24,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Programming Language :: Python :: Implementation",
     "Programming Language :: Python :: Implementation :: CPython",
     "Programming Language :: Python :: Implementation :: PyPy",
diff --git a/pyrogram/client.py b/pyrogram/client.py
@@ -425,7 +425,7 @@ def __init__(
         if isinstance(loop, asyncio.AbstractEventLoop):
             self.loop = loop
         else:
-            self.loop = asyncio.get_event_loop()
+            self.loop = utils.get_event_loop()
 
         self.__config: "raw.types.Config" = None
 
diff --git a/pyrogram/connection/connection.py b/pyrogram/connection/connection.py
@@ -20,6 +20,8 @@
 import logging
 from typing import Optional, Type
 
+from pyrogram import utils
+
 from .transport import TCP, TCPAbridged
 
 log = logging.getLogger(__name__)
@@ -55,7 +57,7 @@ def __init__(
         if isinstance(loop, asyncio.AbstractEventLoop):
             self.loop = loop
         else:
-            self.loop = asyncio.get_event_loop()
+            self.loop = utils.get_event_loop()
 
     async def connect(self) -> None:
         attempts = Connection.MAX_CONNECTION_ATTEMPTS
diff --git a/pyrogram/connection/transport/tcp/tcp.py b/pyrogram/connection/transport/tcp/tcp.py
@@ -25,6 +25,8 @@
 
 import socks
 
+from pyrogram import utils
+
 log = logging.getLogger(__name__)
 
 proxy_type_by_scheme: Dict[str, int] = {
@@ -68,7 +70,7 @@ def __init__(
         if isinstance(loop, asyncio.AbstractEventLoop):
             self.loop = loop
         else:
-            self.loop = asyncio.get_event_loop()
+            self.loop = utils.get_event_loop()
 
     async def _connect_via_proxy(
         self,
diff --git a/pyrogram/methods/bots/__init__.py b/pyrogram/methods/bots/__init__.py
@@ -23,6 +23,7 @@
 from .answer_web_app_query import AnswerWebAppQuery
 from .create_invoice_link import CreateInvoiceLink
 from .delete_bot_commands import DeleteBotCommands
+from .edit_user_star_subscription import EditUserStarSubscription
 from .get_bot_commands import GetBotCommands
 from .get_bot_default_privileges import GetBotDefaultPrivileges
 from .get_bot_info_description import GetBotInfoDescription
@@ -64,6 +65,7 @@ class Bots(
     SetBotCommands,
     GetBotCommands,
     DeleteBotCommands,
+    EditUserStarSubscription,
     SetBotDefaultPrivileges,
     SetBotInfoDescription,
     SetBotInfoShortDescription,
diff --git a/pyrogram/methods/bots/edit_user_star_subscription.py b/pyrogram/methods/bots/edit_user_star_subscription.py
@@ -0,0 +1,56 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import Union
+
+import pyrogram
+from pyrogram import raw
+
+
+class EditUserStarSubscription:
+    async def edit_user_star_subscription(
+        self: "pyrogram.Client",
+        user_id: Union[int, str],
+        telegram_payment_charge_id: str,
+        is_canceled: bool,
+    ) -> bool:
+        """Cancels or re-enables Telegram Star subscription for a user.
+
+        .. include:: /_includes/usable-by/bots.rst
+
+        Parameters:
+            user_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target user.
+
+            telegram_payment_charge_id (``str``):
+                Telegram payment identifier of the subscription.
+
+            is_canceled (``bool``):
+                Pass True to cancel the subscription.
+                Pass False to allow the user to enable it.
+
+        Returns:
+            ``bool``: On success, True is returned.
+        """
+        return await self.invoke(
+            raw.functions.payments.BotCancelStarsSubscription(
+                user_id=await self.resolve_peer(user_id),
+                charge_id=telegram_payment_charge_id,
+                restore=is_canceled,
+            )
+        )
diff --git a/pyrogram/methods/payments/__init__.py b/pyrogram/methods/payments/__init__.py
@@ -24,6 +24,7 @@
 from .create_gift_collection import CreateGiftCollection
 from .delete_gift_collection import DeleteGiftCollection
 from .drop_gift_original_details import DropGiftOriginalDetails
+from .edit_star_subscription import EditStarSubscription
 from .get_available_gifts import GetAvailableGifts
 from .get_chat_gifts import GetChatGifts
 from .get_chat_gifts_count import GetChatGiftsCount
@@ -39,6 +40,7 @@
 from .remove_collection_gifts import RemoveCollectionGifts
 from .reorder_collection_gifts import ReorderCollectionGifts
 from .reorder_gift_collections import ReorderGiftCollections
+from .reuse_star_subscription import ReuseStarSubscription
 from .search_gifts_for_resale import SearchGiftsForResale
 from .send_gift import SendGift
 from .send_payment_form import SendPaymentForm
@@ -61,6 +63,7 @@ class Payments(
     CreateGiftCollection,
     DeleteGiftCollection,
     DropGiftOriginalDetails,
+    EditStarSubscription,
     GetAvailableGifts,
     GetChatGifts,
     GetChatGiftsCount,
@@ -76,6 +79,7 @@ class Payments(
     RemoveCollectionGifts,
     ReorderCollectionGifts,
     ReorderGiftCollections,
+    ReuseStarSubscription,
     SearchGiftsForResale,
     SendGift,
     SendPaymentForm,
diff --git a/pyrogram/methods/payments/edit_star_subscription.py b/pyrogram/methods/payments/edit_star_subscription.py
@@ -0,0 +1,47 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+import pyrogram
+from pyrogram import raw
+
+
+class EditStarSubscription:
+    async def edit_star_subscription(
+        self: "pyrogram.Client", subscription_id: str, is_canceled: bool
+    ) -> bool:
+        """Cancels or re-enables Telegram Star subscription.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            subscription_id (``str``):
+                Identifier of the subscription to change.
+
+            is_canceled (``bool``):
+                New value of is_canceled.
+
+        Returns:
+            ``bool``: On success, True is returned.
+        """
+        return await self.invoke(
+            raw.functions.payments.ChangeStarsSubscription(
+                peer=raw.types.InputPeerSelf(),
+                subscription_id=subscription_id,
+                canceled=is_canceled,
+            )
+        )
diff --git a/pyrogram/methods/payments/reuse_star_subscription.py b/pyrogram/methods/payments/reuse_star_subscription.py
@@ -0,0 +1,41 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present Dan <https://github.com/delivrance>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+import pyrogram
+from pyrogram import raw
+
+
+class ReuseStarSubscription:
+    async def reuse_star_subscription(self: "pyrogram.Client", subscription_id: str) -> bool:
+        """Reuses an active Telegram Star subscription to a channel chat and joins the chat again.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            subscription_id (``str``):
+                Identifier of the subscription.
+
+        Returns:
+            ``bool``: On success, True is returned.
+        """
+        return await self.invoke(
+            raw.functions.payments.FulfillStarsSubscription(
+                peer=raw.types.InputPeerSelf(),
+                subscription_id=subscription_id,
+            )
+        )
diff --git a/pyrogram/methods/payments/send_resold_gift.py b/pyrogram/methods/payments/send_resold_gift.py
@@ -47,7 +47,7 @@ async def send_resold_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).
 
-            price (:obj:`~pyrogram.types.GiftResalePrice`, *optional*):
+            price (:obj:`~pyrogram.types.GiftResalePrice`):
                 The price that the user agreed to pay for the gift.
 
         Returns:
@@ -62,6 +62,17 @@ async def send_resold_gift(
                     new_owner_chat_id=123,
                     price=types.GiftResalePriceStar(star_count=100_000)
                 )
+
+                # Buy ton gift
+                from pyrogram import utils
+
+                await app.send_resold_gift(
+                    gift_link="https://t.me/nft/NekoHelmet-9215",
+                    new_owner_chat_id=123,
+                    price=types.GiftResalePriceTon(
+                        toncoin_cent_count=utils.to_nano(5) # 5 ton
+                    )
+                )
         """
         match = self.UPGRADED_GIFT_RE.match(gift_link)
 
diff --git a/pyrogram/sync.py b/pyrogram/sync.py
diff --git a/pyrogram/types/user_and_chats/found_contacts.py b/pyrogram/types/user_and_chats/found_contacts.py
diff --git a/pyrogram/utils.py b/pyrogram/utils.py
