grammy 1.28.0 → 1.30.0

package/README.md

@@ -10,7 +10,7 @@
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-7.8-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-)
@@ -306,6 +306,10 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <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> <a href="#ideas-rayz1065" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/commits?author=rayz1065" title="Code">💻</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/z44d"><img src="https://avatars.githubusercontent.com/u/162994967?v=4?s=100" width="100px;" alt="Zaid"/><br /><sub><b>Zaid</b></sub></a><br /><a href="#tool-z44d" title="Tools">🔧</a></td>
+    </tr>
   </tbody>
 </table>
 

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> = {
@@ -216,6 +216,8 @@ export declare class Context implements RenamedUpdate {
     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;
+    /** Alias for `ctx.update.purchased_paid_media` */
+    get purchasedPaidMedia(): import("@grammyjs/types/payment.js").PaidMediaPurchased | undefined;
     /**
      * Get the message object from wherever possible. Alias for `this.message ??
      * this.editedMessage ?? this.channelPost ?? this.editedChannelPost ??
@@ -241,7 +243,8 @@ export declare class Context implements RenamedUpdate {
      * (this.chatBoost?.boost ?? this.removedChatBoost)?.source)?.user ??
      * (this.callbackQuery ?? this.msg ?? this.inlineQuery ??
      * this.chosenInlineResult ?? this.shippingQuery ?? this.preCheckoutQuery ??
-     * this.myChatMember ?? this.chatMember ?? this.chatJoinRequest)?.from`.
+     * this.myChatMember ?? this.chatMember ?? this.chatJoinRequest ??
+     * this.purchasedPaidMedia)?.from`.
      */
     get from(): User | undefined;
     /**
@@ -308,15 +311,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 +347,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 +633,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
@@ -665,13 +681,13 @@ export declare class Context implements RenamedUpdate {
     /**
      * Context-aware alias for `api.sendDice`. Use this method to send an animated emoji that will display a random value. On success, the sent Message is returned.
      *
-     * @param emoji Emoji on which the dice throw animation is based. Currently, must be one of “🎲”, “🎯”, “🏀”, “⚽”, or “🎰”. Dice can have values 1-6 for “🎲” and “🎯”, values 1-5 for “🏀” and “⚽”, and values 1-64 for “🎰”. Defaults to “🎲”
+     * @param emoji Emoji on which the dice throw animation is based. Currently, must be one of “🎲”, “🎯”, “🏀”, “⚽”, “🎳”, or “🎰”. Dice can have values 1-6 for “🎲”, “🎯” and “🎳”, values 1-5 for “🏀” and “⚽”, and values 1-64 for “🎰”. Defaults to “🎲”
      * @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
      */
-    replyWithDice(emoji: string, other?: Other<"sendDice", "chat_id" | "emoji">, signal?: AbortSignal): Promise<Message.DiceMessage>;
+    replyWithDice(emoji: (string & Record<never, never>) | "🎲" | "🎯" | "🏀" | "⚽" | "🎳" | "🎰", other?: Other<"sendDice", "chat_id" | "emoji">, signal?: AbortSignal): Promise<Message.DiceMessage>;
     /**
      * 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.
      *
@@ -687,9 +703,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 +732,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 +888,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 +898,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 +1086,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 +1127,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
@@ -1164,7 +1201,7 @@ export declare class Context implements RenamedUpdate {
      * @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#setchatmenubutton
+     * **Official reference:** https://core.telegram.org/bots/api#getchatmenubutton
      */
     getChatMenuButton(other?: Other<"getChatMenuButton">, signal?: AbortSignal): Promise<import("@grammyjs/types/settings.js").MenuButton>;
     /**

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;
         };
@@ -222,6 +233,7 @@ class Context {
         this.me = me;
     }
     // UPDATE SHORTCUTS
+    // Keep in sync with types in `filter.ts`.
     /** Alias for `ctx.update.message` */
     get message() {
         return this.update.message;
@@ -310,6 +322,10 @@ class Context {
     get removedChatBoost() {
         return this.update.removed_chat_boost;
     }
+    /** Alias for `ctx.update.purchased_paid_media` */
+    get purchasedPaidMedia() {
+        return this.update.purchased_paid_media;
+    }
     // AGGREGATION SHORTCUTS
     /**
      * Get the message object from wherever possible. Alias for `this.message ??
@@ -348,12 +364,13 @@ class Context {
      * (this.chatBoost?.boost ?? this.removedChatBoost)?.source)?.user ??
      * (this.callbackQuery ?? this.msg ?? this.inlineQuery ??
      * this.chosenInlineResult ?? this.shippingQuery ?? this.preCheckoutQuery ??
-     * this.myChatMember ?? this.chatMember ?? this.chatJoinRequest)?.from`.
+     * this.myChatMember ?? this.chatMember ?? this.chatJoinRequest ??
+     * this.purchasedPaidMedia)?.from`.
      */
     get from() {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
         // Keep in sync with types in `filter.ts`.
-        return (_g = (_f = ((_b = (_a = this.businessConnection) !== null && _a !== void 0 ? _a : this.messageReaction) !== null && _b !== void 0 ? _b : (_e = ((_d = (_c = this.chatBoost) === null || _c === void 0 ? void 0 : _c.boost) !== null && _d !== void 0 ? _d : this.removedChatBoost)) === null || _e === void 0 ? void 0 : _e.source)) === null || _f === void 0 ? void 0 : _f.user) !== null && _g !== void 0 ? _g : (_r = ((_q = (_p = (_o = (_m = (_l = (_k = (_j = (_h = this.callbackQuery) !== null && _h !== void 0 ? _h : this.msg) !== null && _j !== void 0 ? _j : this.inlineQuery) !== null && _k !== void 0 ? _k : this.chosenInlineResult) !== null && _l !== void 0 ? _l : this.shippingQuery) !== null && _m !== void 0 ? _m : this.preCheckoutQuery) !== null && _o !== void 0 ? _o : this.myChatMember) !== null && _p !== void 0 ? _p : this.chatMember) !== null && _q !== void 0 ? _q : this.chatJoinRequest)) === null || _r === void 0 ? void 0 : _r.from;
+        return (_g = (_f = ((_b = (_a = this.businessConnection) !== null && _a !== void 0 ? _a : this.messageReaction) !== null && _b !== void 0 ? _b : (_e = ((_d = (_c = this.chatBoost) === null || _c === void 0 ? void 0 : _c.boost) !== null && _d !== void 0 ? _d : this.removedChatBoost)) === null || _e === void 0 ? void 0 : _e.source)) === null || _f === void 0 ? void 0 : _f.user) !== null && _g !== void 0 ? _g : (_s = ((_r = (_q = (_p = (_o = (_m = (_l = (_k = (_j = (_h = this.callbackQuery) !== null && _h !== void 0 ? _h : this.msg) !== null && _j !== void 0 ? _j : this.inlineQuery) !== null && _k !== void 0 ? _k : this.chosenInlineResult) !== null && _l !== void 0 ? _l : this.shippingQuery) !== null && _m !== void 0 ? _m : this.preCheckoutQuery) !== null && _o !== void 0 ? _o : this.myChatMember) !== null && _p !== void 0 ? _p : this.chatMember) !== null && _q !== void 0 ? _q : this.chatJoinRequest) !== null && _r !== void 0 ? _r : this.purchasedPaidMedia)) === null || _s === void 0 ? void 0 : _s.from;
     }
     /**
      * Get the message identifier from wherever possible. Alias for
@@ -427,15 +444,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 +472,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 +485,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 +497,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 +546,8 @@ class Context {
             customEmojiAdded,
             customEmojiKept,
             customEmojiRemoved,
+            paid,
+            paidAdded,
         };
     }
     /**
@@ -831,7 +861,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
@@ -887,7 +917,7 @@ class Context {
     /**
      * Context-aware alias for `api.sendDice`. Use this method to send an animated emoji that will display a random value. On success, the sent Message is returned.
      *
-     * @param emoji Emoji on which the dice throw animation is based. Currently, must be one of “🎲”, “🎯”, “🏀”, “⚽”, or “🎰”. Dice can have values 1-6 for “🎲” and “🎯”, values 1-5 for “🏀” and “⚽”, and values 1-64 for “🎰”. Defaults to “🎲”
+     * @param emoji Emoji on which the dice throw animation is based. Currently, must be one of “🎲”, “🎯”, “🏀”, “⚽”, “🎳”, or “🎰”. Dice can have values 1-6 for “🎲”, “🎯” and “🎳”, values 1-5 for “🏀” and “⚽”, and values 1-64 for “🎰”. Defaults to “🎲”
      * @param other Optional remaining parameters, confer the official reference below
      * @param signal Optional `AbortSignal` to cancel the request
      *
@@ -913,9 +943,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 +983,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 +1180,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 +1192,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 +1424,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 +1485,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
@@ -1520,7 +1575,7 @@ class Context {
      * @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#setchatmenubutton
+     * **Official reference:** https://core.telegram.org/bots/api#getchatmenubutton
      */
     getChatMenuButton(other, signal) {
         return this.api.getChatMenuButton(other, signal);

package/out/convenience/frameworks.js

@@ -177,6 +177,7 @@ const http = (req, res) => {
             req.on("data", (chunk) => chunks.push(chunk))
                 .once("end", () => {
                 // @ts-ignore `Buffer` is Node-only
+                // deno-lint-ignore no-node-globals
                 const raw = Buffer.concat(chunks).toString("utf-8");
                 resolve(JSON.parse(raw));
             })

package/out/convenience/session.d.ts

@@ -7,22 +7,21 @@ type MaybePromise<T> = Promise<T> | T;
  *
  * Session middleware will load the session data of a specific chat from your
  * storage solution, and make it available to you on the context object. Check
- * out the
- * [documentation](https://grammy.dev/ref/core/session)
- * on session middleware to know more, and read the section about sessions on
- * the [website](https://grammy.dev/plugins/session).
+ * out the [documentation](https://grammy.dev/ref/core/session) on session
+ * middleware to know more, and read the section about sessions on the
+ * [website](https://grammy.dev/plugins/session).
  */
 export interface SessionFlavor<S> {
     /**
      * Session data on the context object.
      *
      * **WARNING:** You have to make sure that your session data is not
-     * undefined by _providing an initial value to the session middleware_, or by
-     * making sure that `ctx.session` is assigned if it is empty! The type
+     * undefined by _providing an initial value to the session middleware_, or
+     * by making sure that `ctx.session` is assigned if it is empty! The type
      * system does not include `| undefined` because this is really annoying to
      * work with.
      *
-     *  Accessing `ctx.session` by reading or writing will throw if
+     * Accessing `ctx.session` by reading or writing will throw if
      * `getSessionKey(ctx) === undefined` for the respective context object
      * `ctx`.
      */
@@ -37,9 +36,8 @@ export interface SessionFlavor<S> {
  * object. Once you access `ctx.session`, the storage will be queried and the
  * session data becomes available. If you access `ctx.session` again for the
  * same context object, the cached value will be used. Check out the
- * [documentation](https://grammy.dev/ref/core/lazysession)
- * on lazy session middleware to know more, and read the section about lazy
- * sessions on the
+ * [documentation](https://grammy.dev/ref/core/lazysession) on lazy session
+ * middleware to know more, and read the section about lazy sessions on the
  * [website](https://grammy.dev/plugins/session#lazy-sessions).
  */
 export interface LazySessionFlavor<S> {
@@ -301,11 +299,11 @@ export declare function enhanceStorage<T>(options: MigrationOptions<T>): Storage
  * This class is used as default if you do not provide a storage adapter, e.g.
  * to your database.
  *
- * This storage adapter features expiring sessions. When instantiating this class
- * yourself, you can pass a time to live in milliseconds that will be used for
- * each session object. If a session for a user expired, the session data will
- * be discarded on its first read, and a fresh session object as returned by the
- * `initial` option (or undefined) will be put into place.
+ * This storage adapter features expiring sessions. When instantiating this
+ * class yourself, you can pass a time to live in milliseconds that will be used
+ * for each session object. If a session for a user expired, the session data
+ * will be discarded on its first read, and a fresh session object as returned
+ * by the `initial` option (or undefined) will be put into place.
  */
 export declare class MemorySessionStorage<S> implements StorageAdapter<S> {
     private readonly timeToLive?;

package/out/convenience/session.js

@@ -375,11 +375,11 @@ function wrapStorage(storage) {
  * This class is used as default if you do not provide a storage adapter, e.g.
  * to your database.
  *
- * This storage adapter features expiring sessions. When instantiating this class
- * yourself, you can pass a time to live in milliseconds that will be used for
- * each session object. If a session for a user expired, the session data will
- * be discarded on its first read, and a fresh session object as returned by the
- * `initial` option (or undefined) will be put into place.
+ * This storage adapter features expiring sessions. When instantiating this
+ * class yourself, you can pass a time to live in milliseconds that will be used
+ * for each session object. If a session for a user expired, the session data
+ * will be discarded on its first read, and a fresh session object as returned
+ * by the `initial` option (or undefined) will be put into place.
  */
 class MemorySessionStorage {
     /**