feat(raw): update tl schema and add new rpc errors

Author: SychO3

compiler/api/source/main_api.tl

@@ -1,22 +1,43 @@
-// https://github.com/telegramdesktop/tdesktop/blob/dev/Telegram/SourceFiles/mtproto/scheme/api.tl
-// https://github.com/tdlib/td/blob/master/td/generate/scheme/telegram_api.tl
+// === merged.tl generated by fetch-and-merge-tl ===
+// source: tdlib/td/td/generate/scheme/telegram_api.tl@8b005a6
+// source: telegramdesktop/tdesktop/Telegram/SourceFiles/mtproto/scheme/api.tl@6327bac
+// merge strategy: td (primary) order retained; unique lines from tdesktop appended; exact-line de-dup.
+// int ? = Int;
+// long ? = Long;
+// double ? = Double;
+// string ? = String;
 
-///////////////////////////////
-///////// Main application API
-///////////////////////////////
+// bytes = Bytes;
+// int256 = Int256;
 
----types---
+// true#3fedd339 = True;
+
+// boolFalse#bc799737 = Bool;
+// boolTrue#997275b5 = Bool;
+
+// vector#1cb5c415 {t:Type} # [ t ] = Vector t;
+
+// error#c4b9f9bb code:int text:string = Error;
 
-// boolFalse#bc799737 = Bool;  // Parsed manually
-// boolTrue#997275b5 = Bool;  // Parsed manually
+ipPort#d433ad73 ipv4:int port:int = IpPort;
+ipPortSecret#37982646 ipv4:int port:int secret:bytes = IpPort;
+accessPointRule#4679b65f phone_prefix_rules:string dc_id:int ips:vector<IpPort> = AccessPointRule;
+help.configSimple#5a592a6c date:int expires:int rules:vector<AccessPointRule> = help.ConfigSimple;
 
-// true#3fedd339 = True;  // Not used
+inputPeerPhotoFileLocationLegacy#27d69997 flags:# big:flags.0?true peer:InputPeer volume_id:long local_id:int = InputFileLocation;
+inputStickerSetThumbLegacy#dbaeae9 stickerset:InputStickerSet volume_id:long local_id:int = InputFileLocation;
 
-// vector#1cb5c415 {t:Type} # [ t ] = Vector t;  // Parsed manually
+---functions---
+
+test.useConfigSimple = help.ConfigSimple;
+test.parseInputAppEvent = InputAppEvent;
 
-// error#c4b9f9bb code:int text:string = Error;  // Not used
+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;
 
-// null#56730bcc = Null;  // Parsed manually
+---types---
 
 inputPeerEmpty#7f3b18ea = InputPeer;
 inputPeerSelf#7da07ec9 = InputPeer;
@@ -2919,5 +2940,5 @@ smsjobs.getSmsJob#778d902f job_id:string = SmsJob;
 smsjobs.finishJob#4f1ebf24 flags:# job_id:string error:flags.0?string = Bool;
 
 fragment.getCollectibleInfo#be1e85ba collectible:InputCollectible = fragment.CollectibleInfo;
-
-// LAYER 223
+null#56730bcc = Null;
+// LAYER 223

pyrogram/errors/exceptions/all.py

@@ -16,7 +16,7 @@
 # You should have received a copy of the GNU Lesser General Public License
 # along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
 
-count = 771
+count = 774
 
 exceptions = {
     420: {
@@ -587,9 +587,11 @@
         "SRP_A_INVALID": "SrpAInvalid",
         "SRP_ID_INVALID": "SrpIdInvalid",
         "SRP_PASSWORD_CHANGED": "SrpPasswordChanged",
+        "STARGIFT_ALREADY_BURNED": "StargiftAlreadyBurned",
         "STARGIFT_ALREADY_CONVERTED": "StargiftAlreadyConverted",
         "STARGIFT_ALREADY_TRANSFERRED": "StargiftAlreadyTransferred",
         "STARGIFT_ALREADY_UPGRADED": "StargiftAlreadyUpgraded",
+        "STARGIFT_ATTRIBUTE_INVALID": "StargiftAttributeInvalid",
         "STARGIFT_CONVERT_TOO_OLD": "StargiftConvertTooOld",
         "STARGIFT_EXPORT_UNAVAILABLE": "StargiftExportUnavailable",
         "STARGIFT_INVALID": "StargiftInvalid",
@@ -715,6 +717,7 @@
         "USER_CHANNELS_TOO_MUCH": "UserChannelsTooMuch",
         "USER_CREATOR": "UserCreator",
         "USER_GIFT_UNAVAILABLE": "UserGiftUnavailable",
+        "USER_HANDLE_MISMATCH": "UserHandleMismatch",
         "USER_ID_INVALID": "UserIdInvalid",
         "USER_INVALID": "UserInvalid",
         "USER_IS_BLOCKED": "UserIsBlocked",

pyrogram/errors/exceptions/bad_request_400.py

@@ -3407,6 +3407,13 @@ class SrpPasswordChanged(BadRequest):
     MESSAGE = __doc__
 
 
+class StargiftAlreadyBurned(BadRequest):
+    """The provided gift is already burned."""
+    ID = "STARGIFT_ALREADY_BURNED"
+    """``str``: RPC Error ID"""
+    MESSAGE = __doc__
+
+
 class StargiftAlreadyConverted(BadRequest):
     """The provided star gift already converted to stars."""
     ID = "STARGIFT_ALREADY_CONVERTED"
@@ -3428,6 +3435,13 @@ class StargiftAlreadyUpgraded(BadRequest):
     MESSAGE = __doc__
 
 
+class StargiftAttributeInvalid(BadRequest):
+    """The provided gift attribute is invalid."""
+    ID = "STARGIFT_ATTRIBUTE_INVALID"
+    """``str``: RPC Error ID"""
+    MESSAGE = __doc__
+
+
 class StargiftConvertTooOld(BadRequest):
     """This gift can no longer be converted into stars."""
     ID = "STARGIFT_CONVERT_TOO_OLD"
@@ -4303,6 +4317,13 @@ class UserGiftUnavailable(BadRequest):
     MESSAGE = __doc__
 
 
+class UserHandleMismatch(BadRequest):
+    """The user handle mismatch."""
+    ID = "USER_HANDLE_MISMATCH"
+    """``str``: RPC Error ID"""
+    MESSAGE = __doc__
+
+
 class UserIdInvalid(BadRequest):
     """The provided user id is invalid."""
     ID = "USER_ID_INVALID"

pyrogram/raw/all.py

@@ -76,6 +76,16 @@
     0xf3427b8c: "pyrogram.raw.functions.PingDelayDisconnect",
     0xe7512126: "pyrogram.raw.functions.DestroySession",
     0x9a5f6e95: "pyrogram.raw.functions.contest.SaveDeveloperInfo",
+    0xd433ad73: "pyrogram.raw.functions.IpPort",
+    0x37982646: "pyrogram.raw.functions.IpPortSecret",
+    0x4679b65f: "pyrogram.raw.functions.AccessPointRule",
+    0x5a592a6c: "pyrogram.raw.functions.help.ConfigSimple",
+    0x27d69997: "pyrogram.raw.functions.InputPeerPhotoFileLocationLegacy",
+    0xdbaeae9: "pyrogram.raw.functions.InputStickerSetThumbLegacy",
+    0xdd289f8e: "pyrogram.raw.functions.InvokeWithBusinessConnectionPrefix",
+    0x1df92984: "pyrogram.raw.functions.InvokeWithGooglePlayIntegrityPrefix",
+    0x0dae54f8: "pyrogram.raw.functions.InvokeWithApnsSecretPrefix",
+    0xadbb0f94: "pyrogram.raw.functions.InvokeWithReCaptchaPrefix",
     0x7f3b18ea: "pyrogram.raw.types.InputPeerEmpty",
     0x7da07ec9: "pyrogram.raw.types.InputPeerSelf",
     0x35a95cb9: "pyrogram.raw.types.InputPeerChat",
@@ -2373,6 +2383,7 @@
     0x778d902f: "pyrogram.raw.functions.smsjobs.GetSmsJob",
     0x4f1ebf24: "pyrogram.raw.functions.smsjobs.FinishJob",
     0xbe1e85ba: "pyrogram.raw.functions.fragment.GetCollectibleInfo",
+    0x56730bcc: "pyrogram.raw.functions.Null",
     0xbc799737: "pyrogram.raw.core.BoolFalse",
     0x997275b5: "pyrogram.raw.core.BoolTrue",
     0x1cb5c415: "pyrogram.raw.core.Vector",

pyrogram/raw/base/access_point_rule.py

@@ -40,6 +40,14 @@ class AccessPointRule(metaclass=BaseTypeMeta):  # type: ignore
             :columns: 2
 
             - :obj:`AccessPointRule <pyrogram.raw.types.AccessPointRule>`
+
+    See Also:
+        This object can be returned by 1 method:
+
+        .. hlist::
+            :columns: 2
+
+            - :obj:`AccessPointRule <pyrogram.raw.functions.AccessPointRule>`
         """
 
         QUALNAME = "pyrogram.raw.base.AccessPointRule"

pyrogram/raw/base/help/config_simple.py

@@ -40,6 +40,14 @@ class ConfigSimple(metaclass=BaseTypeMeta):  # type: ignore
             :columns: 2
 
             - :obj:`help.ConfigSimple <pyrogram.raw.types.help.ConfigSimple>`
+
+    See Also:
+        This object can be returned by 1 method:
+
+        .. hlist::
+            :columns: 2
+
+            - :obj:`help.ConfigSimple <pyrogram.raw.functions.help.ConfigSimple>`
         """
 
         QUALNAME = "pyrogram.raw.base.help.ConfigSimple"

pyrogram/raw/base/input_file_location.py

@@ -49,6 +49,15 @@ class InputFileLocation(metaclass=BaseTypeMeta):  # type: ignore
             - :obj:`InputSecureFileLocation <pyrogram.raw.types.InputSecureFileLocation>`
             - :obj:`InputStickerSetThumb <pyrogram.raw.types.InputStickerSetThumb>`
             - :obj:`InputTakeoutFileLocation <pyrogram.raw.types.InputTakeoutFileLocation>`
+
+    See Also:
+        This object can be returned by 2 methods:
+
+        .. hlist::
+            :columns: 2
+
+            - :obj:`InputPeerPhotoFileLocationLegacy <pyrogram.raw.functions.InputPeerPhotoFileLocationLegacy>`
+            - :obj:`InputStickerSetThumbLegacy <pyrogram.raw.functions.InputStickerSetThumbLegacy>`
         """
 
         QUALNAME = "pyrogram.raw.base.InputFileLocation"

pyrogram/raw/base/ip_port.py

@@ -41,6 +41,15 @@ class IpPort(metaclass=BaseTypeMeta):  # type: ignore
 
             - :obj:`IpPort <pyrogram.raw.types.IpPort>`
             - :obj:`IpPortSecret <pyrogram.raw.types.IpPortSecret>`
+
+    See Also:
+        This object can be returned by 2 methods:
+
+        .. hlist::
+            :columns: 2
+
+            - :obj:`IpPort <pyrogram.raw.functions.IpPort>`
+            - :obj:`IpPortSecret <pyrogram.raw.functions.IpPortSecret>`
         """
 
         QUALNAME = "pyrogram.raw.base.IpPort"

pyrogram/raw/functions/__init__.py

@@ -32,6 +32,15 @@
 from .ping import Ping
 from .ping_delay_disconnect import PingDelayDisconnect
 from .destroy_session import DestroySession
+from .ip_port import IpPort
+from .ip_port_secret import IpPortSecret
+from .access_point_rule import AccessPointRule
+from .input_peer_photo_file_location_legacy import InputPeerPhotoFileLocationLegacy
+from .input_sticker_set_thumb_legacy import InputStickerSetThumbLegacy
+from .invoke_with_business_connection_prefix import InvokeWithBusinessConnectionPrefix
+from .invoke_with_google_play_integrity_prefix import InvokeWithGooglePlayIntegrityPrefix
+from .invoke_with_apns_secret_prefix import InvokeWithApnsSecretPrefix
+from .invoke_with_re_captcha_prefix import InvokeWithReCaptchaPrefix
 from .invoke_after_msg import InvokeAfterMsg
 from .invoke_after_msgs import InvokeAfterMsgs
 from .init_connection import InitConnection
@@ -43,4 +52,5 @@
 from .invoke_with_google_play_integrity import InvokeWithGooglePlayIntegrity
 from .invoke_with_apns_secret import InvokeWithApnsSecret
 from .invoke_with_re_captcha import InvokeWithReCaptcha
-from . import contest, auth, account, users, contacts, messages, updates, photos, upload, help, channels, bots, payments, stickers, phone, langpack, folders, stats, chatlists, stories, premium, smsjobs, fragment
+from .null import Null
+from . import contest, help, auth, account, users, contacts, messages, updates, photos, upload, channels, bots, payments, stickers, phone, langpack, folders, stats, chatlists, stories, premium, smsjobs, fragment

pyrogram/raw/functions/access_point_rule.py

@@ -0,0 +1,85 @@
+#  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 io import BytesIO
+from typing import TYPE_CHECKING, List, Optional, Any
+
+from pyrogram.raw.core.primitives import Int, Long, Int128, Int256, Bool, Bytes, String, Double, Vector
+from pyrogram.raw.core import TLObject
+
+if TYPE_CHECKING:
+    from pyrogram import raw
+
+# # # # # # # # # # # # # # # # # # # # # # # #
+#               !!! WARNING !!!               #
+#          This is a generated file!          #
+# All changes made in this file will be lost! #
+# # # # # # # # # # # # # # # # # # # # # # # #
+
+
+class AccessPointRule(TLObject["raw.base.AccessPointRule"]):
+    """Telegram API method.
+
+    Details:
+        - Layer: ``223``
+        - ID: ``4679B65F``
+
+    Parameters:
+        phone_prefix_rules: ``str``
+        dc_id: ``int`` ``32-bit``
+        ips: List of :obj:`IpPort <pyrogram.raw.base.IpPort>`
+
+    Returns:
+        :obj:`AccessPointRule <pyrogram.raw.base.AccessPointRule>`
+    """
+
+    __slots__: List[str] = ["phone_prefix_rules", "dc_id", "ips"]
+
+    ID = 0x4679b65f
+    QUALNAME = "functions.AccessPointRule"
+
+    def __init__(self, *, phone_prefix_rules: str, dc_id: int, ips: List["raw.base.IpPort"]) -> None:
+        self.phone_prefix_rules = phone_prefix_rules  # string
+        self.dc_id = dc_id  # int
+        self.ips = ips  # vector<IpPort>
+
+    @staticmethod
+    def read(b: BytesIO, *args: Any) -> "AccessPointRule":
+        # No flags
+        
+        phone_prefix_rules = String.read(b)
+        
+        dc_id = Int.read(b)
+        
+        ips = TLObject.read(b)
+        
+        return AccessPointRule(phone_prefix_rules=phone_prefix_rules, dc_id=dc_id, ips=ips)
+
+    def write(self, *args) -> bytes:
+        b = BytesIO()
+        b.write(Int(self.ID, False))
+
+        # No flags
+        
+        b.write(String(self.phone_prefix_rules))
+        
+        b.write(Int(self.dc_id))
+        
+        b.write(Vector(self.ips))
+        
+        return b.getvalue()