gramio 0.4.12 → 0.4.13

package/dist/index.cjs

@@ -7,7 +7,7 @@ var contexts = require('@gramio/contexts');
 var files = require('@gramio/files');
 var format = require('@gramio/format');
 var debug = require('debug');
-var utils = require('./utils-CYIya32k.cjs');
+var utils = require('./utils-C46rnh-r.cjs');
 var middlewareIo = require('middleware-io');
 var keyboards = require('@gramio/keyboards');
 
@@ -102,6 +102,8 @@ class Plugin {
     onResponses: [],
     /** Store plugin onResponseErrors hooks */
     onResponseErrors: [],
+    /** Store plugin onApiCalls hooks */
+    onApiCalls: [],
     /**
      * Store plugin groups
      *
@@ -185,6 +187,13 @@ class Plugin {
       this._.onResponseErrors.push([methodsOrHandler, void 0]);
     return this;
   }
+  onApiCall(methodsOrHandler, handler) {
+    if ((typeof methodsOrHandler === "string" || Array.isArray(methodsOrHandler)) && handler)
+      this._.onApiCalls.push([handler, methodsOrHandler]);
+    else if (typeof methodsOrHandler === "function")
+      this._.onApiCalls.push([methodsOrHandler, void 0]);
+    return this;
+  }
   /**
    * This hook called when the bot is `started`.
    *
@@ -427,9 +436,6 @@ class Bot {
   /** @deprecated use `~.derives` instead @internal. Remap generic */
   __Derives;
   "~" = this._;
-  filters = {
-    context: (name) => (context) => context.is(name)
-  };
   /** Options provided to instance */
   options;
   /** Bot data (filled in when calling bot.init/bot.start) */
@@ -451,7 +457,13 @@ class Bot {
     get: (_target, method) => (
       // @ts-expect-error
       // biome-ignore lint/suspicious/noAssignInExpressions: <explanation>
-      _target[method] ??= (args) => this._callApi(method, args)
+      _target[method] ??= (args) => {
+        const callSite = new Error();
+        if (Error.captureStackTrace) {
+          Error.captureStackTrace(callSite, _target[method]);
+        }
+        return this._callApi(method, args, callSite);
+      }
     )
   });
   lazyloadPlugins = [];
@@ -477,7 +489,8 @@ class Bot {
     onResponseError: [],
     onError: [],
     onStart: [],
-    onStop: []
+    onStop: [],
+    onApiCall: []
   };
   constructor(tokenOrOptions, optionsRaw) {
     const token = typeof tokenOrOptions === "string" ? tokenOrOptions : tokenOrOptions?.token;
@@ -500,7 +513,10 @@ class Bot {
         new Plugin("@gramio/format").preRequest((context) => {
           if (!context.params) return context;
           const formattable = format.FormattableMap[context.method];
-          if (formattable) context.params = formattable(context.params);
+          if (formattable)
+            context.params = formattable(
+              context.params
+            );
           return context;
         })
       );
@@ -517,63 +533,66 @@ class Bot {
       await hook(...context);
     }
   }
-  async _callApi(method, params = {}) {
-    const debug$api$method = debug(`gramio:api:${method}`);
-    let url = `${this.options.api.baseURL}${this.options.token}/${this.options.api.useTest ? "test/" : ""}${method}`;
-    const reqOptions = {
-      method: "POST",
-      ...this.options.api.fetchOptions,
-      // @ts-ignore types node/bun and global missmatch
-      headers: new Headers(this.options.api.fetchOptions?.headers)
-    };
-    const context = await this.runHooks(
-      "preRequest",
-      // TODO: fix type error
-      // @ts-expect-error
-      {
+  async _callApi(method, params = {}, callSite) {
+    const executeCall = async () => {
+      const debug$api$method = debug(`gramio:api:${method}`);
+      let url = `${this.options.api.baseURL}${this.options.token}/${this.options.api.useTest ? "test/" : ""}${method}`;
+      const reqOptions = {
+        method: "POST",
+        ...this.options.api.fetchOptions,
+        headers: new Headers(this.options.api.fetchOptions?.headers)
+      };
+      const context = await this.runHooks("preRequest", {
         method,
         params
-      }
-    );
-    params = context.params;
-    if (params && files.isMediaUpload(method, params)) {
-      if (utils.IS_BUN) {
-        const formData = await files.convertJsonToFormData(method, params);
-        reqOptions.body = formData;
+      });
+      params = context.params;
+      if (params && files.isMediaUpload(method, params)) {
+        if (utils.IS_BUN) {
+          const formData = await files.convertJsonToFormData(method, params);
+          reqOptions.body = formData;
+        } else {
+          const [formData, paramsWithoutFiles] = await files.extractFilesToFormData(
+            method,
+            params
+          );
+          reqOptions.body = formData;
+          const simplifiedParams = utils.simplifyObject(paramsWithoutFiles);
+          url += `?${new URLSearchParams(simplifiedParams).toString()}`;
+        }
       } else {
-        const [formData, paramsWithoutFiles] = await files.extractFilesToFormData(
-          method,
-          params
-        );
-        reqOptions.body = formData;
-        const simplifiedParams = utils.simplifyObject(paramsWithoutFiles);
-        url += `?${new URLSearchParams(simplifiedParams).toString()}`;
+        reqOptions.headers.set("Content-Type", "application/json");
+        reqOptions.body = JSON.stringify(params);
       }
-    } else {
-      reqOptions.headers.set("Content-Type", "application/json");
-      reqOptions.body = JSON.stringify(params);
-    }
-    debug$api$method("options: %j", reqOptions);
-    const response = await fetch(url, reqOptions);
-    const data = await response.json();
-    debug$api$method("response: %j", data);
-    if (!data.ok) {
-      const err = new utils.TelegramError(data, method, params);
-      this.runImmutableHooks("onResponseError", err, this.api);
-      if (!params?.suppress) throw err;
-      return err;
-    }
-    this.runImmutableHooks(
-      "onResponse",
-      // TODO: fix type error
-      // @ts-expect-error
-      {
-        method,
-        params,
-        response: data.result
+      debug$api$method("options: %j", reqOptions);
+      const response = await fetch(url, reqOptions);
+      const data = await response.json();
+      debug$api$method("response: %j", data);
+      if (!data.ok) {
+        const err = new utils.TelegramError(data, method, params, callSite);
+        this.runImmutableHooks("onResponseError", err, this.api);
+        if (!params?.suppress) throw err;
+        return err;
       }
-    );
-    return data.result;
+      this.runImmutableHooks(
+        "onResponse",
+        // TODO: fix type error
+        // @ts-expect-error
+        {
+          method,
+          params,
+          response: data.result
+        }
+      );
+      return data.result;
+    };
+    if (!this.hooks.onApiCall.length) return executeCall();
+    let fn = executeCall;
+    for (const hook of [...this.hooks.onApiCall].reverse()) {
+      const prev = fn;
+      fn = () => hook({ method, params }, prev);
+    }
+    return fn();
   }
   async downloadFile(attachment, path) {
     function getFileId(attachment2) {
@@ -761,6 +780,19 @@ class Bot {
     } else this.hooks.onResponseError.push(methodsOrHandler);
     return this;
   }
+  onApiCall(methodsOrHandler, handler) {
+    if (typeof methodsOrHandler === "string" || Array.isArray(methodsOrHandler)) {
+      if (!handler) throw new Error("TODO:");
+      const methods = typeof methodsOrHandler === "string" ? [methodsOrHandler] : methodsOrHandler;
+      this.hooks.onApiCall.push(async (context, next) => {
+        if (methods.includes(context.method)) return handler(context, next);
+        return next();
+      });
+    } else {
+      this.hooks.onApiCall.push(methodsOrHandler);
+    }
+    return this;
+  }
   // onExperimental(
   // 	// filter: Filters,
   // 	filter: (
@@ -843,6 +875,11 @@ class Bot {
       if (!updateName) this.onResponseError(onResponseError);
       else this.onResponseError(updateName, onResponseError);
     }
+    for (const value of plugin._.onApiCalls) {
+      const [onApiCall, methods] = value;
+      if (!methods) this.onApiCall(onApiCall);
+      else this.onApiCall(methods, onApiCall);
+    }
     for (const handler of plugin._.groups) {
       this.group(handler);
     }

package/dist/index.d.cts

@@ -23,7 +23,7 @@ declare class TelegramError<T extends keyof APIMethods> extends Error {
     /** Describes why a request was unsuccessful. */
     payload?: TelegramResponseParameters;
     /** Construct new TelegramError */
-    constructor(error: TelegramAPIResponseError, method: T, params: MaybeSuppressedParams<T>);
+    constructor(error: TelegramAPIResponseError, method: T, params: MaybeSuppressedParams<T>, callSite?: Error);
 }
 
 type MaybeArray<T> = T | T[] | ReadonlyArray<T>;
@@ -116,6 +116,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
         onResponses: [Hooks.OnResponse<any>, MaybeArray<keyof APIMethods> | undefined][];
         /** Store plugin onResponseErrors hooks */
         onResponseErrors: [Hooks.OnResponseError<any>, MaybeArray<keyof APIMethods> | undefined][];
+        /** Store plugin onApiCalls hooks */
+        onApiCalls: [Hooks.OnApiCall<any>, MaybeArray<keyof APIMethods> | undefined][];
         /**
          * Store plugin groups
          *
@@ -152,6 +154,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
         onResponses: [Hooks.OnResponse<any>, MaybeArray<keyof APIMethods> | undefined][];
         /** Store plugin onResponseErrors hooks */
         onResponseErrors: [Hooks.OnResponseError<any>, MaybeArray<keyof APIMethods> | undefined][];
+        /** Store plugin onApiCalls hooks */
+        onApiCalls: [Hooks.OnApiCall<any>, MaybeArray<keyof APIMethods> | undefined][];
         /**
          * Store plugin groups
          *
@@ -256,6 +260,21 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
      * */
     onResponseError<Methods extends keyof APIMethods, Handler extends Hooks.OnResponseError<Methods>>(methods: MaybeArray<Methods>, handler: Handler): this;
     onResponseError(handler: Hooks.OnResponseError): this;
+    /**
+     * This hook wraps the entire API call, enabling tracing/instrumentation.
+     *
+     * @example
+     * ```typescript
+     * const plugin = new Plugin("example").onApiCall(async (context, next) => {
+     *     console.log(`Calling ${context.method}`);
+     *     const result = await next();
+     *     console.log(`${context.method} completed`);
+     *     return result;
+     * });
+     * ```
+     *  */
+    onApiCall<Methods extends keyof APIMethods, Handler extends Hooks.OnApiCall<Methods>>(methods: MaybeArray<Methods>, handler: Handler): this;
+    onApiCall(handler: Hooks.OnApiCall): this;
     /**
      * This hook called when the bot is `started`.
      *
@@ -539,6 +558,27 @@ declare namespace Hooks {
      * [Documentation](https://gramio.dev/hooks/on-response.html)
      *  */
     type OnResponse<Methods extends keyof APIMethods = keyof APIMethods> = (context: AnyTelegramMethodWithReturn<Methods>) => unknown;
+    /** Argument type for {@link OnApiCall} */
+    type OnApiCallContext<Methods extends keyof APIMethods> = AnyTelegramMethod<Methods>;
+    /**
+     * Type for `onApiCall` hook (wrap-style)
+     *
+     * This hook wraps the entire API call execution, enabling span creation
+     * around API calls for tracing/instrumentation.
+     *
+     * @example
+     * ```typescript
+     * import { Bot } from "gramio";
+     *
+     * const bot = new Bot(process.env.TOKEN!).onApiCall(async (context, next) => {
+     *     console.log(`Calling ${context.method}`);
+     *     const result = await next();
+     *     console.log(`${context.method} completed`);
+     *     return result;
+     * });
+     * ```
+     *  */
+    type OnApiCall<Methods extends keyof APIMethods = keyof APIMethods> = (context: OnApiCallContext<Methods>, next: () => Promise<unknown>) => Promise<unknown>;
     /** Store hooks */
     interface Store<T extends ErrorDefinitions> {
         preRequest: PreRequest[];
@@ -547,6 +587,7 @@ declare namespace Hooks {
         onError: OnError<T>[];
         onStart: OnStart[];
         onStop: OnStop[];
+        onApiCall: OnApiCall[];
     }
 }
 /** Error map should be map of string: error */
@@ -634,7 +675,6 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
         /** @deprecated @internal. Remap generic */
         derives: Derives;
     };
-    private filters;
     /** Options provided to instance */
     readonly options: BotOptions;
     /** Bot data (filled in when calling bot.init/bot.start) */
@@ -843,6 +883,23 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
      * */
     onResponseError<Methods extends keyof APIMethods, Handler extends Hooks.OnResponseError<Methods>>(methods: MaybeArray<Methods>, handler: Handler): this;
     onResponseError(handler: Hooks.OnResponseError): this;
+    /**
+     * This hook wraps the entire API call, enabling tracing/instrumentation.
+     *
+     * @example
+     * ```typescript
+     * import { Bot } from "gramio";
+     *
+     * const bot = new Bot(process.env.TOKEN!).onApiCall(async (context, next) => {
+     *     console.log(`Calling ${context.method}`);
+     *     const result = await next();
+     *     console.log(`${context.method} completed`);
+     *     return result;
+     * });
+     * ```
+     *  */
+    onApiCall<Methods extends keyof APIMethods, Handler extends Hooks.OnApiCall<Methods>>(methods: MaybeArray<Methods>, handler: Handler): this;
+    onApiCall(handler: Hooks.OnApiCall): this;
     /** Register handler to one or many Updates */
     on<T extends UpdateName>(updateName: MaybeArray<T>, handler: Handler<ContextType<typeof this, T>>): this;
     /** Register handler to any Updates */

package/dist/index.d.ts

@@ -23,7 +23,7 @@ declare class TelegramError<T extends keyof APIMethods> extends Error {
     /** Describes why a request was unsuccessful. */
     payload?: TelegramResponseParameters;
     /** Construct new TelegramError */
-    constructor(error: TelegramAPIResponseError, method: T, params: MaybeSuppressedParams<T>);
+    constructor(error: TelegramAPIResponseError, method: T, params: MaybeSuppressedParams<T>, callSite?: Error);
 }
 
 type MaybeArray<T> = T | T[] | ReadonlyArray<T>;
@@ -116,6 +116,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
         onResponses: [Hooks.OnResponse<any>, MaybeArray<keyof APIMethods> | undefined][];
         /** Store plugin onResponseErrors hooks */
         onResponseErrors: [Hooks.OnResponseError<any>, MaybeArray<keyof APIMethods> | undefined][];
+        /** Store plugin onApiCalls hooks */
+        onApiCalls: [Hooks.OnApiCall<any>, MaybeArray<keyof APIMethods> | undefined][];
         /**
          * Store plugin groups
          *
@@ -152,6 +154,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
         onResponses: [Hooks.OnResponse<any>, MaybeArray<keyof APIMethods> | undefined][];
         /** Store plugin onResponseErrors hooks */
         onResponseErrors: [Hooks.OnResponseError<any>, MaybeArray<keyof APIMethods> | undefined][];
+        /** Store plugin onApiCalls hooks */
+        onApiCalls: [Hooks.OnApiCall<any>, MaybeArray<keyof APIMethods> | undefined][];
         /**
          * Store plugin groups
          *
@@ -256,6 +260,21 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
      * */
     onResponseError<Methods extends keyof APIMethods, Handler extends Hooks.OnResponseError<Methods>>(methods: MaybeArray<Methods>, handler: Handler): this;
     onResponseError(handler: Hooks.OnResponseError): this;
+    /**
+     * This hook wraps the entire API call, enabling tracing/instrumentation.
+     *
+     * @example
+     * ```typescript
+     * const plugin = new Plugin("example").onApiCall(async (context, next) => {
+     *     console.log(`Calling ${context.method}`);
+     *     const result = await next();
+     *     console.log(`${context.method} completed`);
+     *     return result;
+     * });
+     * ```
+     *  */
+    onApiCall<Methods extends keyof APIMethods, Handler extends Hooks.OnApiCall<Methods>>(methods: MaybeArray<Methods>, handler: Handler): this;
+    onApiCall(handler: Hooks.OnApiCall): this;
     /**
      * This hook called when the bot is `started`.
      *
@@ -539,6 +558,27 @@ declare namespace Hooks {
      * [Documentation](https://gramio.dev/hooks/on-response.html)
      *  */
     type OnResponse<Methods extends keyof APIMethods = keyof APIMethods> = (context: AnyTelegramMethodWithReturn<Methods>) => unknown;
+    /** Argument type for {@link OnApiCall} */
+    type OnApiCallContext<Methods extends keyof APIMethods> = AnyTelegramMethod<Methods>;
+    /**
+     * Type for `onApiCall` hook (wrap-style)
+     *
+     * This hook wraps the entire API call execution, enabling span creation
+     * around API calls for tracing/instrumentation.
+     *
+     * @example
+     * ```typescript
+     * import { Bot } from "gramio";
+     *
+     * const bot = new Bot(process.env.TOKEN!).onApiCall(async (context, next) => {
+     *     console.log(`Calling ${context.method}`);
+     *     const result = await next();
+     *     console.log(`${context.method} completed`);
+     *     return result;
+     * });
+     * ```
+     *  */
+    type OnApiCall<Methods extends keyof APIMethods = keyof APIMethods> = (context: OnApiCallContext<Methods>, next: () => Promise<unknown>) => Promise<unknown>;
     /** Store hooks */
     interface Store<T extends ErrorDefinitions> {
         preRequest: PreRequest[];
@@ -547,6 +587,7 @@ declare namespace Hooks {
         onError: OnError<T>[];
         onStart: OnStart[];
         onStop: OnStop[];
+        onApiCall: OnApiCall[];
     }
 }
 /** Error map should be map of string: error */
@@ -634,7 +675,6 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
         /** @deprecated @internal. Remap generic */
         derives: Derives;
     };
-    private filters;
     /** Options provided to instance */
     readonly options: BotOptions;
     /** Bot data (filled in when calling bot.init/bot.start) */
@@ -843,6 +883,23 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
      * */
     onResponseError<Methods extends keyof APIMethods, Handler extends Hooks.OnResponseError<Methods>>(methods: MaybeArray<Methods>, handler: Handler): this;
     onResponseError(handler: Hooks.OnResponseError): this;
+    /**
+     * This hook wraps the entire API call, enabling tracing/instrumentation.
+     *
+     * @example
+     * ```typescript
+     * import { Bot } from "gramio";
+     *
+     * const bot = new Bot(process.env.TOKEN!).onApiCall(async (context, next) => {
+     *     console.log(`Calling ${context.method}`);
+     *     const result = await next();
+     *     console.log(`${context.method} completed`);
+     *     return result;
+     * });
+     * ```
+     *  */
+    onApiCall<Methods extends keyof APIMethods, Handler extends Hooks.OnApiCall<Methods>>(methods: MaybeArray<Methods>, handler: Handler): this;
+    onApiCall(handler: Hooks.OnApiCall): this;
     /** Register handler to one or many Updates */
     on<T extends UpdateName>(updateName: MaybeArray<T>, handler: Handler<ContextType<typeof this, T>>): this;
     /** Register handler to any Updates */

package/dist/index.js

@@ -9,7 +9,7 @@ export * from '@gramio/files';
 import { FormattableMap } from '@gramio/format';
 export * from '@gramio/format';
 import debug from 'debug';
-import { E as ErrorKind, s as sleep, w as withRetries, T as TelegramError, d as debug$updates, I as IS_BUN, a as simplifyObject, t as timeoutWebhook } from './utils-CJfJNxc_.js';
+import { E as ErrorKind, s as sleep, w as withRetries, T as TelegramError, d as debug$updates, I as IS_BUN, a as simplifyObject, t as timeoutWebhook } from './utils-En0iVLWH.js';
 import { Composer as Composer$1, noopNext } from 'middleware-io';
 export * from '@gramio/keyboards';
 
@@ -104,6 +104,8 @@ class Plugin {
     onResponses: [],
     /** Store plugin onResponseErrors hooks */
     onResponseErrors: [],
+    /** Store plugin onApiCalls hooks */
+    onApiCalls: [],
     /**
      * Store plugin groups
      *
@@ -187,6 +189,13 @@ class Plugin {
       this._.onResponseErrors.push([methodsOrHandler, void 0]);
     return this;
   }
+  onApiCall(methodsOrHandler, handler) {
+    if ((typeof methodsOrHandler === "string" || Array.isArray(methodsOrHandler)) && handler)
+      this._.onApiCalls.push([handler, methodsOrHandler]);
+    else if (typeof methodsOrHandler === "function")
+      this._.onApiCalls.push([methodsOrHandler, void 0]);
+    return this;
+  }
   /**
    * This hook called when the bot is `started`.
    *
@@ -429,9 +438,6 @@ class Bot {
   /** @deprecated use `~.derives` instead @internal. Remap generic */
   __Derives;
   "~" = this._;
-  filters = {
-    context: (name) => (context) => context.is(name)
-  };
   /** Options provided to instance */
   options;
   /** Bot data (filled in when calling bot.init/bot.start) */
@@ -453,7 +459,13 @@ class Bot {
     get: (_target, method) => (
       // @ts-expect-error
       // biome-ignore lint/suspicious/noAssignInExpressions: <explanation>
-      _target[method] ??= (args) => this._callApi(method, args)
+      _target[method] ??= (args) => {
+        const callSite = new Error();
+        if (Error.captureStackTrace) {
+          Error.captureStackTrace(callSite, _target[method]);
+        }
+        return this._callApi(method, args, callSite);
+      }
     )
   });
   lazyloadPlugins = [];
@@ -479,7 +491,8 @@ class Bot {
     onResponseError: [],
     onError: [],
     onStart: [],
-    onStop: []
+    onStop: [],
+    onApiCall: []
   };
   constructor(tokenOrOptions, optionsRaw) {
     const token = typeof tokenOrOptions === "string" ? tokenOrOptions : tokenOrOptions?.token;
@@ -502,7 +515,10 @@ class Bot {
         new Plugin("@gramio/format").preRequest((context) => {
           if (!context.params) return context;
           const formattable = FormattableMap[context.method];
-          if (formattable) context.params = formattable(context.params);
+          if (formattable)
+            context.params = formattable(
+              context.params
+            );
           return context;
         })
       );
@@ -519,63 +535,66 @@ class Bot {
       await hook(...context);
     }
   }
-  async _callApi(method, params = {}) {
-    const debug$api$method = debug(`gramio:api:${method}`);
-    let url = `${this.options.api.baseURL}${this.options.token}/${this.options.api.useTest ? "test/" : ""}${method}`;
-    const reqOptions = {
-      method: "POST",
-      ...this.options.api.fetchOptions,
-      // @ts-ignore types node/bun and global missmatch
-      headers: new Headers(this.options.api.fetchOptions?.headers)
-    };
-    const context = await this.runHooks(
-      "preRequest",
-      // TODO: fix type error
-      // @ts-expect-error
-      {
+  async _callApi(method, params = {}, callSite) {
+    const executeCall = async () => {
+      const debug$api$method = debug(`gramio:api:${method}`);
+      let url = `${this.options.api.baseURL}${this.options.token}/${this.options.api.useTest ? "test/" : ""}${method}`;
+      const reqOptions = {
+        method: "POST",
+        ...this.options.api.fetchOptions,
+        headers: new Headers(this.options.api.fetchOptions?.headers)
+      };
+      const context = await this.runHooks("preRequest", {
         method,
         params
-      }
-    );
-    params = context.params;
-    if (params && isMediaUpload(method, params)) {
-      if (IS_BUN) {
-        const formData = await convertJsonToFormData(method, params);
-        reqOptions.body = formData;
+      });
+      params = context.params;
+      if (params && isMediaUpload(method, params)) {
+        if (IS_BUN) {
+          const formData = await convertJsonToFormData(method, params);
+          reqOptions.body = formData;
+        } else {
+          const [formData, paramsWithoutFiles] = await extractFilesToFormData(
+            method,
+            params
+          );
+          reqOptions.body = formData;
+          const simplifiedParams = simplifyObject(paramsWithoutFiles);
+          url += `?${new URLSearchParams(simplifiedParams).toString()}`;
+        }
       } else {
-        const [formData, paramsWithoutFiles] = await extractFilesToFormData(
-          method,
-          params
-        );
-        reqOptions.body = formData;
-        const simplifiedParams = simplifyObject(paramsWithoutFiles);
-        url += `?${new URLSearchParams(simplifiedParams).toString()}`;
+        reqOptions.headers.set("Content-Type", "application/json");
+        reqOptions.body = JSON.stringify(params);
       }
-    } else {
-      reqOptions.headers.set("Content-Type", "application/json");
-      reqOptions.body = JSON.stringify(params);
-    }
-    debug$api$method("options: %j", reqOptions);
-    const response = await fetch(url, reqOptions);
-    const data = await response.json();
-    debug$api$method("response: %j", data);
-    if (!data.ok) {
-      const err = new TelegramError(data, method, params);
-      this.runImmutableHooks("onResponseError", err, this.api);
-      if (!params?.suppress) throw err;
-      return err;
-    }
-    this.runImmutableHooks(
-      "onResponse",
-      // TODO: fix type error
-      // @ts-expect-error
-      {
-        method,
-        params,
-        response: data.result
+      debug$api$method("options: %j", reqOptions);
+      const response = await fetch(url, reqOptions);
+      const data = await response.json();
+      debug$api$method("response: %j", data);
+      if (!data.ok) {
+        const err = new TelegramError(data, method, params, callSite);
+        this.runImmutableHooks("onResponseError", err, this.api);
+        if (!params?.suppress) throw err;
+        return err;
       }
-    );
-    return data.result;
+      this.runImmutableHooks(
+        "onResponse",
+        // TODO: fix type error
+        // @ts-expect-error
+        {
+          method,
+          params,
+          response: data.result
+        }
+      );
+      return data.result;
+    };
+    if (!this.hooks.onApiCall.length) return executeCall();
+    let fn = executeCall;
+    for (const hook of [...this.hooks.onApiCall].reverse()) {
+      const prev = fn;
+      fn = () => hook({ method, params }, prev);
+    }
+    return fn();
   }
   async downloadFile(attachment, path) {
     function getFileId(attachment2) {
@@ -763,6 +782,19 @@ class Bot {
     } else this.hooks.onResponseError.push(methodsOrHandler);
     return this;
   }
+  onApiCall(methodsOrHandler, handler) {
+    if (typeof methodsOrHandler === "string" || Array.isArray(methodsOrHandler)) {
+      if (!handler) throw new Error("TODO:");
+      const methods = typeof methodsOrHandler === "string" ? [methodsOrHandler] : methodsOrHandler;
+      this.hooks.onApiCall.push(async (context, next) => {
+        if (methods.includes(context.method)) return handler(context, next);
+        return next();
+      });
+    } else {
+      this.hooks.onApiCall.push(methodsOrHandler);
+    }
+    return this;
+  }
   // onExperimental(
   // 	// filter: Filters,
   // 	filter: (
@@ -845,6 +877,11 @@ class Bot {
       if (!updateName) this.onResponseError(onResponseError);
       else this.onResponseError(updateName, onResponseError);
     }
+    for (const value of plugin._.onApiCalls) {
+      const [onApiCall, methods] = value;
+      if (!methods) this.onApiCall(onApiCall);
+      else this.onApiCall(methods, onApiCall);
+    }
     for (const handler of plugin._.groups) {
       this.group(handler);
     }

package/dist/{utils-CYIya32k.cjs → utils-C46rnh-r.cjs}

@@ -13,13 +13,19 @@ class TelegramError extends Error {
   /** Describes why a request was unsuccessful. */
   payload;
   /** Construct new TelegramError */
-  constructor(error, method, params) {
+  constructor(error, method, params, callSite) {
     super(error.description);
     this.name = method;
     this.method = method;
     this.params = params;
     this.code = error.error_code;
     if (error.parameters) this.payload = error.parameters;
+    if (callSite?.stack) {
+      const callSiteLines = callSite.stack.split("\n");
+      const relevantFrames = callSiteLines.slice(1);
+      this.stack = `${this.name}: ${this.message}
+${relevantFrames.join("\n")}`;
+    }
   }
 }
 TelegramError.constructor[ErrorKind] = "TELEGRAM";

package/dist/{utils-CJfJNxc_.js → utils-En0iVLWH.js}

@@ -11,13 +11,19 @@ class TelegramError extends Error {
   /** Describes why a request was unsuccessful. */
   payload;
   /** Construct new TelegramError */
-  constructor(error, method, params) {
+  constructor(error, method, params, callSite) {
     super(error.description);
     this.name = method;
     this.method = method;
     this.params = params;
     this.code = error.error_code;
     if (error.parameters) this.payload = error.parameters;
+    if (callSite?.stack) {
+      const callSiteLines = callSite.stack.split("\n");
+      const relevantFrames = callSiteLines.slice(1);
+      this.stack = `${this.name}: ${this.message}
+${relevantFrames.join("\n")}`;
+    }
   }
 }
 TelegramError.constructor[ErrorKind] = "TELEGRAM";

package/dist/utils.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var utils = require('./utils-CYIya32k.cjs');
+var utils = require('./utils-C46rnh-r.cjs');
 require('debug');
 
 

package/dist/utils.js

@@ -1,2 +1,2 @@
-export { w as withRetries } from './utils-CJfJNxc_.js';
+export { w as withRetries } from './utils-En0iVLWH.js';
 import 'debug';

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "gramio",
 	"type": "module",
-	"version": "0.4.12",
+	"version": "0.4.13",
 	"description": "Powerful, extensible and really type-safe Telegram Bot API framework",
 	"main": "dist/index.cjs",
 	"module": "dist/index.js",
@@ -56,10 +56,10 @@
 	"license": "MIT",
 	"devDependencies": {
 		"@biomejs/biome": "2.3.14",
-		"@types/bun": "^1.3.8",
+		"@types/bun": "^1.3.9",
 		"@types/debug": "^4.1.12",
 		"expect-type": "^1.3.0",
-		"pkgroll": "^2.23.0",
+		"pkgroll": "^2.24.0",
 		"typescript": "^5.9.3"
 	},
 	"dependencies": {
@@ -68,7 +68,7 @@
 		"@gramio/files": "^0.3.0",
 		"@gramio/format": "^0.3.4",
 		"@gramio/keyboards": "^1.3.0",
-		"@gramio/types": "^9.3.1",
+		"@gramio/types": "^9.4.0",
 		"debug": "^4.4.3",
 		"middleware-io": "^2.8.1"
 	},