grammy 1.4.2 → 1.5.2

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-40-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 in 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)
 
@@ -126,7 +130,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
   <tr>
     <td align="center"><a href="https://edjopato.de/"><img src="https://avatars.githubusercontent.com/u/7953011?v=4?s=100" width="100px;" alt=""/><br /><sub><b>EdJoPaTo</b></sub></a><br /><a href="#plugin-EdJoPaTo" title="Plugin/utility libraries">🔌</a> <a href="https://github.com/grammyjs/grammY/commits?author=EdJoPaTo" title="Documentation">📖</a> <a href="#ideas-EdJoPaTo" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3AEdJoPaTo" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/grammyjs/grammY/issues?q=author%3AEdJoPaTo" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=EdJoPaTo" title="Code">💻</a> <a href="#question-EdJoPaTo" title="Answering Questions">💬</a></td>
     <td align="center"><a href="https://github.com/Amir-Zouerami"><img src="https://avatars.githubusercontent.com/u/53701884?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Amir Zouerami</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=Amir-Zouerami" title="Documentation">📖</a> <a href="#plugin-Amir-Zouerami" title="Plugin/utility libraries">🔌</a></td>
-    <td align="center"><a href="https://github.com/rojserbest"><img src="https://avatars.githubusercontent.com/u/49933115?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Roj</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=rojserbest" title="Documentation">📖</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Arojserbest" title="Reviewed Pull Requests">👀</a> <a href="#infra-rojserbest" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td>
+    <td align="center"><a href="https://github.com/rojserbest"><img src="https://avatars.githubusercontent.com/u/49933115?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Roj</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=rojserbest" title="Documentation">📖</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Arojserbest" title="Reviewed Pull Requests">👀</a> <a href="#infra-rojserbest" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#translation-rojserbest" title="Translation">🌍</a> <a href="https://github.com/grammyjs/grammY/commits?author=rojserbest" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/jokasimr"><img src="https://avatars.githubusercontent.com/u/20954731?v=4?s=100" width="100px;" alt=""/><br /><sub><b>jokasimr</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ajokasimr" title="Bug reports">🐛</a></td>
     <td align="center"><a href="https://github.com/CikiMomogi"><img src="https://avatars.githubusercontent.com/u/74030149?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ciki Momogi</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=CikiMomogi" title="Documentation">📖</a></td>
     <td align="center"><a href="https://github.com/AndreoliBR"><img src="https://avatars.githubusercontent.com/u/15970011?v=4?s=100" width="100px;" alt=""/><br /><sub><b>AndreoliBR</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3AAndreoliBR" title="Reviewed Pull Requests">👀</a></td>
@@ -142,7 +146,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="https://github.com/deptyped"><img src="https://avatars.githubusercontent.com/u/26162440?v=4?s=100" width="100px;" alt=""/><br /><sub><b>deptyped</b></sub></a><br /><a href="#example-deptyped" title="Examples">💡</a> <a href="https://github.com/grammyjs/grammY/commits?author=deptyped" title="Documentation">📖</a> <a href="#tutorial-deptyped" title="Tutorials">✅</a> <a href="#question-deptyped" title="Answering Questions">💬</a></td>
   </tr>
   <tr>
-    <td align="center"><a href="https://github.com/dzek69"><img src="https://avatars.githubusercontent.com/u/4936805?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jacek Nowacki</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=dzek69" title="Documentation">📖</a> <a href="https://github.com/grammyjs/grammY/commits?author=dzek69" title="Code">💻</a> <a href="https://github.com/grammyjs/grammY/issues?q=author%3Adzek69" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Adzek69" title="Reviewed Pull Requests">👀</a></td>
+    <td align="center"><a href="https://github.com/dzek69"><img src="https://avatars.githubusercontent.com/u/4936805?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jacek Nowacki</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=dzek69" title="Documentation">📖</a> <a href="https://github.com/grammyjs/grammY/commits?author=dzek69" title="Code">💻</a> <a href="https://github.com/grammyjs/grammY/issues?q=author%3Adzek69" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Adzek69" title="Reviewed Pull Requests">👀</a> <a href="#ideas-dzek69" title="Ideas, Planning, & Feedback">🤔</a></td>
     <td align="center"><a href="https://blog.outv.im"><img src="https://avatars.githubusercontent.com/u/19144373?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Outvi V</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=outloudvi" title="Code">💻</a></td>
     <td align="center"><a href="https://bandism.net/"><img src="https://avatars.githubusercontent.com/u/22633385?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ikko Ashimine</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=eltociear" title="Documentation">📖</a></td>
     <td align="center"><a href="https://github.com/amberlionk"><img src="https://avatars.githubusercontent.com/u/29119723?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Yevhen Denesiuk</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Aamberlionk" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/grammyjs/grammY/issues?q=author%3Aamberlionk" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=amberlionk" title="Code">💻</a></td>
@@ -154,17 +158,24 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="https://github.com/chimit"><img src="https://avatars.githubusercontent.com/u/839349?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Chimit</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=chimit" title="Documentation">📖</a></td>
     <td align="center"><a href="https://github.com/CalsiBotDev"><img src="https://avatars.githubusercontent.com/u/55633371?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Calsi</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=CalsiBotDev" title="Documentation">📖</a></td>
     <td align="center"><a href="https://zohren.xyz"><img src="https://avatars.githubusercontent.com/u/15788906?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jonas Zohren</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ajfowl" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=jfowl" title="Code">💻</a></td>
-    <td align="center"><a href="https://zhemu.buzz/"><img src="https://avatars.githubusercontent.com/u/56839018?v=4?s=100" width="100px;" alt=""/><br /><sub><b>linbuxiao</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=linbuxiao" title="Documentation">📖</a></td>
-    <td align="center"><a href="https://github.com/JiquanWang99"><img src="https://avatars.githubusercontent.com/u/63894579?v=4?s=100" width="100px;" alt=""/><br /><sub><b>JiquanWang99</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=JiquanWang99" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://zhemu.buzz/"><img src="https://avatars.githubusercontent.com/u/56839018?v=4?s=100" width="100px;" alt=""/><br /><sub><b>linbuxiao</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=linbuxiao" title="Documentation">📖</a> <a href="#translation-linbuxiao" title="Translation">🌍</a></td>
+    <td align="center"><a href="https://github.com/JiquanWang99"><img src="https://avatars.githubusercontent.com/u/63894579?v=4?s=100" width="100px;" alt=""/><br /><sub><b>JiquanWang99</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=JiquanWang99" title="Documentation">📖</a> <a href="#translation-JiquanWang99" title="Translation">🌍</a></td>
     <td align="center"><a href="http://bor691.ir/"><img src="https://avatars.githubusercontent.com/u/4184939?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Borhan Hafez</b></sub></a><br /><a href="#plugin-zumoshi" title="Plugin/utility libraries">🔌</a></td>
-    <td align="center"><a href="https://blog.limx.dev/"><img src="https://avatars.githubusercontent.com/u/6434137?v=4?s=100" width="100px;" alt=""/><br /><sub><b>WingLim</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=WingLim" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://blog.limx.dev/"><img src="https://avatars.githubusercontent.com/u/6434137?v=4?s=100" width="100px;" alt=""/><br /><sub><b>WingLim</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=WingLim" title="Documentation">📖</a> <a href="#translation-WingLim" title="Translation">🌍</a></td>
   </tr>
   <tr>
-    <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></td>
+    <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="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></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/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.
      *

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/frameworks.node.d.ts

@@ -0,0 +1,39 @@
+import type { IncomingMessage, ServerResponse } from "http";
+export declare const adapters: {
+    http: (req: IncomingMessage, res: ServerResponse) => {
+        update: Promise<any>;
+        end: () => void;
+        respond: (json: string) => void;
+    };
+    https: (req: IncomingMessage, res: ServerResponse) => {
+        update: Promise<any>;
+        end: () => void;
+        respond: (json: string) => void;
+    };
+    express: (req: any, res: any) => {
+        update: Promise<any>;
+        end: () => any;
+        respond: (json: string) => void;
+    };
+    koa: (ctx: any) => {
+        update: Promise<any>;
+        end: () => void;
+        respond: (json: string) => void;
+    };
+    fastify: (req: any, reply: any) => {
+        update: Promise<any>;
+        end: () => any;
+        respond: (json: string) => any;
+    };
+    worktop: (req: any, res: any) => {
+        update: Promise<any>;
+        end: () => any;
+        respond: (json: string) => any;
+    };
+    "aws-lambda": (event: any, _context: any, callback: any) => {
+        update: any;
+        end: () => any;
+        respond: (json: string) => any;
+    };
+};
+export declare const defaultAdapter = "express";

package/out/convenience/frameworks.node.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultAdapter = exports.adapters = void 0;
+/** Node.js native 'http' and 'https' modules */
+const http = (req, res) => ({
+    update: new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk)).once("end", () => {
+            const raw = Buffer.concat(chunks).toString("utf-8");
+            resolve(JSON.parse(raw));
+        }).once("error", reject);
+    }),
+    end: () => res.end(),
+    respond: (json) => res.writeHead(200, { "Content-Type": "application/json" }).end(json),
+});
+/** express web framework */
+const express = (req, res) => ({
+    update: Promise.resolve(req.body),
+    end: () => res.end(),
+    respond: (json) => {
+        res.set("Content-Type", "application/json");
+        res.send(json);
+    },
+});
+/** koa web framework */
+const koa = (ctx) => ({
+    update: Promise.resolve(ctx.request.body),
+    end: () => {
+        ctx.body = "";
+    },
+    respond: (json) => {
+        ctx.set("Content-Type", "application/json");
+        ctx.response.body = json;
+    },
+});
+/** fastify web framework */
+const fastify = (req, reply) => ({
+    update: Promise.resolve(req.body),
+    end: () => reply.status(200).send(),
+    respond: (json) => reply.send(json),
+});
+/** worktop CloudFlare workers framework */
+const worktop = (req, res) => ({
+    update: Promise.resolve(req.body.json()),
+    end: () => res.end(),
+    respond: (json) => res.send(200, json),
+});
+/** AWS lambda serverless functions */
+const awsLambda = (event, _context, callback) => ({
+    update: JSON.parse(event.body),
+    end: () => callback(null, { statusCode: 200 }),
+    respond: (json) => callback(null, { statusCode: 200, body: json }),
+});
+// please open a PR if you want to add another
+exports.adapters = {
+    http,
+    https: http,
+    express,
+    koa,
+    fastify,
+    worktop,
+    "aws-lambda": awsLambda,
+};
+exports.defaultAdapter = "express";

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).

package/out/convenience/webhook.d.ts

@@ -1,10 +1,81 @@
+/// <reference types="node" />
 import { Bot } from "../bot.js";
+import { Update } from "../platform.node.js";
 import { Context } from "../context.js";
+declare const adapters: {
+    callback: FrameworkAdapter;
+    http: (req: import("http").IncomingMessage, res: import("http").ServerResponse) => {
+        update: Promise<any>;
+        end: () => void;
+        respond: (json: string) => void;
+    };
+    https: (req: import("http").IncomingMessage, res: import("http").ServerResponse) => {
+        update: Promise<any>;
+        end: () => void;
+        respond: (json: string) => void;
+    };
+    express: (req: any, res: any) => {
+        update: Promise<any>;
+        end: () => any;
+        respond: (json: string) => void;
+    };
+    koa: (ctx: any) => {
+        update: Promise<any>;
+        end: () => void;
+        respond: (json: string) => void;
+    };
+    fastify: (req: any, reply: any) => {
+        update: Promise<any>;
+        end: () => any;
+        respond: (json: string) => any;
+    };
+    worktop: (req: any, res: any) => {
+        update: Promise<any>;
+        end: () => any;
+        respond: (json: string) => any;
+    };
+    "aws-lambda": (event: any, _context: any, callback: any) => {
+        update: any;
+        end: () => any;
+        respond: (json: string) => any;
+    };
+};
 /**
  * HTTP Web frameworks for which grammY provides compatible callback out of the
  * box.
  */
-declare type SupportedFrameworks = "express" | "http" | "https" | "koa" | "oak" | "fastify" | "worktop" | "callback" | "aws-lambda";
+declare type SupportedFrameworks = keyof typeof adapters;
+/**
+ * Abstraction over a request-response cycle, provding access to the update, as
+ * well as a mechanism for responding to the request and to end it.
+ */
+interface ReqResHandler {
+    /**
+     * The update object sent from Telegram, usually resolves the request's JSON
+     * body
+     */
+    update: Promise<Update>;
+    /**
+     * Ends the request immediately without body, called after every request
+     * unless a webhook reply was performed
+     */
+    end?: () => void;
+    /**
+     * Sends the specified JSON as a payload in the body, used for webhook
+     * replies
+     */
+    respond: (json: string) => unknown;
+    /**
+     * Some frameworks (e.g. Deno's std/http `listenAndServe`) assume
+     * that handler returns something
+     */
+    handlerReturn?: any;
+}
+/**
+ * Middleware for a web framework. Creates a request-response handler for a
+ * request. The handler will be used to integrate with the compatible framework.
+ */
+export declare type FrameworkAdapter = (...args: any[]) => ReqResHandler;
 /**
  * Creates a callback function that you can pass to a web framework (such as
  * express) if you want to run your bot via webhooks. Use it like this:
@@ -24,5 +95,5 @@ declare type SupportedFrameworks = "express" | "http" | "https" | "koa" | "oak"
  * @param onTimeout An optional strategy to handle timeouts (default: 'throw')
  * @param timeoutMilliseconds An optional number of timeout milliseconds (default: 10_000)
  */
-export declare function webhookCallback<C extends Context = Context>(bot: Bot<C>, framework?: SupportedFrameworks, onTimeout?: "throw" | "return" | ((...args: any[]) => unknown), timeoutMilliseconds?: number): (...args: any[]) => Promise<void>;
+export declare function webhookCallback<C extends Context = Context>(bot: Bot<C>, adapter?: SupportedFrameworks | FrameworkAdapter, onTimeout?: "throw" | "return" | ((...args: any[]) => unknown), timeoutMilliseconds?: number): (...args: any[]) => Promise<any>;
 export {};

package/out/convenience/webhook.js

@@ -2,60 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.webhookCallback = void 0;
 const platform_node_js_1 = require("../platform.node.js");
+const frameworks_node_js_1 = require("./frameworks.node.js");
 const debugErr = (0, platform_node_js_1.debug)("grammy:error");
-const standard = (req, res) => ({
-    update: Promise.resolve(req.body),
-    end: () => res.end(),
-    respond: (json) => {
-        res.set("Content-Type", "application/json");
-        res.send(json);
-    },
+const callbackAdapter = (update, callback) => ({
+    update: Promise.resolve(update),
+    respond: callback,
 });
-// Integrations with popular frameworks
-const frameworkAdapters = {
-    express: standard,
-    http: standard,
-    https: standard,
-    koa: (ctx) => ({
-        update: Promise.resolve(ctx.request.body),
-        end: () => (ctx.body = ""),
-        respond: (json) => {
-            ctx.set("Content-Type", "application/json");
-            ctx.response.body = json;
-        },
-    }),
-    oak: (ctx) => ({
-        update: ctx.request.body({ type: "json" }).value,
-        end: () => (ctx.response.status = 200),
-        respond: (json) => {
-            ctx.response.type = "json";
-            ctx.response.body = json;
-        },
-    }),
-    fastify: (req, reply) => ({
-        update: Promise.resolve(req.body),
-        end: () => reply.send({}),
-        respond: (json) => reply.send(json),
-    }),
-    worktop: (req, res) => ({
-        update: Promise.resolve(req.body.json()),
-        end: () => res.end(),
-        respond: (json) => res.send(200, json),
-    }),
-    callback: (update, callback) => ({
-        update: update,
-        respond: callback,
-    }),
-    "aws-lambda": (event, _context, callback) => ({
-        update: JSON.parse(event.body),
-        end: () => callback(null, { statusCode: 200 }),
-        respond: (json) => callback(null, {
-            statusCode: 200,
-            body: json,
-        }),
-    }),
-    // please open a PR if you want to add another
-};
+const adapters = { ...frameworks_node_js_1.adapters, callback: callbackAdapter };
 /**
  * Creates a callback function that you can pass to a web framework (such as
  * express) if you want to run your bot via webhooks. Use it like this:
@@ -75,21 +28,14 @@ const frameworkAdapters = {
  * @param onTimeout An optional strategy to handle timeouts (default: 'throw')
  * @param timeoutMilliseconds An optional number of timeout milliseconds (default: 10_000)
  */
-function webhookCallback(bot, framework = "express", onTimeout = "throw", timeoutMilliseconds = 10000) {
-    var _a;
-    const server = (_a = frameworkAdapters[framework]) !== null && _a !== void 0 ? _a : standard;
+function webhookCallback(bot, adapter = frameworks_node_js_1.defaultAdapter, onTimeout = "throw", timeoutMilliseconds = 10000) {
     let firstUpdate = true;
     let initialized = false;
     let initCall;
+    const server = typeof adapter === "string"
+        ? adapters[adapter]
+        : adapter;
     return async (...args) => {
-        const { update, respond, end } = server(...args);
-        let usedWebhookReply = false;
-        const webhookReplyEnvelope = {
-            send: async (json) => {
-                usedWebhookReply = true;
-                await respond(json);
-            },
-        };
         if (!initialized) {
             if (firstUpdate) {
                 initCall = bot.init();
@@ -98,11 +44,20 @@ function webhookCallback(bot, framework = "express", onTimeout = "throw", timeou
             await initCall;
             initialized = true;
         }
+        const { update, respond, end, handlerReturn } = server(...args);
+        let usedWebhookReply = false;
+        const webhookReplyEnvelope = {
+            async send(json) {
+                usedWebhookReply = true;
+                await respond(json);
+            },
+        };
         await timeoutIfNecessary(bot.handleUpdate(await update, webhookReplyEnvelope), typeof onTimeout === "function"
             ? () => onTimeout(...args)
             : onTimeout, timeoutMilliseconds);
         if (end !== undefined && !usedWebhookReply)
             end();
+        return handlerReturn;
     };
 }
 exports.webhookCallback = webhookCallback;