gramio 0.2.4 → 0.2.6

package/dist/index.cjs

@@ -8,31 +8,10 @@ var files = require('@gramio/files');
 var format = require('@gramio/format');
 var debug = require('debug');
 var inspectable = require('inspectable');
+var utils = require('./utils-BbVj3DtT.cjs');
 var middlewareIo = require('middleware-io');
 var keyboards = require('@gramio/keyboards');
 
-const ErrorKind = Symbol("ErrorKind");
-class TelegramError extends Error {
-  /** Name of the API Method */
-  method;
-  /** Params that were sent */
-  params;
-  /** See  {@link TelegramAPIResponseError.error_code}*/
-  code;
-  /** Describes why a request was unsuccessful. */
-  payload;
-  /** Construct new TelegramError */
-  constructor(error, method, params) {
-    super(error.description);
-    this.name = method;
-    this.method = method;
-    this.params = params;
-    this.code = error.error_code;
-    if (error.parameters) this.payload = error.parameters;
-  }
-}
-TelegramError.constructor[ErrorKind] = "TELEGRAM";
-
 class Composer {
   composer = middlewareIo.Composer.builder();
   length = 0;
@@ -197,7 +176,7 @@ class Plugin {
    * Register custom class-error in plugin
    **/
   error(kind, error) {
-    error[ErrorKind] = kind;
+    error[utils.ErrorKind] = kind;
     this._.errorsDefinitions[kind] = error;
     return this;
   }
@@ -316,8 +295,6 @@ _init$1 = __decoratorStart$1();
 Plugin = __decorateElement$1(_init$1, 0, "Plugin", _Plugin_decorators, Plugin);
 __runInitializers$1(_init$1, 1, Plugin);
 
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-
 class UpdateQueue {
   updateQueue = [];
   pendingUpdates = /* @__PURE__ */ new Set();
@@ -355,7 +332,7 @@ class UpdateQueue {
     this.onIdlePromise = new Promise((resolve) => {
       this.onIdleResolver = resolve;
     });
-    await Promise.race([this.onIdlePromise, sleep(timeout)]);
+    await Promise.race([this.onIdlePromise, utils.sleep(timeout)]);
     this.isActive = false;
   }
 }
@@ -425,9 +402,9 @@ class Updates {
         }
       } catch (error) {
         console.error("Error received when fetching updates", error);
-        if (error instanceof TelegramError && error.payload?.retry_after) {
-          await sleep(error.payload.retry_after * 1e3);
-        } else await sleep(this.bot.options.api.retryGetUpdatesWait ?? 1e3);
+        if (error instanceof utils.TelegramError && error.payload?.retry_after) {
+          await utils.sleep(error.payload.retry_after * 1e3);
+        } else await utils.sleep(this.bot.options.api.retryGetUpdatesWait ?? 1e3);
       }
     }
   }
@@ -512,7 +489,7 @@ class Bot {
   lazyloadPlugins = [];
   dependencies = [];
   errorsDefinitions = {
-    TELEGRAM: TelegramError
+    TELEGRAM: utils.TelegramError
   };
   errorHandler(context, error) {
     if (!this.hooks.onError.length)
@@ -520,7 +497,7 @@ class Bot {
     return this.runImmutableHooks("onError", {
       context,
       //@ts-expect-error ErrorKind exists if user register error-class with .error("kind", SomeError);
-      kind: error.constructor[ErrorKind] ?? "UNKNOWN",
+      kind: error.constructor[utils.ErrorKind] ?? "UNKNOWN",
       error
     });
   }
@@ -574,7 +551,7 @@ class Bot {
   }
   async _callApi(method, params = {}) {
     const debug$api$method = debug$api.extend(method);
-    const url = `${this.options.api.baseURL}${this.options.token}/${this.options.api.useTest ? "test/" : ""}${method}`;
+    let url = `${this.options.api.baseURL}${this.options.token}/${this.options.api.useTest ? "test/" : ""}${method}`;
     const reqOptions = {
       method: "POST",
       ...this.options.api.fetchOptions,
@@ -592,8 +569,18 @@ class Bot {
     );
     params = context.params;
     if (params && files.isMediaUpload(method, params)) {
-      const formData = await files.convertJsonToFormData(method, params);
-      reqOptions.body = formData;
+      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 {
       reqOptions.headers.set("Content-Type", "application/json");
       reqOptions.body = JSON.stringify(params);
@@ -603,7 +590,7 @@ class Bot {
     const data = await response.json();
     debug$api$method("response: %j", data);
     if (!data.ok) {
-      const err = new TelegramError(data, method, params);
+      const err = new utils.TelegramError(data, method, params);
       this.runImmutableHooks("onResponseError", err, this.api);
       if (!params?.suppress) throw err;
       return err;
@@ -674,7 +661,7 @@ class Bot {
    * ```
    */
   error(kind, error) {
-    error[ErrorKind] = kind;
+    error[utils.ErrorKind] = kind;
     this.errorsDefinitions[kind] = error;
     return this;
   }
@@ -1076,7 +1063,7 @@ class Bot {
       const info = await this.api.getMe({
         suppress: true
       });
-      if (info instanceof TelegramError) {
+      if (info instanceof utils.TelegramError) {
         if (info.code === 404)
           info.message = "The bot token is incorrect. Check it in BotFather.";
         throw info;
@@ -1105,10 +1092,12 @@ class Bot {
   } = {}) {
     await this.init();
     if (!webhook) {
-      await this.api.deleteWebhook({
-        drop_pending_updates: dropPendingUpdates
-        // suppress: true,
-      });
+      await utils.withRetries(
+        () => this.api.deleteWebhook({
+          drop_pending_updates: dropPendingUpdates
+          // suppress: true,
+        })
+      );
       this.updates.startPolling({
         allowed_updates: allowedUpdates
       });
@@ -1121,12 +1110,14 @@ class Bot {
       return this.info;
     }
     if (this.updates.isStarted) this.updates.stopPolling();
-    await this.api.setWebhook({
-      ...webhook,
-      drop_pending_updates: dropPendingUpdates,
-      allowed_updates: allowedUpdates
-      // suppress: true,
-    });
+    await utils.withRetries(
+      async () => this.api.setWebhook({
+        ...webhook,
+        drop_pending_updates: dropPendingUpdates,
+        allowed_updates: allowedUpdates
+        // suppress: true,
+      })
+    );
     this.runImmutableHooks("onStart", {
       plugins: this.dependencies,
       // biome-ignore lint/style/noNonNullAssertion: bot.init() guarantees this.info
@@ -1230,11 +1221,11 @@ function webhookHandler(bot, framework, secretToken) {
 
 Symbol.metadata ??= Symbol("Symbol.metadata");
 
+exports.ErrorKind = utils.ErrorKind;
+exports.TelegramError = utils.TelegramError;
 exports.Bot = Bot;
 exports.Composer = Composer;
-exports.ErrorKind = ErrorKind;
 exports.Plugin = Plugin;
-exports.TelegramError = TelegramError;
 exports.Updates = Updates;
 exports.webhookHandler = webhookHandler;
 Object.keys(callbackData).forEach(function (k) {

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { CallbackData } from '@gramio/callback-data';
 export * from '@gramio/callback-data';
-import { Context, UpdateName, MaybeArray, ContextType, Attachment } from '@gramio/contexts';
+import { Context, UpdateName, MaybeArray, ContextType, BotLike, Attachment } from '@gramio/contexts';
 export * from '@gramio/contexts';
 import { APIMethods, TelegramResponseParameters, TelegramAPIResponseError, TelegramUser, APIMethodParams, APIMethodReturn, TelegramUpdate, TelegramReactionTypeEmojiEmoji, SetMyCommandsParams, TelegramBotCommand } from '@gramio/types';
 export * from '@gramio/types';
@@ -556,6 +556,9 @@ type FilterDefinitions = Record<string, (...args: any[]) => (context: Context<Bo
 type AnyBot = Bot<any, any>;
 /** Type of Bot that accepts any generics */
 type AnyPlugin = Plugin<any, any>;
+type CallbackQueryShorthandContext<BotType extends BotLike, Trigger extends CallbackData | string | RegExp> = Omit<ContextType<BotType, "callback_query">, "data"> & BotType["__Derives"]["global"] & BotType["__Derives"]["callback_query"] & {
+    queryData: Trigger extends CallbackData ? ReturnType<Trigger["unpack"]> : Trigger extends RegExp ? RegExpMatchArray : never;
+};
 
 declare class UpdateQueue<Data = TelegramUpdate> {
     private updateQueue;
@@ -888,9 +891,7 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
      *     });
      * ```
      */
-    callbackQuery<Trigger extends CallbackData | string | RegExp>(trigger: Trigger, handler: (context: Omit<ContextType<typeof this, "callback_query">, "data"> & Derives["global"] & Derives["callback_query"] & {
-        queryData: Trigger extends CallbackData ? ReturnType<Trigger["unpack"]> : Trigger extends RegExp ? RegExpMatchArray : never;
-    }) => unknown): this;
+    callbackQuery<Trigger extends CallbackData | string | RegExp>(trigger: Trigger, handler: (context: CallbackQueryShorthandContext<typeof this, Trigger>) => unknown): this;
     /** Register handler to `chosen_inline_result` update */
     chosenInlineResult<Ctx = ContextType<typeof this, "chosen_inline_result"> & Derives["global"] & Derives["chosen_inline_result"]>(trigger: RegExp | string | ((context: Ctx) => boolean), handler: (context: Ctx & {
         args: RegExpMatchArray | null;
@@ -944,7 +945,7 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
      *     if (context.args) await context.send(`Params ${context.args[1]}`);
      * });
      */
-    hears<Ctx = ContextType<typeof this, "message"> & Derives["global"] & Derives["message"]>(trigger: RegExp | string | ((context: Ctx) => boolean), handler: (context: Ctx & {
+    hears<Ctx = ContextType<typeof this, "message"> & Derives["global"] & Derives["message"], Trigger extends RegExp | string | ((context: Ctx) => boolean) = RegExp | string | ((context: Ctx) => boolean)>(trigger: Trigger, handler: (context: Ctx & {
         args: RegExpMatchArray | null;
     }) => unknown): this;
     /**
@@ -1068,4 +1069,4 @@ declare function webhookHandler<Framework extends keyof typeof frameworks>(bot:
     response: () => any;
 } ? (...args: Parameters<(typeof frameworks)[Framework]>) => ReturnType<ReturnType<(typeof frameworks)[Framework]>["response"]> : (...args: Parameters<(typeof frameworks)[Framework]>) => void;
 
-export { type AnyBot, type AnyPlugin, Bot, type BotOptions, Composer, type DeriveDefinitions, type ErrorDefinitions, ErrorKind, type FilterDefinitions, type Handler, Hooks, type MaybePromise, type MaybeSuppressedParams, type MaybeSuppressedReturn, Plugin, type Suppress, type SuppressedAPIMethodParams, type SuppressedAPIMethodReturn, type SuppressedAPIMethods, TelegramError, Updates, type WebhookHandlers, webhookHandler };
+export { type AnyBot, type AnyPlugin, Bot, type BotOptions, type CallbackQueryShorthandContext, Composer, type DeriveDefinitions, type ErrorDefinitions, ErrorKind, type FilterDefinitions, type Handler, Hooks, type MaybePromise, type MaybeSuppressedParams, type MaybeSuppressedReturn, Plugin, type Suppress, type SuppressedAPIMethodParams, type SuppressedAPIMethodReturn, type SuppressedAPIMethods, TelegramError, Updates, type WebhookHandlers, webhookHandler };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { CallbackData } from '@gramio/callback-data';
 export * from '@gramio/callback-data';
-import { Context, UpdateName, MaybeArray, ContextType, Attachment } from '@gramio/contexts';
+import { Context, UpdateName, MaybeArray, ContextType, BotLike, Attachment } from '@gramio/contexts';
 export * from '@gramio/contexts';
 import { APIMethods, TelegramResponseParameters, TelegramAPIResponseError, TelegramUser, APIMethodParams, APIMethodReturn, TelegramUpdate, TelegramReactionTypeEmojiEmoji, SetMyCommandsParams, TelegramBotCommand } from '@gramio/types';
 export * from '@gramio/types';
@@ -556,6 +556,9 @@ type FilterDefinitions = Record<string, (...args: any[]) => (context: Context<Bo
 type AnyBot = Bot<any, any>;
 /** Type of Bot that accepts any generics */
 type AnyPlugin = Plugin<any, any>;
+type CallbackQueryShorthandContext<BotType extends BotLike, Trigger extends CallbackData | string | RegExp> = Omit<ContextType<BotType, "callback_query">, "data"> & BotType["__Derives"]["global"] & BotType["__Derives"]["callback_query"] & {
+    queryData: Trigger extends CallbackData ? ReturnType<Trigger["unpack"]> : Trigger extends RegExp ? RegExpMatchArray : never;
+};
 
 declare class UpdateQueue<Data = TelegramUpdate> {
     private updateQueue;
@@ -888,9 +891,7 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
      *     });
      * ```
      */
-    callbackQuery<Trigger extends CallbackData | string | RegExp>(trigger: Trigger, handler: (context: Omit<ContextType<typeof this, "callback_query">, "data"> & Derives["global"] & Derives["callback_query"] & {
-        queryData: Trigger extends CallbackData ? ReturnType<Trigger["unpack"]> : Trigger extends RegExp ? RegExpMatchArray : never;
-    }) => unknown): this;
+    callbackQuery<Trigger extends CallbackData | string | RegExp>(trigger: Trigger, handler: (context: CallbackQueryShorthandContext<typeof this, Trigger>) => unknown): this;
     /** Register handler to `chosen_inline_result` update */
     chosenInlineResult<Ctx = ContextType<typeof this, "chosen_inline_result"> & Derives["global"] & Derives["chosen_inline_result"]>(trigger: RegExp | string | ((context: Ctx) => boolean), handler: (context: Ctx & {
         args: RegExpMatchArray | null;
@@ -944,7 +945,7 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
      *     if (context.args) await context.send(`Params ${context.args[1]}`);
      * });
      */
-    hears<Ctx = ContextType<typeof this, "message"> & Derives["global"] & Derives["message"]>(trigger: RegExp | string | ((context: Ctx) => boolean), handler: (context: Ctx & {
+    hears<Ctx = ContextType<typeof this, "message"> & Derives["global"] & Derives["message"], Trigger extends RegExp | string | ((context: Ctx) => boolean) = RegExp | string | ((context: Ctx) => boolean)>(trigger: Trigger, handler: (context: Ctx & {
         args: RegExpMatchArray | null;
     }) => unknown): this;
     /**
@@ -1068,4 +1069,4 @@ declare function webhookHandler<Framework extends keyof typeof frameworks>(bot:
     response: () => any;
 } ? (...args: Parameters<(typeof frameworks)[Framework]>) => ReturnType<ReturnType<(typeof frameworks)[Framework]>["response"]> : (...args: Parameters<(typeof frameworks)[Framework]>) => void;
 
-export { type AnyBot, type AnyPlugin, Bot, type BotOptions, Composer, type DeriveDefinitions, type ErrorDefinitions, ErrorKind, type FilterDefinitions, type Handler, Hooks, type MaybePromise, type MaybeSuppressedParams, type MaybeSuppressedReturn, Plugin, type Suppress, type SuppressedAPIMethodParams, type SuppressedAPIMethodReturn, type SuppressedAPIMethods, TelegramError, Updates, type WebhookHandlers, webhookHandler };
+export { type AnyBot, type AnyPlugin, Bot, type BotOptions, type CallbackQueryShorthandContext, Composer, type DeriveDefinitions, type ErrorDefinitions, ErrorKind, type FilterDefinitions, type Handler, Hooks, type MaybePromise, type MaybeSuppressedParams, type MaybeSuppressedReturn, Plugin, type Suppress, type SuppressedAPIMethodParams, type SuppressedAPIMethodReturn, type SuppressedAPIMethods, TelegramError, Updates, type WebhookHandlers, webhookHandler };

package/dist/index.js

@@ -4,37 +4,16 @@ import { CallbackData } from '@gramio/callback-data';
 export * from '@gramio/callback-data';
 import { contextsMappings, PhotoAttachment } from '@gramio/contexts';
 export * from '@gramio/contexts';
-import { isMediaUpload, convertJsonToFormData } from '@gramio/files';
+import { isMediaUpload, convertJsonToFormData, extractFilesToFormData } from '@gramio/files';
 export * from '@gramio/files';
 import { FormattableMap } from '@gramio/format';
 export * from '@gramio/format';
 import debug from 'debug';
 import { Inspectable } from 'inspectable';
+import { E as ErrorKind, s as sleep, T as TelegramError, I as IS_BUN, a as simplifyObject, w as withRetries } from './utils-DTFsIb2X.js';
 import { Composer as Composer$1, noopNext } from 'middleware-io';
 export * from '@gramio/keyboards';
 
-const ErrorKind = Symbol("ErrorKind");
-class TelegramError extends Error {
-  /** Name of the API Method */
-  method;
-  /** Params that were sent */
-  params;
-  /** See  {@link TelegramAPIResponseError.error_code}*/
-  code;
-  /** Describes why a request was unsuccessful. */
-  payload;
-  /** Construct new TelegramError */
-  constructor(error, method, params) {
-    super(error.description);
-    this.name = method;
-    this.method = method;
-    this.params = params;
-    this.code = error.error_code;
-    if (error.parameters) this.payload = error.parameters;
-  }
-}
-TelegramError.constructor[ErrorKind] = "TELEGRAM";
-
 class Composer {
   composer = Composer$1.builder();
   length = 0;
@@ -318,8 +297,6 @@ _init$1 = __decoratorStart$1();
 Plugin = __decorateElement$1(_init$1, 0, "Plugin", _Plugin_decorators, Plugin);
 __runInitializers$1(_init$1, 1, Plugin);
 
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-
 class UpdateQueue {
   updateQueue = [];
   pendingUpdates = /* @__PURE__ */ new Set();
@@ -576,7 +553,7 @@ class Bot {
   }
   async _callApi(method, params = {}) {
     const debug$api$method = debug$api.extend(method);
-    const url = `${this.options.api.baseURL}${this.options.token}/${this.options.api.useTest ? "test/" : ""}${method}`;
+    let url = `${this.options.api.baseURL}${this.options.token}/${this.options.api.useTest ? "test/" : ""}${method}`;
     const reqOptions = {
       method: "POST",
       ...this.options.api.fetchOptions,
@@ -594,8 +571,18 @@ class Bot {
     );
     params = context.params;
     if (params && isMediaUpload(method, params)) {
-      const formData = await convertJsonToFormData(method, params);
-      reqOptions.body = formData;
+      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 {
       reqOptions.headers.set("Content-Type", "application/json");
       reqOptions.body = JSON.stringify(params);
@@ -1107,10 +1094,12 @@ class Bot {
   } = {}) {
     await this.init();
     if (!webhook) {
-      await this.api.deleteWebhook({
-        drop_pending_updates: dropPendingUpdates
-        // suppress: true,
-      });
+      await withRetries(
+        () => this.api.deleteWebhook({
+          drop_pending_updates: dropPendingUpdates
+          // suppress: true,
+        })
+      );
       this.updates.startPolling({
         allowed_updates: allowedUpdates
       });
@@ -1123,12 +1112,14 @@ class Bot {
       return this.info;
     }
     if (this.updates.isStarted) this.updates.stopPolling();
-    await this.api.setWebhook({
-      ...webhook,
-      drop_pending_updates: dropPendingUpdates,
-      allowed_updates: allowedUpdates
-      // suppress: true,
-    });
+    await withRetries(
+      async () => this.api.setWebhook({
+        ...webhook,
+        drop_pending_updates: dropPendingUpdates,
+        allowed_updates: allowedUpdates
+        // suppress: true,
+      })
+    );
     this.runImmutableHooks("onStart", {
       plugins: this.dependencies,
       // biome-ignore lint/style/noNonNullAssertion: bot.init() guarantees this.info

package/dist/utils-BbVj3DtT.cjs

@@ -0,0 +1,72 @@
+'use strict';
+
+const ErrorKind = Symbol("ErrorKind");
+class TelegramError extends Error {
+  /** Name of the API Method */
+  method;
+  /** Params that were sent */
+  params;
+  /** See  {@link TelegramAPIResponseError.error_code}*/
+  code;
+  /** Describes why a request was unsuccessful. */
+  payload;
+  /** Construct new TelegramError */
+  constructor(error, method, params) {
+    super(error.description);
+    this.name = method;
+    this.method = method;
+    this.params = params;
+    this.code = error.error_code;
+    if (error.parameters) this.payload = error.parameters;
+  }
+}
+TelegramError.constructor[ErrorKind] = "TELEGRAM";
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function convertToString(value) {
+  const typeOfValue = typeof value;
+  if (typeOfValue === "string") return value;
+  if (typeOfValue === "object") return JSON.stringify(value);
+  return String(value);
+}
+function simplifyObject(obj) {
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const typeOfValue = typeof value;
+    if (value === void 0 || value === null || typeOfValue === "function")
+      continue;
+    result[key] = convertToString(value);
+  }
+  return result;
+}
+const IS_BUN = typeof Bun !== "undefined";
+
+async function suppressError(fn) {
+  try {
+    return [await fn(), false];
+  } catch (error) {
+    return [error, true];
+  }
+}
+async function withRetries(resultPromise) {
+  let [result, isFromCatch] = await suppressError(resultPromise);
+  while (result instanceof TelegramError) {
+    const retryAfter = result.payload?.retry_after;
+    if (retryAfter) {
+      await sleep(retryAfter * 1e3);
+      [result, isFromCatch] = await suppressError(resultPromise);
+    } else {
+      if (isFromCatch) throw result;
+      return result;
+    }
+  }
+  if (result instanceof Error && isFromCatch) throw result;
+  return result;
+}
+
+exports.ErrorKind = ErrorKind;
+exports.IS_BUN = IS_BUN;
+exports.TelegramError = TelegramError;
+exports.simplifyObject = simplifyObject;
+exports.sleep = sleep;
+exports.withRetries = withRetries;

package/dist/utils-DTFsIb2X.js

@@ -0,0 +1,65 @@
+const ErrorKind = Symbol("ErrorKind");
+class TelegramError extends Error {
+  /** Name of the API Method */
+  method;
+  /** Params that were sent */
+  params;
+  /** See  {@link TelegramAPIResponseError.error_code}*/
+  code;
+  /** Describes why a request was unsuccessful. */
+  payload;
+  /** Construct new TelegramError */
+  constructor(error, method, params) {
+    super(error.description);
+    this.name = method;
+    this.method = method;
+    this.params = params;
+    this.code = error.error_code;
+    if (error.parameters) this.payload = error.parameters;
+  }
+}
+TelegramError.constructor[ErrorKind] = "TELEGRAM";
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function convertToString(value) {
+  const typeOfValue = typeof value;
+  if (typeOfValue === "string") return value;
+  if (typeOfValue === "object") return JSON.stringify(value);
+  return String(value);
+}
+function simplifyObject(obj) {
+  const result = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const typeOfValue = typeof value;
+    if (value === void 0 || value === null || typeOfValue === "function")
+      continue;
+    result[key] = convertToString(value);
+  }
+  return result;
+}
+const IS_BUN = typeof Bun !== "undefined";
+
+async function suppressError(fn) {
+  try {
+    return [await fn(), false];
+  } catch (error) {
+    return [error, true];
+  }
+}
+async function withRetries(resultPromise) {
+  let [result, isFromCatch] = await suppressError(resultPromise);
+  while (result instanceof TelegramError) {
+    const retryAfter = result.payload?.retry_after;
+    if (retryAfter) {
+      await sleep(retryAfter * 1e3);
+      [result, isFromCatch] = await suppressError(resultPromise);
+    } else {
+      if (isFromCatch) throw result;
+      return result;
+    }
+  }
+  if (result instanceof Error && isFromCatch) throw result;
+  return result;
+}
+
+export { ErrorKind as E, IS_BUN as I, TelegramError as T, simplifyObject as a, sleep as s, withRetries as w };

package/dist/utils.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var utils = require('./utils-BbVj3DtT.cjs');
+
+
+
+exports.withRetries = utils.withRetries;

package/dist/utils.d.cts

@@ -0,0 +1,8 @@
+/**
+ * @module
+ *
+ * Pack of useful utilities for Telegram Bot API and GramIO
+ */
+declare function withRetries<Result extends Promise<unknown>>(resultPromise: () => Result): Promise<Result>;
+
+export { withRetries };

package/dist/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @module
+ *
+ * Pack of useful utilities for Telegram Bot API and GramIO
+ */
+declare function withRetries<Result extends Promise<unknown>>(resultPromise: () => Result): Promise<Result>;
+
+export { withRetries };

package/dist/utils.js

@@ -0,0 +1 @@
+export { w as withRetries } from './utils-DTFsIb2X.js';

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "gramio",
 	"type": "module",
-	"version": "0.2.4",
+	"version": "0.2.6",
 	"description": "Powerful, extensible and really type-safe Telegram Bot API framework",
 	"main": "dist/index.cjs",
 	"module": "dist/index.js",
@@ -16,6 +16,16 @@
 				"types": "./dist/index.d.cts",
 				"default": "./dist/index.cjs"
 			}
+		},
+		"./utils": {
+			"import": {
+				"types": "./dist/utils.d.ts",
+				"default": "./dist/utils.js"
+			},
+			"require": {
+				"types": "./dist/utils.d.cts",
+				"default": "./dist/utils.cjs"
+			}
 		}
 	},
 	"keywords": [
@@ -41,18 +51,18 @@
 	"license": "MIT",
 	"devDependencies": {
 		"@biomejs/biome": "1.9.4",
-		"@types/bun": "^1.2.2",
+		"@types/bun": "^1.2.8",
 		"@types/debug": "^4.1.12",
-		"pkgroll": "^2.8.2",
-		"typescript": "^5.7.3"
+		"pkgroll": "^2.12.1",
+		"typescript": "^5.8.3"
 	},
 	"dependencies": {
 		"@gramio/callback-data": "^0.0.3",
-		"@gramio/contexts": "^0.1.3",
-		"@gramio/files": "^0.1.2",
+		"@gramio/contexts": "^0.1.5",
+		"@gramio/files": "^0.2.0",
 		"@gramio/format": "^0.1.5",
 		"@gramio/keyboards": "^1.1.0",
-		"@gramio/types": "^8.3.1",
+		"@gramio/types": "^8.3.3",
 		"debug": "^4.4.0",
 		"inspectable": "^3.0.2",
 		"middleware-io": "^2.8.1"