grammy 1.19.2 → 1.20.0

package/README.md

@@ -10,7 +10,7 @@
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-6.9-blue?logo=telegram&style=flat&labelColor=000&color=3b82f6)](https://core.telegram.org/bots/api)
+[![Bot API](https://img.shields.io/badge/Bot%20API-7.0-blue?logo=telegram&style=flat&labelColor=000&color=3b82f6)](https://core.telegram.org/bots/api)
 [![Deno](https://shield.deno.dev/x/grammy)](https://deno.land/x/grammy)
 [![npm](https://img.shields.io/npm/v/grammy?logo=npm&style=flat&labelColor=000&color=3b82f6)](https://www.npmjs.org/package/grammy)
 [![All Contributors](https://img.shields.io/github/all-contributors/grammyjs/grammy?style=flat&labelColor=000&color=3b82f6)](#contributors-)
@@ -260,7 +260,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/shevernitskiy"><img src="https://avatars.githubusercontent.com/u/28886342?v=4?s=100" width="100px;" alt="shevernitskiy"/><br /><sub><b>shevernitskiy</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ashevernitskiy" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Ashevernitskiy" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/grammyjs/grammY/commits?author=shevernitskiy" title="Code">💻</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/mrmaster009"><img src="https://avatars.githubusercontent.com/u/81420490?v=4?s=100" width="100px;" alt="mrmaster009"/><br /><sub><b>mrmaster009</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=mrmaster009" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://lwjerri.dev/"><img src="https://avatars.githubusercontent.com/u/50290430?v=4?s=100" width="100px;" alt="Andrey Zontov"/><br /><sub><b>Andrey Zontov</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3ALWJerri" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=LWJerri" title="Code">💻</a> <a href="#question-LWJerri" title="Answering Questions">💬</a> <a href="#ideas-LWJerri" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/commits?author=LWJerri" title="Documentation">📖</a> <a href="#translation-LWJerri" title="Translation">🌍</a></td>
-      <td align="center" valign="top" width="11.11%"><a href="https://github.com/AbbassAlmusawi"><img src="https://avatars.githubusercontent.com/u/73327881?v=4?s=100" width="100px;" alt="Abbass Al-Musawi"/><br /><sub><b>Abbass Al-Musawi</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=AbbassAlmusawi" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/AbbassAlmusawi"><img src="https://avatars.githubusercontent.com/u/73327881?v=4?s=100" width="100px;" alt="Abbass Al-Musawi"/><br /><sub><b>Abbass Al-Musawi</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=AbbassAlmusawi" title="Documentation">📖</a> <a href="https://github.com/grammyjs/grammY/issues?q=author%3AAbbassAlmusawi" title="Bug reports">🐛</a></td>
     </tr>
     <tr>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/inji-gg"><img src="https://avatars.githubusercontent.com/u/5071242?v=4?s=100" width="100px;" alt="ArunR"/><br /><sub><b>ArunR</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ainji-gg" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=inji-gg" title="Code">💻</a></td>
@@ -280,6 +280,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/shaunnope"><img src="https://avatars.githubusercontent.com/u/19631195?v=4?s=100" width="100px;" alt="Sean Yap"/><br /><sub><b>Sean Yap</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ashaunnope" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=shaunnope" title="Code">💻</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://sergeysolovev.com"><img src="https://avatars.githubusercontent.com/u/5831301?v=4?s=100" width="100px;" alt="Sergey Solovev"/><br /><sub><b>Sergey Solovev</b></sub></a><br /><a href="#ideas-sergeysolovev" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Asergeysolovev" title="Reviewed Pull Requests">👀</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/HeySreelal"><img src="https://avatars.githubusercontent.com/u/94184909?v=4?s=100" width="100px;" alt="Sree (Taylor's Version)"/><br /><sub><b>Sree (Taylor's Version)</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3AHeySreelal" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=HeySreelal" title="Code">💻</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="http://linkedin.com/in/thecoorum"><img src="https://avatars.githubusercontent.com/u/32096016?v=4?s=100" width="100px;" alt="Yaroslav Vovchenko"/><br /><sub><b>Yaroslav Vovchenko</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Athecoorum" title="Bug reports">🐛</a></td>
     </tr>
   </tbody>
 </table>

package/out/bot.d.ts

@@ -1,10 +1,10 @@
-import { BotError, Composer, type Middleware } from "./composer.js";
-import { Context } from "./context.js";
+import { BotError, Composer, type Middleware, type ReactionMiddleware } from "./composer.js";
+import { Context, type MaybeArray, type ReactionContext } from "./context.js";
 import { Api } from "./core/api.js";
 import { type ApiClientOptions, type WebhookReplyEnvelope } from "./core/client.js";
 import { type Filter, type FilterQuery } from "./filter.js";
-import { type Update, type UserFromGetMe } from "./types.js";
-export declare const DEFAULT_UPDATE_TYPES: readonly ["message", "edited_message", "channel_post", "edited_channel_post", "inline_query", "chosen_inline_result", "callback_query", "shipping_query", "pre_checkout_query", "poll", "poll_answer", "my_chat_member", "chat_join_request"];
+import { type ReactionType, type ReactionTypeEmoji, type Update, type UserFromGetMe } from "./types.js";
+export declare const DEFAULT_UPDATE_TYPES: readonly ["message", "edited_message", "channel_post", "edited_channel_post", "inline_query", "chosen_inline_result", "callback_query", "shipping_query", "pre_checkout_query", "poll", "poll_answer", "my_chat_member", "chat_join_request", "chat_boost", "removed_chat_boost"];
 /**
  * Options that can be specified when running the bot via simple long polling.
  */
@@ -163,6 +163,10 @@ export declare class Bot<C extends Context = Context, A extends Api = Api> exten
      * @inheritdoc
      */
     on<Q extends FilterQuery>(filter: Q | Q[], ...middleware: Array<Middleware<Filter<C, Q>>>): Composer<Filter<C, Q>>;
+    /**
+     * @inheritdoc
+     */
+    reaction(reaction: MaybeArray<ReactionTypeEmoji["emoji"] | ReactionType>, ...middleware: Array<ReactionMiddleware<C>>): Composer<ReactionContext<C>>;
     /**
      * Checks if the bot has been initialized. A bot is initialized if the bot
      * information is set. The bot information can either be set automatically

package/out/bot.js

@@ -26,6 +26,8 @@ exports.DEFAULT_UPDATE_TYPES = [
     "poll_answer",
     "my_chat_member",
     "chat_join_request",
+    "chat_boost",
+    "removed_chat_boost",
 ];
 /**
  * This is the single most important class of grammY. It represents your bot.
@@ -125,6 +127,13 @@ class Bot extends composer_js_1.Composer {
         }
         return super.on(filter, ...middleware);
     }
+    /**
+     * @inheritdoc
+     */
+    reaction(reaction, ...middleware) {
+        this.observedUpdateTypes.add("message_reaction");
+        return super.reaction(reaction, ...middleware);
+    }
     /**
      * Checks if the bot has been initialized. A bot is initialized if the bot
      * information is set. The bot information can either be set automatically

package/out/composer.d.ts

@@ -1,6 +1,6 @@
-import { type CallbackQueryContext, type ChatTypeContext, type ChosenInlineResultContext, type CommandContext, Context, type GameQueryContext, type HearsContext, type InlineQueryContext, type MaybeArray, type StringWithSuggestions } from "./context.js";
+import { type CallbackQueryContext, type ChatTypeContext, type ChosenInlineResultContext, type CommandContext, Context, type GameQueryContext, type HearsContext, type InlineQueryContext, type MaybeArray, type ReactionContext, type StringWithSuggestions } from "./context.js";
 import { type Filter, type FilterQuery } from "./filter.js";
-import { type Chat } from "./types.js";
+import { type Chat, type ReactionType, type ReactionTypeEmoji } from "./types.js";
 type MaybePromise<T> = T | Promise<T>;
 /**
  * A function of this type is passed as the second parameter to all middleware.
@@ -173,7 +173,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      * (logical AND), you can chain the `.on` calls:
      * ```ts
      * // Matches all messages and channel posts that both a) contain a URL and b) are forwards
-     * bot.on('::url').on(':forward_date', ctx => { ... })
+     * bot.on('::url').on(':forward_origin', ctx => { ... })
      * ```
      *
      * @param filter The filter query to use, may also be an array of queries
@@ -268,6 +268,33 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      * @param middleware The middleware to register
      */
     command<S extends string>(command: MaybeArray<StringWithSuggestions<S | "start" | "help" | "settings">>, ...middleware: Array<CommandMiddleware<C>>): Composer<CommandContext<C>>;
+    /**
+     * Registers some middleware that will only be added when a new reaction of
+     * the given type is added to a message.
+     * ```ts
+     * // Reacts to new '👍' reactions
+     * bot.reaction('👍', ctx => { ... })
+     * // Reacts to new '👍' or '👎' reactions
+     * bot.reaction(['👍', '👎'], ctx => { ... })
+     * ```
+     *
+     * > Note that you have to enable `message_reaction` updates in
+     * `allowed_updates` if you want your bot to receive updates about message
+     * reactions.
+     *
+     * `bot.reaction` will trigger if:
+     * - a new emoji reaction is added to a message
+     * - a new custom emoji reaction is added a message
+     *
+     * `bot.reaction` will not trigger if:
+     * - a reaction is removed
+     * - an anonymous reaction count is updated, such as on channel posts
+     * - `message_reaction` updates are not enabled for your bot
+     *
+     * @param reaction The reaction to look for
+     * @param middleware The middleware to register
+     */
+    reaction(reaction: MaybeArray<ReactionTypeEmoji["emoji"] | ReactionType>, ...middleware: Array<ReactionMiddleware<C>>): Composer<ReactionContext<C>>;
     /**
      * Registers some middleware for certain chat types only. For example, you
      * can use this method to only receive updates from private chats. The four
@@ -620,6 +647,15 @@ export type HearsMiddleware<C extends Context> = Middleware<HearsContext<C>>;
  * modular code where handlers are defined in separate files.
  */
 export type CommandMiddleware<C extends Context> = Middleware<CommandContext<C>>;
+/**
+ * Type of the middleware that can be passed to `bot.reaction`.
+ *
+ * This helper type can be used to annotate middleware functions that are
+ * defined in one place, so that they have the correct type when passed to
+ * `bot.reaction` in a different place. For instance, this allows for more
+ * modular code where handlers are defined in separate files.
+ */
+export type ReactionMiddleware<C extends Context> = Middleware<ReactionContext<C>>;
 /**
  * Type of the middleware that can be passed to `bot.callbackQuery`.
  *

package/out/composer.js

@@ -174,7 +174,7 @@ class Composer {
      * (logical AND), you can chain the `.on` calls:
      * ```ts
      * // Matches all messages and channel posts that both a) contain a URL and b) are forwards
-     * bot.on('::url').on(':forward_date', ctx => { ... })
+     * bot.on('::url').on(':forward_origin', ctx => { ... })
      * ```
      *
      * @param filter The filter query to use, may also be an array of queries
@@ -275,6 +275,35 @@ class Composer {
     command(command, ...middleware) {
         return this.filter(context_js_1.Context.has.command(command), ...middleware);
     }
+    /**
+     * Registers some middleware that will only be added when a new reaction of
+     * the given type is added to a message.
+     * ```ts
+     * // Reacts to new '👍' reactions
+     * bot.reaction('👍', ctx => { ... })
+     * // Reacts to new '👍' or '👎' reactions
+     * bot.reaction(['👍', '👎'], ctx => { ... })
+     * ```
+     *
+     * > Note that you have to enable `message_reaction` updates in
+     * `allowed_updates` if you want your bot to receive updates about message
+     * reactions.
+     *
+     * `bot.reaction` will trigger if:
+     * - a new emoji reaction is added to a message
+     * - a new custom emoji reaction is added a message
+     *
+     * `bot.reaction` will not trigger if:
+     * - a reaction is removed
+     * - an anonymous reaction count is updated, such as on channel posts
+     * - `message_reaction` updates are not enabled for your bot
+     *
+     * @param reaction The reaction to look for
+     * @param middleware The middleware to register
+     */
+    reaction(reaction, ...middleware) {
+        return this.filter(context_js_1.Context.has.reaction(reaction), ...middleware);
+    }
     /**
      * Registers some middleware for certain chat types only. For example, you
      * can use this method to only receive updates from private chats. The four

package/out/context.d.ts

@@ -1,7 +1,7 @@
 import { type Api, type Other as OtherApi } from "./core/api.js";
 import { type Methods, type RawApi } from "./core/client.js";
 import { type Filter, type FilterCore, type FilterQuery } from "./filter.js";
-import { type Chat, type ChatPermissions, type InlineQueryResult, type InputFile, type InputMedia, type InputMediaAudio, type InputMediaDocument, type InputMediaPhoto, type InputMediaVideo, type LabeledPrice, type Message, type MessageEntity, type PassportElementError, type Update, type User, type UserFromGetMe } from "./types.js";
+import { type Chat, type ChatPermissions, type InlineQueryResult, type InputFile, type InputMedia, type InputMediaAudio, type InputMediaDocument, type InputMediaPhoto, type InputMediaVideo, type LabeledPrice, type Message, type MessageEntity, type PassportElementError, type ReactionType, type ReactionTypeEmoji, type Update, type User, type UserFromGetMe } from "./types.js";
 export type MaybeArray<T> = T | T[];
 export type StringWithSuggestions<S extends string> = (string & Record<never, never>) | S;
 type Other<M extends Methods<RawApi>, X extends string = never> = OtherApi<RawApi, M, X>;
@@ -33,6 +33,14 @@ interface StaticHas {
      * @param command The command to match
      */
     command<S extends string>(command: MaybeArray<StringWithSuggestions<S | "start" | "help" | "settings">>): <C extends Context>(ctx: C) => ctx is CommandContext<C>;
+    /**
+     * Generates a predicate function that can test context
+     * objects for containing a message reaction update. This uses the same
+     * logic as `bot.reaction`.
+     *
+     * @param reaction The reaction to test against
+     */
+    reaction(reaction: MaybeArray<ReactionTypeEmoji["emoji"] | ReactionType>): <C extends Context>(ctx: C) => ctx is ReactionContext<C>;
     /**
      * Generates a predicate function that can test context objects for
      * belonging to a chat with the given chat type. This uses the same logic as
@@ -153,6 +161,10 @@ export declare class Context implements RenamedUpdate {
     get channelPost(): (Message & Update.Channel) | undefined;
     /** Alias for `ctx.update.edited_channel_post` */
     get editedChannelPost(): (Message & Update.Edited & Update.Channel) | undefined;
+    /** Alias for `ctx.update.message_reaction` */
+    get messageReaction(): import("@grammyjs/types/message.js").MessageReactionUpdated | undefined;
+    /** Alias for `ctx.update.message_reaction_count` */
+    get messageReactionCount(): import("@grammyjs/types/message.js").MessageReactionCountUpdated | undefined;
     /** Alias for `ctx.update.inline_query` */
     get inlineQuery(): import("@grammyjs/types/inline.js").InlineQuery | undefined;
     /** Alias for `ctx.update.chosen_inline_result` */
@@ -173,6 +185,10 @@ export declare class Context implements RenamedUpdate {
     get chatMember(): import("@grammyjs/types/manage.js").ChatMemberUpdated | undefined;
     /** Alias for `ctx.update.chat_join_request` */
     get chatJoinRequest(): import("@grammyjs/types/manage.js").ChatJoinRequest | undefined;
+    /** Alias for `ctx.update.chat_boost` */
+    get chatBoost(): import("@grammyjs/types/manage.js").ChatBoostUpdated | undefined;
+    /** Alias for `ctx.update.removed_chat_boost` */
+    get removedChatBoost(): import("@grammyjs/types/manage.js").ChatBoostRemoved | undefined;
     /**
      * Get message object from wherever possible. Alias for `ctx.message ??
      * ctx.editedMessage ?? ctx.callbackQuery?.message ?? ctx.channelPost ??
@@ -181,7 +197,9 @@ export declare class Context implements RenamedUpdate {
     get msg(): Message | undefined;
     /**
      * Get chat object from wherever possible. Alias for `(ctx.msg ??
-     * ctx.myChatMember ?? ctx.chatMember ?? ctx.chatJoinRequest)?.chat`
+     * ctx.myChatMember ?? ctx.chatMember ?? ctx.chatJoinRequest ??
+     * ctx.messageReaction ?? ctx.messageReactionCount ?? ctx.chatBoost ??
+     * ctx.removedChatBoost)?.chat`
      */
     get chat(): Chat | undefined;
     /**
@@ -218,12 +236,64 @@ export declare class Context implements RenamedUpdate {
      * @returns Array of entities and their texts, or empty array when there's no text
      */
     entities(): Array<MessageEntity & {
+        /** Slice of the message text that contains this entity */
         text: string;
     }>;
     entities<T extends MessageEntity["type"]>(types: MaybeArray<T>): Array<MessageEntity & {
         type: T;
+        /** Slice of the message text that contains this entity */
         text: string;
     }>;
+    /**
+     * Find out which reactions were added and removed in a `message_reaction`
+     * update. This method looks at `ctx.messageReaction` and computes the
+     * difference between the old reaction and the new reaction. It also groups
+     * the reactions by emoji reactions and custom emoji reactions. For example,
+     * the resulting object could look like this:
+     * ```ts
+     * {
+     *   emoji: ['👍', '🎉']
+     *   emojiAdded: ['🎉'],
+     *   emojiKept: ['👍'],
+     *   emojiRemoved: [],
+     *   customEmoji: [],
+     *   customEmojiAdded: [],
+     *   customEmojiKept: [],
+     *   customEmojiRemoved: ['id0123'],
+     * }
+     * ```
+     * In the above example, a tada reaction was added by the user, and a custom
+     * emoji reaction with the custom emoji 'id0123' was removed in the same
+     * update. The user had already reacted with a thumbs up reaction, which
+     * they left unchanged. As a result, the current reaction by the user is
+     * thumbs up and tada. Note that the current reaction (both emoji and custom
+     * emoji in one list) can also be obtained from
+     * `ctx.messageReaction.new_reaction`.
+     *
+     * Remember that reaction updates only include information about the
+     * reaction of a specific user. The respective message may have many more
+     * reactions by other people which will not be included in this update.
+     *
+     * @returns An object containing information about the reaction update
+     */
+    reactions(): {
+        /** Emoji currently present in this user's reaction */
+        emoji: ReactionTypeEmoji["emoji"][];
+        /** Emoji newly added to this user's reaction */
+        emojiAdded: ReactionTypeEmoji["emoji"][];
+        /** Emoji not changed by the update to this user's reaction */
+        emojiKept: ReactionTypeEmoji["emoji"][];
+        /** Emoji removed from this user's reaction */
+        emojiRemoved: ReactionTypeEmoji["emoji"][];
+        /** Custom emoji currently present in this user's reaction */
+        customEmoji: string[];
+        /** Custom emoji newly added to this user's reaction */
+        customEmojiAdded: string[];
+        /** Custom emoji not changed by the update to this user's reaction */
+        customEmojiKept: string[];
+        /** Custom emoji removed from this user's reaction */
+        customEmojiRemoved: string[];
+    };
     /**
      * `Context.has` is an object that contains a number of useful functions for
      * probing context objects. Each of these functions can generate a predicate
@@ -267,6 +337,7 @@ export declare class Context implements RenamedUpdate {
      * @param command The command to match
      */
     hasCommand<S extends string>(command: MaybeArray<StringWithSuggestions<S | "start" | "help" | "settings">>): this is CommandContextCore;
+    hasReaction(reaction: MaybeArray<ReactionTypeEmoji["emoji"] | ReactionType>): this is ReactionContextCore;
     /**
      * Returns `true` if this context object belongs to a chat with the given
      * chat type, and `false` otherwise. This uses the same logic as
@@ -319,7 +390,7 @@ export declare class Context implements RenamedUpdate {
      */
     reply(text: string, other?: Other<"sendMessage", "chat_id" | "text">, signal?: AbortSignal): Promise<Message.TextMessage>;
     /**
-     * Context-aware alias for `api.forwardMessage`. Use this method to forward messages of any kind. Service messages can't be forwarded. On success, the sent Message is returned.
+     * Context-aware alias for `api.forwardMessage`. 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.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param other Optional remaining parameters, confer the official reference below
@@ -329,7 +400,18 @@ export declare class Context implements RenamedUpdate {
      */
     forwardMessage(chat_id: number | string, other?: Other<"forwardMessage", "chat_id" | "from_chat_id" | "message_id">, signal?: AbortSignal): Promise<Message>;
     /**
-     * Context-aware alias for `api.copyMessage`. 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.
+     * Context-aware alias for `api.forwardMessages`. 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.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @param message_ids Identifiers of 1-100 messages in the current chat to forward. The identifiers must be specified in a strictly increasing order.
+     * @param other Optional remaining parameters, confer the official reference below
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#forwardmessages
+     */
+    forwardMessages(chat_id: number | string, message_ids: number[], other?: Other<"forwardMessages", "chat_id" | "from_chat_id" | "message_ids">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").MessageId[]>;
+    /**
+     * Context-aware alias for `api.copyMessage`. 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.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param other Optional remaining parameters, confer the official reference below
@@ -338,6 +420,17 @@ export declare class Context implements RenamedUpdate {
      * **Official reference:** https://core.telegram.org/bots/api#copymessage
      */
     copyMessage(chat_id: number | string, other?: Other<"copyMessage", "chat_id" | "from_chat_id" | "message_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").MessageId>;
+    /**
+     * Context-aware alias for `api.copyMessages`.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.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @param message_ids Identifiers of 1-100 messages in the current chat to copy. The identifiers must be specified in a strictly increasing order.
+     * @param other Optional remaining parameters, confer the official reference below
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#copymessages
+     */
+    copyMessages(chat_id: number | string, message_ids: number[], other?: Other<"copyMessages", "chat_id" | "from_chat_id" | "message_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").MessageId[]>;
     /**
      * Context-aware alias for `api.sendPhoto`. Use this method to send photos. On success, the sent Message is returned.
      *
@@ -501,6 +594,16 @@ export declare class Context implements RenamedUpdate {
      * **Official reference:** https://core.telegram.org/bots/api#senddice
      */
     replyWithDice(emoji: string, other?: Other<"sendDice", "chat_id" | "emoji">, signal?: AbortSignal): Promise<Message.DiceMessage>;
+    /**
+     * Context-aware alias for `api.setMessageReaction`. 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.
+     *
+     * @param reaction 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.
+     * @param other Optional remaining parameters, confer the official reference below
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#senddice
+     */
+    react(reaction: MaybeArray<ReactionTypeEmoji["emoji"] | ReactionType>, other?: Other<"setMessageReaction", "chat_id" | "message_id" | "reaction">, signal?: AbortSignal): Promise<true>;
     /**
      * Context-aware alias for `api.sendChatAction`. 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.
      *
@@ -525,6 +628,15 @@ export declare class Context implements RenamedUpdate {
      * **Official reference:** https://core.telegram.org/bots/api#getuserprofilephotos
      */
     getUserProfilePhotos(other?: Other<"getUserProfilePhotos", "user_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").UserProfilePhotos>;
+    /**
+     * Context-aware alias for `api.getUserChatBoosts`. 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.
+     *
+     * @param chat_id Unique identifier for the chat or username of the channel (in the format @channelusername)
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#getuserchatboosts
+     */
+    getUserChatBoosts(chat_id: number | string, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").UserChatBoosts>;
     /**
      * Context-aware alias for `api.getFile`. Use this method to get basic info about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a File object is returned. The file can then be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>, where <file_path> is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling getFile again.
      *
@@ -534,7 +646,7 @@ export declare class Context implements RenamedUpdate {
      *
      * **Official reference:** https://core.telegram.org/bots/api#getfile
      */
-    getFile(signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").File>;
+    getFile(signal?: AbortSignal): Promise<File>;
     /** @deprecated Use `banAuthor` instead. */
     kickAuthor(...args: Parameters<Context["banAuthor"]>): Promise<true>;
     /**
@@ -544,7 +656,8 @@ export declare class Context implements RenamedUpdate {
      * @param signal Optional `AbortSignal` to cancel the request
      *
      * **Official reference:** https://core.telegram.org/bots/api#banchatmember
-     */ banAuthor(other?: Other<"banChatMember", "chat_id" | "user_id">, signal?: AbortSignal): Promise<true>;
+     */
+    banAuthor(other?: Other<"banChatMember", "chat_id" | "user_id">, signal?: AbortSignal): Promise<true>;
     /** @deprecated Use `banChatMember` instead. */
     kickChatMember(...args: Parameters<Context["banChatMember"]>): Promise<true>;
     /**
@@ -1049,6 +1162,16 @@ export declare class Context implements RenamedUpdate {
      * **Official reference:** https://core.telegram.org/bots/api#deletemessage
      */
     deleteMessage(signal?: AbortSignal): Promise<true>;
+    /**
+     * Context-aware alias for `api.deleteMessages`. Use this method to delete multiple messages simultaneously. Returns True on success.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @param message_ids Identifiers of 1-100 messages to delete. See deleteMessage for limitations on which messages can be deleted
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#deletemessages
+     */
+    deleteMessages(message_ids: number[], signal?: AbortSignal): Promise<true>;
     /**
      * Context-aware alias for `api.sendSticker`. Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers. On success, the sent Message is returned.
      *
@@ -1205,6 +1328,18 @@ type InlineQueryContextCore = FilterCore<"inline_query">;
  * in separate files and still have the correct types.
  */
 export type InlineQueryContext<C extends Context> = Filter<C, "inline_query">;
+type ReactionContextCore = FilterCore<"message_reaction">;
+/**
+ * Type of the context object that is available inside the handlers for
+ * `bot.reaction`.
+ *
+ * This helper type can be used to narrow down context objects the same way how
+ * annotate `bot.reaction` does it. This allows you to context objects in
+ * middleware that is not directly passed to `bot.reaction`, hence not inferring
+ * the correct type automatically. That way, handlers can be defined in separate
+ * files and still have the correct types.
+ */
+export type ReactionContext<C extends Context> = Filter<C, "message_reaction">;
 type ChosenInlineResultContextCore = FilterCore<"chosen_inline_result">;
 /**
  * Type of the context object that is available inside the handlers for