grammy 1.27.0 → 1.28.0

package/README.md

@@ -10,14 +10,14 @@
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-7.7-blue?logo=telegram&style=flat&labelColor=000&color=3b82f6)](https://core.telegram.org/bots/api)
+[![Bot API](https://img.shields.io/badge/Bot%20API-7.8-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-)
 
 <!-- deno-fmt-ignore-end -->
 
-## _[docs.](https://grammy.dev) [reference.](https://deno.land/x/grammy/mod.ts) [chat.](https://telegram.me/grammyjs) [news.](https://telegram.me/grammyjs_news)_
+## _[docs.](https://grammy.dev) [reference.](https://grammy.dev/ref) [chat.](https://telegram.me/grammyjs) [news.](https://telegram.me/grammyjs_news)_
 
 </div>
 
@@ -68,7 +68,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. [VS Code](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://grammy.dev/ref). It even integrates with your code editor, e.g. [VS Code](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 :)
 
@@ -81,7 +81,7 @@ Here are some more resources to support you:
 —main project website and documentation.
 Gets you started and explains all concepts.
 
-### [grammY API reference](https://doc.deno.land/https://deno.land/x/grammy/mod.ts)
+### [grammY API reference](https://grammy.dev/ref)
 
 —reference of everything that grammY exports.
 Useful to look up descriptions about any element of grammY.
@@ -302,6 +302,9 @@ 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/SunsetTechuila"><img src="https://avatars.githubusercontent.com/u/115353812?v=4?s=100" width="100px;" alt="Grigory"/><br /><sub><b>Grigory</b></sub></a><br /><a href="#ideas-SunsetTechuila" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/commits?author=SunsetTechuila" title="Code">💻</a> <a href="https://github.com/grammyjs/grammY/commits?author=SunsetTechuila" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/aleveha"><img src="https://avatars.githubusercontent.com/u/63300936?v=4?s=100" width="100px;" alt="aleveha"/><br /><sub><b>aleveha</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=aleveha" title="Code">💻</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/barinbritva"><img src="https://avatars.githubusercontent.com/u/4758362?v=4?s=100" width="100px;" alt="barinbritva"/><br /><sub><b>barinbritva</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Abarinbritva" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/flmel"><img src="https://avatars.githubusercontent.com/u/55487633?v=4?s=100" width="100px;" alt="Lyudmil Ivanov"/><br /><sub><b>Lyudmil Ivanov</b></sub></a><br /><a href="#example-flmel" title="Examples">💡</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://consortiumkey.com/"><img src="https://avatars.githubusercontent.com/u/95214604?v=4?s=100" width="100px;" alt="lexomis"/><br /><sub><b>lexomis</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Alexomis" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/asologor"><img src="https://avatars.githubusercontent.com/u/97506048?v=4?s=100" width="100px;" alt="Andrew Sologor"/><br /><sub><b>Andrew Sologor</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Aandrew-sol" title="Reviewed Pull Requests">👀</a></td>
     </tr>
   </tbody>
 </table>

package/out/bot.d.ts

@@ -199,7 +199,7 @@ export declare class Bot<C extends Context = Context, A extends Api = Api> exten
      * your bot will handle.
      *
      * If you're writing a library on top of grammY, check out the
-     * [documentation](https://grammy.dev/plugins/runner.html) of the runner
+     * [documentation](https://grammy.dev/plugins/runner) of the runner
      * plugin for an example that uses this method.
      *
      * @param update An update from the Telegram Bot API
@@ -235,7 +235,7 @@ export declare class Bot<C extends Context = Context, A extends Api = Api> exten
      * will impact the responsiveness negatively, so it makes sense to use the
      * `@grammyjs/runner` package even if you receive much fewer messages. If
      * you worry about how much load your bot can handle, check out the grammY
-     * [documentation](https://grammy.dev/advanced/scaling.html) about scaling
+     * [documentation](https://grammy.dev/advanced/scaling) about scaling
      * up.
      *
      * @param options Options to use for simple long polling

package/out/bot.js

@@ -208,7 +208,7 @@ class Bot extends composer_js_1.Composer {
      * your bot will handle.
      *
      * If you're writing a library on top of grammY, check out the
-     * [documentation](https://grammy.dev/plugins/runner.html) of the runner
+     * [documentation](https://grammy.dev/plugins/runner) of the runner
      * plugin for an example that uses this method.
      *
      * @param update An update from the Telegram Bot API
@@ -267,7 +267,7 @@ a known bot info object.");
      * will impact the responsiveness negatively, so it makes sense to use the
      * `@grammyjs/runner` package even if you receive much fewer messages. If
      * you worry about how much load your bot can handle, check out the grammY
-     * [documentation](https://grammy.dev/advanced/scaling.html) about scaling
+     * [documentation](https://grammy.dev/advanced/scaling) about scaling
      * up.
      *
      * @param options Options to use for simple long polling

package/out/composer.d.ts

@@ -65,7 +65,7 @@ export interface MiddlewareObj<C extends Context = Context> {
  * Middleware is an extremely powerful concept and this short explanation only
  * scratched the surface of what is possible with grammY. If you want to know
  * more advanced things about middleware, check out the
- * [documentation](https://grammy.dev/guide/middleware.html) on the website.
+ * [documentation](https://grammy.dev/guide/middleware) on the website.
  */
 export type Middleware<C extends Context = Context> = MiddlewareFn<C> | MiddlewareObj<C>;
 /**
@@ -96,7 +96,7 @@ export declare function run<C extends Context>(middleware: MiddlewareFn<C>, ctx:
  *
  * On the other hand, if you want to dig deeper into how grammY implements
  * middleware, check out the
- * [documentation](https://grammy.dev/advanced/middleware.html) on the website.
+ * [documentation](https://grammy.dev/advanced/middleware) on the website.
  */
 export declare class Composer<C extends Context> implements MiddlewareObj<C> {
     private handler;
@@ -121,7 +121,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      *
      * This method returns a new instance of composer. The returned instance can
      * be further extended, and all changes will be regarded here. Confer the
-     * [documentation](https://grammy.dev/advanced/middleware.html) on the
+     * [documentation](https://grammy.dev/advanced/middleware) on the
      * website if you want to know more about how the middleware system in
      * grammY works, especially when it comes to chaining the method calls
      * (`use( ... ).use( ... ).use( ... )`).
@@ -157,7 +157,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      *
      * You can use autocomplete in VS Code to see all available filter queries.
      * Check out the
-     * [documentation](https://grammy.dev/guide/filter-queries.html) on the
+     * [documentation](https://grammy.dev/guide/filter-queries) on the
      * website to learn more about filter queries in grammY.
      *
      * It is possible to pass multiple filter queries in an array, i.e.
@@ -320,7 +320,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      * // Groups and supergroups only
      * bot.chatType(["group", "supergroup"], ctx => { ... });
      * ```
-     * [Remember](https://grammy.dev/guide/context.html#shortcuts) also that you
+     * [Remember](https://grammy.dev/guide/context#shortcuts) also that you
      * can access the chat type via `ctx.chat.type`.
      *
      * @param chatType The chat type
@@ -663,7 +663,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      * ```
      *
      * Check out the
-     * [documentation](https://grammy.dev/guide/errors.html#error-boundaries) on
+     * [documentation](https://grammy.dev/guide/errors#error-boundaries) on
      * the website to learn more about error boundaries.
      *
      * @param errorHandler The error handler to use

package/out/composer.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Composer = exports.run = exports.BotError = void 0;
+exports.Composer = exports.BotError = void 0;
+exports.run = run;
 const context_js_1 = require("./context.js");
 // === Middleware errors
 /**
@@ -75,7 +76,6 @@ const leaf = () => Promise.resolve();
 async function run(middleware, ctx) {
     await middleware(ctx, leaf);
 }
-exports.run = run;
 // === Composer
 /**
  * The composer is the heart of the middleware system in grammY. It is also the
@@ -88,7 +88,7 @@ exports.run = run;
  *
  * On the other hand, if you want to dig deeper into how grammY implements
  * middleware, check out the
- * [documentation](https://grammy.dev/advanced/middleware.html) on the website.
+ * [documentation](https://grammy.dev/advanced/middleware) on the website.
  */
 class Composer {
     /**
@@ -118,7 +118,7 @@ class Composer {
      *
      * This method returns a new instance of composer. The returned instance can
      * be further extended, and all changes will be regarded here. Confer the
-     * [documentation](https://grammy.dev/advanced/middleware.html) on the
+     * [documentation](https://grammy.dev/advanced/middleware) on the
      * website if you want to know more about how the middleware system in
      * grammY works, especially when it comes to chaining the method calls
      * (`use( ... ).use( ... ).use( ... )`).
@@ -158,7 +158,7 @@ class Composer {
      *
      * You can use autocomplete in VS Code to see all available filter queries.
      * Check out the
-     * [documentation](https://grammy.dev/guide/filter-queries.html) on the
+     * [documentation](https://grammy.dev/guide/filter-queries) on the
      * website to learn more about filter queries in grammY.
      *
      * It is possible to pass multiple filter queries in an array, i.e.
@@ -329,7 +329,7 @@ class Composer {
      * // Groups and supergroups only
      * bot.chatType(["group", "supergroup"], ctx => { ... });
      * ```
-     * [Remember](https://grammy.dev/guide/context.html#shortcuts) also that you
+     * [Remember](https://grammy.dev/guide/context#shortcuts) also that you
      * can access the chat type via `ctx.chat.type`.
      *
      * @param chatType The chat type
@@ -676,7 +676,7 @@ class Composer {
      * ```
      *
      * Check out the
-     * [documentation](https://grammy.dev/guide/errors.html#error-boundaries) on
+     * [documentation](https://grammy.dev/guide/errors#error-boundaries) on
      * the website to learn more about error boundaries.
      *
      * @param errorHandler The error handler to use

package/out/context.d.ts

@@ -135,7 +135,7 @@ interface StaticHas {
  * methods to keep information about how a regular expression was matched.
  *
  * Read up about middleware on the
- * [website](https://grammy.dev/guide/context.html) if you want to know more
+ * [website](https://grammy.dev/guide/context) if you want to know more
  * about the powerful opportunities that lie in context objects, and about how
  * grammY implements them.
  */

package/out/context.js

@@ -198,7 +198,7 @@ const checker = {
  * methods to keep information about how a regular expression was matched.
  *
  * Read up about middleware on the
- * [website](https://grammy.dev/guide/context.html) if you want to know more
+ * [website](https://grammy.dev/guide/context) if you want to know more
  * about the powerful opportunities that lie in context objects, and about how
  * grammY implements them.
  */

package/out/convenience/inline_query.d.ts

@@ -163,7 +163,7 @@ export declare const InlineQueryResultBuilder: {
      * @param options Remaining options
      */
     game(id: string, game_short_name: string, options?: InlineQueryResultOptions<InlineQueryResultGame, "game_short_name">): {
-        reply_markup?: import("@grammyjs/types/markup.js").InlineKeyboardMarkup | undefined;
+        reply_markup?: import("@grammyjs/types/markup.js").InlineKeyboardMarkup;
         type: string;
         id: string;
         game_short_name: string;

package/out/convenience/keyboard.d.ts

@@ -37,7 +37,7 @@ type KeyboardSource = KeyboardButtonSource[][] | Keyboard;
  * ```
  *
  * Be sure to check out the
- * [documentation](https://grammy.dev/plugins/keyboard.html#custom-keyboards) on
+ * [documentation](https://grammy.dev/plugins/keyboard#custom-keyboards) on
  * custom keyboards in grammY.
  */
 export declare class Keyboard {
@@ -221,7 +221,7 @@ export declare class Keyboard {
     static webApp(text: string, url: string): KeyboardButton.WebAppButton;
     /**
      * Make the current keyboard persistent. See
-     * https://grammy.dev/plugins/keyboard.html#persistent-keyboards for more
+     * https://grammy.dev/plugins/keyboard#persistent-keyboards for more
      * details.
      *
      * Keyboards are not persistent by default, use this function to enable it
@@ -233,7 +233,7 @@ export declare class Keyboard {
     persistent(isEnabled?: boolean): this;
     /**
      * Make the current keyboard selective. See
-     * https://grammy.dev/plugins/keyboard.html#selectively-send-custom-keyboards
+     * https://grammy.dev/plugins/keyboard#selectively-send-custom-keyboards
      * for more details.
      *
      * Keyboards are non-selective by default, use this function to enable it
@@ -245,7 +245,7 @@ export declare class Keyboard {
     selected(isEnabled?: boolean): this;
     /**
      * Make the current keyboard one-time. See
-     * https://grammy.dev/plugins/keyboard.html#one-time-custom-keyboards for
+     * https://grammy.dev/plugins/keyboard#one-time-custom-keyboards for
      * more details.
      *
      * Keyboards are non-one-time by default, use this function to enable it
@@ -257,7 +257,7 @@ export declare class Keyboard {
     oneTime(isEnabled?: boolean): this;
     /**
      * Make the current keyboard resized. See
-     * https://grammy.dev/plugins/keyboard.html#resize-custom-keyboard for more
+     * https://grammy.dev/plugins/keyboard#resize-custom-keyboard for more
      * details.
      *
      * Keyboards are non-resized by default, use this function to enable it
@@ -269,7 +269,7 @@ export declare class Keyboard {
     resized(isEnabled?: boolean): this;
     /**
      * Set the current keyboard's input field placeholder. See
-     * https://grammy.dev/plugins/keyboard.html#input-field-placeholder for more
+     * https://grammy.dev/plugins/keyboard#input-field-placeholder for more
      * details.
      *
      * @param value The placeholder text
@@ -401,7 +401,7 @@ type InlineKeyboardSource = InlineKeyboardButton[][] | InlineKeyboard;
  * ```
  *
  * Be sure to to check the
- * [documentation](https://grammy.dev/plugins/keyboard.html#inline-keyboards) on
+ * [documentation](https://grammy.dev/plugins/keyboard#inline-keyboards) on
  * inline keyboards in grammY.
  */
 export declare class InlineKeyboard {

package/out/convenience/keyboard.js

@@ -37,7 +37,7 @@ exports.InlineKeyboard = exports.Keyboard = void 0;
  * ```
  *
  * Be sure to check out the
- * [documentation](https://grammy.dev/plugins/keyboard.html#custom-keyboards) on
+ * [documentation](https://grammy.dev/plugins/keyboard#custom-keyboards) on
  * custom keyboards in grammY.
  */
 class Keyboard {
@@ -237,7 +237,7 @@ class Keyboard {
     }
     /**
      * Make the current keyboard persistent. See
-     * https://grammy.dev/plugins/keyboard.html#persistent-keyboards for more
+     * https://grammy.dev/plugins/keyboard#persistent-keyboards for more
      * details.
      *
      * Keyboards are not persistent by default, use this function to enable it
@@ -252,7 +252,7 @@ class Keyboard {
     }
     /**
      * Make the current keyboard selective. See
-     * https://grammy.dev/plugins/keyboard.html#selectively-send-custom-keyboards
+     * https://grammy.dev/plugins/keyboard#selectively-send-custom-keyboards
      * for more details.
      *
      * Keyboards are non-selective by default, use this function to enable it
@@ -267,7 +267,7 @@ class Keyboard {
     }
     /**
      * Make the current keyboard one-time. See
-     * https://grammy.dev/plugins/keyboard.html#one-time-custom-keyboards for
+     * https://grammy.dev/plugins/keyboard#one-time-custom-keyboards for
      * more details.
      *
      * Keyboards are non-one-time by default, use this function to enable it
@@ -282,7 +282,7 @@ class Keyboard {
     }
     /**
      * Make the current keyboard resized. See
-     * https://grammy.dev/plugins/keyboard.html#resize-custom-keyboard for more
+     * https://grammy.dev/plugins/keyboard#resize-custom-keyboard for more
      * details.
      *
      * Keyboards are non-resized by default, use this function to enable it
@@ -297,7 +297,7 @@ class Keyboard {
     }
     /**
      * Set the current keyboard's input field placeholder. See
-     * https://grammy.dev/plugins/keyboard.html#input-field-placeholder for more
+     * https://grammy.dev/plugins/keyboard#input-field-placeholder for more
      * details.
      *
      * @param value The placeholder text
@@ -463,7 +463,7 @@ exports.Keyboard = Keyboard;
  * ```
  *
  * Be sure to to check the
- * [documentation](https://grammy.dev/plugins/keyboard.html#inline-keyboards) on
+ * [documentation](https://grammy.dev/plugins/keyboard#inline-keyboards) on
  * inline keyboards in grammY.
  */
 class InlineKeyboard {

package/out/convenience/session.d.ts

@@ -8,9 +8,9 @@ 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://grammy.dev/ref/core/session)
  * on session middleware to know more, and read the section about sessions on
- * the [website](https://grammy.dev/plugins/session.html).
+ * the [website](https://grammy.dev/plugins/session).
  */
 export interface SessionFlavor<S> {
     /**
@@ -37,10 +37,10 @@ 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://grammy.dev/ref/core/lazysession)
  * on lazy session middleware to know more, and read the section about lazy
  * sessions on the
- * [website](https://grammy.dev/plugins/session.html#lazy-sessions).
+ * [website](https://grammy.dev/plugins/session#lazy-sessions).
  */
 export interface LazySessionFlavor<S> {
     /**
@@ -115,7 +115,7 @@ export interface SessionOptions<S, C extends Context = Context> {
      * This option lets you generate your own session keys per context object.
      * The session key determines how to map the different session objects to
      * your chats and users. Check out the
-     * [documentation](https://grammy.dev/plugins/session.html#how-to-use-sessions)
+     * [documentation](https://grammy.dev/plugins/session#how-to-use-sessions)
      * on the website about how to use session middleware to know how session
      * keys are used.
      *
@@ -128,7 +128,7 @@ export interface SessionOptions<S, C extends Context = Context> {
      * delete access to the session middleware.
      *
      * Consider using a [known storage
-     * adapter](https://grammy.dev/plugins/session.html#known-storage-adapters)
+     * adapter](https://grammy.dev/plugins/session#known-storage-adapters)
      * instead of rolling your own implementation of this.
      *
      * The default implementation will store session in memory. The data will be
@@ -188,7 +188,7 @@ type MultiSessionOptionsRecord<S extends Record<string, unknown>, C extends Cont
  * You can delete the session data by setting `ctx.session` to `null` or
  * `undefined`.
  *
- * Check out the [documentation](https://grammy.dev/plugins/session.html) on the
+ * Check out the [documentation](https://grammy.dev/plugins/session) on the
  * website to know more about how sessions work in grammY.
  *
  * @param options Optional configuration to pass to the session middleware
@@ -221,7 +221,7 @@ export declare function session<S, C extends Context>(options?: SessionOptions<S
  * ```
  *
  * Check out the
- * [documentation](https://grammy.dev/plugins/session.html#lazy-sessions) on the
+ * [documentation](https://grammy.dev/plugins/session#lazy-sessions) on the
  * website to know more about how lazy sessions work in grammY.
  *
  * @param options Optional configuration to pass to the session middleware
@@ -314,7 +314,7 @@ export declare class MemorySessionStorage<S> implements StorageAdapter<S> {
      */
     protected readonly storage: Map<string, {
         session: S;
-        expires?: number | undefined;
+        expires?: number;
     }>;
     /**
      * Constructs a new memory session storage with the given time to live. Note

package/out/convenience/session.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MemorySessionStorage = exports.enhanceStorage = exports.lazySession = exports.session = void 0;
+exports.MemorySessionStorage = void 0;
+exports.session = session;
+exports.lazySession = lazySession;
+exports.enhanceStorage = enhanceStorage;
 const platform_node_js_1 = require("../platform.node.js");
 const debug = (0, platform_node_js_1.debug)("grammy:session");
 /**
@@ -45,7 +48,7 @@ const debug = (0, platform_node_js_1.debug)("grammy:session");
  * You can delete the session data by setting `ctx.session` to `null` or
  * `undefined`.
  *
- * Check out the [documentation](https://grammy.dev/plugins/session.html) on the
+ * Check out the [documentation](https://grammy.dev/plugins/session) on the
  * website to know more about how sessions work in grammY.
  *
  * @param options Optional configuration to pass to the session middleware
@@ -55,7 +58,6 @@ function session(options = {}) {
         ? strictMultiSession(options)
         : strictSingleSession(options);
 }
-exports.session = session;
 function strictSingleSession(options) {
     const { initial, storage, getSessionKey, custom } = fillDefaults(options);
     return async (ctx, next) => {
@@ -113,7 +115,7 @@ function strictMultiSession(options) {
  * ```
  *
  * Check out the
- * [documentation](https://grammy.dev/plugins/session.html#lazy-sessions) on the
+ * [documentation](https://grammy.dev/plugins/session#lazy-sessions) on the
  * website to know more about how lazy sessions work in grammY.
  *
  * @param options Optional configuration to pass to the session middleware
@@ -133,7 +135,6 @@ function lazySession(options = {}) {
         await propSession.finish();
     };
 }
-exports.lazySession = lazySession;
 /**
  * Internal class that manages a single property on the session. Can be used
  * both in a strict and a lazy way. Works by using `Object.defineProperty` to
@@ -286,7 +287,6 @@ function enhanceStorage(options) {
     }
     return wrapStorage(storage);
 }
-exports.enhanceStorage = enhanceStorage;
 function compatStorage(storage) {
     return {
         read: async (k) => {

package/out/convenience/webhook.d.ts

@@ -45,7 +45,7 @@ type ResolveName<A extends FrameworkAdapter | AdapterNames> = A extends AdapterN
  * ```
  *
  * Confer the grammY
- * [documentation](https://grammy.dev/guide/deployment-types.html) to read more
+ * [documentation](https://grammy.dev/guide/deployment-types) to read more
  * about how to run your bot with webhooks.
  *
  * @param bot The bot for which to create a callback

package/out/convenience/webhook.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.webhookCallback = void 0;
+exports.webhookCallback = webhookCallback;
 const platform_node_js_1 = require("../platform.node.js");
 const frameworks_js_1 = require("./frameworks.js");
 const debugErr = (0, platform_node_js_1.debug)("grammy:error");
@@ -45,12 +45,12 @@ function webhookCallback(bot, adapter = platform_node_js_1.defaultAdapter, onTim
         return handlerReturn;
     };
 }
-exports.webhookCallback = webhookCallback;
 function timeoutIfNecessary(task, onTimeout, timeout) {
     if (timeout === Infinity)
         return task;
     return new Promise((resolve, reject) => {
         const handle = setTimeout(() => {
+            debugErr(`Request timed out after ${timeout} ms`);
             if (onTimeout === "throw") {
                 reject(new Error(`Request timed out after ${timeout} ms`));
             }

package/out/core/client.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node-fetch" />
 import { type ApiMethods as Telegram, type ApiResponse, type Opts } from "../types.js";
 export type Methods<R extends RawApi> = string & keyof R;
 /**
@@ -30,7 +29,7 @@ type ApiCallResult<M extends Methods<R>, R extends RawApi> = R[M] extends (...ar
  * implement rate limiting or other things against the Telegram Bot API.
  *
  * Confer the grammY
- * [documentation](https://grammy.dev/advanced/transformers.html) to read more
+ * [documentation](https://grammy.dev/advanced/transformers) to read more
  * about how to use transformers.
  */
 export type Transformer<R extends RawApi = RawApi> = <M extends Methods<R>>(prev: ApiCallFn<R>, method: M, payload: Payload<M, R>, signal?: AbortSignal) => Promise<ApiResponse<ApiCallResult<M, R>>>;

package/out/core/client.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createRawApi = void 0;
+exports.createRawApi = createRawApi;
 const platform_node_js_1 = require("../platform.node.js");
 const error_js_1 = require("./error.js");
 const payload_js_1 = require("./payload.js");
@@ -125,7 +125,6 @@ function createRawApi(token, options, webhookReplyEnvelope) {
     };
     return api;
 }
-exports.createRawApi = createRawApi;
 const defaultBuildUrl = (root, token, method, env) => {
     const prefix = env === "test" ? "test/" : "";
     return `${root}/bot${token}/${prefix}${method}`;

package/out/core/error.d.ts

@@ -39,7 +39,7 @@ export declare function toGrammyError(err: ApiError, method: string, payload: Re
  * request failed.
  *
  * If an [API transformer
- * function](https://grammy.dev/advanced/transformers.html) throws an error,
+ * function](https://grammy.dev/advanced/transformers) throws an error,
  * grammY will regard this as if the network request failed. The contained error
  * will then be the error that was thrown by the transformer function.
  */

package/out/core/error.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toHttpError = exports.HttpError = exports.toGrammyError = exports.GrammyError = void 0;
+exports.HttpError = exports.GrammyError = void 0;
+exports.toGrammyError = toGrammyError;
+exports.toHttpError = toHttpError;
 const platform_node_js_1 = require("../platform.node.js");
 const debug = (0, platform_node_js_1.debug)("grammy:warn");
 /**
@@ -44,7 +46,6 @@ function toGrammyError(err, method, payload) {
     }
     return new GrammyError(`Call to '${method}' failed!`, err, method, payload);
 }
-exports.toGrammyError = toGrammyError;
 /**
  * This class represents errors that are thrown by grammY because an HTTP call
  * to the Telegram Bot API failed.
@@ -54,7 +55,7 @@ exports.toGrammyError = toGrammyError;
  * request failed.
  *
  * If an [API transformer
- * function](https://grammy.dev/advanced/transformers.html) throws an error,
+ * function](https://grammy.dev/advanced/transformers) throws an error,
  * grammY will regard this as if the network request failed. The contained error
  * will then be the error that was thrown by the transformer function.
  */
@@ -84,4 +85,3 @@ function toHttpError(method, sensitiveLogs) {
         throw new HttpError(msg, err);
     };
 }
-exports.toHttpError = toHttpError;

package/out/core/payload.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * Determines for a given payload if it may be sent as JSON, or if it has to be
  * uploaded via multipart/form-data. Returns `true` in the latter case and

package/out/core/payload.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createFormDataPayload = exports.createJsonPayload = exports.requiresFormDataUpload = void 0;
+exports.requiresFormDataUpload = requiresFormDataUpload;
+exports.createJsonPayload = createJsonPayload;
+exports.createFormDataPayload = createFormDataPayload;
 const platform_node_js_1 = require("../platform.node.js");
 const types_js_1 = require("../types.js");
 // === Payload types (JSON vs. form data)
@@ -18,7 +20,6 @@ function requiresFormDataUpload(payload) {
             ? v.some(requiresFormDataUpload)
             : v instanceof types_js_1.InputFile || requiresFormDataUpload(v)));
 }
-exports.requiresFormDataUpload = requiresFormDataUpload;
 /**
  * Calls `JSON.stringify` but removes `null` values from objects before
  * serialization
@@ -46,7 +47,6 @@ function createJsonPayload(payload) {
         body: str(payload),
     };
 }
-exports.createJsonPayload = createJsonPayload;
 async function* protectItr(itr, onError) {
     try {
         yield* itr;
@@ -77,7 +77,6 @@ function createFormDataPayload(payload, onError) {
         body: stream,
     };
 }
-exports.createFormDataPayload = createFormDataPayload;
 // === Form data creation
 function createBoundary() {
     // Taken from Deno std lib

package/out/filter.d.ts

@@ -17,9 +17,9 @@ type FilterFunction<C extends Context, D extends C> = (ctx: C) => ctx is D;
  * ```
  *
  * Check out the
- * [documentation](https://doc.deno.land/https://deno.land/x/grammy/mod.ts/~/Composer)
+ * [documentation](https://grammy.dev/ref/core/composer#on)
  * of `bot.on` for examples. In addition, the
- * [website](https://grammy.dev/guide/filter-queries.html) contains more
+ * [website](https://grammy.dev/guide/filter-queries) contains more
  * information about how filter queries work in grammY.
  *
  * @param filter A filter query or an array of filter queries
@@ -771,7 +771,7 @@ type ComputeFilterQueryList = InjectShortcuts;
 /**
  * Represents a filter query that can be passed to `bot.on`. There are three
  * different kinds of filter queries: Level 1, Level 2, and Level 3. Check out
- * the [website](https://grammy.dev/guide/filter-queries.html) to read about how
+ * the [website](https://grammy.dev/guide/filter-queries) to read about how
  * filter queries work in grammY, and how to use them.
  *
  * Here are three brief examples:

package/out/filter.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.preprocess = exports.parse = exports.matchFilter = void 0;
+exports.matchFilter = matchFilter;
+exports.parse = parse;
+exports.preprocess = preprocess;
 const filterQueryCache = new Map();
 // === Obtain O(1) filter function from query
 /**
@@ -19,9 +21,9 @@ const filterQueryCache = new Map();
  * ```
  *
  * Check out the
- * [documentation](https://doc.deno.land/https://deno.land/x/grammy/mod.ts/~/Composer)
+ * [documentation](https://grammy.dev/ref/core/composer#on)
  * of `bot.on` for examples. In addition, the
- * [website](https://grammy.dev/guide/filter-queries.html) contains more
+ * [website](https://grammy.dev/guide/filter-queries) contains more
  * information about how filter queries work in grammY.
  *
  * @param filter A filter query or an array of filter queries
@@ -38,13 +40,11 @@ function matchFilter(filter) {
     })();
     return (ctx) => predicate(ctx);
 }
-exports.matchFilter = matchFilter;
 function parse(filter) {
     return Array.isArray(filter)
         ? filter.map((q) => q.split(":"))
         : [filter.split(":")];
 }
-exports.parse = parse;
 function compile(parsed) {
     const preprocessed = parsed.flatMap((q) => check(q, preprocess(q)));
     const ltree = treeify(preprocessed);
@@ -98,7 +98,6 @@ function preprocess(filter) {
     }
     return expanded;
 }
-exports.preprocess = preprocess;
 function check(original, preprocessed) {
     if (preprocessed.length === 0)
         throw new Error("Empty filter query given");

package/out/platform.node.d.ts

@@ -1,6 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
 import { Agent as HttpAgent } from "http";
 import { Agent as HttpsAgent } from "https";
 import { Readable } from "stream";

package/out/platform.node.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultAdapter = exports.baseFetchConfig = exports.itrToStream = exports.debug = void 0;
+exports.defaultAdapter = exports.itrToStream = exports.debug = void 0;
+exports.baseFetchConfig = baseFetchConfig;
 // === Needed imports
 const http_1 = require("http");
 const https_1 = require("https");
@@ -38,6 +39,5 @@ function baseFetchConfig(apiRoot) {
     else
         return {};
 }
-exports.baseFetchConfig = baseFetchConfig;
 // === Default webhook adapter
 exports.defaultAdapter = "express";

package/out/types.node.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { type ApiMethods as ApiMethodsF, type InputMedia as InputMediaF, type InputMediaAnimation as InputMediaAnimationF, type InputMediaAudio as InputMediaAudioF, type InputMediaDocument as InputMediaDocumentF, type InputMediaPhoto as InputMediaPhotoF, type InputMediaVideo as InputMediaVideoF, type InputPaidMedia as InputPaidMediaF, type InputPaidMediaPhoto as InputPaidMediaPhotoF, type InputPaidMediaVideo as InputPaidMediaVideoF, type InputSticker as InputStickerF, type Opts as OptsF } from "@grammyjs/types";
 import { type ReadStream } from "fs";
 export * from "@grammyjs/types";
@@ -14,7 +13,7 @@ interface URLLike {
 }
 /**
  * An `InputFile` wraps a number of different sources for [sending
- * files](https://grammy.dev/guide/files.html#uploading-your-own-file).
+ * files](https://grammy.dev/guide/files#uploading-your-own-files).
  *
  * It corresponds to the `InputFile` type in the [Telegram Bot API
  * Reference](https://core.telegram.org/bots/api#inputfile).
@@ -26,7 +25,7 @@ export declare class InputFile {
      * Optional name of the constructed `InputFile` instance.
      *
      * Check out the
-     * [documentation](https://grammy.dev/guide/files.html#uploading-your-own-file)
+     * [documentation](https://grammy.dev/guide/files#uploading-your-own-files)
      * on sending files with `InputFile`.
      */
     readonly filename?: string;

package/out/types.node.js

@@ -25,7 +25,7 @@ __exportStar(require("@grammyjs/types"), exports);
 // === InputFile handling and File augmenting
 /**
  * An `InputFile` wraps a number of different sources for [sending
- * files](https://grammy.dev/guide/files.html#uploading-your-own-file).
+ * files](https://grammy.dev/guide/files#uploading-your-own-files).
  *
  * It corresponds to the `InputFile` type in the [Telegram Bot API
  * Reference](https://core.telegram.org/bots/api#inputfile).

package/out/web.mjs

@@ -4889,6 +4889,7 @@ function timeoutIfNecessary(task, onTimeout, timeout) {
     if (timeout === Infinity) return task;
     return new Promise((resolve, reject)=>{
         const handle = setTimeout(()=>{
+            debugErr1(`Request timed out after ${timeout} ms`);
             if (onTimeout === "throw") {
                 reject(new Error(`Request timed out after ${timeout} ms`));
             } else {

package/package.json

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