grammy 1.28.0 → 1.29.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,9 @@ 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></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> = {
@@ -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;
         };
@@ -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/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 {
     /**

package/out/core/api.d.ts

@@ -360,7 +360,7 @@ export declare class Api<R extends RawApi = RawApi> {
         location: import("@grammyjs/types/message.js").Location;
     })>;
     /**
-     * Use this method to send paid media to channel chats. On success, the sent Message is returned.
+     * Use this method to send paid media. 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 star_count The number of Telegram Stars that must be paid to buy access to the media
@@ -421,11 +421,11 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     sendDice(chat_id: number | string, emoji: string, other?: Other<R, "sendDice", "chat_id" | "emoji">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").Message.DiceMessage>;
     /**
-     * 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.
+     * 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 chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param message_id Identifier of the target message
-     * @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
      *
@@ -598,7 +598,7 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     createChatInviteLink(chat_id: number | string, other?: Other<R, "createChatInviteLink", "chat_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ChatInviteLink>;
     /**
-     *  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.
+     * 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 chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param invite_link The invite link to edit
@@ -609,7 +609,30 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     editChatInviteLink(chat_id: number | string, invite_link: string, other?: Other<R, "editChatInviteLink", "chat_id" | "invite_link">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ChatInviteLink>;
     /**
-     *  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.
+     * 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 chat_id Unique identifier for the target channel chat or username of the target channel (in the format @channelusername)
+     * @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(chat_id: number | string, subscription_period: number, subscription_price: number, other?: Other<R, "createChatSubscriptionInviteLink", "chat_id" | "subscription_period" | "subscription_price">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ChatInviteLink>;
+    /**
+     * 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 chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @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(chat_id: number | string, invite_link: string, other?: Other<R, "editChatSubscriptionInviteLink", "chat_id" | "invite_link">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ChatInviteLink>;
+    /**
+     * 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 chat_id Unique identifier of the target chat or username of the target channel (in the format @channelusername)
      * @param invite_link The invite link to revoke
@@ -795,7 +818,7 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     createForumTopic(chat_id: number | string, name: string, other?: Other<R, "createForumTopic", "chat_id" | "name">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").ForumTopic>;
     /**
-     * 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.
+     * 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 chat_id Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)
      * @param message_thread_id Unique identifier for the target message thread of the forum topic
@@ -846,7 +869,7 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     unpinAllForumTopicMessages(chat_id: number | string, message_thread_id: number, signal?: AbortSignal): Promise<true>;
     /**
-     * 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.
+     * 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 chat_id Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)
      * @param name New topic name, 1-128 characters

package/out/core/api.js

@@ -381,7 +381,7 @@ class Api {
         return this.raw.stopMessageLiveLocation({ inline_message_id, ...other }, signal);
     }
     /**
-     * Use this method to send paid media to channel chats. On success, the sent Message is returned.
+     * Use this method to send paid media. 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 star_count The number of Telegram Stars that must be paid to buy access to the media
@@ -452,11 +452,11 @@ class Api {
         return this.raw.sendDice({ chat_id, emoji, ...other }, signal);
     }
     /**
-     * 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.
+     * 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 chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param message_id Identifier of the target message
-     * @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
      *
@@ -668,7 +668,7 @@ class Api {
         return this.raw.createChatInviteLink({ chat_id, ...other }, signal);
     }
     /**
-     *  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.
+     * 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 chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param invite_link The invite link to edit
@@ -681,7 +681,34 @@ class Api {
         return this.raw.editChatInviteLink({ chat_id, invite_link, ...other }, signal);
     }
     /**
-     *  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.
+     * 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 chat_id Unique identifier for the target channel chat or username of the target channel (in the format @channelusername)
+     * @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(chat_id, subscription_period, subscription_price, other, signal) {
+        return this.raw.createChatSubscriptionInviteLink({ chat_id, subscription_period, subscription_price, ...other }, signal);
+    }
+    /**
+     * 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 chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @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(chat_id, invite_link, other, signal) {
+        return this.raw.editChatSubscriptionInviteLink({ chat_id, invite_link, ...other }, signal);
+    }
+    /**
+     * 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 chat_id Unique identifier of the target chat or username of the target channel (in the format @channelusername)
      * @param invite_link The invite link to revoke
@@ -907,7 +934,7 @@ class Api {
         return this.raw.createForumTopic({ chat_id, name, ...other }, signal);
     }
     /**
-     * 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.
+     * 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 chat_id Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)
      * @param message_thread_id Unique identifier for the target message thread of the forum topic
@@ -968,7 +995,7 @@ class Api {
         return this.raw.unpinAllForumTopicMessages({ chat_id, message_thread_id }, signal);
     }
     /**
-     * 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.
+     * 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 chat_id Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)
      * @param name New topic name, 1-128 characters

package/out/filter.d.ts

@@ -742,16 +742,19 @@ declare const UPDATE_KEYS: {
         readonly old_reaction: {
             readonly emoji: {};
             readonly custom_emoji: {};
+            readonly paid: {};
         };
         readonly new_reaction: {
             readonly emoji: {};
             readonly custom_emoji: {};
+            readonly paid: {};
         };
     };
     readonly message_reaction_count: {
         readonly reactions: {
             readonly emoji: {};
             readonly custom_emoji: {};
+            readonly paid: {};
         };
     };
     readonly chat_boost: {};

package/out/filter.js

@@ -241,6 +241,7 @@ const STICKER_KEYS = {
 const REACTION_KEYS = {
     emoji: {},
     custom_emoji: {},
+    paid: {},
 };
 // L2
 const COMMON_MESSAGE_KEYS = {

package/out/web.mjs

@@ -187,7 +187,8 @@ const STICKER_KEYS = {
 };
 const REACTION_KEYS = {
     emoji: {},
-    custom_emoji: {}
+    custom_emoji: {},
+    paid: {}
 };
 const COMMON_MESSAGE_KEYS = {
     forward_origin: FORWARD_ORIGIN_KEYS,
@@ -405,6 +406,9 @@ const checker = {
                 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;
@@ -426,25 +430,22 @@ const checker = {
                             break;
                         }
                     }
-                } else {}
-                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 {
-                        return true;
+                } else if (reaction.type === "paid") {
+                    for (const old of old_reaction){
+                        if (old.type !== "paid") continue;
+                        isOld = true;
+                        break;
                     }
+                } else {}
+                if (isOld) continue;
+                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 {
+                    return true;
                 }
             }
             return false;
@@ -610,6 +611,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;
@@ -618,6 +621,8 @@ class Context {
                     emoji.push(reaction.emoji);
                 } else if (reaction.type === "custom_emoji") {
                     customEmoji.push(reaction.custom_emoji_id);
+                } else if (reaction.type === "paid") {
+                    paid = paidAdded = true;
                 }
             }
             for (const reaction of old_reaction){
@@ -625,6 +630,8 @@ class Context {
                     emojiRemoved.push(reaction.emoji);
                 } else if (reaction.type === "custom_emoji") {
                     customEmojiRemoved.push(reaction.custom_emoji_id);
+                } else if (reaction.type === "paid") {
+                    paidAdded = false;
                 }
             }
             emojiAdded.push(...emoji);
@@ -666,7 +673,9 @@ class Context {
             customEmoji,
             customEmojiAdded,
             customEmojiKept,
-            customEmojiRemoved
+            customEmojiRemoved,
+            paid,
+            paidAdded
         };
     }
     static has = checker;
@@ -894,6 +903,12 @@ class Context {
     editChatInviteLink(invite_link, other, signal) {
         return this.api.editChatInviteLink(orThrow(this.chatId, "editChatInviteLink"), invite_link, other, signal);
     }
+    createChatSubscriptionInviteLink(subscription_period, subscription_price, other, signal) {
+        return this.api.createChatSubscriptionInviteLink(orThrow(this.chatId, "createChatSubscriptionInviteLink"), subscription_period, subscription_price, other, signal);
+    }
+    editChatSubscriptionInviteLink(invite_link, other, signal) {
+        return this.api.editChatSubscriptionInviteLink(orThrow(this.chatId, "editChatSubscriptionInviteLink"), invite_link, other, signal);
+    }
     revokeChatInviteLink(invite_link, signal) {
         return this.api.revokeChatInviteLink(orThrow(this.chatId, "editChatInviteLink"), invite_link, signal);
     }
@@ -2722,6 +2737,21 @@ class Api {
             ...other
         }, signal);
     }
+    createChatSubscriptionInviteLink(chat_id, subscription_period, subscription_price, other, signal) {
+        return this.raw.createChatSubscriptionInviteLink({
+            chat_id,
+            subscription_period,
+            subscription_price,
+            ...other
+        }, signal);
+    }
+    editChatSubscriptionInviteLink(chat_id, invite_link, other, signal) {
+        return this.raw.editChatSubscriptionInviteLink({
+            chat_id,
+            invite_link,
+            ...other
+        }, signal);
+    }
     revokeChatInviteLink(chat_id, invite_link, signal) {
         return this.raw.revokeChatInviteLink({
             chat_id,

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "grammy",
     "description": "The Telegram Bot Framework.",
-    "version": "1.28.0",
+    "version": "1.29.0",
     "author": "KnorpelSenf",
     "license": "MIT",
     "engines": {
@@ -17,7 +17,7 @@
         "backport": "deno2node tsconfig.json"
     },
     "dependencies": {
-        "@grammyjs/types": "3.12.0",
+        "@grammyjs/types": "3.13.0",
         "abort-controller": "^3.0.0",
         "debug": "^4.3.4",
         "node-fetch": "^2.7.0"