grammy 1.27.0 → 1.29.0

package/README.md

@@ -10,14 +10,14 @@
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-7.7-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.9-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-)
 
 <!-- deno-fmt-ignore-end -->
 
-## _[docs.](https://grammy.dev) [reference.](https://deno.land/x/grammy/mod.ts) [chat.](https://telegram.me/grammyjs) [news.](https://telegram.me/grammyjs_news)_
+## _[docs.](https://grammy.dev) [reference.](https://grammy.dev/ref) [chat.](https://telegram.me/grammyjs) [news.](https://telegram.me/grammyjs_news)_
 
 </div>
 
@@ -68,7 +68,7 @@ Congrats! You just wrote a Telegram bot :)
 
 ## Going Further
 
-grammY has an excellent [documentation](https://grammy.dev), and an [API Reference](https://doc.deno.land/https://deno.land/x/grammy/mod.ts). It even integrates with your code editor, e.g. [VS Code](https://code.visualstudio.com/). You can hover over any element of grammY to get a detailed description of what that thing does or means.
+grammY has an excellent [documentation](https://grammy.dev), and an [API Reference](https://grammy.dev/ref). It even integrates with your code editor, e.g. [VS Code](https://code.visualstudio.com/). You can hover over any element of grammY to get a detailed description of what that thing does or means.
 
 If you are still stuck, just join the [Telegram chat](https://t.me/grammyjs) and ask for help. People are nice there and we appreciate your question, no matter what it is :)
 
@@ -81,7 +81,7 @@ Here are some more resources to support you:
 —main project website and documentation.
 Gets you started and explains all concepts.
 
-### [grammY API reference](https://doc.deno.land/https://deno.land/x/grammy/mod.ts)
+### [grammY API reference](https://grammy.dev/ref)
 
 —reference of everything that grammY exports.
 Useful to look up descriptions about any element of grammY.
@@ -302,6 +302,12 @@ 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/SunsetTechuila"><img src="https://avatars.githubusercontent.com/u/115353812?v=4?s=100" width="100px;" alt="Grigory"/><br /><sub><b>Grigory</b></sub></a><br /><a href="#ideas-SunsetTechuila" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/commits?author=SunsetTechuila" title="Code">💻</a> <a href="https://github.com/grammyjs/grammY/commits?author=SunsetTechuila" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/aleveha"><img src="https://avatars.githubusercontent.com/u/63300936?v=4?s=100" width="100px;" alt="aleveha"/><br /><sub><b>aleveha</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=aleveha" title="Code">💻</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/barinbritva"><img src="https://avatars.githubusercontent.com/u/4758362?v=4?s=100" width="100px;" alt="barinbritva"/><br /><sub><b>barinbritva</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Abarinbritva" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/flmel"><img src="https://avatars.githubusercontent.com/u/55487633?v=4?s=100" width="100px;" alt="Lyudmil Ivanov"/><br /><sub><b>Lyudmil Ivanov</b></sub></a><br /><a href="#example-flmel" title="Examples">💡</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://consortiumkey.com/"><img src="https://avatars.githubusercontent.com/u/95214604?v=4?s=100" width="100px;" alt="lexomis"/><br /><sub><b>lexomis</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Alexomis" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/asologor"><img src="https://avatars.githubusercontent.com/u/97506048?v=4?s=100" width="100px;" alt="Andrew Sologor"/><br /><sub><b>Andrew Sologor</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Aandrew-sol" title="Reviewed Pull Requests">👀</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/rayz1065"><img src="https://avatars.githubusercontent.com/u/37779815?v=4?s=100" width="100px;" alt="rayz"/><br /><sub><b>rayz</b></sub></a><br /><a href="#question-rayz1065" title="Answering Questions">💬</a></td>
     </tr>
   </tbody>
 </table>

package/out/bot.d.ts

@@ -199,7 +199,7 @@ export declare class Bot<C extends Context = Context, A extends Api = Api> exten
      * your bot will handle.
      *
      * If you're writing a library on top of grammY, check out the
-     * [documentation](https://grammy.dev/plugins/runner.html) of the runner
+     * [documentation](https://grammy.dev/plugins/runner) of the runner
      * plugin for an example that uses this method.
      *
      * @param update An update from the Telegram Bot API
@@ -235,7 +235,7 @@ export declare class Bot<C extends Context = Context, A extends Api = Api> exten
      * will impact the responsiveness negatively, so it makes sense to use the
      * `@grammyjs/runner` package even if you receive much fewer messages. If
      * you worry about how much load your bot can handle, check out the grammY
-     * [documentation](https://grammy.dev/advanced/scaling.html) about scaling
+     * [documentation](https://grammy.dev/advanced/scaling) about scaling
      * up.
      *
      * @param options Options to use for simple long polling

package/out/bot.js

@@ -208,7 +208,7 @@ class Bot extends composer_js_1.Composer {
      * your bot will handle.
      *
      * If you're writing a library on top of grammY, check out the
-     * [documentation](https://grammy.dev/plugins/runner.html) of the runner
+     * [documentation](https://grammy.dev/plugins/runner) of the runner
      * plugin for an example that uses this method.
      *
      * @param update An update from the Telegram Bot API
@@ -267,7 +267,7 @@ a known bot info object.");
      * will impact the responsiveness negatively, so it makes sense to use the
      * `@grammyjs/runner` package even if you receive much fewer messages. If
      * you worry about how much load your bot can handle, check out the grammY
-     * [documentation](https://grammy.dev/advanced/scaling.html) about scaling
+     * [documentation](https://grammy.dev/advanced/scaling) about scaling
      * up.
      *
      * @param options Options to use for simple long polling

package/out/composer.d.ts

@@ -65,7 +65,7 @@ export interface MiddlewareObj<C extends Context = Context> {
  * Middleware is an extremely powerful concept and this short explanation only
  * scratched the surface of what is possible with grammY. If you want to know
  * more advanced things about middleware, check out the
- * [documentation](https://grammy.dev/guide/middleware.html) on the website.
+ * [documentation](https://grammy.dev/guide/middleware) on the website.
  */
 export type Middleware<C extends Context = Context> = MiddlewareFn<C> | MiddlewareObj<C>;
 /**
@@ -96,7 +96,7 @@ export declare function run<C extends Context>(middleware: MiddlewareFn<C>, ctx:
  *
  * On the other hand, if you want to dig deeper into how grammY implements
  * middleware, check out the
- * [documentation](https://grammy.dev/advanced/middleware.html) on the website.
+ * [documentation](https://grammy.dev/advanced/middleware) on the website.
  */
 export declare class Composer<C extends Context> implements MiddlewareObj<C> {
     private handler;
@@ -121,7 +121,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      *
      * This method returns a new instance of composer. The returned instance can
      * be further extended, and all changes will be regarded here. Confer the
-     * [documentation](https://grammy.dev/advanced/middleware.html) on the
+     * [documentation](https://grammy.dev/advanced/middleware) on the
      * website if you want to know more about how the middleware system in
      * grammY works, especially when it comes to chaining the method calls
      * (`use( ... ).use( ... ).use( ... )`).
@@ -157,7 +157,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      *
      * You can use autocomplete in VS Code to see all available filter queries.
      * Check out the
-     * [documentation](https://grammy.dev/guide/filter-queries.html) on the
+     * [documentation](https://grammy.dev/guide/filter-queries) on the
      * website to learn more about filter queries in grammY.
      *
      * It is possible to pass multiple filter queries in an array, i.e.
@@ -320,7 +320,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      * // Groups and supergroups only
      * bot.chatType(["group", "supergroup"], ctx => { ... });
      * ```
-     * [Remember](https://grammy.dev/guide/context.html#shortcuts) also that you
+     * [Remember](https://grammy.dev/guide/context#shortcuts) also that you
      * can access the chat type via `ctx.chat.type`.
      *
      * @param chatType The chat type
@@ -663,7 +663,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      * ```
      *
      * Check out the
-     * [documentation](https://grammy.dev/guide/errors.html#error-boundaries) on
+     * [documentation](https://grammy.dev/guide/errors#error-boundaries) on
      * the website to learn more about error boundaries.
      *
      * @param errorHandler The error handler to use

package/out/composer.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Composer = exports.run = exports.BotError = void 0;
+exports.Composer = exports.BotError = void 0;
+exports.run = run;
 const context_js_1 = require("./context.js");
 // === Middleware errors
 /**
@@ -75,7 +76,6 @@ const leaf = () => Promise.resolve();
 async function run(middleware, ctx) {
     await middleware(ctx, leaf);
 }
-exports.run = run;
 // === Composer
 /**
  * The composer is the heart of the middleware system in grammY. It is also the
@@ -88,7 +88,7 @@ exports.run = run;
  *
  * On the other hand, if you want to dig deeper into how grammY implements
  * middleware, check out the
- * [documentation](https://grammy.dev/advanced/middleware.html) on the website.
+ * [documentation](https://grammy.dev/advanced/middleware) on the website.
  */
 class Composer {
     /**
@@ -118,7 +118,7 @@ class Composer {
      *
      * This method returns a new instance of composer. The returned instance can
      * be further extended, and all changes will be regarded here. Confer the
-     * [documentation](https://grammy.dev/advanced/middleware.html) on the
+     * [documentation](https://grammy.dev/advanced/middleware) on the
      * website if you want to know more about how the middleware system in
      * grammY works, especially when it comes to chaining the method calls
      * (`use( ... ).use( ... ).use( ... )`).
@@ -158,7 +158,7 @@ class Composer {
      *
      * You can use autocomplete in VS Code to see all available filter queries.
      * Check out the
-     * [documentation](https://grammy.dev/guide/filter-queries.html) on the
+     * [documentation](https://grammy.dev/guide/filter-queries) on the
      * website to learn more about filter queries in grammY.
      *
      * It is possible to pass multiple filter queries in an array, i.e.
@@ -329,7 +329,7 @@ class Composer {
      * // Groups and supergroups only
      * bot.chatType(["group", "supergroup"], ctx => { ... });
      * ```
-     * [Remember](https://grammy.dev/guide/context.html#shortcuts) also that you
+     * [Remember](https://grammy.dev/guide/context#shortcuts) also that you
      * can access the chat type via `ctx.chat.type`.
      *
      * @param chatType The chat type
@@ -676,7 +676,7 @@ class Composer {
      * ```
      *
      * Check out the
-     * [documentation](https://grammy.dev/guide/errors.html#error-boundaries) on
+     * [documentation](https://grammy.dev/guide/errors#error-boundaries) on
      * the website to learn more about error boundaries.
      *
      * @param errorHandler The error handler to use

package/out/context.d.ts

@@ -4,7 +4,7 @@ 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 InputPaidMedia, type InputPollOption, 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[];
 /** permits `string` but gives hints */
-export type StringWithCommandSuggestions = (string & Record<never, never>) | "start" | "help" | "settings" | "privacy";
+export type StringWithCommandSuggestions = (string & Record<never, never>) | "start" | "help" | "settings" | "privacy" | "developer_info";
 type Other<M extends Methods<RawApi>, X extends string = never> = OtherApi<RawApi, M, X>;
 type SnakeToCamelCase<S extends string> = S extends `${infer L}_${infer R}` ? `${L}${Capitalize<SnakeToCamelCase<R>>}` : S;
 type AliasProps<U> = {
@@ -135,7 +135,7 @@ interface StaticHas {
  * methods to keep information about how a regular expression was matched.
  *
  * Read up about middleware on the
- * [website](https://grammy.dev/guide/context.html) if you want to know more
+ * [website](https://grammy.dev/guide/context) if you want to know more
  * about the powerful opportunities that lie in context objects, and about how
  * grammY implements them.
  */
@@ -308,15 +308,18 @@ export declare class Context implements RenamedUpdate {
      *   customEmojiAdded: [],
      *   customEmojiKept: [],
      *   customEmojiRemoved: ['id0123'],
+     *   paid: true,
+     *   paidAdded: false,
+     *   paidRemoved: false,
      * }
      * ```
      * 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`.
+     * update. The user had already reacted with a thumbs up reaction and a paid
+     * star reaction, which they left both unchanged. As a result, the current
+     * reaction by the user is thumbs up, tada, and a paid reaction. Note that
+     * the current reaction (all emoji reactions regardless of type 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
@@ -341,6 +344,16 @@ export declare class Context implements RenamedUpdate {
         customEmojiKept: string[];
         /** Custom emoji removed from this user's reaction */
         customEmojiRemoved: string[];
+        /**
+         * `true` if a paid reaction is currently present in this user's
+         * reaction, and `false` otherwise
+         */
+        paid: boolean;
+        /**
+         * `true` if a paid reaction was newly added to this user's reaction,
+         * and `false` otherwise
+         */
+        paidAdded: boolean;
     };
     /**
      * `Context.has` is an object that contains a number of useful functions for
@@ -617,7 +630,7 @@ export declare class Context implements RenamedUpdate {
         location: import("@grammyjs/types/message.js").Location;
     })>;
     /**
-     * Context-aware alias for `api.sendPaidMedia`. Use this method to send paid media to channel chats. On success, the sent Message is returned.
+     * Context-aware alias for `api.sendPaidMedia`. Use this method to send paid media. On success, the sent Message is returned.
      *
      * @param star_count The number of Telegram Stars that must be paid to buy access to the media
      * @param media An array describing the media to be sent; up to 10 items
@@ -687,9 +700,9 @@ export declare class Context implements RenamedUpdate {
      */
     replyWithChatAction(action: "typing" | "upload_photo" | "record_video" | "upload_video" | "record_voice" | "upload_voice" | "upload_document" | "choose_sticker" | "find_location" | "record_video_note" | "upload_video_note", other?: Other<"sendChatAction", "chat_id" | "action">, signal?: AbortSignal): Promise<true>;
     /**
-     * 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.
+     * 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. Bots can't use paid reactions. Returns True on success.
      *
-     * @param reaction A 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 reaction A 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. Paid reactions can't be used by bots.
      * @param other Optional remaining parameters, confer the official reference below
      * @param signal Optional `AbortSignal` to cancel the request
      *
@@ -716,7 +729,7 @@ export declare class Context implements RenamedUpdate {
      */
     getUserChatBoosts(chat_id: number | string, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").UserChatBoosts>;
     /**
-     *  Context-aware alias for `api.getBusinessConnection`. Use this method to get information about the connection of the bot with a business account. Returns a BusinessConnection object on success.
+     * Context-aware alias for `api.getBusinessConnection`. Use this method to get information about the connection of the bot with a business account. Returns a BusinessConnection object on success.
      * @param signal Optional `AbortSignal` to cancel the request
      *
      * **Official reference:** https://core.telegram.org/bots/api#getbusinessconnection
@@ -872,7 +885,7 @@ export declare class Context implements RenamedUpdate {
      */
     createChatInviteLink(other?: Other<"createChatInviteLink", "chat_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ChatInviteLink>;
     /**
-     *  Context-aware alias for `api.editChatInviteLink`. Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the edited invite link as a ChatInviteLink object.
+     * Context-aware alias for `api.editChatInviteLink`. Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the edited invite link as a ChatInviteLink object.
      *
      * @param invite_link The invite link to edit
      * @param other Optional remaining parameters, confer the official reference below
@@ -882,7 +895,28 @@ export declare class Context implements RenamedUpdate {
      */
     editChatInviteLink(invite_link: string, other?: Other<"editChatInviteLink", "chat_id" | "invite_link">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ChatInviteLink>;
     /**
-     *  Context-aware alias for `api.revokeChatInviteLink`. Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the revoked invite link as ChatInviteLink object.
+     * Context-aware alias for `api.createChatSubscriptionInviteLink`. Use this method to create a subscription invite link for a channel chat. The bot must have the can_invite_users administrator rights. The link can be edited using the method editChatSubscriptionInviteLink or revoked using the method revokeChatInviteLink. Returns the new invite link as a ChatInviteLink object.
+     *
+     * @param subscription_period The number of seconds the subscription will be active for before the next payment. Currently, it must always be 2592000 (30 days).
+     * @param subscription_price The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-2500
+     * @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#createchatsubscriptioninvitelink
+     */
+    createChatSubscriptionInviteLink(subscription_period: number, subscription_price: number, other?: Other<"createChatSubscriptionInviteLink", "chat_id" | "subscription_period" | "subscription_price">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ChatInviteLink>;
+    /**
+     * Context-aware alias for `api.editChatSubscriptionInviteLink`. Use this method to edit a subscription invite link created by the bot. The bot must have the can_invite_users administrator rights. Returns the edited invite link as a ChatInviteLink object.
+     *
+     * @param invite_link The invite link to edit
+     * @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#editchatsubscriptioninvitelink
+     */
+    editChatSubscriptionInviteLink(invite_link: string, other?: Other<"editChatSubscriptionInviteLink", "chat_id" | "invite_link">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ChatInviteLink>;
+    /**
+     * Context-aware alias for `api.revokeChatInviteLink`. Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the revoked invite link as ChatInviteLink object.
      *
      * @param invite_link The invite link to revoke
      * @param signal Optional `AbortSignal` to cancel the request
@@ -1049,7 +1083,7 @@ export declare class Context implements RenamedUpdate {
      */
     createForumTopic(name: string, other?: Other<"createForumTopic", "chat_id" | "name">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ForumTopic>;
     /**
-     * Context-aware alias for `api.editForumTopic`. Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.
+     * Context-aware alias for `api.editForumTopic`. Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.
      *
      * @param other Optional remaining parameters, confer the official reference below
      * @param signal Optional `AbortSignal` to cancel the request
@@ -1090,7 +1124,7 @@ export declare class Context implements RenamedUpdate {
      */
     unpinAllForumTopicMessages(signal?: AbortSignal): Promise<true>;
     /**
-     * Context-aware alias for `api.editGeneralForumTopic`. Use this method to edit the name of the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have can_manage_topics administrator rights. Returns True on success.
+     * Context-aware alias for `api.editGeneralForumTopic`. Use this method to edit the name of the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns True on success.
      *
      * @param name New topic name, 1-128 characters
      * @param signal Optional `AbortSignal` to cancel the request

package/out/context.js

@@ -67,11 +67,18 @@ const checker = {
         const normalized = typeof reaction === "string"
             ? [{ type: "emoji", emoji: reaction }]
             : (Array.isArray(reaction) ? reaction : [reaction]).map((emoji) => typeof emoji === "string" ? { type: "emoji", emoji } : emoji);
+        const emoji = new Set(normalized.filter((r) => r.type === "emoji")
+            .map((r) => r.emoji));
+        const customEmoji = new Set(normalized.filter((r) => r.type === "custom_emoji")
+            .map((r) => r.custom_emoji_id));
+        const paid = normalized.some((r) => r.type === "paid");
         return (ctx) => {
             if (!hasMessageReaction(ctx))
                 return false;
             const { old_reaction, new_reaction } = ctx.messageReaction;
+            // try to find a wanted reaction that is new and not old
             for (const reaction of new_reaction) {
+                // first check if the reaction existed previously
                 let isOld = false;
                 if (reaction.type === "emoji") {
                     for (const old of old_reaction) {
@@ -93,34 +100,38 @@ const checker = {
                         }
                     }
                 }
+                else if (reaction.type === "paid") {
+                    for (const old of old_reaction) {
+                        if (old.type !== "paid")
+                            continue;
+                        isOld = true;
+                        break;
+                    }
+                }
                 else {
                     // always regard unsupported emoji types as new
                 }
-                if (!isOld) {
-                    if (reaction.type === "emoji") {
-                        for (const wanted of normalized) {
-                            if (wanted.type !== "emoji")
-                                continue;
-                            if (wanted.emoji === reaction.emoji) {
-                                return true;
-                            }
-                        }
-                    }
-                    else if (reaction.type === "custom_emoji") {
-                        for (const wanted of normalized) {
-                            if (wanted.type !== "custom_emoji")
-                                continue;
-                            if (wanted.custom_emoji_id ===
-                                reaction.custom_emoji_id) {
-                                return true;
-                            }
-                        }
-                    }
-                    else {
-                        // always regard unsupported emoji types as new
+                // disregard reaction if it is not new
+                if (isOld)
+                    continue;
+                // check if the new reaction is wanted and short-circuit
+                if (reaction.type === "emoji") {
+                    if (emoji.has(reaction.emoji))
                         return true;
-                    }
                 }
+                else if (reaction.type === "custom_emoji") {
+                    if (customEmoji.has(reaction.custom_emoji_id))
+                        return true;
+                }
+                else if (reaction.type === "paid") {
+                    if (paid)
+                        return true;
+                }
+                else {
+                    // always regard unsupported emoji types as new
+                    return true;
+                }
+                // new reaction not wanted, check next one
             }
             return false;
         };
@@ -198,7 +209,7 @@ const checker = {
  * methods to keep information about how a regular expression was matched.
  *
  * Read up about middleware on the
- * [website](https://grammy.dev/guide/context.html) if you want to know more
+ * [website](https://grammy.dev/guide/context) if you want to know more
  * about the powerful opportunities that lie in context objects, and about how
  * grammY implements them.
  */
@@ -427,15 +438,18 @@ class Context {
      *   customEmojiAdded: [],
      *   customEmojiKept: [],
      *   customEmojiRemoved: ['id0123'],
+     *   paid: true,
+     *   paidAdded: false,
+     *   paidRemoved: false,
      * }
      * ```
      * 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`.
+     * update. The user had already reacted with a thumbs up reaction and a paid
+     * star reaction, which they left both unchanged. As a result, the current
+     * reaction by the user is thumbs up, tada, and a paid reaction. Note that
+     * the current reaction (all emoji reactions regardless of type 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
@@ -452,6 +466,8 @@ class Context {
         const customEmojiAdded = [];
         const customEmojiKept = [];
         const customEmojiRemoved = [];
+        let paid = false;
+        let paidAdded = false;
         const r = this.messageReaction;
         if (r !== undefined) {
             const { old_reaction, new_reaction } = r;
@@ -463,6 +479,9 @@ class Context {
                 else if (reaction.type === "custom_emoji") {
                     customEmoji.push(reaction.custom_emoji_id);
                 }
+                else if (reaction.type === "paid") {
+                    paid = paidAdded = true;
+                }
             }
             // temporarily move all old emoji to the *Removed arrays
             for (const reaction of old_reaction) {
@@ -472,6 +491,9 @@ class Context {
                 else if (reaction.type === "custom_emoji") {
                     customEmojiRemoved.push(reaction.custom_emoji_id);
                 }
+                else if (reaction.type === "paid") {
+                    paidAdded = false;
+                }
             }
             // temporarily move all new emoji to the *Added arrays
             emojiAdded.push(...emoji);
@@ -518,6 +540,8 @@ class Context {
             customEmojiAdded,
             customEmojiKept,
             customEmojiRemoved,
+            paid,
+            paidAdded,
         };
     }
     /**
@@ -831,7 +855,7 @@ class Context {
             : this.api.stopMessageLiveLocation(orThrow(this.chatId, "stopMessageLiveLocation"), orThrow(this.msgId, "stopMessageLiveLocation"), other, signal);
     }
     /**
-     * Context-aware alias for `api.sendPaidMedia`. Use this method to send paid media to channel chats. On success, the sent Message is returned.
+     * Context-aware alias for `api.sendPaidMedia`. Use this method to send paid media. On success, the sent Message is returned.
      *
      * @param star_count The number of Telegram Stars that must be paid to buy access to the media
      * @param media An array describing the media to be sent; up to 10 items
@@ -913,9 +937,9 @@ class Context {
         return this.api.sendChatAction(orThrow(this.chatId, "sendChatAction"), action, { business_connection_id: this.businessConnectionId, ...other }, signal);
     }
     /**
-     * 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.
+     * 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. Bots can't use paid reactions. Returns True on success.
      *
-     * @param reaction A 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 reaction A 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. Paid reactions can't be used by bots.
      * @param other Optional remaining parameters, confer the official reference below
      * @param signal Optional `AbortSignal` to cancel the request
      *
@@ -953,7 +977,7 @@ class Context {
         return this.api.getUserChatBoosts(chat_id, orThrow(this.from, "getUserChatBoosts").id, signal);
     }
     /**
-     *  Context-aware alias for `api.getBusinessConnection`. Use this method to get information about the connection of the bot with a business account. Returns a BusinessConnection object on success.
+     * Context-aware alias for `api.getBusinessConnection`. Use this method to get information about the connection of the bot with a business account. Returns a BusinessConnection object on success.
      * @param signal Optional `AbortSignal` to cancel the request
      *
      * **Official reference:** https://core.telegram.org/bots/api#getbusinessconnection
@@ -1150,7 +1174,7 @@ class Context {
         return this.api.createChatInviteLink(orThrow(this.chatId, "createChatInviteLink"), other, signal);
     }
     /**
-     *  Context-aware alias for `api.editChatInviteLink`. Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the edited invite link as a ChatInviteLink object.
+     * Context-aware alias for `api.editChatInviteLink`. Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the edited invite link as a ChatInviteLink object.
      *
      * @param invite_link The invite link to edit
      * @param other Optional remaining parameters, confer the official reference below
@@ -1162,7 +1186,32 @@ class Context {
         return this.api.editChatInviteLink(orThrow(this.chatId, "editChatInviteLink"), invite_link, other, signal);
     }
     /**
-     *  Context-aware alias for `api.revokeChatInviteLink`. Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the revoked invite link as ChatInviteLink object.
+     * Context-aware alias for `api.createChatSubscriptionInviteLink`. Use this method to create a subscription invite link for a channel chat. The bot must have the can_invite_users administrator rights. The link can be edited using the method editChatSubscriptionInviteLink or revoked using the method revokeChatInviteLink. Returns the new invite link as a ChatInviteLink object.
+     *
+     * @param subscription_period The number of seconds the subscription will be active for before the next payment. Currently, it must always be 2592000 (30 days).
+     * @param subscription_price The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat; 1-2500
+     * @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#createchatsubscriptioninvitelink
+     */
+    createChatSubscriptionInviteLink(subscription_period, subscription_price, other, signal) {
+        return this.api.createChatSubscriptionInviteLink(orThrow(this.chatId, "createChatSubscriptionInviteLink"), subscription_period, subscription_price, other, signal);
+    }
+    /**
+     * Context-aware alias for `api.editChatSubscriptionInviteLink`. Use this method to edit a subscription invite link created by the bot. The bot must have the can_invite_users administrator rights. Returns the edited invite link as a ChatInviteLink object.
+     *
+     * @param invite_link The invite link to edit
+     * @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#editchatsubscriptioninvitelink
+     */
+    editChatSubscriptionInviteLink(invite_link, other, signal) {
+        return this.api.editChatSubscriptionInviteLink(orThrow(this.chatId, "editChatSubscriptionInviteLink"), invite_link, other, signal);
+    }
+    /**
+     * Context-aware alias for `api.revokeChatInviteLink`. Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the revoked invite link as ChatInviteLink object.
      *
      * @param invite_link The invite link to revoke
      * @param signal Optional `AbortSignal` to cancel the request
@@ -1369,7 +1418,7 @@ class Context {
         return this.api.createForumTopic(orThrow(this.chatId, "createForumTopic"), name, other, signal);
     }
     /**
-     * Context-aware alias for `api.editForumTopic`. Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.
+     * Context-aware alias for `api.editForumTopic`. Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights, unless it is the creator of the topic. Returns True on success.
      *
      * @param other Optional remaining parameters, confer the official reference below
      * @param signal Optional `AbortSignal` to cancel the request
@@ -1430,7 +1479,7 @@ class Context {
         return this.api.unpinAllForumTopicMessages(message.chat.id, thread, signal);
     }
     /**
-     * Context-aware alias for `api.editGeneralForumTopic`. Use this method to edit the name of the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have can_manage_topics administrator rights. Returns True on success.
+     * Context-aware alias for `api.editGeneralForumTopic`. Use this method to edit the name of the 'General' topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns True on success.
      *
      * @param name New topic name, 1-128 characters
      * @param signal Optional `AbortSignal` to cancel the request

package/out/convenience/inline_query.d.ts

@@ -163,7 +163,7 @@ export declare const InlineQueryResultBuilder: {
      * @param options Remaining options
      */
     game(id: string, game_short_name: string, options?: InlineQueryResultOptions<InlineQueryResultGame, "game_short_name">): {
-        reply_markup?: import("@grammyjs/types/markup.js").InlineKeyboardMarkup | undefined;
+        reply_markup?: import("@grammyjs/types/markup.js").InlineKeyboardMarkup;
         type: string;
         id: string;
         game_short_name: string;