gramio 0.4.9 → 0.4.11

package/dist/index.cjs

@@ -49,17 +49,17 @@ class Composer {
   derive(updateNameOrHandler, handler) {
     if (typeof updateNameOrHandler === "function")
       this.use(async (context, next) => {
-        for (const [key, value] of Object.entries(
-          await updateNameOrHandler(context)
-        )) {
-          context[key] = value;
+        const assign = await updateNameOrHandler(context);
+        for (const key in assign) {
+          context[key] = assign[key];
         }
         return await next();
       });
     else if (handler)
       this.on(updateNameOrHandler, async (context, next) => {
-        for (const [key, value] of Object.entries(await handler(context))) {
-          context[key] = value;
+        const assign = await handler(context);
+        for (const key in assign) {
+          context[key] = assign[key];
         }
         return await next();
       });
@@ -1033,6 +1033,31 @@ class Bot {
       return next();
     });
   }
+  /**
+   * Register handler to `start` command when start parameter is matched
+   *
+   * @example
+   * ```ts
+   * new Bot().startParameter(/^ref_(.+)$/, (context) => {
+   *     return context.send(`Reference: ${context.rawStartPayload}`);
+   * });
+   * ```
+   */
+  startParameter(parameter, handler) {
+    return this.on("message", (context, next) => {
+      if (!context.rawStartPayload) return next();
+      if (parameter instanceof RegExp && parameter.test(context.rawStartPayload)) {
+        return handler(context);
+      }
+      if (Array.isArray(parameter) && parameter.includes(context.rawStartPayload)) {
+        return handler(context);
+      }
+      if (typeof parameter === "string" && parameter === context.rawStartPayload) {
+        return handler(context);
+      }
+      return next();
+    });
+  }
   /** Currently not isolated!!! */
   group(grouped) {
     return grouped(this);
@@ -1228,7 +1253,7 @@ function webhookHandler(bot, framework, secretTokenOrOptions) {
   const secretToken = typeof secretTokenOrOptions === "string" ? secretTokenOrOptions : secretTokenOrOptions?.secretToken;
   const shouldWaitOptions = typeof secretTokenOrOptions === "string" ? false : secretTokenOrOptions?.shouldWait;
   const isShouldWait = shouldWaitOptions && (typeof shouldWaitOptions === "object" || typeof shouldWaitOptions === "boolean");
-  return async (...args) => {
+  return (async (...args) => {
     const { update, response, header, unauthorized } = frameworkAdapter(
       ...args
     );
@@ -1247,7 +1272,7 @@ function webhookHandler(bot, framework, secretTokenOrOptions) {
       );
       if (response) return response();
     }
-  };
+  });
 }
 
 Symbol.metadata ??= Symbol("Symbol.metadata");

package/dist/index.d.cts

@@ -980,6 +980,19 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
     command(command: MaybeArray<string>, handler: (context: ContextType<typeof this, "message"> & {
         args: string | null;
     }) => unknown): this;
+    /**
+     * Register handler to `start` command when start parameter is matched
+     *
+     * @example
+     * ```ts
+     * new Bot().startParameter(/^ref_(.+)$/, (context) => {
+     *     return context.send(`Reference: ${context.rawStartPayload}`);
+     * });
+     * ```
+     */
+    startParameter(parameter: RegExp | MaybeArray<string>, handler: Handler<ContextType<typeof this, "message"> & {
+        rawStartPayload: string;
+    }>): this;
     /** Currently not isolated!!! */
     group(grouped: (bot: typeof this) => AnyBot): typeof this;
     /**
@@ -1114,4 +1127,5 @@ 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 AllowedUpdates, type AnyBot, type AnyPlugin, Bot, type BotOptions, type BotStartOptions, type BotStartOptionsLongPolling, type BotStartOptionsWebhook, type CallbackQueryShorthandContext, Composer, type DeriveDefinitions, type ErrorDefinitions, ErrorKind, type FilterDefinitions, type Handler, Hooks, type MaybePromise, type MaybeSuppressedParams, type MaybeSuppressedReturn, Plugin, type PollingStartOptions, type Suppress, type SuppressedAPIMethodParams, type SuppressedAPIMethodReturn, type SuppressedAPIMethods, TelegramError, Updates, type WebhookHandlerOptions, type WebhookHandlerOptionsShouldWait, type WebhookHandlers, webhookHandler };
+export { Bot, Composer, ErrorKind, Hooks, Plugin, TelegramError, Updates, webhookHandler };
+export type { AllowedUpdates, AnyBot, AnyPlugin, BotOptions, BotStartOptions, BotStartOptionsLongPolling, BotStartOptionsWebhook, CallbackQueryShorthandContext, DeriveDefinitions, ErrorDefinitions, FilterDefinitions, Handler, MaybePromise, MaybeSuppressedParams, MaybeSuppressedReturn, PollingStartOptions, Suppress, SuppressedAPIMethodParams, SuppressedAPIMethodReturn, SuppressedAPIMethods, WebhookHandlerOptions, WebhookHandlerOptionsShouldWait, WebhookHandlers };

package/dist/index.d.ts

@@ -980,6 +980,19 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
     command(command: MaybeArray<string>, handler: (context: ContextType<typeof this, "message"> & {
         args: string | null;
     }) => unknown): this;
+    /**
+     * Register handler to `start` command when start parameter is matched
+     *
+     * @example
+     * ```ts
+     * new Bot().startParameter(/^ref_(.+)$/, (context) => {
+     *     return context.send(`Reference: ${context.rawStartPayload}`);
+     * });
+     * ```
+     */
+    startParameter(parameter: RegExp | MaybeArray<string>, handler: Handler<ContextType<typeof this, "message"> & {
+        rawStartPayload: string;
+    }>): this;
     /** Currently not isolated!!! */
     group(grouped: (bot: typeof this) => AnyBot): typeof this;
     /**
@@ -1114,4 +1127,5 @@ 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 AllowedUpdates, type AnyBot, type AnyPlugin, Bot, type BotOptions, type BotStartOptions, type BotStartOptionsLongPolling, type BotStartOptionsWebhook, type CallbackQueryShorthandContext, Composer, type DeriveDefinitions, type ErrorDefinitions, ErrorKind, type FilterDefinitions, type Handler, Hooks, type MaybePromise, type MaybeSuppressedParams, type MaybeSuppressedReturn, Plugin, type PollingStartOptions, type Suppress, type SuppressedAPIMethodParams, type SuppressedAPIMethodReturn, type SuppressedAPIMethods, TelegramError, Updates, type WebhookHandlerOptions, type WebhookHandlerOptionsShouldWait, type WebhookHandlers, webhookHandler };
+export { Bot, Composer, ErrorKind, Hooks, Plugin, TelegramError, Updates, webhookHandler };
+export type { AllowedUpdates, AnyBot, AnyPlugin, BotOptions, BotStartOptions, BotStartOptionsLongPolling, BotStartOptionsWebhook, CallbackQueryShorthandContext, DeriveDefinitions, ErrorDefinitions, FilterDefinitions, Handler, MaybePromise, MaybeSuppressedParams, MaybeSuppressedReturn, PollingStartOptions, Suppress, SuppressedAPIMethodParams, SuppressedAPIMethodReturn, SuppressedAPIMethods, WebhookHandlerOptions, WebhookHandlerOptionsShouldWait, WebhookHandlers };

package/dist/index.js

@@ -51,17 +51,17 @@ class Composer {
   derive(updateNameOrHandler, handler) {
     if (typeof updateNameOrHandler === "function")
       this.use(async (context, next) => {
-        for (const [key, value] of Object.entries(
-          await updateNameOrHandler(context)
-        )) {
-          context[key] = value;
+        const assign = await updateNameOrHandler(context);
+        for (const key in assign) {
+          context[key] = assign[key];
         }
         return await next();
       });
     else if (handler)
       this.on(updateNameOrHandler, async (context, next) => {
-        for (const [key, value] of Object.entries(await handler(context))) {
-          context[key] = value;
+        const assign = await handler(context);
+        for (const key in assign) {
+          context[key] = assign[key];
         }
         return await next();
       });
@@ -1035,6 +1035,31 @@ class Bot {
       return next();
     });
   }
+  /**
+   * Register handler to `start` command when start parameter is matched
+   *
+   * @example
+   * ```ts
+   * new Bot().startParameter(/^ref_(.+)$/, (context) => {
+   *     return context.send(`Reference: ${context.rawStartPayload}`);
+   * });
+   * ```
+   */
+  startParameter(parameter, handler) {
+    return this.on("message", (context, next) => {
+      if (!context.rawStartPayload) return next();
+      if (parameter instanceof RegExp && parameter.test(context.rawStartPayload)) {
+        return handler(context);
+      }
+      if (Array.isArray(parameter) && parameter.includes(context.rawStartPayload)) {
+        return handler(context);
+      }
+      if (typeof parameter === "string" && parameter === context.rawStartPayload) {
+        return handler(context);
+      }
+      return next();
+    });
+  }
   /** Currently not isolated!!! */
   group(grouped) {
     return grouped(this);
@@ -1230,7 +1255,7 @@ function webhookHandler(bot, framework, secretTokenOrOptions) {
   const secretToken = typeof secretTokenOrOptions === "string" ? secretTokenOrOptions : secretTokenOrOptions?.secretToken;
   const shouldWaitOptions = typeof secretTokenOrOptions === "string" ? false : secretTokenOrOptions?.shouldWait;
   const isShouldWait = shouldWaitOptions && (typeof shouldWaitOptions === "object" || typeof shouldWaitOptions === "boolean");
-  return async (...args) => {
+  return (async (...args) => {
     const { update, response, header, unauthorized } = frameworkAdapter(
       ...args
     );
@@ -1249,7 +1274,7 @@ function webhookHandler(bot, framework, secretTokenOrOptions) {
       );
       if (response) return response();
     }
-  };
+  });
 }
 
 Symbol.metadata ??= Symbol("Symbol.metadata");

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "gramio",
 	"type": "module",
-	"version": "0.4.9",
+	"version": "0.4.11",
 	"description": "Powerful, extensible and really type-safe Telegram Bot API framework",
 	"main": "dist/index.cjs",
 	"module": "dist/index.js",
@@ -55,22 +55,24 @@
 	"author": "kravets",
 	"license": "MIT",
 	"devDependencies": {
-		"@biomejs/biome": "1.9.4",
-		"@types/bun": "^1.2.14",
+		"@biomejs/biome": "2.1.1",
+		"@types/bun": "^1.2.18",
 		"@types/debug": "^4.1.12",
-		"expect-type": "^1.2.1",
-		"pkgroll": "^2.12.2",
+		"expect-type": "^1.2.2",
+		"pkgroll": "^2.14.1",
 		"typescript": "^5.8.3"
 	},
 	"dependencies": {
 		"@gramio/callback-data": "^0.0.3",
-		"@gramio/contexts": "^0.2.5",
+		"@gramio/contexts": "^0.3.0",
 		"@gramio/files": "^0.3.0",
-		"@gramio/format": "^0.2.1",
+		"@gramio/format": "^0.3.3",
 		"@gramio/keyboards": "^1.2.1",
-		"@gramio/types": "^9.0.2",
+		"@gramio/types": "^9.1.3",
 		"debug": "^4.4.1",
 		"middleware-io": "^2.8.1"
 	},
-	"files": ["dist"]
+	"files": [
+		"dist"
+	]
 }