gramio 0.0.28 → 0.0.30

package/dist/bot.d.ts

@@ -1,5 +1,5 @@
 import { CallbackData } from "@gramio/callback-data";
-import type { Context, ContextType, MaybeArray, UpdateName } from "@gramio/contexts";
+import { type Attachment, type Context, type ContextType, type MaybeArray, type UpdateName } from "@gramio/contexts";
 import type { APIMethodParams, APIMethods, SetMyCommandsParams, TelegramBotCommand, TelegramReactionTypeEmojiEmoji, TelegramUser } from "@gramio/types";
 import { Plugin } from "./plugin";
 import type { BotOptions, DeriveDefinitions, ErrorDefinitions, Handler, Hooks, MaybePromise, SuppressedAPIMethods } from "./types";
@@ -20,7 +20,12 @@ export declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends D
     private runHooks;
     private runImmutableHooks;
     private _callApi;
-    downloadFile(fileId: string): Promise<ArrayBuffer>;
+    downloadFile(attachment: Attachment | {
+        file_id: string;
+    } | string): Promise<ArrayBuffer>;
+    downloadFile(attachment: Attachment | {
+        file_id: string;
+    } | string, path: string): Promise<string>;
     /**
      * Register custom class-error for type-safe catch in `onError` hook
      *
@@ -104,7 +109,7 @@ export declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends D
         args: string | null;
     }) => unknown, options?: Omit<SetMyCommandsParams, "commands"> & Omit<TelegramBotCommand, "command">): this;
     /** Currently not isolated!!! */
-    group(grouped: (bot: typeof this) => Bot<any, any>): Bot<any, any>;
+    group(grouped: (bot: typeof this) => Bot<any, any>): typeof this;
     init(): Promise<void>;
     start({ webhook, dropPendingUpdates, allowedUpdates, }?: {
         webhook?: Omit<APIMethodParams<"setWebhook">, "drop_pending_updates" | "allowed_updates">;

package/dist/bot.js

@@ -33,9 +33,14 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Bot = void 0;
+const promises_1 = __importDefault(require("node:fs/promises"));
 const callback_data_1 = require("@gramio/callback-data");
+const contexts_1 = require("@gramio/contexts");
 const files_1 = require("@gramio/files");
 const format_1 = require("@gramio/format");
 const inspectable_1 = require("inspectable");
@@ -163,11 +168,26 @@ let Bot = (() => {
             });
             return data.result;
         }
-        async downloadFile(fileId) {
+        async downloadFile(attachment, path) {
+            function getFileId(attachment) {
+                if (attachment instanceof contexts_1.PhotoAttachment) {
+                    return attachment.bigSize.fileId;
+                }
+                if ("fileId" in attachment && typeof attachment.fileId === "string")
+                    return attachment.fileId;
+                if ("file_id" in attachment)
+                    return attachment.file_id;
+                throw new Error("Invalid attachment");
+            }
+            const fileId = typeof attachment === "string" ? attachment : getFileId(attachment);
             const file = await this.api.getFile({ file_id: fileId });
             const url = `https://api.telegram.org/file/bot${this.options.token}/${file.file_path}`;
             const res = await fetch(url);
             const buffer = await res.arrayBuffer();
+            if (path) {
+                await promises_1.default.writeFile(path, Buffer.from(buffer));
+                return path;
+            }
             return buffer;
         }
         /**

package/dist/plugin.d.ts

@@ -19,6 +19,9 @@ export declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extend
         MaybeArray<keyof APIMethods> | undefined
     ][];
     groups: ((bot: Bot<any, any>) => Bot<any, any>)[];
+    onStarts: Hooks.OnStart[];
+    onStops: Hooks.OnStop[];
+    onErrors: Hooks.OnError<any, any>[];
     name: string;
     errorsDefinitions: Record<string, {
         new (...args: any): any;
@@ -49,4 +52,8 @@ export declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extend
     onResponse(handler: Hooks.OnResponse): this;
     onResponseError<Methods extends keyof APIMethods, Handler extends Hooks.OnResponseError<Methods>>(methods: MaybeArray<Methods>, handler: Handler): this;
     onResponseError(handler: Hooks.OnResponseError): this;
+    onStart(handler: Hooks.OnStart): this;
+    onStop(handler: Hooks.OnStop): this;
+    onError<T extends UpdateName>(updateName: MaybeArray<T>, handler: Hooks.OnError<Errors, ContextType<Bot, T> & Derives["global"] & Derives[T]>): this;
+    onError(handler: Hooks.OnError<Errors, Context<Bot> & Derives["global"]>): this;
 }

package/dist/plugin.js

@@ -64,6 +64,9 @@ let Plugin = (() => {
         onResponses = [];
         onResponseErrors = [];
         groups = [];
+        onStarts = [];
+        onStops = [];
+        onErrors = [];
         name;
         errorsDefinitions = {};
         dependencies = [];
@@ -122,6 +125,27 @@ let Plugin = (() => {
                 this.onResponseErrors.push([methodsOrHandler, undefined]);
             return this;
         }
+        onStart(handler) {
+            this.onStarts.push(handler);
+            return this;
+        }
+        onStop(handler) {
+            this.onStops.push(handler);
+            return this;
+        }
+        onError(updateNameOrHandler, handler) {
+            if (typeof updateNameOrHandler === "function") {
+                this.onErrors.push(updateNameOrHandler);
+                return this;
+            }
+            if (handler) {
+                this.onErrors.push(async (errContext) => {
+                    if (errContext.context.is(updateNameOrHandler))
+                        await handler(errContext);
+                });
+            }
+            return this;
+        }
     };
     return Plugin = _classThis;
 })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gramio",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "description": "Powerful Telegram Bot API framework",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -24,20 +24,20 @@
   "author": "kravets",
   "license": "ISC",
   "devDependencies": {
-    "@biomejs/biome": "1.6.4",
-    "@types/node": "^20.12.7",
+    "@biomejs/biome": "1.7.2",
+    "@types/node": "^20.12.8",
     "typescript": "^5.4.5"
   },
   "dependencies": {
     "@gramio/callback-data": "^0.0.2",
-    "@gramio/contexts": "^0.0.9",
+    "@gramio/contexts": "^0.0.12",
     "@gramio/files": "^0.0.5",
     "@gramio/format": "^0.0.8",
     "@gramio/keyboards": "^0.3.0",
-    "@gramio/types": "^7.2.1",
+    "@gramio/types": "^7.2.2",
     "inspectable": "^3.0.0",
     "middleware-io": "^2.8.1",
-    "undici": "^6.12.0"
+    "undici": "^6.15.0"
   },
   "files": [
     "dist"