grammy 1.6.1 → 1.7.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 KnorpelSenf
+Copyright (c) 2022 KnorpelSenf
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -10,9 +10,9 @@ _<h2 align="center"> [:mag: Documentation](https://grammy.dev) | [:page_with_cur
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-5.5-blue?logo=telegram&style=flat-square)](https://core.telegram.org/bots/api)
+[![Bot API](https://img.shields.io/badge/Bot%20API-5.7-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-48-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-50-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 <!-- deno-fmt-ignore-end -->
@@ -176,7 +176,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
   <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> <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="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> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Adarvesh" title="Reviewed Pull Requests">👀</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> <a href="https://github.com/grammyjs/grammY/commits?author=dcdunkan" title="Documentation">📖</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>
@@ -189,6 +189,10 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
     <td align="center"><a href="http://glukki.ru"><img src="https://avatars.githubusercontent.com/u/140462?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Vitaliy Meshchaninov</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Aglukki" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=glukki" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/dilyanpalauzov"><img src="https://avatars.githubusercontent.com/u/4992947?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Дилян Палаузов</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Adilyanpalauzov" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=dilyanpalauzov" title="Code">💻</a></td>
     <td align="center"><a href="https://github.com/lmx-Hexagram"><img src="https://avatars.githubusercontent.com/u/52130356?v=4?s=100" width="100px;" alt=""/><br /><sub><b>lmx-Hexagram</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=lmx-Hexagram" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/IlyaSemenov"><img src="https://avatars.githubusercontent.com/u/128121?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Ilya Semenov</b></sub></a><br /><a href="#ideas-IlyaSemenov" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3AIlyaSemenov" title="Reviewed Pull Requests">👀</a></td>
+  </tr>
+  <tr>
+    <td align="center"><a href="https://github.com/abdollahzadehAli"><img src="https://avatars.githubusercontent.com/u/96317431?v=4?s=100" width="100px;" alt=""/><br /><sub><b>abdollahzadehAli</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=abdollahzadehAli" title="Documentation">📖</a> <a href="#example-abdollahzadehAli" title="Examples">💡</a></td>
   </tr>
 </table>
 

package/out/bot.d.ts

@@ -1,8 +1,8 @@
 import { BotError, Composer } from "./composer.js";
 import { Context } from "./context.js";
 import { Api } from "./core/api.js";
-import { ApiClientOptions, WebhookReplyEnvelope } from "./core/client.js";
-import { Update, UserFromGetMe } from "./platform.node.js";
+import { type ApiClientOptions, type WebhookReplyEnvelope } from "./core/client.js";
+import { type Update, type UserFromGetMe } from "./platform.node.js";
 /**
  * Options that can be specified when running the bot via simple long polling.
  */
@@ -153,11 +153,30 @@ export declare class Bot<C extends Context = Context, A extends Api = Api> exten
      */
     set botInfo(botInfo: UserFromGetMe);
     get botInfo(): UserFromGetMe;
+    /**
+     * Checks if the bot has been initialized. A bot is initialized if the bot
+     * information is set. The bot information can either be set automatically
+     * by calling `bot.init`, or manually through the bot constructor. Note that
+     * usually, initialization is done automatically and you do not have to care
+     * about this method.
+     *
+     * @returns true if the bot is initialized, and false otherwise
+     */
+    isInited(): boolean;
     /**
      * Initializes the bot, i.e. fetches information about the bot itself. This
-     * method is called automatically, you don't have to call it manually.
+     * method is called automatically, you usually don't have to call it
+     * manually.
      */
     init(): Promise<void>;
+    /**
+     * Internal. Do not call. Handles an update batch sequentially by supplying
+     * it one-by-one to the middleware. Handles middleware errors and stores the
+     * last update identifier that was being tried to handle.
+     *
+     * @param updates An array of updates to handle
+     */
+    private handleUpdates;
     /**
      * This is an internal method that you probably will not ever need to call.
      * It is used whenever a new update arrives from the Telegram servers that
@@ -238,4 +257,23 @@ export declare class Bot<C extends Context = Context, A extends Api = Api> exten
      * @param errorHandler A function that handles potential middleware errors
      */
     catch(errorHandler: ErrorHandler<C>): void;
+    /**
+     * Internal. Do not call. Enters a loop that will perform long polling until
+     * the bot is stopped.
+     */
+    private loop;
+    /**
+     * Internal. Do not call. Reliably fetches an update batch via `getUpdates`.
+     * Handles all known errors. Returns `undefined` if the bot is stopped and
+     * the call gets cancelled.
+     *
+     * @param options Polling options
+     * @returns An array of updates, or `undefined` if the bot is stopped.
+     */
+    private fetchUpdates;
+    /**
+     * Internal. Do not call. Handles an error that occurred during long
+     * polling.
+     */
+    private handlePollingError;
 }

package/out/bot.js

@@ -50,85 +50,25 @@ class Bot extends composer_js_1.Composer {
     constructor(token, config) {
         var _a;
         super();
-        Object.defineProperty(this, "token", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: token
-        });
-        Object.defineProperty(this, "pollingRunning", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: false
-        });
-        Object.defineProperty(this, "pollingAbortController", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "lastTriedUpdateId", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0
-        });
-        /**
-         * Gives you full access to the Telegram Bot API.
-         * ```ts
-         * // This is how to call the Bot API methods:
-         * bot.api.sendMessage(chat_id, 'Hello, grammY!')
-         * ```
-         *
-         * Use this only outside of your middleware. If you have access to `ctx`,
-         * then using `ctx.api` instead of `bot.api` is preferred.
-         */
-        Object.defineProperty(this, "api", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "me", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "clientConfig", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "ContextConstructor", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+        this.token = token;
+        this.pollingRunning = false;
+        this.lastTriedUpdateId = 0;
         /**
          * Holds the bot's error handler that is invoked whenever middleware throws
          * (rejects). If you set your own error handler via `bot.catch`, all that
          * happens is that this variable is assigned.
          */
-        Object.defineProperty(this, "errorHandler", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: async (err) => {
-                var _a, _b;
-                console.error("Error in middleware while handling update", (_b = (_a = err.ctx) === null || _a === void 0 ? void 0 : _a.update) === null || _b === void 0 ? void 0 : _b.update_id, err.error);
-                console.error("No error handler was set!");
-                console.error("Set your own error handler with `bot.catch = ...`");
-                if (this.pollingRunning) {
-                    console.error("Stopping bot");
-                    await this.stop();
-                }
-                throw err;
+        this.errorHandler = async (err) => {
+            var _a, _b;
+            console.error("Error in middleware while handling update", (_b = (_a = err.ctx) === null || _a === void 0 ? void 0 : _a.update) === null || _b === void 0 ? void 0 : _b.update_id, err.error);
+            console.error("No error handler was set!");
+            console.error("Set your own error handler with `bot.catch = ...`");
+            if (this.pollingRunning) {
+                console.error("Stopping bot");
+                await this.stop();
             }
-        });
+            throw err;
+        };
         if (!token)
             throw new Error("Empty token!");
         this.me = config === null || config === void 0 ? void 0 : config.botInfo;
@@ -157,12 +97,25 @@ class Bot extends composer_js_1.Composer {
         }
         return this.me;
     }
+    /**
+     * Checks if the bot has been initialized. A bot is initialized if the bot
+     * information is set. The bot information can either be set automatically
+     * by calling `bot.init`, or manually through the bot constructor. Note that
+     * usually, initialization is done automatically and you do not have to care
+     * about this method.
+     *
+     * @returns true if the bot is initialized, and false otherwise
+     */
+    isInited() {
+        return this.me !== undefined;
+    }
     /**
      * Initializes the bot, i.e. fetches information about the bot itself. This
-     * method is called automatically, you don't have to call it manually.
+     * method is called automatically, you usually don't have to call it
+     * manually.
      */
     async init() {
-        if (this.me === undefined) {
+        if (!this.isInited()) {
             debug("Initializing bot");
             const me = await this.api.getMe();
             if (this.me === undefined)
@@ -170,11 +123,34 @@ class Bot extends composer_js_1.Composer {
             else
                 debug("Bot info was set manually by now, will not overwrite");
         }
-        else {
-            debug("Bot already initialized!");
-        }
         debug(`I am ${this.me.username}!`);
     }
+    /**
+     * Internal. Do not call. Handles an update batch sequentially by supplying
+     * it one-by-one to the middleware. Handles middleware errors and stores the
+     * last update identifier that was being tried to handle.
+     *
+     * @param updates An array of updates to handle
+     */
+    async handleUpdates(updates) {
+        // handle updates sequentially (!)
+        for (const update of updates) {
+            this.lastTriedUpdateId = update.update_id;
+            try {
+                await this.handleUpdate(update);
+            }
+            catch (err) {
+                // should always be true
+                if (err instanceof composer_js_1.BotError) {
+                    await this.errorHandler(err);
+                }
+                else {
+                    console.error("FATAL: grammY unable to handle:", err);
+                    throw err;
+                }
+            }
+        }
+    }
     /**
      * This is an internal method that you probably will not ever need to call.
      * It is used whenever a new update arrives from the Telegram servers that
@@ -246,9 +222,10 @@ a known bot info object.");
      * @param options Options to use for simple long polling
      */
     async start(options) {
-        var _a, _b;
+        var _a;
         // Perform setup
-        await withRetries(() => this.init());
+        if (!this.isInited())
+            await withRetries(() => this.init());
         if (this.pollingRunning) {
             debug("Simple long polling already running!");
             return;
@@ -272,76 +249,8 @@ you can circumvent this protection against memory leaks.`);
         };
         // Start polling
         debug("Starting simple long polling");
-        this.pollingRunning = true;
-        this.pollingAbortController = new shim_node_js_1.AbortController();
-        const limit = options === null || options === void 0 ? void 0 : options.limit;
-        const timeout = (_a = options === null || options === void 0 ? void 0 : options.timeout) !== null && _a !== void 0 ? _a : 30; // seconds
-        let allowed_updates = options === null || options === void 0 ? void 0 : options.allowed_updates;
-        try {
-            (_b = options === null || options === void 0 ? void 0 : options.onStart) === null || _b === void 0 ? void 0 : _b.call(options, this.botInfo);
-        }
-        catch (error) {
-            this.pollingRunning = false;
-            this.pollingAbortController = undefined;
-            throw error;
-        }
-        const handleErr = async (error) => {
-            if (!this.pollingRunning)
-                throw error;
-            else if (error instanceof error_js_1.GrammyError) {
-                debugErr(error.message);
-                if (error.error_code === 401) {
-                    debugErr("Make sure you are using the bot token you obtained from @BotFather (https://t.me/BotFather).");
-                    throw error;
-                }
-                else if (error.error_code === 409) {
-                    debugErr("Consider revoking the bot token if you believe that no other instance is running.");
-                    throw error;
-                }
-            }
-            else
-                debugErr(error);
-            debugErr("Call to getUpdates failed, retrying in 3 seconds ...");
-            await new Promise((r) => setTimeout(r, 3000));
-        };
-        while (this.pollingRunning) {
-            // fetch updates
-            const offset = this.lastTriedUpdateId + 1;
-            let updates = undefined;
-            do {
-                try {
-                    updates = await this.api.getUpdates({ offset, limit, timeout, allowed_updates }, this.pollingAbortController.signal);
-                }
-                catch (error) {
-                    if (this.pollingRunning)
-                        await handleErr(error);
-                    else
-                        debug("Pending getUpdates request cancelled");
-                }
-            } while (updates === undefined && this.pollingRunning);
-            if (updates === undefined)
-                break;
-            // handle them sequentially (!)
-            for (const update of updates) {
-                this.lastTriedUpdateId = update.update_id;
-                try {
-                    await this.handleUpdate(update);
-                }
-                catch (err) {
-                    // should always be true
-                    if (err instanceof composer_js_1.BotError) {
-                        await this.errorHandler(err);
-                    }
-                    else {
-                        console.error("FATAL: grammY unable to handle:", err);
-                        throw err;
-                    }
-                }
-            }
-            // Telegram uses the last setting if `allowed_updates` is omitted so
-            // we can save same traffic by only sending it in the first request
-            allowed_updates = undefined;
-        }
+        (_a = options === null || options === void 0 ? void 0 : options.onStart) === null || _a === void 0 ? void 0 : _a.call(options, this.botInfo);
+        await this.loop(options);
         debug("Middleware is done running");
     }
     /**
@@ -391,8 +300,90 @@ you can circumvent this protection against memory leaks.`);
     catch(errorHandler) {
         this.errorHandler = errorHandler;
     }
+    /**
+     * Internal. Do not call. Enters a loop that will perform long polling until
+     * the bot is stopped.
+     */
+    async loop(options) {
+        var _a;
+        this.pollingRunning = true;
+        this.pollingAbortController = new shim_node_js_1.AbortController();
+        const limit = options === null || options === void 0 ? void 0 : options.limit;
+        const timeout = (_a = options === null || options === void 0 ? void 0 : options.timeout) !== null && _a !== void 0 ? _a : 30; // seconds
+        let allowed_updates = options === null || options === void 0 ? void 0 : options.allowed_updates;
+        while (this.pollingRunning) {
+            // fetch updates
+            const updates = await this.fetchUpdates({ limit, timeout, allowed_updates });
+            // check if polling stopped
+            if (updates === undefined)
+                break;
+            // handle updates
+            await this.handleUpdates(updates);
+            // Telegram uses the last setting if `allowed_updates` is omitted so
+            // we can save same traffic by only sending it in the first request
+            allowed_updates = undefined;
+        }
+    }
+    /**
+     * Internal. Do not call. Reliably fetches an update batch via `getUpdates`.
+     * Handles all known errors. Returns `undefined` if the bot is stopped and
+     * the call gets cancelled.
+     *
+     * @param options Polling options
+     * @returns An array of updates, or `undefined` if the bot is stopped.
+     */
+    async fetchUpdates({ limit, timeout, allowed_updates }) {
+        var _a;
+        const offset = this.lastTriedUpdateId + 1;
+        let updates = undefined;
+        do {
+            try {
+                updates = await this.api.getUpdates({ offset, limit, timeout, allowed_updates }, (_a = this.pollingAbortController) === null || _a === void 0 ? void 0 : _a.signal);
+            }
+            catch (error) {
+                await this.handlePollingError(error);
+            }
+        } while (updates === undefined && this.pollingRunning);
+        return updates;
+    }
+    /**
+     * Internal. Do not call. Handles an error that occurred during long
+     * polling.
+     */
+    async handlePollingError(error) {
+        var _a;
+        if (!this.pollingRunning) {
+            debug("Pending getUpdates request cancelled");
+            return;
+        }
+        let sleepSeconds = 3;
+        if (error instanceof error_js_1.GrammyError) {
+            debugErr(error.message);
+            if (error.error_code === 401) {
+                debugErr("Make sure you are using the bot token you obtained from @BotFather (https://t.me/BotFather).");
+                throw error;
+            }
+            else if (error.error_code === 409) {
+                debugErr("Consider revoking the bot token if you believe that no other instance is running.");
+                throw error;
+            }
+            else if (error.error_code === 429) {
+                debugErr("Bot API server is closing.");
+                sleepSeconds = (_a = error.parameters.retry_after) !== null && _a !== void 0 ? _a : sleepSeconds;
+            }
+        }
+        else
+            debugErr(error);
+        debugErr(`Call to getUpdates failed, retrying in ${sleepSeconds} seconds ...`);
+        await sleep(sleepSeconds);
+    }
 }
 exports.Bot = Bot;
+/**
+ * Performs a network call task, retrying upon known errors until success.
+ *
+ * @param task Async task to perform
+ */
 async function withRetries(task) {
     let success = false;
     while (!success) {
@@ -409,9 +400,8 @@ async function withRetries(task) {
                     continue;
                 if (error.error_code === 429) {
                     const retryAfter = error.parameters.retry_after;
-                    if (retryAfter !== undefined) {
-                        await new Promise((resolve) => setTimeout(resolve, 1000 * retryAfter));
-                    }
+                    if (retryAfter !== undefined)
+                        await sleep(retryAfter);
                     continue;
                 }
             }
@@ -419,4 +409,10 @@ async function withRetries(task) {
         }
     }
 }
+/**
+ * Returns a new promise that resolves after the specified number of seconds.
+ */
+function sleep(seconds) {
+    return new Promise((r) => setTimeout(r, 1000 * seconds));
+}
 const shim_node_js_1 = require("./shim.node.js");

package/out/composer.d.ts

@@ -1,5 +1,5 @@
-import { Context } from "./context.js";
-import { Filter, FilterQuery } from "./filter.js";
+import { type Context } from "./context.js";
+import { type Filter, type FilterQuery } from "./filter.js";
 declare type MaybePromise<T> = T | Promise<T>;
 declare type MaybeArray<T> = T | T[];
 declare type StringWithSuggestions<S extends string> = (string & {}) | S;

package/out/composer.js

@@ -11,18 +11,8 @@ const filter_js_1 = require("./filter.js");
 class BotError extends Error {
     constructor(error, ctx) {
         super(generateBotErrorMessage(error));
-        Object.defineProperty(this, "error", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: error
-        });
-        Object.defineProperty(this, "ctx", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: ctx
-        });
+        this.error = error;
+        this.ctx = ctx;
         this.name = "BotError";
         if (error instanceof Error)
             this.stack = error.stack;
@@ -109,12 +99,6 @@ class Composer {
      * @param middleware The middleware to compose
      */
     constructor(...middleware) {
-        Object.defineProperty(this, "handler", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         this.handler = middleware.length === 0
             ? pass
             : middleware.map(flatten).reduce(concat);

package/out/context.d.ts

@@ -1,6 +1,6 @@
-import { Api, Other as OtherApi } from "./core/api.js";
-import { Methods, RawApi } from "./core/client.js";
-import { Chat, ChatPermissions, InlineQueryResult, InputFile, InputMedia, InputMediaAudio, InputMediaDocument, InputMediaPhoto, InputMediaVideo, LabeledPrice, Message, PassportElementError, Update, User, UserFromGetMe } from "./platform.node.js";
+import { type Api, type Other as OtherApi } from "./core/api.js";
+import { type Methods, type RawApi } from "./core/client.js";
+import { type Chat, type ChatPermissions, type InlineQueryResult, type InputFile, type InputMedia, type InputMediaAudio, type InputMediaDocument, type InputMediaPhoto, type InputMediaVideo, type LabeledPrice, type Message, type PassportElementError, type Update, type User, type UserFromGetMe } from "./platform.node.js";
 declare type Other<M extends Methods<RawApi>, X extends string = never> = OtherApi<RawApi, M, X>;
 declare type SnakeToCamelCase<S extends string> = S extends `${infer L}_${infer R}` ? `${L}${Capitalize<SnakeToCamelCase<R>>}` : S;
 export declare type AliasProps<U> = {
@@ -10,7 +10,7 @@ declare type RenamedUpdate = AliasProps<Omit<Update, "update_id">>;
 /**
  * When your bot receives a message, Telegram sends an update object to your
  * bot. The update contains information about the chat, the user, and of course
- * the message itself. There a numerous other updates, too:
+ * the message itself. There are numerous other updates, too:
  * https://core.telegram.org/bots/api#update
  *
  * When grammY receives an update, it wraps this update into a context object
@@ -735,7 +735,7 @@ export declare class Context implements RenamedUpdate {
      */
     deleteMessage(signal?: AbortSignal): Promise<true>;
     /**
-     * Context-aware alias for `api.sendSticker`. Use this method to send static .WEBP or animated .TGS stickers. On success, the sent Message is returned.
+     * Context-aware alias for `api.sendSticker`. Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers. On success, the sent Message is returned.
      *
      * @param sticker Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data.
      * @param other Optional remaining parameters, confer the official reference below

package/out/context.js

@@ -4,7 +4,7 @@ exports.Context = void 0;
 /**
  * When your bot receives a message, Telegram sends an update object to your
  * bot. The update contains information about the chat, the user, and of course
- * the message itself. There a numerous other updates, too:
+ * the message itself. There are numerous other updates, too:
  * https://core.telegram.org/bots/api#update
  *
  * When grammY receives an update, it wraps this update into a context object
@@ -53,34 +53,9 @@ class Context {
      * Information about the bot itself.
      */
     me) {
-        Object.defineProperty(this, "update", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: update
-        });
-        Object.defineProperty(this, "api", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: api
-        });
-        Object.defineProperty(this, "me", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: me
-        });
-        /**
-         * Used by some middleware to store information about how a certain string
-         * or regular expression was matched.
-         */
-        Object.defineProperty(this, "match", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+        this.update = update;
+        this.api = api;
+        this.me = me;
     }
     // UPDATE SHORTCUTS
     /** Alias for `ctx.update.message` */
@@ -940,7 +915,7 @@ class Context {
         return this.api.deleteMessage(orThrow(this.chat, "deleteMessage").id, orThrow(this.msg, "deleteMessage").message_id, signal);
     }
     /**
-     * Context-aware alias for `api.sendSticker`. Use this method to send static .WEBP or animated .TGS stickers. On success, the sent Message is returned.
+     * Context-aware alias for `api.sendSticker`. Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers. On success, the sent Message is returned.
      *
      * @param sticker Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP file from the Internet, or upload a new one using multipart/form-data.
      * @param other Optional remaining parameters, confer the official reference below

package/out/convenience/frameworks.node.d.ts

@@ -1,14 +1,15 @@
-import type { IncomingMessage, ServerResponse } from "http";
+/// <reference types="node" />
+import { type IncomingMessage, type ServerResponse } from "http";
 export declare const adapters: {
     http: (req: IncomingMessage, res: ServerResponse) => {
         update: Promise<any>;
-        end: () => void;
-        respond: (json: string) => void;
+        end: () => ServerResponse;
+        respond: (json: string) => ServerResponse;
     };
     https: (req: IncomingMessage, res: ServerResponse) => {
         update: Promise<any>;
-        end: () => void;
-        respond: (json: string) => void;
+        end: () => ServerResponse;
+        respond: (json: string) => ServerResponse;
     };
     express: (req: any, res: any) => {
         update: Promise<any>;

package/out/convenience/keyboard.d.ts

@@ -1,4 +1,4 @@
-import { InlineKeyboardButton, KeyboardButton, LoginUrl } from "../platform.node.js";
+import { type InlineKeyboardButton, type KeyboardButton, type LoginUrl } from "../platform.node.js";
 /**
  * Use this class to simplify building a custom keyboard (something like this:
  * https://core.telegram.org/bots#keyboards).