@mtcute/tl 206.0.0 → 208.0.0

package/index.d.ts

@@ -1,6 +1,6 @@
 import _Long from 'long';
 export declare namespace tl {
-    const LAYER = 206;
+    const LAYER = 208;
 
     function $extendTypes(types: Record<string, string>): void
 
@@ -972,8 +972,10 @@ export class RpcError extends Error {
     interface RawInputMediaUploadedDocument {
         _: 'inputMediaUploadedDocument';
         /**
-         * Whether the specified document is a video file with no audio
-         * tracks (a GIF animation (even as MPEG4), for example)
+         * Whether to send the file as a video even if it doesn't have
+         * an audio track (i.e. if set, the
+         * {@link RawDocumentAttributeAnimated} attribute will
+         * <strong>not</strong> be set even for videos without audio)
          */
         nosoundVideo?: boolean;
         /**
@@ -8839,13 +8841,7 @@ export class RpcError extends Error {
      */
     interface RawUpdateBroadcastRevenueTransactions {
         _: 'updateBroadcastRevenueTransactions';
-        /**
-         * Channel
-         */
         peer: tl.TypePeer;
-        /**
-         * New ad revenue balance.
-         */
         balances: tl.TypeBroadcastRevenueBalances;
     }
     /**
@@ -10605,7 +10601,7 @@ export class RpcError extends Error {
         supportsStreaming?: boolean;
         /**
          * Whether the specified document is a video file with no audio
-         * tracks (a GIF animation (even as MPEG4), for example)
+         * tracks
          */
         nosound?: boolean;
         /**
@@ -10831,6 +10827,8 @@ export class RpcError extends Error {
          * 
          * - <code>telegram_livestream</code>
          * 
+         * - <code>telegram_call</code>
+         * 
          * - <code>telegram_user</code>
          * 
          * - <code>telegram_botapp</code>
@@ -18482,6 +18480,12 @@ export class RpcError extends Error {
      * (<code>ios-android</code>, <code>ios-wp</code>), unknown
      * platforms are to be ignored. The <code>text</code> is the
      * error message that should be shown to the user.
+     * 
+     * The
+     * <a href="https://corefork.telegram.org/api/config#restriction-add-platforms">restriction_add_platforms
+     * »</a> client configuration parameter contains an array of
+     * platform identifiers that must also be treated as our own,
+     * in additional to the one hardcoded in the client.
      */
     interface RawRestrictionReason {
         _: 'restrictionReason';
@@ -18493,7 +18497,10 @@ export class RpcError extends Error {
         platform: string;
         /**
          * Restriction reason (<code>porno</code>, <code>terms</code>,
-         * etc.)
+         * etc.). Ignore this restriction reason if it is contained in
+         * the
+         * <a href="https://corefork.telegram.org/api/config#ignore-restriction-reasons">ignore_restriction_reasons
+         * »</a> client configuration parameter.
          */
         reason: string;
         /**
@@ -19230,8 +19237,16 @@ export class RpcError extends Error {
          * in the UI, returning a list of booleans that directly
          * specify whether we can or cannot write to each user. 
          * 
+         * This option may be enabled by both
+         * non-<a href="https://corefork.telegram.org/api/premium">Premium</a>
+         * and
          * <a href="https://corefork.telegram.org/api/premium">Premium</a>
-         * users only, non-Premium users will receive a
+         * users only if the
+         * <a href="https://corefork.telegram.org/api/config#new-noncontact-peers-require-premium-without-ownpremium">new_noncontact_peers_require_premium_without_ownpremium
+         * client configuration flag »</a> is equal to true, otherwise
+         * it may be enabled only by
+         * <a href="https://corefork.telegram.org/api/premium">Premium</a>
+         * users and non-Premium users will receive a
          * <code>PREMIUM_ACCOUNT_REQUIRED</code> error when trying to
          * enable this flag.
          */
@@ -19328,6 +19343,7 @@ export class RpcError extends Error {
          * code units</a>).
          */
         quoteOffset?: number;
+        todoItemId?: number;
     }
     /**
      * Represents a reply to a
@@ -22161,6 +22177,7 @@ export class RpcError extends Error {
          */
         quoteOffset?: number;
         monoforumPeerId?: tl.TypeInputPeer;
+        todoItemId?: number;
     }
     /**
      * Reply to a story.
@@ -23758,17 +23775,8 @@ export class RpcError extends Error {
      */
     interface RawBroadcastRevenueTransactionProceeds {
         _: 'broadcastRevenueTransactionProceeds';
-        /**
-         * Amount in the smallest unit of the cryptocurrency.
-         */
         amount: Long;
-        /**
-         * Start unixtime for the timeframe.
-         */
         fromDate: number;
-        /**
-         * End unixtime for the timeframe.
-         */
         toDate: number;
     }
     /**
@@ -23778,39 +23786,12 @@ export class RpcError extends Error {
      */
     interface RawBroadcastRevenueTransactionWithdrawal {
         _: 'broadcastRevenueTransactionWithdrawal';
-        /**
-         * Whether the withdrawal is currently pending
-         */
         pending?: boolean;
-        /**
-         * Whether the withdrawal has failed
-         */
         failed?: boolean;
-        /**
-         * Amount withdrawn
-         */
         amount: Long;
-        /**
-         * Withdrawal date
-         */
         date: number;
-        /**
-         * Payment provider name
-         */
         provider: string;
-        /**
-         * If neither <code>pending</code> nor <code>failed</code> are
-         * set, the transaction was completed successfully, and this
-         * field will contain the point in time (UNIX timestamp in
-         * seconds) when the withdrawal was completed successfully.
-         */
         transactionDate?: number;
-        /**
-         * If neither <code>pending</code> nor <code>failed</code> are
-         * set, the transaction was completed successfully, and this
-         * field will contain a URL where the withdrawal transaction
-         * can be viewed.
-         */
         transactionUrl?: string;
     }
     /**
@@ -23820,17 +23801,8 @@ export class RpcError extends Error {
      */
     interface RawBroadcastRevenueTransactionRefund {
         _: 'broadcastRevenueTransactionRefund';
-        /**
-         * Amount refunded.
-         */
         amount: Long;
-        /**
-         * Date of refund.
-         */
         date: number;
-        /**
-         * Payment provider name.
-         */
         provider: string;
     }
     /**
@@ -23893,25 +23865,9 @@ export class RpcError extends Error {
      */
     interface RawBroadcastRevenueBalances {
         _: 'broadcastRevenueBalances';
-        /**
-         * If set, the available balance can be
-         * <a href="https://corefork.telegram.org/api/revenue#withdrawing-revenue">withdrawn
-         * »</a>.
-         */
         withdrawalEnabled?: boolean;
-        /**
-         * Amount of not-yet-withdrawn cryptocurrency.
-         */
         currentBalance: Long;
-        /**
-         * Amount of withdrawable cryptocurrency, out of the currently
-         * available balance (<code>available_balance <=
-         * current_balance</code>).
-         */
         availableBalance: Long;
-        /**
-         * Total amount of earned cryptocurrency.
-         */
         overallRevenue: Long;
     }
     /**
@@ -24682,6 +24638,7 @@ export class RpcError extends Error {
         upgradeStars?: Long;
         resellMinStars?: Long;
         title?: string;
+        releasedBy?: tl.TypePeer;
     }
     interface RawStarGiftUnique {
         _: 'starGiftUnique';
@@ -24697,6 +24654,7 @@ export class RpcError extends Error {
         availabilityTotal: number;
         giftAddress?: string;
         resellStars?: Long;
+        releasedBy?: tl.TypePeer;
     }
     /**
      * Report menu option
@@ -24823,7 +24781,11 @@ export class RpcError extends Error {
         endDate?: number;
         /**
          * The amount of daily revenue per user in Telegram Stars of
-         * the bot that created the affiliate program
+         * the bot that created the affiliate program. 
+         * 
+         * To obtain the approximated revenue per referred user,
+         * multiply this value by <code>commission_permille</code> and
+         * divide by <code>1000</code>.
          */
         dailyRevenuePerUser?: tl.TypeStarsAmount;
     }
@@ -25106,38 +25068,10 @@ export class RpcError extends Error {
      */
     interface RawPremiumGiftOption {
         _: 'premiumGiftOption';
-        /**
-         * Duration of gifted Telegram Premium subscription
-         */
         months: number;
-        /**
-         * Three-letter ISO 4217
-         * <a href="https://corefork.telegram.org/bots/payments#supported-currencies">currency</a>
-         * code
-         */
         currency: string;
-        /**
-         * Price of the product in the smallest units of the currency
-         * (integer, not float/double). For example, for a price of
-         * <code>US$ 1.45</code> pass <code>amount = 145</code>. See
-         * the exp parameter in
-         * <a href="https://corefork.telegram.org/bots/payments/currencies.json">currencies.json</a>,
-         * it shows the number of digits past the decimal point for
-         * each currency (2 for the majority of currencies).
-         */
         amount: Long;
-        /**
-         * An
-         * <a href="https://corefork.telegram.org/api/links#invoice-links">invoice
-         * deep link »</a> to an invoice for in-app payment, using the
-         * official Premium bot; may be empty if direct payment isn't
-         * available.
-         */
         botUrl: string;
-        /**
-         * An identifier for the App Store/Play Store product
-         * associated with the Premium gift.
-         */
         storeProduct?: string;
     }
     /**
@@ -25147,14 +25081,7 @@ export class RpcError extends Error {
      */
     interface RawEmojiStatusUntil {
         _: 'emojiStatusUntil';
-        /**
-         * <a href="https://corefork.telegram.org/api/custom-emoji">Custom
-         * emoji document ID</a>
-         */
         documentId: Long;
-        /**
-         * This status is valid until this date
-         */
         until: number;
     }
     /**
@@ -25164,51 +25091,13 @@ export class RpcError extends Error {
      */
     interface RawUserStarGift {
         _: 'userStarGift';
-        /**
-         * If set, <code>from_id</code> will not be visible to users
-         * (it will still be visible to the receiver of the gift).
-         */
         nameHidden?: boolean;
-        /**
-         * If set, indicates this is a gift sent by
-         * <code>from_id</code>, received by the current user and
-         * currently hidden from our profile page.
-         */
         unsaved?: boolean;
-        /**
-         * Sender of the gift (may be empty for anonymous senders; will
-         * always be set if this gift was sent to us).
-         */
         fromId?: number;
-        /**
-         * When was this gift sent.
-         */
         date: number;
-        /**
-         * The gift.
-         */
         gift: tl.TypeStarGift;
-        /**
-         * Message attached to the gift by the sender.
-         */
         message?: tl.TypeTextWithEntities;
-        /**
-         * Only visible to the receiver of the gift, contains the ID of
-         * the {@link RawMessageService} with the
-         * {@link RawMessageActionStarGift} in the chat with
-         * <code>from_id</code>.
-         */
         msgId?: number;
-        /**
-         * The receiver of this gift may convert it to this many
-         * Telegram Stars, instead of displaying it on their profile
-         * page.
-         * 
-         * <code>convert_stars</code> will be equal to the buying price
-         * of the gift only if the gift was bought using recently
-         * bought Telegram Stars, otherwise it will be less than
-         * <code>stars</code>.
-         */
         convertStars?: Long;
     }
     /**
@@ -37427,7 +37316,7 @@ export class RpcError extends Error {
              *  
              * 
              * If the user explicitly chose to make their paid reaction(s)
-             * private, pass true to
+             * not private, pass true to
              * {@link messages.RawSendPaidReactionRequest}.<code>private</code>.
              *  
              * 
@@ -44182,6 +44071,8 @@ export class RpcError extends Error {
              * List of available gifts.
              */
             gifts: tl.TypeStarGift[];
+            chats: tl.TypeChat[];
+            users: tl.TypeUser[];
         }
         /**
          * Active
@@ -44269,22 +44160,9 @@ export class RpcError extends Error {
          */
         interface RawUserStarGifts {
             _: 'payments.userStarGifts';
-            /**
-             * Total number of gifts displayed on the profile.
-             */
             count: number;
-            /**
-             * The gifts.
-             */
             gifts: tl.TypeUserStarGift[];
-            /**
-             * Offset for
-             * <a href="https://corefork.telegram.org/api/offsets">pagination</a>.
-             */
             nextOffset?: string;
-            /**
-             * Users mentioned in the <code>gifts</code> vector.
-             */
             users: tl.TypeUser[];
         }
         /**
@@ -45104,6 +44982,11 @@ export class RpcError extends Error {
             sortByValue?: boolean;
             peer: tl.TypeInputPeer;
             offset: string;
+            /**
+             * Maximum number of results to return,
+             * <a href="https://corefork.telegram.org/api/offsets">see
+             * pagination</a>
+             */
             limit: number;
         }
         /**
@@ -45156,6 +45039,11 @@ export class RpcError extends Error {
             giftId: Long;
             attributes?: tl.TypeStarGiftAttributeId[];
             offset: string;
+            /**
+             * Maximum number of results to return,
+             * <a href="https://corefork.telegram.org/api/offsets">see
+             * pagination</a>
+             */
             limit: number;
         }
         /**
@@ -45175,9 +45063,6 @@ export class RpcError extends Error {
          */
         interface RawCanPurchasePremiumRequest {
             _: 'payments.canPurchasePremium';
-            /**
-             * Payment purpose
-             */
             purpose: tl.TypeInputStorePaymentPurpose;
         }
         /**
@@ -45192,23 +45077,8 @@ export class RpcError extends Error {
          */
         interface RawGetUserStarGiftsRequest {
             _: 'payments.getUserStarGifts';
-            /**
-             * Identifier of the user (can be the current user to fetch all
-             * gifts received by the current user).
-             */
             userId: tl.TypeInputUser;
-            /**
-             * Offset for
-             * <a href="https://corefork.telegram.org/api/offsets">pagination</a>,
-             * taken from {@link payments.RawUserStarGifts} (initially
-             * empty).
-             */
             offset: string;
-            /**
-             * Maximum number of results to return,
-             * <a href="https://corefork.telegram.org/api/offsets">see
-             * pagination</a>
-             */
             limit: number;
         }
         interface RpcCallReturn {
@@ -46233,6 +46103,11 @@ export class RpcError extends Error {
             call: tl.TypeInputGroupCall;
             subChainId: number;
             offset: number;
+            /**
+             * Maximum number of results to return,
+             * <a href="https://corefork.telegram.org/api/offsets">see
+             * pagination</a>
+             */
             limit: number;
         }
         interface RpcCallReturn {
@@ -46607,25 +46482,9 @@ export class RpcError extends Error {
          */
         interface RawBroadcastRevenueStats {
             _: 'stats.broadcastRevenueStats';
-            /**
-             * Ad impressions graph
-             */
             topHoursGraph: tl.TypeStatsGraph;
-            /**
-             * Ad revenue graph (in the smallest unit of the cryptocurrency
-             * in which revenue is calculated)
-             */
             revenueGraph: tl.TypeStatsGraph;
-            /**
-             * Current balance, current withdrawable balance and overall
-             * revenue
-             */
             balances: tl.TypeBroadcastRevenueBalances;
-            /**
-             * Current conversion rate of the cryptocurrency
-             * (<strong>not</strong> in the smallest unit) in which revenue
-             * is calculated to USD
-             */
             usdRate: Double;
         }
         /**
@@ -46635,11 +46494,6 @@ export class RpcError extends Error {
          */
         interface RawBroadcastRevenueWithdrawalUrl {
             _: 'stats.broadcastRevenueWithdrawalUrl';
-            /**
-             * A unique URL to a Fragment page where the user will be able
-             * to specify and submit the address of the TON wallet where
-             * the funds will be sent.
-             */
             url: string;
         }
         /**
@@ -46648,13 +46502,7 @@ export class RpcError extends Error {
          */
         interface RawBroadcastRevenueTransactions {
             _: 'stats.broadcastRevenueTransactions';
-            /**
-             * Total number of transactions.
-             */
             count: number;
-            /**
-             * Transactions
-             */
             transactions: tl.TypeBroadcastRevenueTransaction[];
         }
         /**
@@ -46833,13 +46681,7 @@ export class RpcError extends Error {
          */
         interface RawGetBroadcastRevenueStatsRequest {
             _: 'stats.getBroadcastRevenueStats';
-            /**
-             * Whether to enable dark theme for graph colors
-             */
             dark?: boolean;
-            /**
-             * Get ad revenue stats for the specified channel or bot
-             */
             peer: tl.TypeInputPeer;
         }
         /**
@@ -46852,16 +46694,7 @@ export class RpcError extends Error {
          */
         interface RawGetBroadcastRevenueWithdrawalUrlRequest {
             _: 'stats.getBroadcastRevenueWithdrawalUrl';
-            /**
-             * Get ad revenue withdrawal URL for the specified channel or
-             * bot
-             */
             peer: tl.TypeInputPeer;
-            /**
-             * 2FA password, see
-             * <a href="https://corefork.telegram.org/api/srp#using-the-2fa-password">here
-             * »</a> for more info.
-             */
             password: tl.TypeInputCheckPasswordSRP;
         }
         /**
@@ -46874,20 +46707,8 @@ export class RpcError extends Error {
          */
         interface RawGetBroadcastRevenueTransactionsRequest {
             _: 'stats.getBroadcastRevenueTransactions';
-            /**
-             * Get ad revenue transactions for the specified channel or bot
-             */
             peer: tl.TypeInputPeer;
-            /**
-             * <a href="https://corefork.telegram.org/api/offsets">Offset
-             * for pagination</a>
-             */
             offset: number;
-            /**
-             * Maximum number of results to return,
-             * <a href="https://corefork.telegram.org/api/offsets">see
-             * pagination</a>
-             */
             limit: number;
         }
         interface RpcCallReturn {
@@ -47316,9 +47137,6 @@ export class RpcError extends Error {
          */
         interface RawGetIsPremiumRequiredToContactRequest {
             _: 'users.getIsPremiumRequiredToContact';
-            /**
-             * Users to fetch info about.
-             */
             id: tl.TypeInputUser[];
         }
         interface RpcCallReturn {