gramio 0.3.0 → 0.3.1

package/dist/index.cjs

@@ -306,12 +306,12 @@ class Updates {
     this.composer = new Composer(onError);
     this.queue = new UpdateQueue(this.handleUpdate.bind(this));
   }
-  async handleUpdate(data) {
+  async handleUpdate(data, mode = "wait") {
     const updateType = Object.keys(data).at(1);
     const UpdateContext = contexts.contextsMappings[updateType];
     if (!UpdateContext) throw new Error(updateType);
     const updatePayload = data[updateType];
-    if (!updatePayload) throw new Error("");
+    if (!updatePayload) throw new Error("Unsupported event??");
     try {
       let context = new UpdateContext({
         bot: this.bot,
@@ -333,7 +333,7 @@ class Updates {
           updateId: data.update_id
         });
       }
-      return this.composer.composeWait(context);
+      return mode === "wait" ? this.composer.composeWait(context) : this.composer.compose(context);
     } catch (error) {
       throw new Error(`[UPDATES] Update type ${updateType} not supported.`);
     }

package/dist/index.d.cts

@@ -198,10 +198,10 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
      * })
      * ```
      */
-    derive<Handler extends Hooks.Derive<Context<AnyBot> & Derives["global"]>>(handler: Handler): Plugin<Errors, Derives & {
+    derive<Handler extends Hooks.Derive<Context<BotLike> & Derives["global"]>>(handler: Handler): Plugin<Errors, Derives & {
         global: Awaited<ReturnType<Handler>>;
     }>;
-    derive<Update extends UpdateName, Handler extends Hooks.Derive<ContextType<AnyBot, Update> & Derives["global"] & Derives[Update]>>(updateName: MaybeArray<Update>, handler: Handler): Plugin<Errors, Derives & {
+    derive<Update extends UpdateName, Handler extends Hooks.Derive<ContextType<BotLike, Update> & Derives["global"] & Derives[Update]>>(updateName: MaybeArray<Update>, handler: Handler): Plugin<Errors, Derives & {
         [K in Update]: Awaited<ReturnType<Handler>>;
     }>;
     decorate<Value extends Record<string, any>>(value: Value): Plugin<Errors, Derives & {
@@ -215,9 +215,9 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
         };
     }>;
     /** Register handler to one or many Updates */
-    on<T extends UpdateName>(updateName: MaybeArray<T>, handler: Handler<ContextType<AnyBot, T> & Derives["global"] & Derives[T]>): this;
+    on<T extends UpdateName>(updateName: MaybeArray<T>, handler: Handler<ContextType<BotLike, T> & Derives["global"] & Derives[T]>): this;
     /** Register handler to any Updates */
-    use(handler: Handler<Context<AnyBot> & Derives["global"]>): this;
+    use(handler: Handler<Context<BotLike> & Derives["global"]>): this;
     /**
      * This hook called before sending a request to Telegram Bot API (allows us to impact the sent parameters).
      *
@@ -305,8 +305,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
      * })
      * ```
      */
-    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<AnyBot> & Derives["global"]>): this;
+    onError<T extends UpdateName>(updateName: MaybeArray<T>, handler: Hooks.OnError<Errors, ContextType<BotLike, T> & Derives["global"] & Derives[T]>): this;
+    onError(handler: Hooks.OnError<Errors, Context<BotLike> & Derives["global"]>): this;
     /**
      * ! ** At the moment, it can only pick up types** */
     extend<NewPlugin extends AnyPlugin>(plugin: MaybePromise<NewPlugin>): Plugin<Errors & NewPlugin["_"]["Errors"], Derives & NewPlugin["_"]["Derives"]>;
@@ -580,7 +580,7 @@ declare class Updates {
     composer: Composer;
     queue: UpdateQueue<TelegramUpdate>;
     constructor(bot: AnyBot, onError: CaughtMiddlewareHandler<Context<any>>);
-    handleUpdate(data: TelegramUpdate): Promise<unknown>;
+    handleUpdate(data: TelegramUpdate, mode?: "wait" | "lazy"): Promise<unknown>;
     /** @deprecated use bot.start instead @internal */
     startPolling(params?: APIMethodParams<"getUpdates">): void;
     startFetchLoop(params?: APIMethodParams<"getUpdates">): Promise<void>;

package/dist/index.d.ts

@@ -198,10 +198,10 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
      * })
      * ```
      */
-    derive<Handler extends Hooks.Derive<Context<AnyBot> & Derives["global"]>>(handler: Handler): Plugin<Errors, Derives & {
+    derive<Handler extends Hooks.Derive<Context<BotLike> & Derives["global"]>>(handler: Handler): Plugin<Errors, Derives & {
         global: Awaited<ReturnType<Handler>>;
     }>;
-    derive<Update extends UpdateName, Handler extends Hooks.Derive<ContextType<AnyBot, Update> & Derives["global"] & Derives[Update]>>(updateName: MaybeArray<Update>, handler: Handler): Plugin<Errors, Derives & {
+    derive<Update extends UpdateName, Handler extends Hooks.Derive<ContextType<BotLike, Update> & Derives["global"] & Derives[Update]>>(updateName: MaybeArray<Update>, handler: Handler): Plugin<Errors, Derives & {
         [K in Update]: Awaited<ReturnType<Handler>>;
     }>;
     decorate<Value extends Record<string, any>>(value: Value): Plugin<Errors, Derives & {
@@ -215,9 +215,9 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
         };
     }>;
     /** Register handler to one or many Updates */
-    on<T extends UpdateName>(updateName: MaybeArray<T>, handler: Handler<ContextType<AnyBot, T> & Derives["global"] & Derives[T]>): this;
+    on<T extends UpdateName>(updateName: MaybeArray<T>, handler: Handler<ContextType<BotLike, T> & Derives["global"] & Derives[T]>): this;
     /** Register handler to any Updates */
-    use(handler: Handler<Context<AnyBot> & Derives["global"]>): this;
+    use(handler: Handler<Context<BotLike> & Derives["global"]>): this;
     /**
      * This hook called before sending a request to Telegram Bot API (allows us to impact the sent parameters).
      *
@@ -305,8 +305,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
      * })
      * ```
      */
-    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<AnyBot> & Derives["global"]>): this;
+    onError<T extends UpdateName>(updateName: MaybeArray<T>, handler: Hooks.OnError<Errors, ContextType<BotLike, T> & Derives["global"] & Derives[T]>): this;
+    onError(handler: Hooks.OnError<Errors, Context<BotLike> & Derives["global"]>): this;
     /**
      * ! ** At the moment, it can only pick up types** */
     extend<NewPlugin extends AnyPlugin>(plugin: MaybePromise<NewPlugin>): Plugin<Errors & NewPlugin["_"]["Errors"], Derives & NewPlugin["_"]["Derives"]>;
@@ -580,7 +580,7 @@ declare class Updates {
     composer: Composer;
     queue: UpdateQueue<TelegramUpdate>;
     constructor(bot: AnyBot, onError: CaughtMiddlewareHandler<Context<any>>);
-    handleUpdate(data: TelegramUpdate): Promise<unknown>;
+    handleUpdate(data: TelegramUpdate, mode?: "wait" | "lazy"): Promise<unknown>;
     /** @deprecated use bot.start instead @internal */
     startPolling(params?: APIMethodParams<"getUpdates">): void;
     startFetchLoop(params?: APIMethodParams<"getUpdates">): Promise<void>;

package/dist/index.js

@@ -308,12 +308,12 @@ class Updates {
     this.composer = new Composer(onError);
     this.queue = new UpdateQueue(this.handleUpdate.bind(this));
   }
-  async handleUpdate(data) {
+  async handleUpdate(data, mode = "wait") {
     const updateType = Object.keys(data).at(1);
     const UpdateContext = contextsMappings[updateType];
     if (!UpdateContext) throw new Error(updateType);
     const updatePayload = data[updateType];
-    if (!updatePayload) throw new Error("");
+    if (!updatePayload) throw new Error("Unsupported event??");
     try {
       let context = new UpdateContext({
         bot: this.bot,
@@ -335,7 +335,7 @@ class Updates {
           updateId: data.update_id
         });
       }
-      return this.composer.composeWait(context);
+      return mode === "wait" ? this.composer.composeWait(context) : this.composer.compose(context);
     } catch (error) {
       throw new Error(`[UPDATES] Update type ${updateType} not supported.`);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "gramio",
 	"type": "module",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"description": "Powerful, extensible and really type-safe Telegram Bot API framework",
 	"main": "dist/index.cjs",
 	"module": "dist/index.js",
@@ -56,14 +56,15 @@
 	"license": "MIT",
 	"devDependencies": {
 		"@biomejs/biome": "1.9.4",
-		"@types/bun": "^1.2.9",
+		"@types/bun": "^1.2.10",
 		"@types/debug": "^4.1.12",
+		"expect-type": "^1.2.1",
 		"pkgroll": "^2.12.1",
 		"typescript": "^5.8.3"
 	},
 	"dependencies": {
 		"@gramio/callback-data": "^0.0.3",
-		"@gramio/contexts": "^0.2.0",
+		"@gramio/contexts": "^0.2.5",
 		"@gramio/files": "^0.3.0",
 		"@gramio/format": "^0.2.0",
 		"@gramio/keyboards": "^1.2.1",