grammy 1.19.2 → 1.19.3

package/README.md

@@ -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/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;

package/package.json

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