grammy 1.40.0 → 1.41.0

package/README.md

@@ -10,7 +10,7 @@
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-9.4-blue?logo=telegram&style=flat&labelColor=000&color=3b82f6)](https://core.telegram.org/bots/api)
+[![Bot API](https://img.shields.io/badge/Bot%20API-9.5-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-)
@@ -262,7 +262,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/AbbassAlmusawi"><img src="https://avatars.githubusercontent.com/u/73327881?v=4?s=100" width="100px;" alt="Abbass Al-Musawi"/><br /><sub><b>Abbass Al-Musawi</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=AbbassAlmusawi" title="Documentation">📖</a> <a href="https://github.com/grammyjs/grammY/issues?q=author%3AAbbassAlmusawi" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=AbbassAlmusawi" title="Code">💻</a></td>
     </tr>
     <tr>
-      <td align="center" valign="top" width="11.11%"><a href="https://github.com/inji-gg"><img src="https://avatars.githubusercontent.com/u/5071242?v=4?s=100" width="100px;" alt="ArunR"/><br /><sub><b>ArunR</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ainji-gg" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=inji-gg" title="Code">💻</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/arunr-inji"><img src="https://avatars.githubusercontent.com/u/5071242?v=4?s=100" width="100px;" alt="ArunR"/><br /><sub><b>ArunR</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Aarunr-inji" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=arunr-inji" title="Code">💻</a> <a href="#ideas-arunr-inji" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/commits?author=arunr-inji" title="Tests">⚠️</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/ndatg"><img src="https://avatars.githubusercontent.com/u/108090198?v=4?s=100" width="100px;" alt="NDA"/><br /><sub><b>NDA</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Andatg" title="Bug reports">🐛</a> <a href="#ideas-ndatg" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/commits?author=ndatg" title="Code">💻</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/MatyiFKBT"><img src="https://avatars.githubusercontent.com/u/6183867?v=4?s=100" width="100px;" alt="MatyiFKBT"/><br /><sub><b>MatyiFKBT</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=MatyiFKBT" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://chrisandrew.cl"><img src="https://avatars.githubusercontent.com/u/368831?v=4?s=100" width="100px;" alt="Chris Andrew C. L."/><br /><sub><b>Chris Andrew C. L.</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Achrisandrewcl" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=chrisandrewcl" title="Code">💻</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Achrisandrewcl" title="Reviewed Pull Requests">👀</a></td>
@@ -332,8 +332,8 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/OfficialCodinary"><img src="https://avatars.githubusercontent.com/u/133005277?v=4?s=100" width="100px;" alt="Codinary"/><br /><sub><b>Codinary</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3AOfficialCodinary" title="Reviewed Pull Requests">👀</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/dotvhs"><img src="https://avatars.githubusercontent.com/u/681416?v=4?s=100" width="100px;" alt=".vhs"/><br /><sub><b>.vhs</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Adotvhs" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Adotvhs" title="Reviewed Pull Requests">👀</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://agou.im/"><img src="https://avatars.githubusercontent.com/u/55237525?v=4?s=100" width="100px;" alt="agoudbg"/><br /><sub><b>agoudbg</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Aagoudbg" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=agoudbg" title="Code">💻</a></td>
-      <td align="center" valign="top" width="11.11%"><a href="https://github.com/arunr-inji"><img src="https://avatars.githubusercontent.com/u/5071242?v=4?s=100" width="100px;" alt="ArunR"/><br /><sub><b>ArunR</b></sub></a><br /><a href="#ideas-arunr-inji" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/commits?author=arunr-inji" title="Code">💻</a> <a href="https://github.com/grammyjs/grammY/commits?author=arunr-inji" title="Tests">⚠️</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/crwnd"><img src="https://avatars.githubusercontent.com/u/97118277?v=4?s=100" width="100px;" alt="A"/><br /><sub><b>A</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Acrwnd" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Acrwnd" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="http://www.linkedin.com/in/huntharo/"><img src="https://avatars.githubusercontent.com/u/5617868?v=4?s=100" width="100px;" alt="Harold Hunt"/><br /><sub><b>Harold Hunt</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ahuntharo" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=huntharo" title="Code">💻</a> <a href="https://github.com/grammyjs/grammY/commits?author=huntharo" title="Tests">⚠️</a></td>
     </tr>
   </tbody>
 </table>

package/out/context.d.ts

@@ -473,7 +473,7 @@ export declare class Context implements RenamedUpdate {
      */
     reply(text: string, other?: Other<"sendMessage", "chat_id" | "text">, signal?: AbortSignal): Promise<Message.TextMessage>;
     /**
-     * Context-aware alias for `api.sendMessageDraft`. Use this method to stream a partial message to a user while the message is being generated; supported only for bots with forum topic mode enabled. Returns True on success.
+     * Context-aware alias for `api.sendMessageDraft`. Use this method to stream a partial message to a user while the message is being generated. Returns True on success.
      *
      * @param text Text of the message to be sent, 1-4096 characters after entities parsing
      * @param other Optional remaining parameters, confer the official reference below
@@ -905,6 +905,25 @@ export declare class Context implements RenamedUpdate {
      * **Official reference:** https://core.telegram.org/bots/api#setchatadministratorcustomtitle
      */
     setChatAdministratorCustomTitle(user_id: number, custom_title: string, signal?: AbortSignal): Promise<true>;
+    /**
+     * Context-aware alias for `api.setChatMemberTag`. Use this method to set a tag for a regular member in a group or a supergroup. The bot must be an administrator in the chat for this to work and must have the “can_manage_tags” administrator right. Returns True on success.
+     *
+     * @param tag New tag for the member; 0-16 characters, emoji are not allowed
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#setChatMemberTag
+     */
+    setAuthorTag(tag: string, signal?: AbortSignal): Promise<true>;
+    /**
+     * Context-aware alias for `api.setChatMemberTag`. Use this method to set a tag for a regular member in a group or a supergroup. The bot must be an administrator in the chat for this to work and must have the “can_manage_tags” administrator right. Returns True on success.
+     *
+     * @param user_id Unique identifier of the target user
+     * @param tag New tag for the member; 0-16 characters, emoji are not allowed
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#setChatMemberTag
+     */
+    setChatMemberTag(user_id: number, tag: string, signal?: AbortSignal): Promise<true>;
     /**
      * Context-aware alias for `api.banChatSenderChat`. Use this method to ban a channel chat in a supergroup or a channel. Until the chat is unbanned, the owner of the banned chat won't be able to send messages on behalf of any of their channels. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns True on success.
      *

package/out/context.js

@@ -678,7 +678,7 @@ class Context {
         }, signal);
     }
     /**
-     * Context-aware alias for `api.sendMessageDraft`. Use this method to stream a partial message to a user while the message is being generated; supported only for bots with forum topic mode enabled. Returns True on success.
+     * Context-aware alias for `api.sendMessageDraft`. Use this method to stream a partial message to a user while the message is being generated. Returns True on success.
      *
      * @param text Text of the message to be sent, 1-4096 characters after entities parsing
      * @param other Optional remaining parameters, confer the official reference below
@@ -1368,6 +1368,29 @@ class Context {
     setChatAdministratorCustomTitle(user_id, custom_title, signal) {
         return this.api.setChatAdministratorCustomTitle(orThrow(this.chatId, "setChatAdministratorCustomTitle"), user_id, custom_title, signal);
     }
+    /**
+     * Context-aware alias for `api.setChatMemberTag`. Use this method to set a tag for a regular member in a group or a supergroup. The bot must be an administrator in the chat for this to work and must have the “can_manage_tags” administrator right. Returns True on success.
+     *
+     * @param tag New tag for the member; 0-16 characters, emoji are not allowed
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#setChatMemberTag
+     */
+    setAuthorTag(tag, signal) {
+        return this.api.setChatMemberTag(orThrow(this.chatId, "setChatMemberTag"), orThrow(this.from, "setChatMemberTag").id, tag, signal);
+    }
+    /**
+     * Context-aware alias for `api.setChatMemberTag`. Use this method to set a tag for a regular member in a group or a supergroup. The bot must be an administrator in the chat for this to work and must have the “can_manage_tags” administrator right. Returns True on success.
+     *
+     * @param user_id Unique identifier of the target user
+     * @param tag New tag for the member; 0-16 characters, emoji are not allowed
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#setChatMemberTag
+     */
+    setChatMemberTag(user_id, tag, signal) {
+        return this.api.setChatMemberTag(orThrow(this.chatId, "setChatMemberTag"), user_id, tag, signal);
+    }
     /**
      * Context-aware alias for `api.banChatSenderChat`. Use this method to ban a channel chat in a supergroup or a channel. Until the chat is unbanned, the owner of the banned chat won't be able to send messages on behalf of any of their channels. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns True on success.
      *

package/out/convenience/constants.d.ts

@@ -1,19 +1,19 @@
 import { DEFAULT_UPDATE_TYPES } from "../bot.js";
 declare const ALL_UPDATE_TYPES: readonly ["message", "edited_message", "channel_post", "edited_channel_post", "business_connection", "business_message", "edited_business_message", "deleted_business_messages", "inline_query", "chosen_inline_result", "callback_query", "shipping_query", "pre_checkout_query", "purchased_paid_media", "poll", "poll_answer", "my_chat_member", "chat_join_request", "chat_boost", "removed_chat_boost", "chat_member", "message_reaction", "message_reaction_count"];
 declare const ALL_CHAT_PERMISSIONS: {
-    readonly is_anonymous: true;
-    readonly can_manage_chat: true;
-    readonly can_delete_messages: true;
-    readonly can_manage_video_chats: true;
-    readonly can_restrict_members: true;
-    readonly can_promote_members: true;
+    readonly can_send_messages: true;
+    readonly can_send_audios: true;
+    readonly can_send_documents: true;
+    readonly can_send_photos: true;
+    readonly can_send_videos: true;
+    readonly can_send_video_notes: true;
+    readonly can_send_voice_notes: true;
+    readonly can_send_polls: true;
+    readonly can_send_other_messages: true;
+    readonly can_add_web_page_previews: true;
     readonly can_change_info: true;
     readonly can_invite_users: true;
-    readonly can_post_stories: true;
-    readonly can_edit_stories: true;
-    readonly can_delete_stories: true;
-    readonly can_post_messages: true;
-    readonly can_edit_messages: true;
+    readonly can_edit_tag: true;
     readonly can_pin_messages: true;
     readonly can_manage_topics: true;
 };
@@ -77,7 +77,7 @@ export interface ApiConstants {
      * await ctx.restrictAuthor(ALL_CHAT_PERMISSIONS);
      * ```
      *
-     * See the [Bot API reference](https://core.telegram.org/bots/api#update)
+     * See the [Bot API reference](https://core.telegram.org/bots/api#chatpermissions)
      * for more information.
      */
     ALL_CHAT_PERMISSIONS: keyof typeof ALL_CHAT_PERMISSIONS;

package/out/convenience/constants.js

@@ -9,19 +9,19 @@ const ALL_UPDATE_TYPES = [
     "message_reaction_count",
 ];
 const ALL_CHAT_PERMISSIONS = {
-    is_anonymous: true,
-    can_manage_chat: true,
-    can_delete_messages: true,
-    can_manage_video_chats: true,
-    can_restrict_members: true,
-    can_promote_members: true,
+    can_send_messages: true,
+    can_send_audios: true,
+    can_send_documents: true,
+    can_send_photos: true,
+    can_send_videos: true,
+    can_send_video_notes: true,
+    can_send_voice_notes: true,
+    can_send_polls: true,
+    can_send_other_messages: true,
+    can_add_web_page_previews: true,
     can_change_info: true,
     can_invite_users: true,
-    can_post_stories: true,
-    can_edit_stories: true,
-    can_delete_stories: true,
-    can_post_messages: true,
-    can_edit_messages: true,
+    can_edit_tag: true,
     can_pin_messages: true,
     can_manage_topics: true,
 };

package/out/convenience/frameworks.js

@@ -204,7 +204,12 @@ const http = (req, res) => {
                     // @ts-ignore `Buffer` is Node-only
                     // deno-lint-ignore no-node-globals
                     const raw = Buffer.concat(chunks).toString("utf-8");
-                    resolve(JSON.parse(raw));
+                    try {
+                        resolve(JSON.parse(raw));
+                    }
+                    catch (err) {
+                        reject(err);
+                    }
                 })
                     .once("error", reject);
             });

package/out/core/api.d.ts

@@ -155,7 +155,7 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     sendMessage(chat_id: number | string, text: string, other?: Other<R, "sendMessage", "chat_id" | "text">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").Message.TextMessage>;
     /**
-     * Use this method to stream a partial message to a user while the message is being generated; supported only for bots with forum topic mode enabled. Returns True on success.
+     * Use this method to stream a partial message to a user while the message is being generated. Returns True on success.
      *
      * @param chat_id Unique identifier for the target private chat
      * @param draft_id Unique identifier of the message draft; must be non-zero. Changes of drafts with the same identifier are animated
@@ -622,6 +622,17 @@ export declare class Api<R extends RawApi = RawApi> {
      * **Official reference:** https://core.telegram.org/bots/api#setchatadministratorcustomtitle
      */
     setChatAdministratorCustomTitle(chat_id: number | string, user_id: number, custom_title: string, signal?: AbortSignal): Promise<true>;
+    /**
+     * Use this method to set a tag for a regular member in a group or a supergroup. The bot must be an administrator in the chat for this to work and must have the “can_manage_tags” administrator right. Returns True on success.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)
+     * @param user_id Unique identifier of the target user
+     * @param tag New tag for the member; 0-16 characters, emoji are not allowed
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#setChatMemberTag
+     */
+    setChatMemberTag(chat_id: number | string, user_id: number, tag: string, signal?: AbortSignal): Promise<true>;
     /**
      * Use this method to ban a channel chat in a supergroup or a channel. Until the chat is unbanned, the owner of the banned chat won't be able to send messages on behalf of any of their channels. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns True on success.
      *

package/out/core/api.js

@@ -140,7 +140,7 @@ class Api {
         return this.raw.sendMessage({ chat_id, text, ...other }, signal);
     }
     /**
-     * Use this method to stream a partial message to a user while the message is being generated; supported only for bots with forum topic mode enabled. Returns True on success.
+     * Use this method to stream a partial message to a user while the message is being generated. Returns True on success.
      *
      * @param chat_id Unique identifier for the target private chat
      * @param draft_id Unique identifier of the message draft; must be non-zero. Changes of drafts with the same identifier are animated
@@ -708,6 +708,19 @@ class Api {
     setChatAdministratorCustomTitle(chat_id, user_id, custom_title, signal) {
         return this.raw.setChatAdministratorCustomTitle({ chat_id, user_id, custom_title }, signal);
     }
+    /**
+     * Use this method to set a tag for a regular member in a group or a supergroup. The bot must be an administrator in the chat for this to work and must have the “can_manage_tags” administrator right. Returns True on success.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)
+     * @param user_id Unique identifier of the target user
+     * @param tag New tag for the member; 0-16 characters, emoji are not allowed
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#setChatMemberTag
+     */
+    setChatMemberTag(chat_id, user_id, tag, signal) {
+        return this.raw.setChatMemberTag({ chat_id, user_id, tag }, signal);
+    }
     /**
      * Use this method to ban a channel chat in a supergroup or a channel. Until the chat is unbanned, the owner of the banned chat won't be able to send messages on behalf of any of their channels. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns True on success.
      *

package/out/web.mjs

@@ -1074,6 +1074,12 @@ class Context {
     setChatAdministratorCustomTitle(user_id, custom_title, signal) {
         return this.api.setChatAdministratorCustomTitle(orThrow(this.chatId, "setChatAdministratorCustomTitle"), user_id, custom_title, signal);
     }
+    setAuthorTag(tag, signal) {
+        return this.api.setChatMemberTag(orThrow(this.chatId, "setChatMemberTag"), orThrow(this.from, "setChatMemberTag").id, tag, signal);
+    }
+    setChatMemberTag(user_id, tag, signal) {
+        return this.api.setChatMemberTag(orThrow(this.chatId, "setChatMemberTag"), user_id, tag, signal);
+    }
     banChatSenderChat(sender_chat_id, signal) {
         return this.api.banChatSenderChat(orThrow(this.chatId, "banChatSenderChat"), sender_chat_id, signal);
     }
@@ -3120,6 +3126,13 @@ class Api {
             custom_title
         }, signal);
     }
+    setChatMemberTag(chat_id, user_id, tag, signal) {
+        return this.raw.setChatMemberTag({
+            chat_id,
+            user_id,
+            tag
+        }, signal);
+    }
     banChatSenderChat(chat_id, sender_chat_id, signal) {
         return this.raw.banChatSenderChat({
             chat_id,
@@ -4245,19 +4258,19 @@ const ALL_UPDATE_TYPES = [
     "message_reaction_count"
 ];
 const ALL_CHAT_PERMISSIONS = {
-    is_anonymous: true,
-    can_manage_chat: true,
-    can_delete_messages: true,
-    can_manage_video_chats: true,
-    can_restrict_members: true,
-    can_promote_members: true,
+    can_send_messages: true,
+    can_send_audios: true,
+    can_send_documents: true,
+    can_send_photos: true,
+    can_send_videos: true,
+    can_send_video_notes: true,
+    can_send_voice_notes: true,
+    can_send_polls: true,
+    can_send_other_messages: true,
+    can_add_web_page_previews: true,
     can_change_info: true,
     can_invite_users: true,
-    can_post_stories: true,
-    can_edit_stories: true,
-    can_delete_stories: true,
-    can_post_messages: true,
-    can_edit_messages: true,
+    can_edit_tag: true,
     can_pin_messages: true,
     can_manage_topics: true
 };
@@ -5577,7 +5590,11 @@ const http = (req, res)=>{
                 const chunks = [];
                 req.on("data", (chunk)=>chunks.push(chunk)).once("end", ()=>{
                     const raw = Buffer.concat(chunks).toString("utf-8");
-                    resolve(JSON.parse(raw));
+                    try {
+                        resolve(JSON.parse(raw));
+                    } catch (err) {
+                        reject(err);
+                    }
                 }).once("error", reject);
             });
         },

package/package.json

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