grammy 1.6.2 → 1.7.2

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.6-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-50-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-52-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>
@@ -193,6 +193,8 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
   </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>
+    <td align="center"><a href="https://github.com/MrSaeedNasiri"><img src="https://avatars.githubusercontent.com/u/17780289?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Saeed Nasiri</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=MrSaeedNasiri" title="Documentation">📖</a></td>
+    <td align="center"><a href="https://github.com/Scrip7"><img src="https://avatars.githubusercontent.com/u/37535505?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Hesoyam</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=Scrip7" title="Documentation">📖</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.
  */
@@ -35,13 +35,14 @@ export interface PollingOptions {
      */
     drop_pending_updates?: boolean;
     /**
-     * Synchronous callback that is useful for logging. It will be executed once
-     * the setup of the bot has completed, and immediately before the first
-     * updates are being fetched. The bot information `bot.botInfo` will be
-     * available when the function is run. For convenience, the callback
-     * function receives the value of `bot.botInfo` as an argument.
+     * A callback function that is useful for logging (or setting up middleware
+     * if you did not do this before). It will be executed after the setup of
+     * the bot has completed, and immediately before the first updates are being
+     * fetched. The bot information `bot.botInfo` will be available when the
+     * function is run. For convenience, the callback function receives the
+     * value of `bot.botInfo` as an argument.
      */
-    onStart?: (botInfo: UserFromGetMe) => void;
+    onStart?: (botInfo: UserFromGetMe) => void | Promise<void>;
 }
 export { BotError };
 /**
@@ -50,7 +51,7 @@ export { BotError };
  */
 export declare type ErrorHandler<C extends Context = Context> = (error: BotError<C>) => unknown;
 /**
- * Options to pass the bot when creating it.
+ * Options to pass to the bot when creating it.
  */
 export interface BotConfig<C extends Context> {
     /**
@@ -169,6 +170,14 @@ export declare class Bot<C extends Context = Context, A extends Api = Api> exten
      * 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
@@ -249,4 +258,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;
@@ -185,6 +125,32 @@ class Bot extends composer_js_1.Composer {
         }
         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
@@ -256,7 +222,7 @@ a known bot info object.");
      * @param options Options to use for simple long polling
      */
     async start(options) {
-        var _a, _b;
+        var _a;
         // Perform setup
         if (!this.isInited())
             await withRetries(() => this.init());
@@ -267,6 +233,8 @@ a known bot info object.");
         await withRetries(() => this.api.deleteWebhook({
             drop_pending_updates: options === null || options === void 0 ? void 0 : options.drop_pending_updates,
         }));
+        // All async ops of setup complete, run callback
+        await ((_a = options === null || options === void 0 ? void 0 : options.onStart) === null || _a === void 0 ? void 0 : _a.call(options, this.botInfo));
         // Prevent common misuse that causes memory leak
         this.use = () => {
             throw new Error(`It looks like you are registering more listeners \
@@ -283,76 +251,7 @@ 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;
-        }
+        await this.loop(options);
         debug("Middleware is done running");
     }
     /**
@@ -402,8 +301,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) {
@@ -420,9 +401,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;
                 }
             }
@@ -430,4 +410,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).

package/out/convenience/keyboard.js

@@ -34,12 +34,7 @@ class Keyboard {
          * The nested array that holds the custom keyboard. It will be extended every time
          * you call one of the provided methods.
          */
-        Object.defineProperty(this, "keyboard", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: [[]]
-        });
+        this.keyboard = [[]];
     }
     /**
      * Allows you to add your own `KeyboardButton` objects if you already have
@@ -141,12 +136,7 @@ class InlineKeyboard {
          * The nested array that holds the inline keyboard. It will be extended
          * every time you call one of the provided methods.
          */
-        Object.defineProperty(this, "inline_keyboard", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: [[]]
-        });
+        this.inline_keyboard = [[]];
     }
     /**
      * Allows you to add your own `InlineKeyboardButton` objects if you already

package/out/convenience/session.d.ts

@@ -1,5 +1,5 @@
-import { Context } from "../context.js";
-import { MiddlewareFn } from "../composer.js";
+import { type Context } from "../context.js";
+import { type MiddlewareFn } from "../composer.js";
 declare type MaybePromise<T> = Promise<T> | T;
 /**
  * A session flavor is a context flavor that holds session data under