@grammyjs/types 3.3.1 → 3.4.1

package/methods.d.ts

@@ -1,7 +1,7 @@
 import type { InlineQueryResult, InlineQueryResultsButton } from "./inline.js";
-import type { BotCommand, ChatAdministratorRights, ChatFromGetChat, ChatInviteLink, ChatMember, ChatMemberAdministrator, ChatMemberOwner, ChatPermissions, File, ForumTopic, UserFromGetMe, UserProfilePhotos, WebhookInfo } from "./manage.js";
+import type { BotCommand, ChatAdministratorRights, ChatFromGetChat, ChatInviteLink, ChatMember, ChatMemberAdministrator, ChatMemberOwner, ChatPermissions, ForumTopic, UserChatBoosts, UserFromGetMe, UserProfilePhotos, WebhookInfo } from "./manage.js";
 import type { ForceReply, InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove } from "./markup.js";
-import type { GameHighScore, MaskPosition, Message, MessageEntity, MessageId, ParseMode, Poll, SentWebAppMessage, Sticker, StickerSet } from "./message.js";
+import type { GameHighScore, LinkPreviewOptions, MaskPosition, Message, MessageEntity, MessageId, ParseMode, Poll, ReactionType, ReplyParameters, SentWebAppMessage, Sticker, StickerSet } from "./message.js";
 import type { PassportElementError } from "./passport.js";
 import type { LabeledPrice, ShippingOption } from "./payment.js";
 import type { BotCommandScope, BotDescription, BotName, BotShortDescription, MenuButton } from "./settings.js";
@@ -26,7 +26,7 @@ export type ApiMethods<F> = {
         limit?: number;
         /** Timeout in seconds for long polling. Defaults to 0, i.e. usual short polling. Should be positive, short polling should be used for testing purposes only. */
         timeout?: number;
-        /** A list of the update types you want your bot to receive. For example, specify [“message”, “edited_channel_post”, “callback_query”] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member (default). If not specified, the previous setting will be used.
+        /** A list of the update types you want your bot to receive. For example, specify ["message", "edited_channel_post", "callback_query"] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member, message_reaction, and message_reaction_count (default). If not specified, the previous setting will be used.
     
         Please note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time. */
         allowed_updates?: ReadonlyArray<Exclude<keyof Update, "update_id">>;
@@ -50,7 +50,7 @@ export type ApiMethods<F> = {
         ip_address?: string;
         /** The maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to 40. Use lower values to limit the load on your bot's server, and higher values to increase your bot's throughput. */
         max_connections?: number;
-        /** A list of the update types you want your bot to receive. For example, specify [“message”, “edited_channel_post”, “callback_query”] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member (default). If not specified, the previous setting will be used.
+        /** A list of the update types you want your bot to receive. For example, specify ["message", "edited_channel_post", "callback_query"] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member, message_reaction, and message_reaction_count (default). If not specified, the previous setting will be used.
     
         Please note that this parameter doesn't affect updates created before the call to the setWebhook, so unwanted updates may be received for a short period of time. */
         allowed_updates?: ReadonlyArray<Exclude<keyof Update, "update_id">>;
@@ -84,20 +84,20 @@ export type ApiMethods<F> = {
         parse_mode?: ParseMode;
         /** A list of special entities that appear in message text, which can be specified instead of parse_mode */
         entities?: MessageEntity[];
-        /** Boolean Disables link previews for links in this message */
-        disable_web_page_preview?: boolean;
+        /** Link preview generation options for the message */
+        link_preview_options?: LinkPreviewOptions;
         /** Sends the message silently. Users will receive a notification with no sound. */
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.TextMessage;
-    /** Use this method to forward messages of any kind. Service messages can't be forwarded. On success, the sent Message is returned. */
+    /** Use this method to forward messages of any kind. Service messages and messages with protected content can't be forwarded. On success, the sent Message is returned. */
     forwardMessage(args: {
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
@@ -112,7 +112,22 @@ export type ApiMethods<F> = {
         /** Message identifier in the chat specified in from_chat_id */
         message_id: number;
     }): Message;
-    /** Use this method to copy messages of any kind. Service messages and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success. */
+    /** Use this method to forward multiple messages of any kind. If some of the specified messages can't be found or forwarded, they are skipped. Service messages and messages with protected content can't be forwarded. Album grouping is kept for forwarded messages. On success, an array of MessageId of the sent messages is returned. */
+    forwardMessages(args: {
+        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+        chat_id: number | string;
+        /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
+        message_thread_id?: number;
+        /** Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername) */
+        from_chat_id: number | string;
+        /** Identifiers of 1-100 messages in the chat from_chat_id to forward. The identifiers must be specified in a strictly increasing order. */
+        message_ids: number[];
+        /** Sends the messages silently. Users will receive a notification with no sound. */
+        disable_notification?: boolean;
+        /** Protects the contents of the forwarded messages from forwarding and saving */
+        protect_content?: boolean;
+    }): MessageId[];
+    /** Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success. */
     copyMessage(args: {
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
@@ -132,13 +147,30 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): MessageId;
+    /** Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned. */
+    copyMessages(args: {
+        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+        chat_id: number | string;
+        /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
+        message_thread_id?: number;
+        /** Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername) */
+        from_chat_id: number | string;
+        /** Identifiers of 1-100 messages in the chat from_chat_id to copy. The identifiers must be specified in a strictly increasing order. */
+        message_ids: number[];
+        /** 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 copy the messages without their captions */
+        remove_caption?: boolean;
+    }): MessageId[];
     /** Use this method to send photos. On success, the sent Message is returned. */
     sendPhoto(args: {
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
@@ -159,12 +191,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.PhotoMessage;
     /** Use this method to send audio files, if you want Telegram clients to display them in the music player. Your audio must be in the .MP3 or .M4A format. On success, the sent Message is returned. Bots can currently send audio files of up to 50 MB in size, this limit may be changed in the future.
   
@@ -194,12 +226,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.AudioMessage;
     /** Use this method to send general files. On success, the sent Message is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. */
     sendDocument(args: {
@@ -223,12 +255,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.DocumentMessage;
     /** Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as Document). On success, the sent Message is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. */
     sendVideo(args: {
@@ -260,12 +292,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.VideoMessage;
     /** Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent Message is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. */
     sendAnimation(args: {
@@ -295,12 +327,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.AnimationMessage;
     /** Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS (other formats may be sent as Audio or Document). On success, the sent Message is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. */
     sendVoice(args: {
@@ -322,12 +354,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.VoiceMessage;
     /** Use this method to send video messages. On success, the sent Message is returned.
     As of v.4.0, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. */
@@ -348,12 +380,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.VideoNoteMessage;
     /** Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of Messages that were sent is returned. */
     sendMediaGroup(args: {
@@ -367,10 +399,10 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent messages from forwarding and saving */
         protect_content?: boolean;
-        /** If messages are a reply, ID of the original message */
+        /** Description of the message to reply to */
+        reply_parameters?: ReplyParameters;
+        /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: boolean;
     }): Array<Message.AudioMessage | Message.DocumentMessage | Message.PhotoMessage | Message.VideoMessage>;
     /** Use this method to send point on the map. On success, the sent Message is returned. */
     sendLocation(args: {
@@ -394,12 +426,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.LocationMessage;
     /** Use this method to edit live location messages. A location can be edited until its live_period expires or editing is explicitly disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
     editMessageLiveLocation(args: {
@@ -459,12 +491,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.VenueMessage;
     /** Use this method to send phone contacts. On success, the sent Message is returned. */
     sendContact(args: {
@@ -484,12 +516,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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 keyboard or to force a reply from the user. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.ContactMessage;
     /** Use this method to send a native poll. On success, the sent Message is returned. */
     sendPoll(args: {
@@ -525,12 +557,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.PollMessage;
     /** Use this method to send an animated emoji that will display a random value. On success, the sent Message is returned. */
     sendDice(args: {
@@ -544,12 +576,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.DiceMessage;
     /** Use this method when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status). Returns True on success.
   
@@ -564,6 +596,17 @@ export type ApiMethods<F> = {
         /** Unique identifier for the target message thread; supergroups only */
         message_thread_id?: number;
     }): true;
+    /** Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. In albums, bots must react to the first message. Returns True on success. */
+    setMessageReaction(args: {
+        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+        chat_id: number | string;
+        /** Identifier of the target message */
+        message_id: number;
+        /** New list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators. */
+        reaction?: ReactionType[];
+        /** Pass True to set the reaction with a big animation */
+        is_big?: boolean;
+    }): true;
     /** Use this method to get a list of profile pictures for a user. Returns a UserProfilePhotos object. */
     getUserProfilePhotos(args: {
         /** Unique identifier of the target user */
@@ -793,7 +836,7 @@ export type ApiMethods<F> = {
         /** Unique identifier for the target chat or username of the target supergroup or channel (in the format @channelusername) */
         chat_id: number | string;
     }): true;
-    /** Use this method to get up to date information about the chat (current name of the user for one-on-one conversations, current username of a user, group or channel, etc.). Returns a Chat object on success. */
+    /** Use this method to get up to date information about the chat. Returns a Chat object on success. */
     getChat(args: {
         /** Unique identifier for the target chat or username of the target supergroup or channel (in the format @channelusername) */
         chat_id: number | string;
@@ -931,18 +974,13 @@ export type ApiMethods<F> = {
         /** The maximum amount of time in seconds that the result of the callback query may be cached client-side. Telegram apps will support caching starting in version 3.14. Defaults to 0. */
         cache_time?: number;
     }): true;
-    /** Use this method to change the bot's name. Returns True on success. */
-    setMyName(args: {
-        /** New bot name; 0-64 characters. Pass an empty string to remove the dedicated name for the given language. */
-        name?: string;
-        /** A two-letter ISO 639-1 language code. If empty, the name will be shown to all users for whose language there is no dedicated name. */
-        language_code?: string;
-    }): true;
-    /** Use this method to get the current bot name for the given user language. Returns BotName on success. */
-    getMyName(args: {
-        /** A two-letter ISO 639-1 language code or an empty string */
-        language_code?: string;
-    }): BotName;
+    /** Use this method to get the list of boosts added to a chat by a user. Requires administrator rights in the chat. Returns a UserChatBoosts object. */
+    getUserChatBoosts(args: {
+        /** Unique identifier for the chat or username of the channel (in the format @channelusername) */
+        chat_id: number | string;
+        /** Unique identifier of the target user */
+        user_id: number;
+    }): UserChatBoosts;
     /** Use this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands. Returns True on success. */
     setMyCommands(args: {
         /** A list of bot commands to be set as the list of the bot's commands. At most 100 commands can be specified. */
@@ -966,6 +1004,18 @@ export type ApiMethods<F> = {
         /** A two-letter ISO 639-1 language code or an empty string */
         language_code?: string;
     }): BotCommand[];
+    /** Use this method to change the bot's name. Returns True on success. */
+    setMyName(args: {
+        /** New bot name; 0-64 characters. Pass an empty string to remove the dedicated name for the given language. */
+        name?: string;
+        /** A two-letter ISO 639-1 language code. If empty, the name will be shown to all users for whose language there is no dedicated name. */
+        language_code?: string;
+    }): true;
+    /** Use this method to get the current bot name for the given user language. Returns BotName on success. */
+    getMyName(args: {
+        /** A two-letter ISO 639-1 language code or an empty string */
+        language_code?: string;
+    }): BotName;
     /** Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success. */
     setMyDescription(args: {
         /** New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language. */
@@ -1028,8 +1078,8 @@ export type ApiMethods<F> = {
         parse_mode?: ParseMode;
         /** A list of special entities that appear in message text, which can be specified instead of parse_mode */
         entities?: MessageEntity[];
-        /** Disables link previews for links in this message */
-        disable_web_page_preview?: boolean;
+        /** Link preview generation options for the message */
+        link_preview_options?: LinkPreviewOptions;
         /** An object for an inline keyboard. */
         reply_markup?: InlineKeyboardMarkup;
     }): (Update.Edited & Message.TextMessage) | true;
@@ -1099,6 +1149,13 @@ export type ApiMethods<F> = {
         /** Identifier of the message to delete */
         message_id: number;
     }): true;
+    /** Use this method to delete multiple messages simultaneously. Returns True on success. */
+    deleteMessages(args: {
+        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+        chat_id: number | string;
+        /** Identifiers of 1-100 messages to delete. See deleteMessage for limitations on which messages can be deleted */
+        message_ids: number[];
+    }): true;
     /** Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers. On success, the sent Message is returned. */
     sendSticker(args: {
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
@@ -1113,12 +1170,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: 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. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.StickerMessage;
     /** Use this method to get a sticker set. On success, a StickerSet object is returned. */
     getStickerSet(args: {
@@ -1303,12 +1360,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: boolean;
+        /** Description of the message to reply to */
+        reply_parameters?: ReplyParameters;
         /** An object for an inline keyboard. If empty, one 'Pay total price' button will be shown. If not empty, the first button must be a Pay button. */
         reply_markup?: InlineKeyboardMarkup;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.InvoiceMessage;
     /** Use this method to create a link for an invoice. Returns the created invoice link as String on success. */
     createInvoiceLink(args: {
@@ -1394,12 +1451,12 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
         protect_content?: boolean;
-        /** If the message is a reply, ID of the original message */
-        reply_to_message_id?: number;
-        /** Pass True if the message should be sent even if the specified replied-to message is not found */
-        allow_sending_without_reply?: boolean;
+        /** Description of the message to reply to */
+        reply_parameters?: ReplyParameters;
         /** An object for an inline keyboard. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. */
         reply_markup?: InlineKeyboardMarkup;
+        /** @deprecated Use `reply_parameters` instead. */
+        reply_to_message_id?: number;
     }): Message.GameMessage;
     /** Use this method to set the score of the specified user in a game message. On success, if the message is not an inline message, the Message is returned, otherwise True is returned. Returns an error, if the new score is not greater than the user's current score in the chat and force is False. */
     setGameScore(args: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grammyjs/types",
-  "version": "3.3.1",
+  "version": "3.4.1",
   "description": "Telegram Bot API type declarations for grammY",
   "main": "mod.js",
   "repository": {

package/update.d.ts

@@ -1,7 +1,7 @@
 import type { ChosenInlineResult, InlineQuery } from "./inline.js";
-import type { Chat, ChatJoinRequest, ChatMemberUpdated, User } from "./manage.js";
+import type { Chat, ChatBoostRemoved, ChatBoostUpdated, ChatJoinRequest, ChatMemberUpdated, User } from "./manage.js";
 import type { CallbackQuery } from "./markup.js";
-import type { Message, Poll, PollAnswer } from "./message.js";
+import type { Message, MessageReactionCountUpdated, MessageReactionUpdated, Poll, PollAnswer } from "./message.js";
 import type { PreCheckoutQuery, ShippingQuery } from "./payment.js";
 /** Internal namespace used to make some message types more accurate */
 export declare namespace Update {
@@ -33,6 +33,10 @@ export interface Update {
     channel_post?: Message & Update.Channel;
     /** New version of a channel post that is known to the bot and was edited */
     edited_channel_post?: Message & Update.Edited & Update.Channel;
+    /** A reaction to a message was changed by a user. The bot must be an administrator in the chat and must explicitly specify "message_reaction" in the list of allowed_updates to receive these updates. The update isn't received for reactions set by bots. */
+    message_reaction?: MessageReactionUpdated;
+    /** Reactions to a message with anonymous reactions were changed. The bot must be an administrator in the chat and must explicitly specify "message_reaction_count" in the list of allowed_updates to receive these updates. */
+    message_reaction_count?: MessageReactionCountUpdated;
     /** New incoming inline query */
     inline_query?: InlineQuery;
     /** The result of an inline query that was chosen by a user and sent to their chat partner. Please see our documentation on the feedback collecting for details on how to enable these updates for your bot. */
@@ -53,4 +57,8 @@ export interface Update {
     chat_member?: ChatMemberUpdated;
     /** A request to join the chat has been sent. The bot must have the can_invite_users administrator right in the chat to receive these updates. */
     chat_join_request?: ChatJoinRequest;
+    /** A chat boost was added or changed. The bot must be an administrator in the chat to receive these updates. */
+    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;
 }