Merge branch 'dev' into mc

Author: SpEcHiDe

compiler/api/source/main_api.tl

@@ -477,7 +477,7 @@ updateStarsBalance#4e80a379 balance:StarsAmount = Update;
 updateBusinessBotCallbackQuery#1ea2fda7 flags:# query_id:long user_id:long connection_id:string message:Message reply_to_message:flags.2?Message chat_instance:long data:flags.0?bytes = Update;
 updateStarsRevenueStatus#a584b019 peer:Peer status:StarsRevenueStatus = Update;
 updateBotPurchasedPaidMedia#283bd312 user_id:long payload:string qts:int = Update;
-updatePaidReactionPrivacy#51ca7aec private:Bool = Update;
+updatePaidReactionPrivacy#8b725fce private:PaidReactionPrivacy = Update;
 
 updates.state#a56c2a3e pts:int qts:int date:int seq:int unread_count:int = updates.State;
 
@@ -650,7 +650,7 @@ messages.affectedMessages#84d19185 pts:int pts_count:int = messages.AffectedMess
 
 webPageEmpty#211a1788 flags:# id:long url:flags.0?string = WebPage;
 webPagePending#b0d13e47 flags:# id:long url:flags.0?string date:int = WebPage;
-webPage#e89c45b2 flags:# has_large_media:flags.13?true id:long url:string display_url:string hash:int type:flags.0?string site_name:flags.1?string title:flags.2?string description:flags.3?string photo:flags.4?Photo embed_url:flags.5?string embed_type:flags.5?string embed_width:flags.6?int embed_height:flags.6?int duration:flags.7?int author:flags.8?string document:flags.9?Document cached_page:flags.10?Page attributes:flags.12?Vector<WebPageAttribute> = WebPage;
+webPage#e89c45b2 flags:# has_large_media:flags.13?true video_cover_photo:flags.14?true id:long url:string display_url:string hash:int type:flags.0?string site_name:flags.1?string title:flags.2?string description:flags.3?string photo:flags.4?Photo embed_url:flags.5?string embed_type:flags.5?string embed_width:flags.6?int embed_height:flags.6?int duration:flags.7?int author:flags.8?string document:flags.9?Document cached_page:flags.10?Page attributes:flags.12?Vector<WebPageAttribute> = WebPage;
 webPageNotModified#7311ca11 flags:# cached_page_views:flags.0?int = WebPage;
 
 authorization#ad01d61d flags:# current:flags.0?true official_app:flags.1?true password_pending:flags.2?true encrypted_requests_disabled:flags.3?true call_requests_disabled:flags.4?true unconfirmed:flags.5?true hash:long device_model:string platform:string system_version:string api_id:int app_name:string app_version:string date_created:int date_active:int ip:string country:string region:string = Authorization;
@@ -1928,7 +1928,7 @@ starsGiveawayOption#94ce852a flags:# extended:flags.0?true default:flags.1?true
 starsGiveawayWinnersOption#54236209 flags:# default:flags.0?true users:int per_user_stars:long = StarsGiveawayWinnersOption;
 
 starGift#2cc73c8 flags:# limited:flags.0?true sold_out:flags.1?true birthday:flags.2?true id:long sticker:Document stars:long availability_remains:flags.0?int availability_total:flags.0?int convert_stars:long first_sale_date:flags.1?int last_sale_date:flags.1?int upgrade_stars:flags.3?long = StarGift;
-starGiftUnique#f2fe7e4a flags:# id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int = StarGift;
+starGiftUnique#5c62d151 flags:# id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int gift_address:flags.3?string = StarGift;
 
 payments.starGiftsNotModified#a388a368 = payments.StarGifts;
 payments.starGifts#901689ea hash:int gifts:Vector<StarGift> = payments.StarGifts;
@@ -1985,6 +1985,10 @@ inputSavedStarGiftChat#f101aa7f peer:InputPeer saved_id:long = InputSavedStarGif
 
 payments.starGiftWithdrawalUrl#84aa3a9c url:string = payments.StarGiftWithdrawalUrl;
 
+paidReactionPrivacyDefault#206ad49e = PaidReactionPrivacy;
+paidReactionPrivacyAnonymous#1f0c1ad9 = PaidReactionPrivacy;
+paidReactionPrivacyPeer#dc6cfcf0 peer:InputPeer = PaidReactionPrivacy;
+
 ---functions---
 
 invokeAfterMsg#cb9f372d {X:Type} msg_id:long query:!X = X;
@@ -1997,6 +2001,7 @@ invokeWithTakeout#aca9fd2e {X:Type} takeout_id:long query:!X = X;
 invokeWithBusinessConnection#dd289f8e {X:Type} connection_id:string query:!X = X;
 invokeWithGooglePlayIntegrity#1df92984 {X:Type} nonce:string token:string query:!X = X;
 invokeWithApnsSecret#0dae54f8 {X:Type} nonce:string secret:string query:!X = X;
+invokeWithReCaptcha#adbb0f94 {X:Type} token:string query:!X = X;
 
 auth.sendCode#a677244f phone_number:string api_id:int api_hash:string settings:CodeSettings = auth.SentCode;
 auth.signUp#aac7b717 flags:# no_joined_notifications:flags.0?true phone_number:string phone_code_hash:string first_name:string last_name:string = auth.Authorization;
@@ -2382,8 +2387,8 @@ messages.editFactCheck#589ee75 peer:InputPeer msg_id:int text:TextWithEntities =
 messages.deleteFactCheck#d1da940c peer:InputPeer msg_id:int = Updates;
 messages.getFactCheck#b9cdc5ee peer:InputPeer msg_id:Vector<int> = Vector<FactCheck>;
 messages.requestMainWebView#c9e01e7b flags:# compact:flags.7?true fullscreen:flags.8?true peer:InputPeer bot:InputUser start_param:flags.1?string theme_params:flags.0?DataJSON platform:string = WebViewResult;
-messages.sendPaidReaction#9dd6a67b flags:# peer:InputPeer msg_id:int count:int random_id:long private:flags.0?Bool = Updates;
-messages.togglePaidReactionPrivacy#849ad397 peer:InputPeer msg_id:int private:Bool = Bool;
+messages.sendPaidReaction#58bbcb50 flags:# peer:InputPeer msg_id:int count:int random_id:long private:flags.0?PaidReactionPrivacy = Updates;
+messages.togglePaidReactionPrivacy#435885b5 peer:InputPeer msg_id:int private:PaidReactionPrivacy = Bool;
 messages.getPaidReactionPrivacy#472455aa = Updates;
 messages.viewSponsoredMessage#673ad8f1 peer:InputPeer random_id:bytes = Bool;
 messages.clickSponsoredMessage#f093465 flags:# media:flags.0?true fullscreen:flags.1?true peer:InputPeer random_id:bytes = Bool;
@@ -2474,7 +2479,7 @@ channels.editLocation#58e63f6d channel:InputChannel geo_point:InputGeoPoint addr
 channels.toggleSlowMode#edd49ef0 channel:InputChannel seconds:int = Updates;
 channels.getInactiveChannels#11e831ee = messages.InactiveChats;
 channels.convertToGigagroup#b290c69 channel:InputChannel = Updates;
-channels.getSendAs#dc770ee peer:InputPeer = channels.SendAsPeers;
+channels.getSendAs#e785a43f flags:# for_paid_reactions:flags.0?true peer:InputPeer = channels.SendAsPeers;
 channels.deleteParticipantHistory#367544db channel:InputChannel participant:InputPeer = messages.AffectedHistory;
 channels.toggleJoinToSend#e4cb9580 channel:InputChannel enabled:Bool = Updates;
 channels.toggleJoinRequest#4c2985b6 channel:InputChannel enabled:Bool = Updates;
@@ -2706,5 +2711,6 @@ fragment.getCollectibleInfo#be1e85ba collectible:InputCollectible = fragment.Col
 // invokeWithBusinessConnectionPrefix#dd289f8e connection_id:string = Error;
 // invokeWithGooglePlayIntegrityPrefix#1df92984 nonce:string token:string = Error;
 // invokeWithApnsSecretPrefix#0dae54f8 nonce:string secret:string = Error;
+// invokeWithReCaptchaPrefix#adbb0f94 token:string = Error;
 
-// LAYER 198
+// LAYER 199

compiler/docs/compiler.py

@@ -677,6 +677,10 @@ def get_title_list(s: str) -> list:
             ShippingQuery
             PreCheckoutQuery
             StarAmount
+            PaidReactionType
+            PaidReactionTypeAnonymous
+            PaidReactionTypeChat
+            PaidReactionTypeRegular
         """
     )
 

docs/source/releases/changes-in-this-fork.rst

@@ -25,6 +25,12 @@ Breaking Changes in this Fork
 Changes in this Fork
 =====================
 
++------------------------+
+| Scheme layer used: 199 |
++------------------------+
+
+- View `new and changed <https://telegramplayground.github.io/TG-APIs/TL/diff/tdlib.html?from=198&to=199>`__ `raw API methods <https://telegramplayground.github.io/TG-APIs/TL/diff/tdesktop.html?from=198&to=199>`__.
+
 +------------------------+
 | Scheme layer used: 198 |
 +------------------------+
@@ -33,7 +39,7 @@ Changes in this Fork
 - Added ``message.content`` property.
 - Added the parameter ``pinned`` and made the parameter ``chat_id`` optional in :meth:`~pyrogram.Client.get_messages`. **NOTE**: Please be aware about using the correct :doc:`Message Identifiers <../../topics/message-identifiers>`, when using this method.
 - Added the ``cover`` and ``start_timestamp`` parameters in :meth:`~pyrogram.Client.send_video` and :obj:`~pyrogram.types.InputPaidMediaVideo`.
-- Added the ``new_video_start_timestamp`` and renamed the ``send_copy`` and ``remove_caption`` parameters in :meth:`~pyrogram.Client.forward_messages` and :meth:`~pyrogram.types.Message.forward`.
+- Added the ``video_start_timestamp`` and renamed the ``send_copy`` and ``remove_caption`` parameters in :meth:`~pyrogram.Client.forward_messages` and :meth:`~pyrogram.types.Message.forward`.
 - Added the ``gift_count`` to the :obj:`~pyrogram.types.Chat`.
 - Added the :meth:`~pyrogram.Client.get_similar_bots`.
 - Changed types in :obj:`~pyrogram.types.UpgradedGift`, :obj:`~pyrogram.types.UserGift`.

pyrogram/methods/business/get_available_gifts.py

@@ -31,7 +31,7 @@ async def get_available_gifts(
         .. include:: /_includes/usable-by/users-bots.rst
 
         Returns:
-            List of :obj:`~pyrogram.types.Gift` | :obj:`~pyrogram.types.UpgradedGift`: On success, a list of star gifts is returned.
+            List of :obj:`~pyrogram.types.Gift` | :obj:`~pyrogram.types.UpgradedGift`: On success, a list of star gifts that can be sent by the Client to users and channel chats is returned.
 
         Example:
             .. code-block:: python

pyrogram/methods/business/send_gift.py

@@ -26,21 +26,32 @@
 class SendGift:
     async def send_gift(
         self: "pyrogram.Client",
-        user_id: Union[int, str],
-        gift_id: int,
+        *,
+        user_id: Union[int, str] = None,
+        chat_id: Union[int, str] = None,
+        gift_id: int = None,
         pay_for_upgrade: Optional[bool] = None,
         text: Optional[str] = None,
-        parse_mode: Optional["enums.ParseMode"] = None,
-        entities: Optional[list["types.MessageEntity"]] = None,
+        text_parse_mode: Optional["enums.ParseMode"] = None,
+        text_entities: Optional[list["types.MessageEntity"]] = None,
         is_private: Optional[bool] = None,
     ) -> bool:
-        """Sends a gift to another user.
+        """Sends a gift to the given user or channel chat. The gift can't be converted to Telegram Stars by the receiver.
 
         .. include:: /_includes/usable-by/users-bots.rst
 
+        You must use exactly one of ``user_id`` OR ``chat_id``.
+
         Parameters:
             user_id (``int`` | ``str``):
-                Unique identifier (int) or username (str) of the user that will receive the gift.
+                Required if ``chat_id`` is not specified.
+                Unique identifier (int) or username (str) of the target user that will receive 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).
+
+            chat_id (``int`` | ``str``):
+                Required if ``user_id`` is not specified.
+                Unique identifier (int) or username (str) for the chat or username of the channel that will receive 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).
 
@@ -53,12 +64,12 @@ async def send_gift(
             text (``str``, *optional*):
                 Text that will be shown along with the gift. 0-``gift_text_length_max`` characters.
 
-            parse_mode (:obj:`~pyrogram.enums.ParseMode`, *optional*):
+            text_parse_mode (:obj:`~pyrogram.enums.ParseMode`, *optional*):
                 By default, texts are parsed using both Markdown and HTML styles.
                 You can combine both syntaxes together.
 
-            entities (List of :obj:`~pyrogram.types.MessageEntity`, *optional*):
-                List of special entities that appear in message text, which can be specified instead of *parse_mode*.
+            text_entities (List of :obj:`~pyrogram.types.MessageEntity`, *optional*):
+                List of special entities that appear in message text, which can be specified instead of *text_parse_mode*.
                 Only Bold, Italic, Underline, Strikethrough, Spoiler, and CustomEmoji entities are allowed.
 
             is_private (``bool``, *optional*):
@@ -77,12 +88,15 @@ async def send_gift(
                 app.send_gift(user_id=user_id, gift_id=123)
 
         """
-        peer = await self.resolve_peer(user_id)
-
-        if not isinstance(peer, (raw.types.InputPeerUser, raw.types.InputPeerSelf)):
-            raise ValueError("user_id must belong to a user.")
-
-        text, entities = (await utils.parse_text_entities(self, text, parse_mode, entities)).values()
+        peer = None
+        if user_id:
+            peer = await self.resolve_peer(user_id)
+        elif chat_id:
+            peer = await self.resolve_peer(chat_id)
+        # TODO
+        if not peer:
+            raise ValueError("You must use exactly one of user_id OR chat_id")
+        text, entities = (await utils.parse_text_entities(self, text, text_parse_mode, text_entities)).values()
 
         invoice = raw.types.InputInvoiceStarGift(
             user_id=peer,

pyrogram/methods/chats/get_send_as_chats.py

@@ -26,7 +26,7 @@
 class GetSendAsChats:
     async def get_send_as_chats(
         self: "pyrogram.Client",
-        chat_id: Union[int, str]
+        chat_id: Union[int, str],
     ) -> list["types.Chat"]:
         """Get the list of "send_as" chats available.
 
@@ -44,10 +44,11 @@ async def get_send_as_chats(
 
                 chats = await app.get_send_as_chats(chat_id)
                 print(chats)
+
         """
         r = await self.invoke(
             raw.functions.channels.GetSendAs(
-                peer=await self.resolve_peer(chat_id)
+                peer=await self.resolve_peer(chat_id),
             )
         )
 

pyrogram/methods/messages/add_paid_message_reaction.py

@@ -16,22 +16,19 @@
 #  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 logging
 from typing import Union
 
 import pyrogram
 from pyrogram import raw, types
 
-log = logging.getLogger(__name__)
-
 
 class AddPaidMessageReaction:
     async def add_paid_message_reaction(
         self: "pyrogram.Client",
         chat_id: Union[int, str],
         message_id: int,
         star_count: int = None,
-        is_anonymous: bool = False
+        paid_reaction_type: "types.PaidReactionType" = None
     ) -> "types.MessageReactions":
         """Adds the paid message reaction to a message.
 
@@ -47,9 +44,8 @@ async def add_paid_message_reaction(
             star_count (``int``, *optional*):
                 Number of Telegram Stars to be used for the reaction; 1-2500.
 
-            is_anonymous (``bool``, *optional*):
-                Pass True to make paid reaction of the user on the message anonymous; pass False to make the user's profile visible among top reactors.
-                Defaults to False.
+            paid_reaction_type (:obj:`~pyrogram.types.PaidReactionType`, *optional*):
+                Type of the paid reaction; pass None if the user didn't choose reaction type explicitly, for example, the reaction is set from the message bubble.
 
         Returns:
             On success, :obj:`~pyrogram.types.MessageReactions`: is returned.
@@ -58,7 +54,7 @@ async def add_paid_message_reaction(
             .. code-block:: python
 
                 # Add a paid reaction to a message
-                await app.add_paid_message_reaction(chat_id, message_id, 1, False)
+                await app.add_paid_message_reaction(chat_id, message_id, 1)
 
         """
 
@@ -68,7 +64,7 @@ async def add_paid_message_reaction(
                 msg_id=message_id,
                 random_id=self.rnd_id(),
                 count=star_count,
-                private=is_anonymous
+                private=await paid_reaction_type.write(self) if paid_reaction_type else None
             )
         )
         for i in r.updates:

pyrogram/methods/messages/forward_messages.py

@@ -36,7 +36,7 @@ async def forward_messages(
         allow_paid_broadcast: bool = None,
         send_copy: bool = None,
         remove_caption: bool = None,
-        new_video_start_timestamp: int = None,
+        video_start_timestamp: int = None,
         send_as: Union[int, str] = None,
         schedule_date: datetime = None
     ) -> Union["types.Message", list["types.Message"]]:
@@ -77,8 +77,8 @@ async def forward_messages(
             remove_caption (``bool``, *optional*):
                 Pass True to remove media captions of message copies.
 
-            new_video_start_timestamp (``int``, *optional*):
-                The new video start timestamp. Pass time to replace video start timestamp in the forwarded message.
+            video_start_timestamp (``int``, *optional*):
+                New start timestamp for the forwarded video in the message.
 
             send_as (``int`` | ``str``):
                 Unique identifier (int) or username (str) of the chat or channel to send the message as.
@@ -114,7 +114,7 @@ async def forward_messages(
                 id=message_ids,
                 silent=disable_notification or None,
                 # TODO
-                video_timestamp=new_video_start_timestamp,
+                video_timestamp=video_start_timestamp,
                 drop_author=send_copy,
                 drop_media_captions=remove_caption,
                 noforwards=protect_content,