grammy 1.4.3 → 1.5.3

package/README.md

@@ -4,15 +4,15 @@
 
 ---
 
-_<h2 align="center"> [:mag: Documentation](https://grammy.dev) | [:page_with_curl: API Reference](https://doc.deno.land/https/deno.land/x/grammy/mod.ts) | [:busts_in_silhouette: Group Chat](https://telegram.me/grammyjs) | [:new: News](https://telegram.me/grammyjs_news)</h2>_
+_<h2 align="center"> [:mag: Documentation](https://grammy.dev) | [:page_with_curl: API Reference](https://doc.deno.land/https://deno.land/x/grammy/mod.ts) | [:busts_in_silhouette: Group Chat](https://telegram.me/grammyjs) | [:new: News](https://telegram.me/grammyjs_news)</h2>_
 
 <div align="center">
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-5.4-blue?logo=telegram&style=flat-square)](https://core.telegram.org/bots/api)
+[![Bot API](https://img.shields.io/badge/Bot%20API-5.5-blue?logo=telegram&style=flat-square)](https://core.telegram.org/bots/api)
 [![npm](https://img.shields.io/npm/v/grammy?logo=npm&style=flat-square)](https://www.npmjs.org/package/grammy) <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-43-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-45-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <!-- deno-fmt-ignore-end -->
@@ -25,7 +25,7 @@ You want grammY because it is easy to use. It is very powerful and always up to
 
 Are you ready? 🤖🚀
 
-Bots are written in [TypeScript](https://www.typescriptlang.org/) (or JavaScript) and run on [Node.js](https://nodejs.org/).
+Bots are written in [TypeScript](https://www.typescriptlang.org/) (or JavaScript) and run on [Node.js](https://nodejs.org/) or [Deno](#deno-support).
 
 ## Quickstart
 
@@ -66,7 +66,7 @@ Congrats! You just wrote a Telegram bot :)
 
 ## Going Further
 
-grammY has an excellent [documentation](https://grammy.dev), and an [API Reference](https://doc.deno.land/https/deno.land/x/grammy/mod.ts). It even integrates with your code editor, e.g. [VSCode](https://code.visualstudio.com/). You can hover over any element of grammY to get a detailed description of what that thing does or means.
+grammY has an excellent [documentation](https://grammy.dev), and an [API Reference](https://doc.deno.land/https://deno.land/x/grammy/mod.ts). It even integrates with your code editor, e.g. [VSCode](https://code.visualstudio.com/). You can hover over any element of grammY to get a detailed description of what that thing does or means.
 
 If you are still stuck, just join the [Telegram chat](https://t.me/grammyjs) and ask for help. People are nice there and we appreciate your question, no matter what it is :)
 
@@ -78,7 +78,7 @@ Here are some more resources to support you:
 
 —main project website and documentation.
 
-### [grammY API Reference](https://doc.deno.land/https/deno.land/x/grammy/mod.ts)
+### [grammY API Reference](https://doc.deno.land/https://deno.land/x/grammy/mod.ts)
 
 —reference of everything that grammY exports.
 
@@ -90,6 +90,8 @@ Here are some more resources to support you:
 
 —Telegram chat where you can ask any question about grammY or bots in general. We are also open for feedback, ideas, and contributions!
 
+The Russian commnity chat can be found [here](https://t.me/grammyjs_ru).
+
 ### [grammY News Channel](https://t.me/grammyjs_news)
 
 —Telegram channel where updates to grammY and the ecosystem are posted.
@@ -100,9 +102,11 @@ Here are some more resources to support you:
 
 ## Deno Support
 
-All grammY packages published by [@grammyjs](https://github.com/grammyjs) run natively on Deno. We are compiling every codebase to still run on Node.
+All grammY packages published by [@grammyjs](https://github.com/grammyjs) run natively on [Deno](https://deno.land). We are compiling every codebase to still run on Node.js.
+
+However, given that most bot developers are still using Node.js, all documentation is written Node.js-first. We may migrate it if Deno overtakes Node.js. If you are already on Deno today, import grammY from [`https://deno.land/x/grammy/mod.ts`](https://deno.land/x/grammy).
 
-However, given that most bot developers are still using Node, all documentation is written Node-first. We may migrate it if Deno overtakes Node. If you are already on Deno today, we expect you to know what you're doing. You mainly have to adjust the imports to URL imports, and import from [`https://deno.land/x/grammy/mod.ts`](https://deno.land/x/grammy).
+You may also be interested in [why we support Deno](https://grammy.dev/resources/faq.html#why-do-you-support-deno).
 
 ## [Contribution Guide »](./CONTRIBUTING.md)
 
@@ -163,13 +167,15 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="https://github.com/taotie111"><img src="https://avatars.githubusercontent.com/u/44166322?v=4?s=100" width="100px;" alt=""/><br /><sub><b>taotie111</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=taotie111" title="Documentation">📖</a> <a href="#translation-taotie111" title="Translation">🌍</a></td>
     <td align="center"><a href="https://www.linkedin.com/in/merlin-brandes-42328717a/"><img src="https://avatars.githubusercontent.com/u/14237330?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Merlin</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=FatalMerlin" title="Documentation">📖</a></td>
     <td align="center"><a href="https://darve.sh"><img src="https://avatars.githubusercontent.com/u/22394081?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Darvesh</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Adarvesh" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=darvesh" title="Code">💻</a></td>
-    <td align="center"><a href="http://telegram.me/dcdunkan"><img src="https://avatars.githubusercontent.com/u/70066170?v=4?s=100" width="100px;" alt=""/><br /><sub><b>dcdunkan</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Adcdunkan" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=dcdunkan" title="Code">💻</a></td>
+    <td align="center"><a href="http://telegram.me/dcdunkan"><img src="https://avatars.githubusercontent.com/u/70066170?v=4?s=100" width="100px;" alt=""/><br /><sub><b>dcdunkan</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Adcdunkan" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=dcdunkan" title="Code">💻</a> <a href="#plugin-dcdunkan" title="Plugin/utility libraries">🔌</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Adcdunkan" title="Reviewed Pull Requests">👀</a></td>
     <td align="center"><a href="https://xuann.wang/"><img src="https://avatars.githubusercontent.com/u/44045911?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kid</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=kidonng" title="Documentation">📖</a> <a href="#translation-kidonng" title="Translation">🌍</a></td>
     <td align="center"><a href="http://slava.fomin.io/"><img src="https://avatars.githubusercontent.com/u/1702725?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Slava Fomin II</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Aslavafomin" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=slavafomin" title="Documentation">📖</a></td>
     <td align="center"><a href="https://kikobeats.com/"><img src="https://avatars.githubusercontent.com/u/2096101?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kiko Beats</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=Kikobeats" title="Documentation">📖</a></td>
   </tr>
   <tr>
     <td align="center"><a href="http://///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////kraftwerk28.pp.ua"><img src="https://avatars.githubusercontent.com/u/31807671?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Vsevolod</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=kraftwerk28" title="Code">💻</a> <a href="#ideas-kraftwerk28" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Akraftwerk28" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://github.com/habemuscode"><img src="https://avatars.githubusercontent.com/u/34692207?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Habemuscode</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Ahabemuscode" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://borodutch.com/"><img src="https://avatars.githubusercontent.com/u/3192028?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Nikita Kolmogorov</b></sub></a><br /><a href="#plugin-backmeupplz" title="Plugin/utility libraries">🔌</a></td>
   </tr>
 </table>
 

package/out/bot.js

@@ -301,7 +301,7 @@ you can circumvent this protection against memory leaks.`);
             }
             else
                 debugErr(error);
-            debugErr("Call to `getUpdates` failed, retrying in 3 seconds ...");
+            debugErr("Call to getUpdates failed, retrying in 3 seconds ...");
             await new Promise((r) => setTimeout(r, 3000));
         };
         while (this.pollingRunning) {
@@ -313,7 +313,10 @@ you can circumvent this protection against memory leaks.`);
                     updates = await this.api.getUpdates({ offset, limit, timeout, allowed_updates }, this.pollingAbortController.signal);
                 }
                 catch (error) {
-                    await handleErr(error);
+                    if (this.pollingRunning)
+                        await handleErr(error);
+                    else
+                        debug("Pending getUpdates request cancelled");
                 }
             } while (updates === undefined && this.pollingRunning);
             if (updates === undefined)

package/out/context.d.ts

@@ -62,7 +62,7 @@ export declare class Context implements RenamedUpdate {
      * Used by some middleware to store information about how a certain string
      * or regular expression was matched.
      */
-    match?: string | RegExpMatchArray | null;
+    match?: string | RegExpMatchArray;
     constructor(
     /**
      * The update object that is contained in the context.
@@ -113,7 +113,7 @@ export declare class Context implements RenamedUpdate {
     get msg(): Message | undefined;
     /**
      * Get chat object from whereever possible. Alias for `(this.msg ??
-     * this.myChatMember ?? this.chatMember)?.chat`
+     * this.myChatMember ?? this.chatMember ?? this.chatJoinRequest)?.chat`
      */
     get chat(): Chat | undefined;
     /**
@@ -125,7 +125,7 @@ export declare class Context implements RenamedUpdate {
      * Get message author from whereever possible. Alias for
      * `(ctx.callbackQuery?? ctx.inlineQuery ?? ctx.shippingQuery ??
      * ctx.preCheckoutQuery ?? ctx.chosenInlineResult ?? ctx.msg ??
-     * this.myChatMember ?? this.chatMember)?.from`
+     * this.myChatMember ?? this.chatMember ?? this.chatJoinRequest)?.from`
      */
     get from(): User | undefined;
     /**
@@ -447,6 +447,24 @@ 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.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.
+     *
+     * @param sender_chat_id Unique identifier of the target sender chat
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#banchatsenderchat
+     */
+    banChatSenderChat(sender_chat_id: number, signal?: AbortSignal): Promise<true>;
+    /**
+     * Context-aware alias for `api.unbanChatSenderChat`. Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns True on success.
+     *
+     * @param sender_chat_id Unique identifier of the target sender chat
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#unbanchatsenderchat
+     */
+    unbanChatSenderChat(sender_chat_id: number, signal?: AbortSignal): Promise<true>;
     /**
      * Context-aware alias for `api.setChatPermissions`. Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the can_restrict_members administrator rights. Returns True on success.
      *
@@ -753,7 +771,7 @@ export declare class Context implements RenamedUpdate {
      *
      * **Official reference:** https://core.telegram.org/bots/api#sendinvoice
      */
-    replyWithInvoice(title: string, description: string, payload: string, provider_token: string, currency: string, prices: readonly LabeledPrice[], other?: Other<"sendInvoice", "title" | "description" | "payload" | "provider_token" | "start_parameter" | "currency" | "prices">, signal?: AbortSignal): Promise<Message.InvoiceMessage>;
+    replyWithInvoice(title: string, description: string, payload: string, provider_token: string, currency: string, prices: readonly LabeledPrice[], other?: Other<"sendInvoice", "title" | "description" | "payload" | "provider_token" | "currency" | "prices">, signal?: AbortSignal): Promise<Message.InvoiceMessage>;
     /**
      * Context-aware alias for `api.answerShippingQuery`. If you sent an invoice requesting a shipping address and the parameter is_flexible was specified, the Bot API will send an Update with a shipping_query field to the bot. Use this method to reply to shipping queries. On success, True is returned.
      *

package/out/context.js

@@ -152,12 +152,12 @@ class Context {
     }
     /**
      * Get chat object from whereever possible. Alias for `(this.msg ??
-     * this.myChatMember ?? this.chatMember)?.chat`
+     * this.myChatMember ?? this.chatMember ?? this.chatJoinRequest)?.chat`
      */
     get chat() {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
         // Keep in sync with types in `filter.ts`.
-        return (_c = ((_b = (_a = this.msg) !== null && _a !== void 0 ? _a : this.myChatMember) !== null && _b !== void 0 ? _b : this.chatMember)) === null || _c === void 0 ? void 0 : _c.chat;
+        return (_d = ((_c = (_b = (_a = this.msg) !== null && _a !== void 0 ? _a : this.myChatMember) !== null && _b !== void 0 ? _b : this.chatMember) !== null && _c !== void 0 ? _c : this.chatJoinRequest)) === null || _d === void 0 ? void 0 : _d.chat;
     }
     /**
      * Get sender chat object from wherever possible. Alias for
@@ -171,12 +171,12 @@ class Context {
      * Get message author from whereever possible. Alias for
      * `(ctx.callbackQuery?? ctx.inlineQuery ?? ctx.shippingQuery ??
      * ctx.preCheckoutQuery ?? ctx.chosenInlineResult ?? ctx.msg ??
-     * this.myChatMember ?? this.chatMember)?.from`
+     * this.myChatMember ?? this.chatMember ?? this.chatJoinRequest)?.from`
      */
     get from() {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         // Keep in sync with types in `filter.ts`.
-        return (_h = ((_g = (_f = (_e = (_d = (_c = (_b = (_a = this.callbackQuery) !== null && _a !== void 0 ? _a : this.inlineQuery) !== null && _b !== void 0 ? _b : this.shippingQuery) !== null && _c !== void 0 ? _c : this.preCheckoutQuery) !== null && _d !== void 0 ? _d : this.chosenInlineResult) !== null && _e !== void 0 ? _e : this.msg) !== null && _f !== void 0 ? _f : this.myChatMember) !== null && _g !== void 0 ? _g : this.chatMember)) === null || _h === void 0 ? void 0 : _h.from;
+        return (_j = ((_h = (_g = (_f = (_e = (_d = (_c = (_b = (_a = this.callbackQuery) !== null && _a !== void 0 ? _a : this.inlineQuery) !== null && _b !== void 0 ? _b : this.shippingQuery) !== null && _c !== void 0 ? _c : this.preCheckoutQuery) !== null && _d !== void 0 ? _d : this.chosenInlineResult) !== null && _e !== void 0 ? _e : this.msg) !== null && _f !== void 0 ? _f : this.myChatMember) !== null && _g !== void 0 ? _g : this.chatMember) !== null && _h !== void 0 ? _h : this.chatJoinRequest)) === null || _j === void 0 ? void 0 : _j.from;
     }
     /**
      * Get inline message ID from whereever possible. Alias for
@@ -576,6 +576,28 @@ class Context {
     setChatAdministratorCustomTitle(user_id, custom_title, signal) {
         return this.api.setChatAdministratorCustomTitle(orThrow(this.chat, "setChatAdministratorCustomTitle").id, user_id, custom_title, 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.
+     *
+     * @param sender_chat_id Unique identifier of the target sender chat
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#banchatsenderchat
+     */
+    banChatSenderChat(sender_chat_id, signal) {
+        return this.api.banChatSenderChat(orThrow(this.chat, "banChatSenderChat").id, sender_chat_id, signal);
+    }
+    /**
+     * Context-aware alias for `api.unbanChatSenderChat`. Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns True on success.
+     *
+     * @param sender_chat_id Unique identifier of the target sender chat
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#unbanchatsenderchat
+     */
+    unbanChatSenderChat(sender_chat_id, signal) {
+        return this.api.unbanChatSenderChat(orThrow(this.chat, "unbanChatSenderChat").id, sender_chat_id, signal);
+    }
     /**
      * Context-aware alias for `api.setChatPermissions`. Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the can_restrict_members administrator rights. Returns True on success.
      *

package/out/convenience/keyboard.d.ts

@@ -138,7 +138,7 @@ export declare class InlineKeyboard {
      * the button is pressed.
      *
      * @param text The text to display
-     * @param url HTTP or tg:// url to be opened when button is pressed
+     * @param url HTTP or tg:// url to be opened when the button is pressed. Links tg://user?id=<user_id> can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings.
      */
     url(text: string, url: string): this;
     /**
@@ -211,7 +211,7 @@ export declare class InlineKeyboard {
     /**
      * Adds a new payment button, confer https://core.telegram.org/bots/api#payments
      *
-     * This type of button must always be the first button in the first row.
+     * This type of button must always be the first button in the first row and can only be used in invoice messages.
      *
      * @param text The text to display
      */

package/out/convenience/keyboard.js

@@ -179,7 +179,7 @@ class InlineKeyboard {
      * the button is pressed.
      *
      * @param text The text to display
-     * @param url HTTP or tg:// url to be opened when button is pressed
+     * @param url HTTP or tg:// url to be opened when the button is pressed. Links tg://user?id=<user_id> can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings.
      */
     url(text, url) {
         return this.add({ text, url });
@@ -269,7 +269,7 @@ class InlineKeyboard {
     /**
      * Adds a new payment button, confer https://core.telegram.org/bots/api#payments
      *
-     * This type of button must always be the first button in the first row.
+     * This type of button must always be the first button in the first row and can only be used in invoice messages.
      *
      * @param text The text to display
      */

package/out/convenience/session.d.ts

@@ -8,7 +8,7 @@ declare 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://doc.deno.land/https/deno.land/x/grammy/mod.ts#session)
+ * [documentation](https://doc.deno.land/https://deno.land/x/grammy/mod.ts/~/session)
  * on session middleware to know more, and read the section about sessions on
  * the [website](https://grammy.dev/plugins/session.html).
  */
@@ -37,7 +37,7 @@ 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://doc.deno.land/https/deno.land/x/grammy/mod.ts#lazySession)
+ * [documentation](https://doc.deno.land/https://deno.land/x/grammy/mod.ts/~/lazySession)
  * on lazy session middleware to know more, and read the section about lazy
  * sessions on the
  * [website](https://grammy.dev/plugins/session.html#lazy-sessions).
@@ -218,7 +218,13 @@ export declare function lazySession<S, C extends Context>(options?: SessionOptio
  */
 export declare class MemorySessionStorage<S> implements StorageAdapter<S> {
     private readonly timeToLive;
-    private readonly storage;
+    /**
+     * Internally used `Map` instance that stores the session data
+     */
+    protected readonly storage: Map<string, {
+        session: S;
+        expires?: number | undefined;
+    }>;
     /**
      * Constructs a new memory session storage with the given time to live. Note
      * that this storage adapter will not store your data permanently.
@@ -227,6 +233,11 @@ export declare class MemorySessionStorage<S> implements StorageAdapter<S> {
      */
     constructor(timeToLive?: number);
     read(key: string): S | undefined;
+    /**
+     * Reads the values for all keys of the session storage, and returns them as
+     * an array.
+     */
+    readAll(): S[];
     write(key: string, value: S): void;
     private addExpiryDate;
     delete(key: string): void;

package/out/convenience/session.js

@@ -218,6 +218,9 @@ class MemorySessionStorage {
             writable: true,
             value: timeToLive
         });
+        /**
+         * Internally used `Map` instance that stores the session data
+         */
         Object.defineProperty(this, "storage", {
             enumerable: true,
             configurable: true,
@@ -235,6 +238,16 @@ class MemorySessionStorage {
         }
         return value.session;
     }
+    /**
+     * Reads the values for all keys of the session storage, and returns them as
+     * an array.
+     */
+    readAll() {
+        return Array
+            .from(this.storage.keys())
+            .map((key) => this.read(key))
+            .filter((value) => value !== undefined);
+    }
     write(key, value) {
         this.storage.set(key, this.addExpiryDate(value));
     }

package/out/core/api.d.ts

@@ -459,6 +459,26 @@ 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 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.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @param sender_chat_id Unique identifier of the target sender chat
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#banchatsenderchat
+     */
+    banChatSenderChat(chat_id: number | string, sender_chat_id: number, signal?: AbortSignal): Promise<true>;
+    /**
+     * Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns True on success.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @param sender_chat_id Unique identifier of the target sender chat
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#unbanchatsenderchat
+     */
+    unbanChatSenderChat(chat_id: number | string, sender_chat_id: number, signal?: AbortSignal): Promise<true>;
     /**
      * Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the can_restrict_members administrator rights. Returns True on success.
      *
@@ -938,7 +958,7 @@ export declare class Api<R extends RawApi = RawApi> {
      *
      * **Official reference:** https://core.telegram.org/bots/api#sendinvoice
      */
-    sendInvoice(chat_id: number | string, title: string, description: string, payload: string, provider_token: string, currency: string, prices: readonly LabeledPrice[], other?: Other<R, "sendInvoice", "title" | "description" | "payload" | "provider_token" | "start_parameter" | "currency" | "prices">, signal?: AbortSignal): Promise<import("@grammyjs/types/message").Message.InvoiceMessage>;
+    sendInvoice(chat_id: number | string, title: string, description: string, payload: string, provider_token: string, currency: string, prices: readonly LabeledPrice[], other?: Other<R, "sendInvoice", "title" | "description" | "payload" | "provider_token" | "currency" | "prices">, signal?: AbortSignal): Promise<import("@grammyjs/types/message").Message.InvoiceMessage>;
     /**
      * If you sent an invoice requesting a shipping address and the parameter is_flexible was specified, the Bot API will send an Update with a shipping_query field to the bot. Use this method to reply to shipping queries. On success, True is returned.
      *

package/out/core/api.js

@@ -166,12 +166,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#forwardmessage
      */
     forwardMessage(chat_id, from_chat_id, message_id, other, signal) {
-        return this.raw.forwardMessage({
-            chat_id,
-            from_chat_id,
-            message_id,
-            ...other,
-        }, signal);
+        return this.raw.forwardMessage({ chat_id, from_chat_id, message_id, ...other }, signal);
     }
     /**
      * Use this method to copy messages of any kind. Service messages and invoice messages can't be copied. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.
@@ -185,12 +180,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#copymessage
      */
     copyMessage(chat_id, from_chat_id, message_id, other, signal) {
-        return this.raw.copyMessage({
-            chat_id,
-            from_chat_id,
-            message_id,
-            ...other,
-        }, signal);
+        return this.raw.copyMessage({ chat_id, from_chat_id, message_id, ...other }, signal);
     }
     /**
      * Use this method to send photos. On success, the sent Message is returned.
@@ -326,13 +316,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#editmessagelivelocation
      */
     editMessageLiveLocation(chat_id, message_id, latitude, longitude, other, signal) {
-        return this.raw.editMessageLiveLocation({
-            chat_id,
-            message_id,
-            latitude,
-            longitude,
-            ...other,
-        }, signal);
+        return this.raw.editMessageLiveLocation({ chat_id, message_id, latitude, longitude, ...other }, signal);
     }
     /**
      * Use this method to edit live location inline messages. A location can be edited until its live_period expires or editing is explicitly disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.
@@ -346,12 +330,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#editmessagelivelocation
      */
     editMessageLiveLocationInline(inline_message_id, latitude, longitude, other, signal) {
-        return this.raw.editMessageLiveLocation({
-            inline_message_id,
-            latitude,
-            longitude,
-            ...other,
-        }, signal);
+        return this.raw.editMessageLiveLocation({ inline_message_id, latitude, longitude, ...other }, signal);
     }
     /**
      * Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.
@@ -364,11 +343,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#stopmessagelivelocation
      */
     stopMessageLiveLocation(chat_id, message_id, other, signal) {
-        return this.raw.stopMessageLiveLocation({
-            chat_id,
-            message_id,
-            ...other,
-        }, signal);
+        return this.raw.stopMessageLiveLocation({ chat_id, message_id, ...other }, signal);
     }
     /**
      * Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned.
@@ -396,14 +371,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#sendvenue
      */
     sendVenue(chat_id, latitude, longitude, title, address, other, signal) {
-        return this.raw.sendVenue({
-            chat_id,
-            latitude,
-            longitude,
-            title,
-            address,
-            ...other,
-        }, signal);
+        return this.raw.sendVenue({ chat_id, latitude, longitude, title, address, ...other }, signal);
     }
     /**
      * Use this method to send phone contacts. On success, the sent Message is returned.
@@ -417,12 +385,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#sendcontact
      */
     sendContact(chat_id, phone_number, first_name, other, signal) {
-        return this.raw.sendContact({
-            chat_id,
-            phone_number,
-            first_name,
-            ...other,
-        }, signal);
+        return this.raw.sendContact({ chat_id, phone_number, first_name, ...other }, signal);
     }
     /**
      * Use this method to send a native poll. On success, the sent Message is returned.
@@ -534,12 +497,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#restrictchatmember
      */
     restrictChatMember(chat_id, user_id, permissions, other, signal) {
-        return this.raw.restrictChatMember({
-            chat_id,
-            user_id,
-            permissions,
-            ...other,
-        }, signal);
+        return this.raw.restrictChatMember({ chat_id, user_id, permissions, ...other }, signal);
     }
     /**
      * Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Pass False for all boolean parameters to demote a user. Returns True on success.
@@ -565,11 +523,31 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#setchatadministratorcustomtitle
      */
     setChatAdministratorCustomTitle(chat_id, user_id, custom_title, signal) {
-        return this.raw.setChatAdministratorCustomTitle({
-            chat_id,
-            user_id,
-            custom_title,
-        }, signal);
+        return this.raw.setChatAdministratorCustomTitle({ chat_id, user_id, custom_title }, 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.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @param sender_chat_id Unique identifier of the target sender chat
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#banchatsenderchat
+     */
+    banChatSenderChat(chat_id, sender_chat_id, signal) {
+        return this.raw.banChatSenderChat({ chat_id, sender_chat_id }, signal);
+    }
+    /**
+     * Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns True on success.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @param sender_chat_id Unique identifier of the target sender chat
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#unbanchatsenderchat
+     */
+    unbanChatSenderChat(chat_id, sender_chat_id, signal) {
+        return this.raw.unbanChatSenderChat({ chat_id, sender_chat_id }, signal);
     }
     /**
      * Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the can_restrict_members administrator rights. Returns True on success.
@@ -811,10 +789,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#setchatstickerset
      */
     setChatStickerSet(chat_id, sticker_set_name, signal) {
-        return this.raw.setChatStickerSet({
-            chat_id,
-            sticker_set_name,
-        }, signal);
+        return this.raw.setChatStickerSet({ chat_id, sticker_set_name }, signal);
     }
     /**
      * Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field can_set_sticker_set ly returned in getChat requests to check if the bot can use this method. Returns True on success.
@@ -938,12 +913,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#editmessagemedia
      */
     editMessageMedia(chat_id, message_id, media, other, signal) {
-        return this.raw.editMessageMedia({
-            chat_id,
-            message_id,
-            media,
-            ...other,
-        }, signal);
+        return this.raw.editMessageMedia({ chat_id, message_id, media, ...other }, signal);
     }
     /**
      * Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.
@@ -969,11 +939,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#editmessagereplymarkup
      */
     editMessageReplyMarkup(chat_id, message_id, other, signal) {
-        return this.raw.editMessageReplyMarkup({
-            chat_id,
-            message_id,
-            ...other,
-        }, signal);
+        return this.raw.editMessageReplyMarkup({ chat_id, message_id, ...other }, signal);
     }
     /**
      * Use this method to edit only the reply markup of inline messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned.
@@ -1069,13 +1035,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#createnewstickerset
      */
     createNewStickerSet(user_id, name, title, emojis, other, signal) {
-        return this.raw.createNewStickerSet({
-            user_id,
-            name,
-            title,
-            emojis,
-            ...other,
-        }, signal);
+        return this.raw.createNewStickerSet({ user_id, name, title, emojis, ...other }, signal);
     }
     /**
      * Use this method to add a new sticker to a set created by the bot. You must use exactly one of the fields png_sticker or tgs_sticker. Animated stickers can be added to animated sticker sets and only to them. Animated sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success.
@@ -1141,11 +1101,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#answerinlinequery
      */
     answerInlineQuery(inline_query_id, results, other, signal) {
-        return this.raw.answerInlineQuery({
-            inline_query_id,
-            results,
-            ...other,
-        }, signal);
+        return this.raw.answerInlineQuery({ inline_query_id, results, ...other }, signal);
     }
     /**
      * Use this method to send invoices. On success, the sent Message is returned.
@@ -1198,11 +1154,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#answerprecheckoutquery
      */
     answerPreCheckoutQuery(pre_checkout_query_id, ok, other, signal) {
-        return this.raw.answerPreCheckoutQuery({
-            pre_checkout_query_id,
-            ok,
-            ...other,
-        }, signal);
+        return this.raw.answerPreCheckoutQuery({ pre_checkout_query_id, ok, ...other }, signal);
     }
     /**
      * Informs a user that some of the Telegram Passport elements they provided contains errors. The user will not be able to re-submit their Passport to you until the errors are fixed (the contents of the field for which you returned the error must change). Returns True on success.
@@ -1244,13 +1196,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#setgamescore
      */
     setGameScore(chat_id, message_id, user_id, score, other, signal) {
-        return this.raw.setGameScore({
-            chat_id,
-            message_id,
-            user_id,
-            score,
-            ...other,
-        }, signal);
+        return this.raw.setGameScore({ chat_id, message_id, user_id, score, ...other }, signal);
     }
     /**
      * Use this method to set the score of the specified user in a game message. On success, if the message is not an inline message, the Message is returned, otherwise True is returned. Returns an error, if the new score is not greater than the user's current score in the chat and force is False.
@@ -1264,12 +1210,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#setgamescore
      */
     setGameScoreInline(inline_message_id, user_id, score, other, signal) {
-        return this.raw.setGameScore({
-            inline_message_id,
-            user_id,
-            score,
-            ...other,
-        }, signal);
+        return this.raw.setGameScore({ inline_message_id, user_id, score, ...other }, signal);
     }
     /**
      * Use this method to get data for high score tables. Will return the score of the specified user and several of their neighbors in a game. On success, returns an Array of GameHighScore objects.
@@ -1284,11 +1225,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#getgamehighscores
      */
     getGameHighScores(chat_id, message_id, user_id, signal) {
-        return this.raw.getGameHighScores({
-            chat_id,
-            message_id,
-            user_id,
-        }, signal);
+        return this.raw.getGameHighScores({ chat_id, message_id, user_id }, signal);
     }
     /**
      * Use this method to get data for high score tables. Will return the score of the specified user and several of their neighbors in an inline game. On success, returns an Array of GameHighScore objects.
@@ -1302,10 +1239,7 @@ class Api {
      * **Official reference:** https://core.telegram.org/bots/api#getgamehighscores
      */
     getGameHighScoresInline(inline_message_id, user_id, signal) {
-        return this.raw.getGameHighScores({
-            inline_message_id,
-            user_id,
-        }, signal);
+        return this.raw.getGameHighScores({ inline_message_id, user_id }, signal);
     }
 }
 exports.Api = Api;

package/out/filter.d.ts

@@ -17,7 +17,7 @@ declare type FilterFunction<C extends Context, D extends C> = (ctx: C) => ctx is
  * ```
  *
  * Check out the
- * [documentation](https://doc.deno.land/https/deno.land/x/grammy/mod.ts#Composer)
+ * [documentation](https://doc.deno.land/https://deno.land/x/grammy/mod.ts/~/Composer)
  * of `bot.on` for examples. In addition, the
  * [website](https://grammy.dev/guide/filter-queries.html) contains more
  * information about how filter queries work in grammY.
@@ -61,6 +61,7 @@ declare const UPDATE_KEYS: {
         readonly voice_chat_ended: {};
         readonly voice_chat_participants_invited: {};
         readonly forward_date: {};
+        readonly is_automatic_forward: {};
         readonly text: {};
         readonly animation: {};
         readonly audio: {};
@@ -140,6 +141,7 @@ declare const UPDATE_KEYS: {
         readonly voice_chat_ended: {};
         readonly voice_chat_participants_invited: {};
         readonly forward_date: {};
+        readonly is_automatic_forward: {};
         readonly text: {};
         readonly animation: {};
         readonly audio: {};
@@ -205,6 +207,7 @@ declare const UPDATE_KEYS: {
         readonly voice_chat_ended: {};
         readonly voice_chat_participants_invited: {};
         readonly forward_date: {};
+        readonly is_automatic_forward: {};
         readonly text: {};
         readonly animation: {};
         readonly audio: {};
@@ -270,6 +273,7 @@ declare const UPDATE_KEYS: {
         readonly voice_chat_ended: {};
         readonly voice_chat_participants_invited: {};
         readonly forward_date: {};
+        readonly is_automatic_forward: {};
         readonly text: {};
         readonly animation: {};
         readonly audio: {};
@@ -398,8 +402,8 @@ declare type PerformQuery<C extends Context, U extends SomeObject> = U extends u
 declare type FilteredContext<C extends Context, U extends Update> = C & Record<"update", U> & AliasProps<Omit<U, "update_id">> & Shortcuts<U>;
 interface Shortcuts<U extends Update> {
     msg: [U["callback_query"]] extends [SomeObject] ? U["callback_query"]["message"] : [U["message"]] extends [SomeObject] ? U["message"] : [U["edited_message"]] extends [SomeObject] ? U["edited_message"] : [U["channel_post"]] extends [SomeObject] ? U["channel_post"] : [U["edited_channel_post"]] extends [SomeObject] ? U["edited_channel_post"] : undefined;
-    chat: [U["callback_query"]] extends [SomeObject] ? NonNullable<U["callback_query"]["message"]>["chat"] | undefined : [Shortcuts<U>["msg"]] extends [SomeObject] ? Shortcuts<U>["msg"]["chat"] : [U["my_chat_member"]] extends [SomeObject] ? U["my_chat_member"]["chat"] : [U["chat_member"]] extends [SomeObject] ? U["chat_member"]["chat"] : undefined;
-    from: [U["callback_query"]] extends [SomeObject] ? U["callback_query"]["from"] : [U["inline_query"]] extends [SomeObject] ? U["inline_query"]["from"] : [U["shipping_query"]] extends [SomeObject] ? U["shipping_query"]["from"] : [U["pre_checkout_query"]] extends [SomeObject] ? U["pre_checkout_query"]["from"] : [U["chosen_inline_result"]] extends [SomeObject] ? U["chosen_inline_result"]["from"] : [U["message"]] extends [SomeObject] ? NonNullable<U["message"]["from"]> : [U["edited_message"]] extends [SomeObject] ? NonNullable<U["edited_message"]["from"]> : [U["my_chat_member"]] extends [SomeObject] ? U["my_chat_member"]["from"] : [U["chat_member"]] extends [SomeObject] ? U["chat_member"]["from"] : undefined;
+    chat: [U["callback_query"]] extends [SomeObject] ? NonNullable<U["callback_query"]["message"]>["chat"] | undefined : [Shortcuts<U>["msg"]] extends [SomeObject] ? Shortcuts<U>["msg"]["chat"] : [U["my_chat_member"]] extends [SomeObject] ? U["my_chat_member"]["chat"] : [U["chat_member"]] extends [SomeObject] ? U["chat_member"]["chat"] : [U["chat_join_request"]] extends [SomeObject] ? U["chat_join_request"]["chat"] : undefined;
+    from: [U["callback_query"]] extends [SomeObject] ? U["callback_query"]["from"] : [U["inline_query"]] extends [SomeObject] ? U["inline_query"]["from"] : [U["shipping_query"]] extends [SomeObject] ? U["shipping_query"]["from"] : [U["pre_checkout_query"]] extends [SomeObject] ? U["pre_checkout_query"]["from"] : [U["chosen_inline_result"]] extends [SomeObject] ? U["chosen_inline_result"]["from"] : [U["message"]] extends [SomeObject] ? NonNullable<U["message"]["from"]> : [U["edited_message"]] extends [SomeObject] ? NonNullable<U["edited_message"]["from"]> : [U["my_chat_member"]] extends [SomeObject] ? U["my_chat_member"]["from"] : [U["chat_member"]] extends [SomeObject] ? U["chat_member"]["from"] : [U["chat_join_request"]] extends [SomeObject] ? U["chat_join_request"]["from"] : undefined;
 }
 declare const L1_SHORTCUTS: {
     readonly "": readonly ["message", "channel_post"];

package/out/filter.js

@@ -18,7 +18,7 @@ exports.matchFilter = void 0;
  * ```
  *
  * Check out the
- * [documentation](https://doc.deno.land/https/deno.land/x/grammy/mod.ts#Composer)
+ * [documentation](https://doc.deno.land/https://deno.land/x/grammy/mod.ts/~/Composer)
  * of `bot.on` for examples. In addition, the
  * [website](https://grammy.dev/guide/filter-queries.html) contains more
  * information about how filter queries work in grammY.
@@ -249,6 +249,7 @@ const COMMON_MESSAGE_KEYS = {
     voice_chat_ended: {},
     voice_chat_participants_invited: {},
     forward_date: {},
+    is_automatic_forward: {},
 };
 const MESSAGE_KEYS = {
     ...COMMON_MESSAGE_KEYS,

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "grammy",
     "description": "The Telegram Bot Framework.",
-    "version": "1.4.3",
+    "version": "1.5.3",
     "author": "KnorpelSenf",
     "license": "MIT",
     "engines": {
@@ -23,7 +23,7 @@
         "contribs": "all-contributors"
     },
     "dependencies": {
-        "@grammyjs/types": "^2.3.1",
+        "@grammyjs/types": "^2.4.5",
         "abort-controller": "^3.0.0",
         "debug": "^4.3.3",
         "node-fetch": "^2.6.5"