grammy 1.19.1 → 1.19.3

package/README.md

@@ -257,7 +257,7 @@ 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/binamralamsal"><img src="https://avatars.githubusercontent.com/u/61900781?v=4?s=100" width="100px;" alt="Binamra Lamsal"/><br /><sub><b>Binamra Lamsal</b></sub></a><br /><a href="#ideas-binamralamsal" title="Ideas, Planning, & Feedback">🤔</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/gertminov"><img src="https://avatars.githubusercontent.com/u/78727928?v=4?s=100" width="100px;" alt="gertminov"/><br /><sub><b>gertminov</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=gertminov" title="Documentation">📖</a> <a href="#tutorial-gertminov" title="Tutorials">✅</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/amanape"><img src="https://avatars.githubusercontent.com/u/83104063?v=4?s=100" width="100px;" alt="Stephan Psaras"/><br /><sub><b>Stephan Psaras</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Aamanape" title="Bug reports">🐛</a></td>
-      <td align="center" valign="top" width="11.11%"><a href="https://github.com/shevernitskiy"><img src="https://avatars.githubusercontent.com/u/28886342?v=4?s=100" width="100px;" alt="shevernitskiy"/><br /><sub><b>shevernitskiy</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ashevernitskiy" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Ashevernitskiy" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/shevernitskiy"><img src="https://avatars.githubusercontent.com/u/28886342?v=4?s=100" width="100px;" alt="shevernitskiy"/><br /><sub><b>shevernitskiy</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ashevernitskiy" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Ashevernitskiy" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/grammyjs/grammY/commits?author=shevernitskiy" title="Code">💻</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/mrmaster009"><img src="https://avatars.githubusercontent.com/u/81420490?v=4?s=100" width="100px;" alt="mrmaster009"/><br /><sub><b>mrmaster009</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=mrmaster009" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://lwjerri.dev/"><img src="https://avatars.githubusercontent.com/u/50290430?v=4?s=100" width="100px;" alt="Andrey Zontov"/><br /><sub><b>Andrey Zontov</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3ALWJerri" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=LWJerri" title="Code">💻</a> <a href="#question-LWJerri" title="Answering Questions">💬</a> <a href="#ideas-LWJerri" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/commits?author=LWJerri" title="Documentation">📖</a> <a href="#translation-LWJerri" title="Translation">🌍</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/AbbassAlmusawi"><img src="https://avatars.githubusercontent.com/u/73327881?v=4?s=100" width="100px;" alt="Abbass Al-Musawi"/><br /><sub><b>Abbass Al-Musawi</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=AbbassAlmusawi" title="Documentation">📖</a></td>
@@ -280,6 +280,7 @@ 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/shaunnope"><img src="https://avatars.githubusercontent.com/u/19631195?v=4?s=100" width="100px;" alt="Sean Yap"/><br /><sub><b>Sean Yap</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Ashaunnope" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=shaunnope" title="Code">💻</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://sergeysolovev.com"><img src="https://avatars.githubusercontent.com/u/5831301?v=4?s=100" width="100px;" alt="Sergey Solovev"/><br /><sub><b>Sergey Solovev</b></sub></a><br /><a href="#ideas-sergeysolovev" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Asergeysolovev" title="Reviewed Pull Requests">👀</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/HeySreelal"><img src="https://avatars.githubusercontent.com/u/94184909?v=4?s=100" width="100px;" alt="Sree (Taylor's Version)"/><br /><sub><b>Sree (Taylor's Version)</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3AHeySreelal" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=HeySreelal" title="Code">💻</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="http://linkedin.com/in/thecoorum"><img src="https://avatars.githubusercontent.com/u/32096016?v=4?s=100" width="100px;" alt="Yaroslav Vovchenko"/><br /><sub><b>Yaroslav Vovchenko</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Athecoorum" title="Bug reports">🐛</a></td>
     </tr>
   </tbody>
 </table>

package/out/convenience/frameworks.d.ts

@@ -46,21 +46,22 @@ export interface ReqResHandler {
  */
 export type FrameworkAdapter = (...args: any[]) => ReqResHandler;
 export declare const adapters: {
-    express: FrameworkAdapter;
-    koa: FrameworkAdapter;
-    fastify: FrameworkAdapter;
-    serveHttp: FrameworkAdapter;
-    "std/http": FrameworkAdapter;
-    oak: FrameworkAdapter;
-    http: FrameworkAdapter;
-    https: FrameworkAdapter;
     "aws-lambda": FrameworkAdapter;
     "aws-lambda-async": FrameworkAdapter;
     azure: FrameworkAdapter;
-    "next-js": FrameworkAdapter;
-    sveltekit: FrameworkAdapter;
     cloudflare: FrameworkAdapter;
     "cloudflare-mod": FrameworkAdapter;
+    express: FrameworkAdapter;
+    fastify: FrameworkAdapter;
     hono: FrameworkAdapter;
+    http: FrameworkAdapter;
+    https: FrameworkAdapter;
+    koa: FrameworkAdapter;
+    "next-js": FrameworkAdapter;
+    nhttp: FrameworkAdapter;
+    oak: FrameworkAdapter;
+    serveHttp: FrameworkAdapter;
+    "std/http": FrameworkAdapter;
+    sveltekit: FrameworkAdapter;
     worktop: FrameworkAdapter;
 };

package/out/convenience/frameworks.js

@@ -13,111 +13,6 @@ const unauthorized = () => new Response('"unauthorized"', {
     status: 401,
     statusText: WRONG_TOKEN_ERROR,
 });
-/** express web framework */
-const express = (req, res) => ({
-    update: Promise.resolve(req.body),
-    header: req.header(SECRET_HEADER),
-    end: () => res.end(),
-    respond: (json) => {
-        res.set("Content-Type", "application/json");
-        res.send(json);
-    },
-    unauthorized: () => {
-        res.status(401).send(WRONG_TOKEN_ERROR);
-    },
-});
-/** koa web framework */
-const koa = (ctx) => ({
-    update: Promise.resolve(ctx.request.body),
-    header: ctx.get(SECRET_HEADER),
-    end: () => {
-        ctx.body = "";
-    },
-    respond: (json) => {
-        ctx.set("Content-Type", "application/json");
-        ctx.response.body = json;
-    },
-    unauthorized: () => {
-        ctx.status = 401;
-    },
-});
-/** fastify web framework */
-const fastify = (req, reply) => ({
-    update: Promise.resolve(req.body),
-    header: req.headers[SECRET_HEADER_LOWERCASE],
-    end: () => reply.status(200).send(),
-    respond: (json) => reply.send(json),
-    unauthorized: () => reply.code(401).send(WRONG_TOKEN_ERROR),
-});
-const serveHttp = (requestEvent) => ({
-    update: requestEvent.request.json(),
-    header: requestEvent.request.headers.get(SECRET_HEADER) || undefined,
-    end: () => requestEvent.respondWith(ok()),
-    respond: (json) => requestEvent.respondWith(okJson(json)),
-    unauthorized: () => requestEvent.respondWith(unauthorized()),
-});
-/** std/http web server */
-const stdHttp = (req) => {
-    let resolveResponse;
-    return {
-        update: req.json(),
-        header: req.headers.get(SECRET_HEADER) || undefined,
-        end: () => {
-            if (resolveResponse)
-                resolveResponse(ok());
-        },
-        respond: (json) => {
-            if (resolveResponse)
-                resolveResponse(okJson(json));
-        },
-        unauthorized: () => {
-            if (resolveResponse)
-                resolveResponse(unauthorized());
-        },
-        handlerReturn: new Promise((resolve) => {
-            resolveResponse = resolve;
-        }),
-    };
-};
-/** oak web framework */
-const oak = (ctx) => ({
-    update: ctx.request.body({ type: "json" }).value,
-    header: ctx.request.headers.get(SECRET_HEADER) || undefined,
-    end: () => {
-        ctx.response.status = 200;
-    },
-    respond: (json) => {
-        ctx.response.type = "json";
-        ctx.response.body = json;
-    },
-    unauthorized: () => {
-        ctx.response.status = 401;
-    },
-});
-/** Node.js native 'http' and 'https' modules */
-const http = (req, res) => {
-    const secretHeaderFromRequest = req.headers[SECRET_HEADER_LOWERCASE];
-    return {
-        update: new Promise((resolve, reject) => {
-            const chunks = [];
-            req.on("data", (chunk) => chunks.push(chunk))
-                .once("end", () => {
-                // @ts-ignore `Buffer` is Node-only
-                const raw = Buffer.concat(chunks).toString("utf-8");
-                resolve(JSON.parse(raw));
-            })
-                .once("error", reject);
-        }),
-        header: Array.isArray(secretHeaderFromRequest)
-            ? secretHeaderFromRequest[0]
-            : secretHeaderFromRequest,
-        end: () => res.end(),
-        respond: (json) => res
-            .writeHead(200, { "Content-Type": "application/json" })
-            .end(json),
-        unauthorized: () => res.writeHead(401).end(WRONG_TOKEN_ERROR),
-    };
-};
 /** AWS lambda serverless functions */
 const awsLambda = (event, _context, callback) => ({
     update: JSON.parse(event.body),
@@ -164,37 +59,6 @@ const azure = (context, req) => ({
         context.res.send(401, WRONG_TOKEN_ERROR);
     },
 });
-/** Next.js Serverless Functions */
-const nextJs = (req, res) => ({
-    update: Promise.resolve(req.body),
-    header: req.headers[SECRET_HEADER_LOWERCASE],
-    end: () => res.end(),
-    respond: (json) => res.status(200).json(json),
-    unauthorized: () => res.status(401).send(WRONG_TOKEN_ERROR),
-});
-/** Sveltekit Serverless Functions */
-const sveltekit = ({ request }) => {
-    let resolveResponse;
-    return {
-        update: Promise.resolve(request.json()),
-        header: request.headers.get(SECRET_HEADER) || undefined,
-        end: () => {
-            if (resolveResponse)
-                resolveResponse(ok());
-        },
-        respond: (json) => {
-            if (resolveResponse)
-                resolveResponse(okJson(json));
-        },
-        unauthorized: () => {
-            if (resolveResponse)
-                resolveResponse(unauthorized());
-        },
-        handlerReturn: new Promise((resolve) => {
-            resolveResponse = resolve;
-        }),
-    };
-};
 /** Native CloudFlare workers (service worker) */
 const cloudflare = (event) => {
     let resolveResponse;
@@ -235,6 +99,27 @@ const cloudflareModule = (request) => {
         }),
     };
 };
+/** express web framework */
+const express = (req, res) => ({
+    update: Promise.resolve(req.body),
+    header: req.header(SECRET_HEADER),
+    end: () => res.end(),
+    respond: (json) => {
+        res.set("Content-Type", "application/json");
+        res.send(json);
+    },
+    unauthorized: () => {
+        res.status(401).send(WRONG_TOKEN_ERROR);
+    },
+});
+/** fastify web framework */
+const fastify = (req, reply) => ({
+    update: Promise.resolve(req.body),
+    header: req.headers[SECRET_HEADER_LOWERCASE],
+    end: () => reply.status(200).send(),
+    respond: (json) => reply.send(json),
+    unauthorized: () => reply.code(401).send(WRONG_TOKEN_ERROR),
+});
 /** hono web framework */
 const hono = (ctx) => {
     let resolveResponse;
@@ -258,6 +143,130 @@ const hono = (ctx) => {
         }),
     };
 };
+/** Node.js native 'http' and 'https' modules */
+const http = (req, res) => {
+    const secretHeaderFromRequest = req.headers[SECRET_HEADER_LOWERCASE];
+    return {
+        update: new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on("data", (chunk) => chunks.push(chunk))
+                .once("end", () => {
+                // @ts-ignore `Buffer` is Node-only
+                const raw = Buffer.concat(chunks).toString("utf-8");
+                resolve(JSON.parse(raw));
+            })
+                .once("error", reject);
+        }),
+        header: Array.isArray(secretHeaderFromRequest)
+            ? secretHeaderFromRequest[0]
+            : secretHeaderFromRequest,
+        end: () => res.end(),
+        respond: (json) => res
+            .writeHead(200, { "Content-Type": "application/json" })
+            .end(json),
+        unauthorized: () => res.writeHead(401).end(WRONG_TOKEN_ERROR),
+    };
+};
+/** koa web framework */
+const koa = (ctx) => ({
+    update: Promise.resolve(ctx.request.body),
+    header: ctx.get(SECRET_HEADER),
+    end: () => {
+        ctx.body = "";
+    },
+    respond: (json) => {
+        ctx.set("Content-Type", "application/json");
+        ctx.response.body = json;
+    },
+    unauthorized: () => {
+        ctx.status = 401;
+    },
+});
+/** Next.js Serverless Functions */
+const nextJs = (req, res) => ({
+    update: Promise.resolve(req.body),
+    header: req.headers[SECRET_HEADER_LOWERCASE],
+    end: () => res.end(),
+    respond: (json) => res.status(200).json(json),
+    unauthorized: () => res.status(401).send(WRONG_TOKEN_ERROR),
+});
+/** nhttp web framework */
+const nhttp = (rev) => ({
+    update: rev.body,
+    header: rev.headers.get(SECRET_HEADER) || undefined,
+    end: () => rev.response.sendStatus(200),
+    respond: (json) => rev.response.status(200).send(json),
+    unauthorized: () => rev.response.status(401).send(WRONG_TOKEN_ERROR),
+});
+/** oak web framework */
+const oak = (ctx) => ({
+    update: ctx.request.body({ type: "json" }).value,
+    header: ctx.request.headers.get(SECRET_HEADER) || undefined,
+    end: () => {
+        ctx.response.status = 200;
+    },
+    respond: (json) => {
+        ctx.response.type = "json";
+        ctx.response.body = json;
+    },
+    unauthorized: () => {
+        ctx.response.status = 401;
+    },
+});
+/** Deno.serve */
+const serveHttp = (requestEvent) => ({
+    update: requestEvent.request.json(),
+    header: requestEvent.request.headers.get(SECRET_HEADER) || undefined,
+    end: () => requestEvent.respondWith(ok()),
+    respond: (json) => requestEvent.respondWith(okJson(json)),
+    unauthorized: () => requestEvent.respondWith(unauthorized()),
+});
+/** std/http web server */
+const stdHttp = (req) => {
+    let resolveResponse;
+    return {
+        update: req.json(),
+        header: req.headers.get(SECRET_HEADER) || undefined,
+        end: () => {
+            if (resolveResponse)
+                resolveResponse(ok());
+        },
+        respond: (json) => {
+            if (resolveResponse)
+                resolveResponse(okJson(json));
+        },
+        unauthorized: () => {
+            if (resolveResponse)
+                resolveResponse(unauthorized());
+        },
+        handlerReturn: new Promise((resolve) => {
+            resolveResponse = resolve;
+        }),
+    };
+};
+/** Sveltekit Serverless Functions */
+const sveltekit = ({ request }) => {
+    let resolveResponse;
+    return {
+        update: Promise.resolve(request.json()),
+        header: request.headers.get(SECRET_HEADER) || undefined,
+        end: () => {
+            if (resolveResponse)
+                resolveResponse(ok());
+        },
+        respond: (json) => {
+            if (resolveResponse)
+                resolveResponse(okJson(json));
+        },
+        unauthorized: () => {
+            if (resolveResponse)
+                resolveResponse(unauthorized());
+        },
+        handlerReturn: new Promise((resolve) => {
+            resolveResponse = resolve;
+        }),
+    };
+};
 /** worktop CloudFlare workers framework */
 const worktop = (req, res) => ({
     update: Promise.resolve(req.body.json()),
@@ -266,23 +275,24 @@ const worktop = (req, res) => ({
     respond: (json) => res.send(200, json),
     unauthorized: () => res.send(401, WRONG_TOKEN_ERROR),
 });
-// Please open a PR if you want to add another adapter
+// Please open a pull request if you want to add another adapter
 exports.adapters = {
-    express,
-    koa,
-    fastify,
-    serveHttp,
-    "std/http": stdHttp,
-    oak,
-    http,
-    https: http,
     "aws-lambda": awsLambda,
     "aws-lambda-async": awsLambdaAsync,
     azure,
-    "next-js": nextJs,
-    sveltekit,
     cloudflare,
     "cloudflare-mod": cloudflareModule,
+    express,
+    fastify,
     hono,
+    http,
+    https: http,
+    koa,
+    "next-js": nextJs,
+    nhttp,
+    oak,
+    serveHttp,
+    "std/http": stdHttp,
+    sveltekit,
     worktop,
 };

package/out/core/client.d.ts

@@ -64,6 +64,19 @@ export interface ApiClientOptions {
      * https://api.telegram.org
      */
     apiRoot?: string;
+    /**
+     * Specifies whether to use the [test
+     * environment](https://core.telegram.org/bots/webapps#using-bots-in-the-test-environment).
+     * Can be either `"prod"` (default) or `"test"`.
+     *
+     * The testing infrastructure is separate from the regular production
+     * infrastructure. No chats, accounts, or other data is shared between them.
+     * If you set this option to `"test"`, you will need to make your Telegram
+     * client connect to the testing data centers of Telegram, register your
+     * phone number again, open a new chat with @BotFather, and create a
+     * separate bot.
+     */
+    environment?: "prod" | "test";
     /**
      * URL builder function for API calls. Can be used to modify which API
      * server should be called.
@@ -71,9 +84,10 @@ export interface ApiClientOptions {
      * @param root The URL that was passed in `apiRoot`, or its default value
      * @param token The bot's token that was passed when creating the bot
      * @param method The API method to be called, e.g. `getMe`
+     * @param env The value that was passed in `environment`, or its default value
      * @returns The URL that will be fetched during the API call
      */
-    buildUrl?: (root: string, token: string, method: string) => string | URL;
+    buildUrl?: (root: string, token: string, method: string, env: "prod" | "test") => string | URL;
     /**
      * Maximum number of seconds that a request to the Bot API server may take.
      * If a request has not completed before this time has elapsed, grammY

package/out/core/client.js

@@ -11,7 +11,7 @@ function concatTransformer(prev, trans) {
 }
 class ApiClient {
     constructor(token, options = {}, webhookReplyEnvelope = {}) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f;
         this.token = token;
         this.webhookReplyEnvelope = webhookReplyEnvelope;
         this.hasUsedWebhookReply = false;
@@ -39,7 +39,7 @@ class ApiClient {
             const timeout = createTimeout(controller, opts.timeoutSeconds, method);
             const streamErr = createStreamError(controller);
             // Build request URL and config
-            const url = opts.buildUrl(opts.apiRoot, this.token, method);
+            const url = opts.buildUrl(opts.apiRoot, this.token, method, opts.environment);
             const config = formDataRequired
                 ? (0, payload_js_1.createFormDataPayload)(payload, (err) => streamErr.catch(err))
                 : (0, payload_js_1.createJsonPayload)(payload);
@@ -60,16 +60,18 @@ class ApiClient {
             }
         };
         const apiRoot = (_a = options.apiRoot) !== null && _a !== void 0 ? _a : "https://api.telegram.org";
+        const environment = (_b = options.environment) !== null && _b !== void 0 ? _b : "prod";
         this.options = {
             apiRoot,
-            buildUrl: (_b = options.buildUrl) !== null && _b !== void 0 ? _b : ((root, token, method) => `${root}/bot${token}/${method}`),
-            timeoutSeconds: (_c = options.timeoutSeconds) !== null && _c !== void 0 ? _c : 500,
+            environment,
+            buildUrl: (_c = options.buildUrl) !== null && _c !== void 0 ? _c : defaultBuildUrl,
+            timeoutSeconds: (_d = options.timeoutSeconds) !== null && _d !== void 0 ? _d : 500,
             baseFetchConfig: {
                 ...(0, platform_node_js_1.baseFetchConfig)(apiRoot),
                 ...options.baseFetchConfig,
             },
-            canUseWebhookReply: (_d = options.canUseWebhookReply) !== null && _d !== void 0 ? _d : (() => false),
-            sensitiveLogs: (_e = options.sensitiveLogs) !== null && _e !== void 0 ? _e : false,
+            canUseWebhookReply: (_e = options.canUseWebhookReply) !== null && _e !== void 0 ? _e : (() => false),
+            sensitiveLogs: (_f = options.sensitiveLogs) !== null && _f !== void 0 ? _f : false,
         };
         if (this.options.apiRoot.endsWith("/")) {
             throw new Error(`Remove the trailing '/' from the 'apiRoot' option (use '${this.options.apiRoot.substring(0, this.options.apiRoot.length - 1)}' instead of '${this.options.apiRoot}')`);
@@ -124,6 +126,10 @@ 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}`;
+};
 const proxyMethods = {
     set() {
         return false;

package/out/platform.node.d.ts

@@ -4,8 +4,7 @@
 import { Agent as HttpAgent } from "http";
 import { Agent as HttpsAgent } from "https";
 import { Readable } from "stream";
-import { debug as d } from "debug";
-export { d as debug };
+export { debug } from "debug";
 export declare const itrToStream: (itr: AsyncIterable<Uint8Array>) => Readable;
 export declare function baseFetchConfig(apiRoot: string): {
     compress: boolean;

package/out/platform.node.js

@@ -6,7 +6,7 @@ const http_1 = require("http");
 const https_1 = require("https");
 const stream_1 = require("stream");
 // === Export debug
-const debug_1 = require("debug");
+var debug_1 = require("debug");
 Object.defineProperty(exports, "debug", { enumerable: true, get: function () { return debug_1.debug; } });
 // === Export system-specific operations
 // Turn an AsyncIterable<Uint8Array> into a stream

package/out/web.mjs

@@ -1919,7 +1919,7 @@ class ApiClient {
             const controller = createAbortControllerFromSignal(signal);
             const timeout = createTimeout(controller, opts.timeoutSeconds, method);
             const streamErr = createStreamError(controller);
-            const url = opts.buildUrl(opts.apiRoot, this.token, method);
+            const url = opts.buildUrl(opts.apiRoot, this.token, method, opts.environment);
             const config = formDataRequired ? createFormDataPayload(payload, (err)=>streamErr.catch(err)) : createJsonPayload(payload);
             const sig = controller.signal;
             const options = {
@@ -1941,9 +1941,11 @@ class ApiClient {
             }
         };
         const apiRoot = options.apiRoot ?? "https://api.telegram.org";
+        const environment = options.environment ?? "prod";
         this.options = {
             apiRoot,
-            buildUrl: options.buildUrl ?? ((root, token, method)=>`${root}/bot${token}/${method}`),
+            environment,
+            buildUrl: options.buildUrl ?? defaultBuildUrl,
             timeoutSeconds: options.timeoutSeconds ?? 500,
             baseFetchConfig: {
                 ...baseFetchConfig(apiRoot),
@@ -1988,6 +1990,10 @@ function createRawApi(token, options, webhookReplyEnvelope) {
     };
     return api;
 }
+const defaultBuildUrl = (root, token, method, env)=>{
+    const prefix = env === "test" ? "test/" : "";
+    return `${root}/bot${token}/${prefix}${method}`;
+};
 const proxyMethods = {
     set () {
         return false;
@@ -4151,99 +4157,6 @@ const unauthorized = ()=>new Response('"unauthorized"', {
         status: 401,
         statusText: WRONG_TOKEN_ERROR
     });
-const express = (req, res)=>({
-        update: Promise.resolve(req.body),
-        header: req.header(SECRET_HEADER),
-        end: ()=>res.end(),
-        respond: (json)=>{
-            res.set("Content-Type", "application/json");
-            res.send(json);
-        },
-        unauthorized: ()=>{
-            res.status(401).send(WRONG_TOKEN_ERROR);
-        }
-    });
-const koa = (ctx)=>({
-        update: Promise.resolve(ctx.request.body),
-        header: ctx.get(SECRET_HEADER),
-        end: ()=>{
-            ctx.body = "";
-        },
-        respond: (json)=>{
-            ctx.set("Content-Type", "application/json");
-            ctx.response.body = json;
-        },
-        unauthorized: ()=>{
-            ctx.status = 401;
-        }
-    });
-const fastify = (req, reply)=>({
-        update: Promise.resolve(req.body),
-        header: req.headers[SECRET_HEADER_LOWERCASE],
-        end: ()=>reply.status(200).send(),
-        respond: (json)=>reply.send(json),
-        unauthorized: ()=>reply.code(401).send(WRONG_TOKEN_ERROR)
-    });
-const serveHttp = (requestEvent)=>({
-        update: requestEvent.request.json(),
-        header: requestEvent.request.headers.get(SECRET_HEADER) || undefined,
-        end: ()=>requestEvent.respondWith(ok()),
-        respond: (json)=>requestEvent.respondWith(okJson(json)),
-        unauthorized: ()=>requestEvent.respondWith(unauthorized())
-    });
-const stdHttp = (req)=>{
-    let resolveResponse;
-    return {
-        update: req.json(),
-        header: req.headers.get(SECRET_HEADER) || undefined,
-        end: ()=>{
-            if (resolveResponse) resolveResponse(ok());
-        },
-        respond: (json)=>{
-            if (resolveResponse) resolveResponse(okJson(json));
-        },
-        unauthorized: ()=>{
-            if (resolveResponse) resolveResponse(unauthorized());
-        },
-        handlerReturn: new Promise((resolve)=>{
-            resolveResponse = resolve;
-        })
-    };
-};
-const oak = (ctx)=>({
-        update: ctx.request.body({
-            type: "json"
-        }).value,
-        header: ctx.request.headers.get(SECRET_HEADER) || undefined,
-        end: ()=>{
-            ctx.response.status = 200;
-        },
-        respond: (json)=>{
-            ctx.response.type = "json";
-            ctx.response.body = json;
-        },
-        unauthorized: ()=>{
-            ctx.response.status = 401;
-        }
-    });
-const http = (req, res)=>{
-    const secretHeaderFromRequest = req.headers[SECRET_HEADER_LOWERCASE];
-    return {
-        update: new Promise((resolve, reject)=>{
-            const chunks = [];
-            req.on("data", (chunk)=>chunks.push(chunk)).once("end", ()=>{
-                const raw = Buffer.concat(chunks).toString("utf-8");
-                resolve(JSON.parse(raw));
-            }).once("error", reject);
-        }),
-        header: Array.isArray(secretHeaderFromRequest) ? secretHeaderFromRequest[0] : secretHeaderFromRequest,
-        end: ()=>res.end(),
-        respond: (json)=>res.writeHead(200, {
-                "Content-Type": "application/json"
-            }).end(json),
-        unauthorized: ()=>res.writeHead(401).end(WRONG_TOKEN_ERROR)
-    };
-};
 const awsLambda = (event, _context, callback)=>({
         update: JSON.parse(event.body),
         header: event.headers[SECRET_HEADER],
@@ -4299,32 +4212,6 @@ const azure = (context, req)=>({
             context.res.send(401, WRONG_TOKEN_ERROR);
         }
     });
-const nextJs = (req, res)=>({
-        update: Promise.resolve(req.body),
-        header: req.headers[SECRET_HEADER_LOWERCASE],
-        end: ()=>res.end(),
-        respond: (json)=>res.status(200).json(json),
-        unauthorized: ()=>res.status(401).send(WRONG_TOKEN_ERROR)
-    });
-const sveltekit = ({ request })=>{
-    let resolveResponse;
-    return {
-        update: Promise.resolve(request.json()),
-        header: request.headers.get(SECRET_HEADER) || undefined,
-        end: ()=>{
-            if (resolveResponse) resolveResponse(ok());
-        },
-        respond: (json)=>{
-            if (resolveResponse) resolveResponse(okJson(json));
-        },
-        unauthorized: ()=>{
-            if (resolveResponse) resolveResponse(unauthorized());
-        },
-        handlerReturn: new Promise((resolve)=>{
-            resolveResponse = resolve;
-        })
-    };
-};
 const cloudflare = (event)=>{
     let resolveResponse;
     event.respondWith(new Promise((resolve)=>{
@@ -4363,6 +4250,25 @@ const cloudflareModule = (request)=>{
         })
     };
 };
+const express = (req, res)=>({
+        update: Promise.resolve(req.body),
+        header: req.header(SECRET_HEADER),
+        end: ()=>res.end(),
+        respond: (json)=>{
+            res.set("Content-Type", "application/json");
+            res.send(json);
+        },
+        unauthorized: ()=>{
+            res.status(401).send(WRONG_TOKEN_ERROR);
+        }
+    });
+const fastify = (req, reply)=>({
+        update: Promise.resolve(req.body),
+        header: req.headers[SECRET_HEADER_LOWERCASE],
+        end: ()=>reply.status(200).send(),
+        respond: (json)=>reply.send(json),
+        unauthorized: ()=>reply.code(401).send(WRONG_TOKEN_ERROR)
+    });
 const hono = (ctx)=>{
     let resolveResponse;
     return {
@@ -4385,6 +4291,113 @@ const hono = (ctx)=>{
         })
     };
 };
+const http = (req, res)=>{
+    const secretHeaderFromRequest = req.headers[SECRET_HEADER_LOWERCASE];
+    return {
+        update: new Promise((resolve, reject)=>{
+            const chunks = [];
+            req.on("data", (chunk)=>chunks.push(chunk)).once("end", ()=>{
+                const raw = Buffer.concat(chunks).toString("utf-8");
+                resolve(JSON.parse(raw));
+            }).once("error", reject);
+        }),
+        header: Array.isArray(secretHeaderFromRequest) ? secretHeaderFromRequest[0] : secretHeaderFromRequest,
+        end: ()=>res.end(),
+        respond: (json)=>res.writeHead(200, {
+                "Content-Type": "application/json"
+            }).end(json),
+        unauthorized: ()=>res.writeHead(401).end(WRONG_TOKEN_ERROR)
+    };
+};
+const koa = (ctx)=>({
+        update: Promise.resolve(ctx.request.body),
+        header: ctx.get(SECRET_HEADER),
+        end: ()=>{
+            ctx.body = "";
+        },
+        respond: (json)=>{
+            ctx.set("Content-Type", "application/json");
+            ctx.response.body = json;
+        },
+        unauthorized: ()=>{
+            ctx.status = 401;
+        }
+    });
+const nextJs = (req, res)=>({
+        update: Promise.resolve(req.body),
+        header: req.headers[SECRET_HEADER_LOWERCASE],
+        end: ()=>res.end(),
+        respond: (json)=>res.status(200).json(json),
+        unauthorized: ()=>res.status(401).send(WRONG_TOKEN_ERROR)
+    });
+const nhttp = (rev)=>({
+        update: rev.body,
+        header: rev.headers.get(SECRET_HEADER) || undefined,
+        end: ()=>rev.response.sendStatus(200),
+        respond: (json)=>rev.response.status(200).send(json),
+        unauthorized: ()=>rev.response.status(401).send(WRONG_TOKEN_ERROR)
+    });
+const oak = (ctx)=>({
+        update: ctx.request.body({
+            type: "json"
+        }).value,
+        header: ctx.request.headers.get(SECRET_HEADER) || undefined,
+        end: ()=>{
+            ctx.response.status = 200;
+        },
+        respond: (json)=>{
+            ctx.response.type = "json";
+            ctx.response.body = json;
+        },
+        unauthorized: ()=>{
+            ctx.response.status = 401;
+        }
+    });
+const serveHttp = (requestEvent)=>({
+        update: requestEvent.request.json(),
+        header: requestEvent.request.headers.get(SECRET_HEADER) || undefined,
+        end: ()=>requestEvent.respondWith(ok()),
+        respond: (json)=>requestEvent.respondWith(okJson(json)),
+        unauthorized: ()=>requestEvent.respondWith(unauthorized())
+    });
+const stdHttp = (req)=>{
+    let resolveResponse;
+    return {
+        update: req.json(),
+        header: req.headers.get(SECRET_HEADER) || undefined,
+        end: ()=>{
+            if (resolveResponse) resolveResponse(ok());
+        },
+        respond: (json)=>{
+            if (resolveResponse) resolveResponse(okJson(json));
+        },
+        unauthorized: ()=>{
+            if (resolveResponse) resolveResponse(unauthorized());
+        },
+        handlerReturn: new Promise((resolve)=>{
+            resolveResponse = resolve;
+        })
+    };
+};
+const sveltekit = ({ request })=>{
+    let resolveResponse;
+    return {
+        update: Promise.resolve(request.json()),
+        header: request.headers.get(SECRET_HEADER) || undefined,
+        end: ()=>{
+            if (resolveResponse) resolveResponse(ok());
+        },
+        respond: (json)=>{
+            if (resolveResponse) resolveResponse(okJson(json));
+        },
+        unauthorized: ()=>{
+            if (resolveResponse) resolveResponse(unauthorized());
+        },
+        handlerReturn: new Promise((resolve)=>{
+            resolveResponse = resolve;
+        })
+    };
+};
 const worktop = (req, res)=>({
         update: Promise.resolve(req.body.json()),
         header: req.headers.get(SECRET_HEADER),
@@ -4393,22 +4406,23 @@ const worktop = (req, res)=>({
         unauthorized: ()=>res.send(401, WRONG_TOKEN_ERROR)
     });
 const adapters = {
-    express,
-    koa,
-    fastify,
-    serveHttp,
-    "std/http": stdHttp,
-    oak,
-    http,
-    https: http,
     "aws-lambda": awsLambda,
     "aws-lambda-async": awsLambdaAsync,
     azure,
-    "next-js": nextJs,
-    sveltekit,
     cloudflare,
     "cloudflare-mod": cloudflareModule,
+    express,
+    fastify,
     hono,
+    http,
+    https: http,
+    koa,
+    "next-js": nextJs,
+    nhttp,
+    oak,
+    serveHttp,
+    "std/http": stdHttp,
+    sveltekit,
     worktop
 };
 const debugErr1 = browser$1("grammy:error");

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "grammy",
     "description": "The Telegram Bot Framework.",
-    "version": "1.19.1",
+    "version": "1.19.3",
     "author": "KnorpelSenf",
     "license": "MIT",
     "engines": {