@grammyjs/types 3.13.0 → 3.15.0

package/inline.d.ts

@@ -621,7 +621,7 @@ export interface InputInvoiceMessageContent {
     title: string;
     /** Product description, 1-255 characters */
     description: string;
-    /** Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. */
+    /** Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use it for your internal processes. */
     payload: string;
     /** Payment provider token, obtained via @BotFather. Pass an empty string for payments in Telegram Stars. */
     provider_token?: string;

package/manage.d.ts

@@ -535,6 +535,10 @@ export interface ChatInviteLink {
     member_limit?: number;
     /** Number of pending join requests created using this link */
     pending_join_request_count?: number;
+    /** The number of seconds the subscription will be active for before the next payment */
+    subscription_period?: number;
+    /** The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat using the link */
+    subscription_price?: number;
 }
 /** Represents the rights of an administrator in a chat. */
 export interface ChatAdministratorRights {
@@ -842,14 +846,16 @@ export interface ChatBoostSourceGiftCode {
     /** User for which the gift code was created */
     user: User;
 }
-/** The boost was obtained by the creation of a Telegram Premium giveaway. This boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription. */
+/** The boost was obtained by the creation of a Telegram Premium or a Telegram Star giveaway. This boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription for Telegram Premium giveaways and prize_star_count / 500 times for one year for Telegram Star giveaways. */
 export interface ChatBoostSourceGiveaway {
     /** Source of the boost, always “giveaway” */
     source: "giveaway";
     /** Identifier of a message in the chat with the giveaway; the message could have been deleted already */
     giveaway_message_id: number;
-    /** User that won the prize in the giveaway if any */
+    /** User that won the prize in the giveaway if any; for Telegram Premium giveaways only */
     user?: User;
+    /** The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only */
+    prize_star_count?: number;
     /** True, if the giveaway was completed, but there was no user to win the prize */
     is_unclaimed?: true;
 }

package/markup.d.ts

@@ -40,6 +40,10 @@ export declare namespace InlineKeyboardButton {
         /** If set, pressing the button will prompt the user to select one of their chats of the specified type, open that chat and insert the bot's username and the specified inline query in the input field. Not supported for messages sent on behalf of a Telegram Business account. */
         switch_inline_query_chosen_chat: SwitchInlineQueryChosenChat;
     }
+    interface CopyTextButtonButton extends AbstractInlineKeyboardButton {
+        /** Description of the button that copies the specified text to the clipboard. */
+        copy_text: CopyTextButton;
+    }
     interface GameButton extends AbstractInlineKeyboardButton {
         /** Description of the game that will be launched when the user presses the button.
     
@@ -54,7 +58,7 @@ export declare namespace InlineKeyboardButton {
     }
 }
 /** This object represents one button of an inline keyboard. You must use exactly one of the optional fields. */
-export type InlineKeyboardButton = InlineKeyboardButton.CallbackButton | InlineKeyboardButton.GameButton | InlineKeyboardButton.LoginButton | InlineKeyboardButton.PayButton | InlineKeyboardButton.SwitchInlineButton | InlineKeyboardButton.SwitchInlineCurrentChatButton | InlineKeyboardButton.SwitchInlineChosenChatButton | InlineKeyboardButton.UrlButton | InlineKeyboardButton.WebAppButton;
+export type InlineKeyboardButton = InlineKeyboardButton.CallbackButton | InlineKeyboardButton.GameButton | InlineKeyboardButton.LoginButton | InlineKeyboardButton.PayButton | InlineKeyboardButton.SwitchInlineButton | InlineKeyboardButton.SwitchInlineCurrentChatButton | InlineKeyboardButton.SwitchInlineChosenChatButton | InlineKeyboardButton.CopyTextButtonButton | InlineKeyboardButton.UrlButton | InlineKeyboardButton.WebAppButton;
 /** This object represents a parameter of the inline keyboard button used to automatically authorize a user. Serves as a great replacement for the Telegram Login Widget when the user is coming from Telegram. All the user needs to do is tap/click a button and confirm that they want to log in.
 Telegram apps support these buttons as of version 5.7. */
 export interface LoginUrl {
@@ -184,6 +188,11 @@ export interface ForceReply {
     /** Use this parameter if you want to force reply from specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot's message is a reply to a message in the same chat and forum topic, sender of the original message. */
     selective?: boolean;
 }
+/** This object represents an inline keyboard button that copies specified text to the clipboard. */
+export interface CopyTextButton {
+    /** The text to be copied to the clipboard; 1-256 characters */
+    text: string;
+}
 /** Describes a Web App. */
 export interface WebAppInfo {
     /** An HTTPS URL of a Web App to be opened with additional data as specified in Initializing Web Apps */

package/message.d.ts

@@ -5,7 +5,7 @@ import type { Invoice, RefundedPayment, SuccessfulPayment } from "./payment.js";
 type MsgWith<P extends keyof Message> = Record<P, NonNullable<Message[P]>>;
 export declare namespace Message {
     interface ServiceMessage {
-        /** Unique message identifier inside this chat */
+        /** Unique message identifier inside this chat. In specific instances (e.g., message containing a video sent to a big chat), the server might automatically schedule a message instead of sending it immediately. In such cases, this field will be 0 and the relevant message will be unusable until it is actually sent */
         message_id: number;
         /** Unique identifier of a message thread or a forum topic to which the message belongs; for supergroups only */
         message_thread_id?: number;
@@ -245,7 +245,7 @@ export interface Message extends Message.MediaMessage {
 }
 /** This object represents a unique message identifier. */
 export interface MessageId {
-    /** Unique message identifier */
+    /** Unique message identifier. In specific instances (e.g., message containing a video sent to a big chat), the server might automatically schedule a message instead of sending it immediately. In such cases, this field will be 0 and the relevant message will be unusable until it is actually sent */
     message_id: number;
 }
 /** Describes an inline message sent by a Web App on behalf of a user. */
@@ -381,7 +381,7 @@ Please note:
 export type ParseMode = "Markdown" | "MarkdownV2" | "HTML";
 export declare namespace MessageEntity {
     interface AbstractMessageEntity {
-        /** Type of the entity. Currently, can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers) */
+        /** Type of the entity. Currently, can be “mention” (@username), “hashtag” (#hashtag or #hashtag@chatusername), “cashtag” ($USD or $USD@chatusername), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers) */
         type: string;
         /** Offset in UTF-16 code units to the start of the entity */
         offset: number;
@@ -1020,8 +1020,10 @@ export interface VideoChatParticipantsInvited {
     /** New members that were invited to the video chat */
     users: User[];
 }
-/** This object represents a service message about the creation of a scheduled giveaway. Currently holds no information. */
+/** This object represents a service message about the creation of a scheduled giveaway. */
 export interface GiveawayCreated {
+    /** The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only */
+    prize_star_count?: number;
 }
 /** This object represents a message about a scheduled giveaway. */
 export interface Giveaway {
@@ -1039,7 +1041,9 @@ export interface Giveaway {
     prize_description?: string;
     /** A list of two-letter ISO 3166-1 alpha-2 country codes indicating the countries from which eligible users for the giveaway must come. If empty, then all users can participate in the giveaway. Users with a phone number that was bought on Fragment can always participate in giveaways. */
     country_codes?: string[];
-    /** The number of months the Telegram Premium subscription won from the giveaway will be active for */
+    /** The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only */
+    prize_star_count?: number;
+    /** The number of months the Telegram Premium subscription won from the giveaway will be active for; for Telegram Premium giveaways only */
     premium_subscription_month_count?: number;
 }
 /** This object represents a message about the completion of a giveaway with public winners. */
@@ -1056,7 +1060,9 @@ export interface GiveawayWinners {
     winners: User[];
     /** The number of other chats the user had to join in order to be eligible for the giveaway */
     additional_chat_count?: number;
-    /** The number of months the Telegram Premium subscription won from the giveaway will be active for */
+    /** The number of Telegram Stars that were split between giveaway winners; for Telegram Star giveaways only */
+    prize_star_count?: number;
+    /** The number of months the Telegram Premium subscription won from the giveaway will be active for; for Telegram Premium giveaways only */
     premium_subscription_month_count?: number;
     /** Number of undistributed prizes */
     unclaimed_prize_count?: number;
@@ -1075,6 +1081,8 @@ export interface GiveawayCompleted {
     unclaimed_prize_count?: number;
     /** Message with the giveaway that was completed, if it wasn't deleted */
     giveaway_message?: Message;
+    /** True, if the giveaway is a Telegram Star giveaway. Otherwise, currently, the giveaway is a Telegram Premium giveaway. */
+    is_star_giveaway?: true;
 }
 /** Describes the options used for link preview generation. */
 export interface LinkPreviewOptions {

package/methods.d.ts

@@ -94,6 +94,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -155,6 +157,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
         /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
@@ -203,6 +207,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -242,6 +248,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -275,6 +283,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -318,6 +328,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -359,6 +371,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -390,6 +404,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -420,6 +436,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -435,14 +453,16 @@ export type ApiMethods<F> = {
         business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
-        /** An array describing messages to be sent, must include 2-10 items */
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** An array describing messages to be sent, must include 2-10 items */
         media: ReadonlyArray<InputMediaAudio<F> | InputMediaDocument<F> | InputMediaPhoto<F> | InputMediaVideo<F>>;
         /** Sends the messages silently. Users will receive a notification with no sound. */
         disable_notification?: boolean;
         /** Protects the contents of the sent messages from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -474,6 +494,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -527,10 +549,12 @@ export type ApiMethods<F> = {
         business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance. */
         chat_id: number | string;
-        /** The number of Telegram Stars that must be paid to buy access to the media */
+        /** The number of Telegram Stars that must be paid to buy access to the media; 1-2500 */
         star_count: number;
         /** An array describing the media to be sent; up to 10 items */
         media: InputPaidMedia<F>[];
+        /** Bot-defined paid media payload, 0-128 bytes. This will not be displayed to the user, use it for your internal processes. */
+        payload?: string;
         /** Media caption, 0-1024 characters after entities parsing */
         caption?: string;
         /** Mode for parsing entities in the media caption. See formatting options for more details. */
@@ -543,6 +567,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
         /** Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user */
@@ -576,6 +602,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -605,6 +633,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -654,6 +684,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -672,11 +704,13 @@ export type ApiMethods<F> = {
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
         /** Emoji on which the dice throw animation is based. Currently, must be one of "🎲", "🎯", "🏀", "⚽", "🎳", or "🎰". Dice can have values 1-6 for "🎲", "🎯" and "🎳", values 1-5 for "🏀" and "⚽", and values 1-64 for "🎰". Defaults to "🎲" */
-        emoji?: string;
+        emoji?: (string & Record<never, never>) | "🎲" | "🎯" | "🏀" | "⚽" | "🎳" | "🎰";
         /** Sends the message silently. Users will receive a notification with no sound. */
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -1240,7 +1274,7 @@ export type ApiMethods<F> = {
         /** An object for an inline keyboard. */
         reply_markup?: InlineKeyboardMarkup;
     }): (Update.Edited & Message.CaptionableMessage) | true;
-    /** Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within 48 hours from the time they were sent. */
+    /** Use this method to edit animation, audio, document, photo, or video messages, or to add media to text messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within 48 hours from the time they were sent. */
     editMessageMedia(args: {
         /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
         business_connection_id?: string;
@@ -1318,6 +1352,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -1479,7 +1515,7 @@ export type ApiMethods<F> = {
         title: string;
         /** Product description, 1-255 characters */
         description: string;
-        /** Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. */
+        /** Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use it for your internal processes. */
         payload: string;
         /** Payment provider token, obtained via BotFather. Pass an empty string for payments in Telegram Stars. */
         provider_token?: string;
@@ -1521,6 +1557,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -1536,7 +1574,7 @@ export type ApiMethods<F> = {
         title: string;
         /** Product description, 1-255 characters */
         description: string;
-        /** Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes. */
+        /** Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use it for your internal processes. */
         payload: string;
         /** Payment provider token, obtained via @BotFather. Pass an empty string for payments in Telegram Stars. */
         provider_token?: string;
@@ -1630,6 +1668,8 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
+        /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
+        allow_paid_broadcast?: boolean;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grammyjs/types",
-  "version": "3.13.0",
+  "version": "3.15.0",
   "description": "Telegram Bot API type declarations for grammY",
   "main": "mod.js",
   "repository": {
@@ -15,7 +15,7 @@
     "types"
   ],
   "scripts": {
-    "prepare": "deno task backport"
+    "prepare": "deno task build"
   },
   "author": "KnorpelSenf",
   "types": "mod.d.ts",

package/payment.d.ts

@@ -143,8 +143,9 @@ export interface RevenueWithdrawalStateFailed {
 - TransactionPartnerUser
 - TransactionPartnerFragment
 - TransactionPartnerTelegramAds
+- TransactionPartnerTelegramApi
 - TransactionPartnerOther */
-export type TransactionPartner = TransactionPartnerUser | TransactionPartnerFragment | TransactionPartnerTelegramAds | TransactionPartnerOther;
+export type TransactionPartner = TransactionPartnerUser | TransactionPartnerFragment | TransactionPartnerTelegramAds | TransactionPartnerTelegramApi | TransactionPartnerOther;
 /** Describes a transaction with a user. */
 export interface TransactionPartnerUser {
     /** Type of the transaction partner, always “user” */
@@ -155,6 +156,8 @@ export interface TransactionPartnerUser {
     invoice_payload?: string;
     /** Information about the paid media bought by the user */
     paid_media?: PaidMedia[];
+    /** Bot-specified paid media payload */
+    paid_media_payload?: string;
 }
 /** Describes a withdrawal transaction with Fragment. */
 export interface TransactionPartnerFragment {
@@ -168,6 +171,13 @@ export interface TransactionPartnerTelegramAds {
     /** Type of the transaction partner, always “telegram_ads” */
     type: "telegram_ads";
 }
+/** Describes a transaction with payment for paid broadcasting. */
+export interface TransactionPartnerTelegramApi {
+    /** Type of the transaction partner, always “telegram_api” */
+    type: "telegram_api";
+    /** The number of successful requests that exceeded regular limits and were therefore billed */
+    request_count: number;
+}
 /** Describes a transaction with an unknown source or recipient. */
 export interface TransactionPartnerOther {
     /** Type of the transaction partner, always “other” */
@@ -175,7 +185,7 @@ export interface TransactionPartnerOther {
 }
 /** Describes a Telegram Star transaction. */
 export interface StarTransaction {
-    /** Unique identifier of the transaction. Coincides with the identifer of the original transaction for refund transactions. Coincides with SuccessfulPayment.telegram_payment_charge_id for successful incoming payments from users. */
+    /** Unique identifier of the transaction. Coincides with the identifier of the original transaction for refund transactions. Coincides with SuccessfulPayment.telegram_payment_charge_id for successful incoming payments from users. */
     id: string;
     /** Number of Telegram Stars transferred by the transaction */
     amount: number;
@@ -191,3 +201,10 @@ export interface StarTransactions {
     /** The list of transactions */
     transactions: StarTransaction[];
 }
+/** This object contains information about a paid media purchase. */
+export interface PaidMediaPurchased {
+    /** User who purchased the media */
+    from: User;
+    /** Bot-specified paid media payload */
+    paid_media_payload: string;
+}

package/update.d.ts

@@ -2,7 +2,7 @@ import type { ChosenInlineResult, InlineQuery } from "./inline.js";
 import type { BusinessConnection, BusinessMessagesDeleted, Chat, ChatBoostRemoved, ChatBoostUpdated, ChatJoinRequest, ChatMemberUpdated, User } from "./manage.js";
 import type { CallbackQuery } from "./markup.js";
 import type { Message, MessageReactionCountUpdated, MessageReactionUpdated, Poll, PollAnswer } from "./message.js";
-import type { PreCheckoutQuery, ShippingQuery } from "./payment.js";
+import type { PaidMediaPurchased, PreCheckoutQuery, ShippingQuery } from "./payment.js";
 /** Internal namespace used to make some message types more accurate */
 export declare namespace Update {
     /** Internal type holding properties that message updates in private chats share. */
@@ -73,4 +73,6 @@ export interface Update {
     chat_boost?: ChatBoostUpdated;
     /** A boost was removed from a chat. The bot must be an administrator in the chat to receive these updates. */
     removed_chat_boost?: ChatBoostRemoved;
+    /** A user purchased paid media with a non-empty payload sent by the bot in a non-channel chat */
+    purchased_paid_media?: PaidMediaPurchased;
 }