npm - gramio - Versions diffs - 0.8.3 → 0.10.0 - Mend

gramio 0.8.3 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.cjs CHANGED Viewed

@@ -34,7 +34,9 @@ const ALL_NAMES = [
   "chat_member",
   "chat_join_request",
   "chat_boost",
-  "removed_chat_boost"
+  "removed_chat_boost",
+  "managed_bot",
+  "guest_message"
 ];
 const MESSAGE_PARENT_TYPES = [
   "message",
@@ -203,7 +205,9 @@ const methods = composer.defineComposerMethods({
       return macroHandler ? macroHandler(context, composer.noopNext) : handler(context);
     });
   },
-  inlineQuery(trigger, handler, options = {}) {
+  inlineQuery(triggerOrHandler, maybeHandler, options = {}) {
+    const trigger = maybeHandler === void 0 ? (() => true) : triggerOrHandler;
+    const handler = maybeHandler ?? triggerOrHandler;
     if (options.onResult) this.chosenInlineResult(trigger, options.onResult);
     const { onResult: _, ...macroOptions } = options;
     const hasMacros = Object.keys(macroOptions).length > 0;
@@ -228,6 +232,32 @@ const methods = composer.defineComposerMethods({
       return macroHandler ? macroHandler(context, composer.noopNext) : handler(context);
     });
   },
+  guestQuery(triggerOrHandler, maybeHandler, macroOptions) {
+    const trigger = maybeHandler === void 0 ? (() => true) : triggerOrHandler;
+    const handler = maybeHandler ?? triggerOrHandler;
+    const macroHandler = macroOptions ? composer.buildFromOptions(this["~"].macros, macroOptions, handler) : null;
+    if (typeof trigger === "string") {
+      return this.on("guest_message", (context, next) => {
+        const text = context.text ?? context.caption;
+        if (text !== trigger) return next();
+        context.args = null;
+        return macroHandler ? macroHandler(context, composer.noopNext) : handler(context);
+      });
+    }
+    if (trigger instanceof RegExp) {
+      return this.on("guest_message", (context, next) => {
+        const text = context.text ?? context.caption;
+        if (!text || !trigger.test(text)) return next();
+        context.args = text.match(trigger);
+        return macroHandler ? macroHandler(context, composer.noopNext) : handler(context);
+      });
+    }
+    return this.on("guest_message", (context, next) => {
+      if (!trigger(context)) return next();
+      context.args = null;
+      return macroHandler ? macroHandler(context, composer.noopNext) : handler(context);
+    });
+  },
   hears(trigger, handler, macroOptions) {
     const macroHandler = macroOptions ? composer.buildFromOptions(this["~"].macros, macroOptions, handler) : null;
     if (typeof trigger === "string") {
@@ -1282,49 +1312,18 @@ class Bot {
     );
     return this;
   }
-  /**
-   * Register handler to `inline_query` update
-   *
-   * @example
-   * ```ts
-   * new Bot().inlineQuery(
-   *     /regular expression with (.*)/i,
-   *     async (context) => {
-   *         if (context.args) {
-   *             await context.answer(
-   *                 [
-   *                     InlineQueryResult.article(
-   *                         "id-1",
-   *                         context.args[1],
-   *                         InputMessageContent.text("some"),
-   *                         {
-   *                             reply_markup: new InlineKeyboard().text(
-   *                                 "some",
-   *                                 "callback-data"
-   *                             ),
-   *                         }
-   *                     ),
-   *                 ],
-   *                 {
-   *                     cache_time: 0,
-   *                 }
-   *             );
-   *         }
-   *     },
-   *     {
-   *         onResult: (context) => context.editText("Message edited!"),
-   *     }
-   * );
-   * ```
-   * */
-  inlineQuery(trigger, handler, options) {
+  inlineQuery(triggerOrHandler, handler, options) {
     this.updates.composer.inlineQuery(
-      trigger,
+      triggerOrHandler,
       handler,
       options
     );
     return this;
   }
+  guestQuery(triggerOrHandler, handler, options) {
+    this.updates.composer.guestQuery(triggerOrHandler, handler, options);
+    return this;
+  }
   /**
    * Register handler to `message` and `business_message` event
    *

package/dist/index.d.cts CHANGED Viewed

@@ -187,13 +187,20 @@ declare const methods: {
     chosenInlineResult<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | string | ((context: Ctx<"chosen_inline_result">) => boolean), handler: (context: Ctx<"chosen_inline_result"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "chosen_inline_result">) => unknown, macroOptions?: Record<string, unknown>): TThis;
-    inlineQuery<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | string | ((context: Ctx<"inline_query">) => boolean), handler: (context: Ctx<"inline_query"> & {
+    inlineQuery<TThis extends GramIOLike<TThis>>(this: TThis, triggerOrHandler: RegExp | string | ((context: Ctx<"inline_query">) => boolean) | ((context: Ctx<"inline_query"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "inline_query">) => unknown), maybeHandler?: (context: Ctx<"inline_query"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "inline_query">) => unknown, options?: {
         onResult?: (context: Ctx<"chosen_inline_result"> & {
             args: RegExpMatchArray | null;
         } & EventContextOf<TThis, "chosen_inline_result">) => unknown;
     } & Record<string, unknown>): TThis;
+    guestQuery<TThis extends GramIOLike<TThis>>(this: TThis, triggerOrHandler: RegExp | string | ((context: Ctx<"guest_message">) => boolean) | ((context: Ctx<"guest_message"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "guest_message">) => unknown), maybeHandler?: (context: Ctx<"guest_message"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "guest_message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
     hears<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | MaybeArray<string> | ((context: Ctx<"message">) => boolean), handler: (context: Ctx<"message"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
@@ -216,6 +223,7 @@ declare module "@gramio/composer" {
         hears: (typeof methods)["hears"];
         reaction: (typeof methods)["reaction"];
         inlineQuery: (typeof methods)["inlineQuery"];
+        guestQuery: (typeof methods)["guestQuery"];
         chosenInlineResult: (typeof methods)["chosenInlineResult"];
         startParameter: (typeof methods)["startParameter"];
     }
@@ -228,13 +236,20 @@ declare const Composer: _gramio_composer.EventComposerConstructor<Context<AnyBot
     chosenInlineResult<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | string | ((context: Ctx<"chosen_inline_result">) => boolean), handler: (context: Ctx<"chosen_inline_result"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "chosen_inline_result">) => unknown, macroOptions?: Record<string, unknown>): TThis;
-    inlineQuery<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | string | ((context: Ctx<"inline_query">) => boolean), handler: (context: Ctx<"inline_query"> & {
+    inlineQuery<TThis extends GramIOLike<TThis>>(this: TThis, triggerOrHandler: RegExp | string | ((context: Ctx<"inline_query">) => boolean) | ((context: Ctx<"inline_query"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "inline_query">) => unknown), maybeHandler?: (context: Ctx<"inline_query"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "inline_query">) => unknown, options?: {
         onResult?: (context: Ctx<"chosen_inline_result"> & {
             args: RegExpMatchArray | null;
         } & EventContextOf<TThis, "chosen_inline_result">) => unknown;
     } & Record<string, unknown>): TThis;
+    guestQuery<TThis extends GramIOLike<TThis>>(this: TThis, triggerOrHandler: RegExp | string | ((context: Ctx<"guest_message">) => boolean) | ((context: Ctx<"guest_message"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "guest_message">) => unknown), maybeHandler?: (context: Ctx<"guest_message"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "guest_message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
     hears<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | MaybeArray<string> | ((context: Ctx<"message">) => boolean), handler: (context: Ctx<"message"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
@@ -316,6 +331,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
             invoice: _gramio_contexts.InvoiceContext<AnyBot>;
             left_chat_member: _gramio_contexts.LeftChatMemberContext<AnyBot>;
             location: _gramio_contexts.LocationContext<AnyBot>;
+            managed_bot: _gramio_contexts.ManagedBotContext<AnyBot>;
+            managed_bot_created: _gramio_contexts.ManagedBotCreatedContext<AnyBot>;
             message_auto_delete_timer_changed: _gramio_contexts.MessageAutoDeleteTimerChangedContext<AnyBot>;
             message: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
             channel_post: _gramio_contexts.MessageContext<AnyBot>;
@@ -323,6 +340,7 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
             edited_channel_post: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
             business_message: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
             edited_business_message: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
+            guest_message: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
             deleted_business_messages: _gramio_contexts.BusinessMessagesDeletedContext<AnyBot>;
             business_connection: _gramio_contexts.BusinessConnectionContext<AnyBot>;
             migrate_from_chat_id: _gramio_contexts.MigrateFromChatIdContext<AnyBot>;
@@ -333,6 +351,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
             passport_data: _gramio_contexts.PassportDataContext<AnyBot>;
             pinned_message: _gramio_contexts.PinnedMessageContext<AnyBot>;
             poll_answer: _gramio_contexts.PollAnswerContext<AnyBot>;
+            poll_option_added: _gramio_contexts.PollOptionAddedContext<AnyBot>;
+            poll_option_deleted: _gramio_contexts.PollOptionDeletedContext<AnyBot>;
             poll: _gramio_contexts.PollContext<AnyBot>;
             pre_checkout_query: _gramio_contexts.PreCheckoutQueryContext<AnyBot>;
             proximity_alert_triggered: _gramio_contexts.ProximityAlertTriggeredContext<AnyBot>;
@@ -414,13 +434,27 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
                     Derives?: Record<string, object>;
                 };
                 chosenInlineResult(trigger: any, handler: any, macroOptions?: any): TThis;
-            }>(this: TThis, trigger: RegExp | string | ((context: _gramio_contexts.InlineQueryContext<AnyBot>) => boolean), handler: (context: _gramio_contexts.InlineQueryContext<AnyBot> & {
+            }>(this: TThis, triggerOrHandler: RegExp | string | ((context: _gramio_contexts.InlineQueryContext<AnyBot>) => boolean) | ((context: _gramio_contexts.InlineQueryContext<AnyBot> & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "inline_query">) => unknown), maybeHandler?: (context: _gramio_contexts.InlineQueryContext<AnyBot> & {
                 args: RegExpMatchArray | null;
             } & _gramio_composer.EventContextOf<TThis, "inline_query">) => unknown, options?: {
                 onResult?: (context: _gramio_contexts.ChosenInlineResultContext<AnyBot> & {
                     args: RegExpMatchArray | null;
                 } & _gramio_composer.EventContextOf<TThis, "chosen_inline_result">) => unknown;
             } & Record<string, unknown>): TThis;
+            guestQuery<TThis extends _gramio_composer.ComposerLike<TThis> & {
+                "~": {
+                    macros: MacroDefinitions;
+                    commandsMeta?: Map<string, unknown>;
+                    Derives?: Record<string, object>;
+                };
+                chosenInlineResult(trigger: any, handler: any, macroOptions?: any): TThis;
+            }>(this: TThis, triggerOrHandler: RegExp | string | ((context: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) => boolean) | ((context: (_gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "guest_message">) => unknown), maybeHandler?: (context: (_gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "guest_message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
             hears<TThis extends _gramio_composer.ComposerLike<TThis> & {
                 "~": {
                     macros: MacroDefinitions;
@@ -489,13 +523,27 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
                     Derives?: Record<string, object>;
                 };
                 chosenInlineResult(trigger: any, handler: any, macroOptions?: any): TThis;
-            }>(this: TThis, trigger: RegExp | string | ((context: _gramio_contexts.InlineQueryContext<AnyBot>) => boolean), handler: (context: _gramio_contexts.InlineQueryContext<AnyBot> & {
+            }>(this: TThis, triggerOrHandler: RegExp | string | ((context: _gramio_contexts.InlineQueryContext<AnyBot>) => boolean) | ((context: _gramio_contexts.InlineQueryContext<AnyBot> & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "inline_query">) => unknown), maybeHandler?: (context: _gramio_contexts.InlineQueryContext<AnyBot> & {
                 args: RegExpMatchArray | null;
             } & _gramio_composer.EventContextOf<TThis, "inline_query">) => unknown, options?: {
                 onResult?: (context: _gramio_contexts.ChosenInlineResultContext<AnyBot> & {
                     args: RegExpMatchArray | null;
                 } & _gramio_composer.EventContextOf<TThis, "chosen_inline_result">) => unknown;
             } & Record<string, unknown>): TThis;
+            guestQuery<TThis extends _gramio_composer.ComposerLike<TThis> & {
+                "~": {
+                    macros: MacroDefinitions;
+                    commandsMeta?: Map<string, unknown>;
+                    Derives?: Record<string, object>;
+                };
+                chosenInlineResult(trigger: any, handler: any, macroOptions?: any): TThis;
+            }>(this: TThis, triggerOrHandler: RegExp | string | ((context: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) => boolean) | ((context: (_gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "guest_message">) => unknown), maybeHandler?: (context: (_gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "guest_message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
             hears<TThis extends _gramio_composer.ComposerLike<TThis> & {
                 "~": {
                     macros: MacroDefinitions;
@@ -746,6 +794,8 @@ interface Plugin<Errors, Derives, Macros> {
     reaction: (typeof methods)["reaction"];
     /** Register inline query handler */
     inlineQuery: (typeof methods)["inlineQuery"];
+    /** Register guest query (`guest_message`) handler */
+    guestQuery: (typeof methods)["guestQuery"];
     /** Register chosen inline result handler */
     chosenInlineResult: (typeof methods)["chosenInlineResult"];
     /** Register deep-link parameter handler */
@@ -1513,6 +1563,9 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
      * );
      * ```
      * */
+    inlineQuery<Ctx = ContextType<typeof this, "inline_query">>(handler: (context: Ctx & {
+        args: RegExpMatchArray | null;
+    }) => unknown): this;
     inlineQuery<Ctx = ContextType<typeof this, "inline_query">>(trigger: RegExp | string | ((context: Ctx) => boolean), handler: (context: Ctx & {
         args: RegExpMatchArray | null;
     }) => unknown, options?: HandlerOptions<Ctx, Macros> & {
@@ -1520,6 +1573,34 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
             args: RegExpMatchArray | null;
         }) => unknown;
     }): this;
+    /**
+     * Register handler to `guest_message` update — a message sent to the bot
+     * from a chat where the bot is not a member, via a guest query.
+     *
+     * Reply with {@link MessageContext.answerGuestQuery `context.answerGuestQuery()`}
+     * (NOT `context.send`/`context.reply`, which target a chat the bot can't post to).
+     *
+     * @example
+     * ```ts
+     * new Bot().guestQuery(/^find (.*)/i, async (context) => {
+     *     await context.answerGuestQuery({
+     *         type: "text",
+     *         text: `Looking up ${context.args?.[1]}…`,
+     *     });
+     * });
+     *
+     * // No-trigger form — match any guest message:
+     * new Bot().guestQuery(async (context) => {
+     *     await context.answerGuestQuery({ type: "text", text: "Hi!" });
+     * });
+     * ```
+     * */
+    guestQuery<Ctx = ContextType<typeof this, "guest_message">>(handler: (context: Ctx & {
+        args: RegExpMatchArray | null;
+    }) => unknown): this;
+    guestQuery<Ctx = ContextType<typeof this, "guest_message">>(trigger: RegExp | string | ((context: Ctx) => boolean), handler: (context: Ctx & {
+        args: RegExpMatchArray | null;
+    }) => unknown, options?: HandlerOptions<Ctx, Macros>): this;
     /**
      * Register handler to `message` and `business_message` event
      *
@@ -1992,7 +2073,7 @@ interface WebhookHandlerOptions {
  * });
  * ```
  */
-declare function webhookHandler<Framework extends keyof typeof frameworks>(bot: Bot, framework: Framework, secretTokenOrOptions?: string | WebhookHandlerOptions): ReturnType<(typeof frameworks)[Framework]> extends {
+declare function webhookHandler<Framework extends keyof typeof frameworks>(bot: AnyBot, framework: Framework, secretTokenOrOptions?: string | WebhookHandlerOptions): ReturnType<(typeof frameworks)[Framework]> extends {
     response: () => any;
 } ? (...args: Parameters<(typeof frameworks)[Framework]>) => ReturnType<ReturnType<(typeof frameworks)[Framework]>["response"]> : (...args: Parameters<(typeof frameworks)[Framework]>) => void;

package/dist/index.d.ts CHANGED Viewed

@@ -187,13 +187,20 @@ declare const methods: {
     chosenInlineResult<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | string | ((context: Ctx<"chosen_inline_result">) => boolean), handler: (context: Ctx<"chosen_inline_result"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "chosen_inline_result">) => unknown, macroOptions?: Record<string, unknown>): TThis;
-    inlineQuery<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | string | ((context: Ctx<"inline_query">) => boolean), handler: (context: Ctx<"inline_query"> & {
+    inlineQuery<TThis extends GramIOLike<TThis>>(this: TThis, triggerOrHandler: RegExp | string | ((context: Ctx<"inline_query">) => boolean) | ((context: Ctx<"inline_query"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "inline_query">) => unknown), maybeHandler?: (context: Ctx<"inline_query"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "inline_query">) => unknown, options?: {
         onResult?: (context: Ctx<"chosen_inline_result"> & {
             args: RegExpMatchArray | null;
         } & EventContextOf<TThis, "chosen_inline_result">) => unknown;
     } & Record<string, unknown>): TThis;
+    guestQuery<TThis extends GramIOLike<TThis>>(this: TThis, triggerOrHandler: RegExp | string | ((context: Ctx<"guest_message">) => boolean) | ((context: Ctx<"guest_message"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "guest_message">) => unknown), maybeHandler?: (context: Ctx<"guest_message"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "guest_message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
     hears<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | MaybeArray<string> | ((context: Ctx<"message">) => boolean), handler: (context: Ctx<"message"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
@@ -216,6 +223,7 @@ declare module "@gramio/composer" {
         hears: (typeof methods)["hears"];
         reaction: (typeof methods)["reaction"];
         inlineQuery: (typeof methods)["inlineQuery"];
+        guestQuery: (typeof methods)["guestQuery"];
         chosenInlineResult: (typeof methods)["chosenInlineResult"];
         startParameter: (typeof methods)["startParameter"];
     }
@@ -228,13 +236,20 @@ declare const Composer: _gramio_composer.EventComposerConstructor<Context<AnyBot
     chosenInlineResult<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | string | ((context: Ctx<"chosen_inline_result">) => boolean), handler: (context: Ctx<"chosen_inline_result"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "chosen_inline_result">) => unknown, macroOptions?: Record<string, unknown>): TThis;
-    inlineQuery<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | string | ((context: Ctx<"inline_query">) => boolean), handler: (context: Ctx<"inline_query"> & {
+    inlineQuery<TThis extends GramIOLike<TThis>>(this: TThis, triggerOrHandler: RegExp | string | ((context: Ctx<"inline_query">) => boolean) | ((context: Ctx<"inline_query"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "inline_query">) => unknown), maybeHandler?: (context: Ctx<"inline_query"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "inline_query">) => unknown, options?: {
         onResult?: (context: Ctx<"chosen_inline_result"> & {
             args: RegExpMatchArray | null;
         } & EventContextOf<TThis, "chosen_inline_result">) => unknown;
     } & Record<string, unknown>): TThis;
+    guestQuery<TThis extends GramIOLike<TThis>>(this: TThis, triggerOrHandler: RegExp | string | ((context: Ctx<"guest_message">) => boolean) | ((context: Ctx<"guest_message"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "guest_message">) => unknown), maybeHandler?: (context: Ctx<"guest_message"> & {
+        args: RegExpMatchArray | null;
+    } & EventContextOf<TThis, "guest_message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
     hears<TThis extends GramIOLike<TThis>>(this: TThis, trigger: RegExp | MaybeArray<string> | ((context: Ctx<"message">) => boolean), handler: (context: Ctx<"message"> & {
         args: RegExpMatchArray | null;
     } & EventContextOf<TThis, "message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
@@ -316,6 +331,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
             invoice: _gramio_contexts.InvoiceContext<AnyBot>;
             left_chat_member: _gramio_contexts.LeftChatMemberContext<AnyBot>;
             location: _gramio_contexts.LocationContext<AnyBot>;
+            managed_bot: _gramio_contexts.ManagedBotContext<AnyBot>;
+            managed_bot_created: _gramio_contexts.ManagedBotCreatedContext<AnyBot>;
             message_auto_delete_timer_changed: _gramio_contexts.MessageAutoDeleteTimerChangedContext<AnyBot>;
             message: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
             channel_post: _gramio_contexts.MessageContext<AnyBot>;
@@ -323,6 +340,7 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
             edited_channel_post: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
             business_message: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
             edited_business_message: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
+            guest_message: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">;
             deleted_business_messages: _gramio_contexts.BusinessMessagesDeletedContext<AnyBot>;
             business_connection: _gramio_contexts.BusinessConnectionContext<AnyBot>;
             migrate_from_chat_id: _gramio_contexts.MigrateFromChatIdContext<AnyBot>;
@@ -333,6 +351,8 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
             passport_data: _gramio_contexts.PassportDataContext<AnyBot>;
             pinned_message: _gramio_contexts.PinnedMessageContext<AnyBot>;
             poll_answer: _gramio_contexts.PollAnswerContext<AnyBot>;
+            poll_option_added: _gramio_contexts.PollOptionAddedContext<AnyBot>;
+            poll_option_deleted: _gramio_contexts.PollOptionDeletedContext<AnyBot>;
             poll: _gramio_contexts.PollContext<AnyBot>;
             pre_checkout_query: _gramio_contexts.PreCheckoutQueryContext<AnyBot>;
             proximity_alert_triggered: _gramio_contexts.ProximityAlertTriggeredContext<AnyBot>;
@@ -414,13 +434,27 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
                     Derives?: Record<string, object>;
                 };
                 chosenInlineResult(trigger: any, handler: any, macroOptions?: any): TThis;
-            }>(this: TThis, trigger: RegExp | string | ((context: _gramio_contexts.InlineQueryContext<AnyBot>) => boolean), handler: (context: _gramio_contexts.InlineQueryContext<AnyBot> & {
+            }>(this: TThis, triggerOrHandler: RegExp | string | ((context: _gramio_contexts.InlineQueryContext<AnyBot>) => boolean) | ((context: _gramio_contexts.InlineQueryContext<AnyBot> & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "inline_query">) => unknown), maybeHandler?: (context: _gramio_contexts.InlineQueryContext<AnyBot> & {
                 args: RegExpMatchArray | null;
             } & _gramio_composer.EventContextOf<TThis, "inline_query">) => unknown, options?: {
                 onResult?: (context: _gramio_contexts.ChosenInlineResultContext<AnyBot> & {
                     args: RegExpMatchArray | null;
                 } & _gramio_composer.EventContextOf<TThis, "chosen_inline_result">) => unknown;
             } & Record<string, unknown>): TThis;
+            guestQuery<TThis extends _gramio_composer.ComposerLike<TThis> & {
+                "~": {
+                    macros: MacroDefinitions;
+                    commandsMeta?: Map<string, unknown>;
+                    Derives?: Record<string, object>;
+                };
+                chosenInlineResult(trigger: any, handler: any, macroOptions?: any): TThis;
+            }>(this: TThis, triggerOrHandler: RegExp | string | ((context: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) => boolean) | ((context: (_gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "guest_message">) => unknown), maybeHandler?: (context: (_gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "guest_message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
             hears<TThis extends _gramio_composer.ComposerLike<TThis> & {
                 "~": {
                     macros: MacroDefinitions;
@@ -489,13 +523,27 @@ declare class Plugin<Errors extends ErrorDefinitions = {}, Derives extends Deriv
                     Derives?: Record<string, object>;
                 };
                 chosenInlineResult(trigger: any, handler: any, macroOptions?: any): TThis;
-            }>(this: TThis, trigger: RegExp | string | ((context: _gramio_contexts.InlineQueryContext<AnyBot>) => boolean), handler: (context: _gramio_contexts.InlineQueryContext<AnyBot> & {
+            }>(this: TThis, triggerOrHandler: RegExp | string | ((context: _gramio_contexts.InlineQueryContext<AnyBot>) => boolean) | ((context: _gramio_contexts.InlineQueryContext<AnyBot> & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "inline_query">) => unknown), maybeHandler?: (context: _gramio_contexts.InlineQueryContext<AnyBot> & {
                 args: RegExpMatchArray | null;
             } & _gramio_composer.EventContextOf<TThis, "inline_query">) => unknown, options?: {
                 onResult?: (context: _gramio_contexts.ChosenInlineResultContext<AnyBot> & {
                     args: RegExpMatchArray | null;
                 } & _gramio_composer.EventContextOf<TThis, "chosen_inline_result">) => unknown;
             } & Record<string, unknown>): TThis;
+            guestQuery<TThis extends _gramio_composer.ComposerLike<TThis> & {
+                "~": {
+                    macros: MacroDefinitions;
+                    commandsMeta?: Map<string, unknown>;
+                    Derives?: Record<string, object>;
+                };
+                chosenInlineResult(trigger: any, handler: any, macroOptions?: any): TThis;
+            }>(this: TThis, triggerOrHandler: RegExp | string | ((context: _gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) => boolean) | ((context: (_gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "guest_message">) => unknown), maybeHandler?: (context: (_gramio_contexts.MessageContext<AnyBot> & _gramio_contexts.Require<_gramio_contexts.MessageContext<AnyBot>, "from">) & {
+                args: RegExpMatchArray | null;
+            } & _gramio_composer.EventContextOf<TThis, "guest_message">) => unknown, macroOptions?: Record<string, unknown>): TThis;
             hears<TThis extends _gramio_composer.ComposerLike<TThis> & {
                 "~": {
                     macros: MacroDefinitions;
@@ -746,6 +794,8 @@ interface Plugin<Errors, Derives, Macros> {
     reaction: (typeof methods)["reaction"];
     /** Register inline query handler */
     inlineQuery: (typeof methods)["inlineQuery"];
+    /** Register guest query (`guest_message`) handler */
+    guestQuery: (typeof methods)["guestQuery"];
     /** Register chosen inline result handler */
     chosenInlineResult: (typeof methods)["chosenInlineResult"];
     /** Register deep-link parameter handler */
@@ -1513,6 +1563,9 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
      * );
      * ```
      * */
+    inlineQuery<Ctx = ContextType<typeof this, "inline_query">>(handler: (context: Ctx & {
+        args: RegExpMatchArray | null;
+    }) => unknown): this;
     inlineQuery<Ctx = ContextType<typeof this, "inline_query">>(trigger: RegExp | string | ((context: Ctx) => boolean), handler: (context: Ctx & {
         args: RegExpMatchArray | null;
     }) => unknown, options?: HandlerOptions<Ctx, Macros> & {
@@ -1520,6 +1573,34 @@ declare class Bot<Errors extends ErrorDefinitions = {}, Derives extends DeriveDe
             args: RegExpMatchArray | null;
         }) => unknown;
     }): this;
+    /**
+     * Register handler to `guest_message` update — a message sent to the bot
+     * from a chat where the bot is not a member, via a guest query.
+     *
+     * Reply with {@link MessageContext.answerGuestQuery `context.answerGuestQuery()`}
+     * (NOT `context.send`/`context.reply`, which target a chat the bot can't post to).
+     *
+     * @example
+     * ```ts
+     * new Bot().guestQuery(/^find (.*)/i, async (context) => {
+     *     await context.answerGuestQuery({
+     *         type: "text",
+     *         text: `Looking up ${context.args?.[1]}…`,
+     *     });
+     * });
+     *
+     * // No-trigger form — match any guest message:
+     * new Bot().guestQuery(async (context) => {
+     *     await context.answerGuestQuery({ type: "text", text: "Hi!" });
+     * });
+     * ```
+     * */
+    guestQuery<Ctx = ContextType<typeof this, "guest_message">>(handler: (context: Ctx & {
+        args: RegExpMatchArray | null;
+    }) => unknown): this;
+    guestQuery<Ctx = ContextType<typeof this, "guest_message">>(trigger: RegExp | string | ((context: Ctx) => boolean), handler: (context: Ctx & {
+        args: RegExpMatchArray | null;
+    }) => unknown, options?: HandlerOptions<Ctx, Macros>): this;
     /**
      * Register handler to `message` and `business_message` event
      *
@@ -1992,7 +2073,7 @@ interface WebhookHandlerOptions {
  * });
  * ```
  */
-declare function webhookHandler<Framework extends keyof typeof frameworks>(bot: Bot, framework: Framework, secretTokenOrOptions?: string | WebhookHandlerOptions): ReturnType<(typeof frameworks)[Framework]> extends {
+declare function webhookHandler<Framework extends keyof typeof frameworks>(bot: AnyBot, framework: Framework, secretTokenOrOptions?: string | WebhookHandlerOptions): ReturnType<(typeof frameworks)[Framework]> extends {
     response: () => any;
 } ? (...args: Parameters<(typeof frameworks)[Framework]>) => ReturnType<ReturnType<(typeof frameworks)[Framework]>["response"]> : (...args: Parameters<(typeof frameworks)[Framework]>) => void;

package/dist/index.js CHANGED Viewed

@@ -36,7 +36,9 @@ const ALL_NAMES = [
   "chat_member",
   "chat_join_request",
   "chat_boost",
-  "removed_chat_boost"
+  "removed_chat_boost",
+  "managed_bot",
+  "guest_message"
 ];
 const MESSAGE_PARENT_TYPES = [
   "message",
@@ -205,7 +207,9 @@ const methods = defineComposerMethods({
       return macroHandler ? macroHandler(context, noopNext) : handler(context);
     });
   },
-  inlineQuery(trigger, handler, options = {}) {
+  inlineQuery(triggerOrHandler, maybeHandler, options = {}) {
+    const trigger = maybeHandler === void 0 ? (() => true) : triggerOrHandler;
+    const handler = maybeHandler ?? triggerOrHandler;
     if (options.onResult) this.chosenInlineResult(trigger, options.onResult);
     const { onResult: _, ...macroOptions } = options;
     const hasMacros = Object.keys(macroOptions).length > 0;
@@ -230,6 +234,32 @@ const methods = defineComposerMethods({
       return macroHandler ? macroHandler(context, noopNext) : handler(context);
     });
   },
+  guestQuery(triggerOrHandler, maybeHandler, macroOptions) {
+    const trigger = maybeHandler === void 0 ? (() => true) : triggerOrHandler;
+    const handler = maybeHandler ?? triggerOrHandler;
+    const macroHandler = macroOptions ? buildFromOptions(this["~"].macros, macroOptions, handler) : null;
+    if (typeof trigger === "string") {
+      return this.on("guest_message", (context, next) => {
+        const text = context.text ?? context.caption;
+        if (text !== trigger) return next();
+        context.args = null;
+        return macroHandler ? macroHandler(context, noopNext) : handler(context);
+      });
+    }
+    if (trigger instanceof RegExp) {
+      return this.on("guest_message", (context, next) => {
+        const text = context.text ?? context.caption;
+        if (!text || !trigger.test(text)) return next();
+        context.args = text.match(trigger);
+        return macroHandler ? macroHandler(context, noopNext) : handler(context);
+      });
+    }
+    return this.on("guest_message", (context, next) => {
+      if (!trigger(context)) return next();
+      context.args = null;
+      return macroHandler ? macroHandler(context, noopNext) : handler(context);
+    });
+  },
   hears(trigger, handler, macroOptions) {
     const macroHandler = macroOptions ? buildFromOptions(this["~"].macros, macroOptions, handler) : null;
     if (typeof trigger === "string") {
@@ -1284,49 +1314,18 @@ class Bot {
     );
     return this;
   }
-  /**
-   * Register handler to `inline_query` update
-   *
-   * @example
-   * ```ts
-   * new Bot().inlineQuery(
-   *     /regular expression with (.*)/i,
-   *     async (context) => {
-   *         if (context.args) {
-   *             await context.answer(
-   *                 [
-   *                     InlineQueryResult.article(
-   *                         "id-1",
-   *                         context.args[1],
-   *                         InputMessageContent.text("some"),
-   *                         {
-   *                             reply_markup: new InlineKeyboard().text(
-   *                                 "some",
-   *                                 "callback-data"
-   *                             ),
-   *                         }
-   *                     ),
-   *                 ],
-   *                 {
-   *                     cache_time: 0,
-   *                 }
-   *             );
-   *         }
-   *     },
-   *     {
-   *         onResult: (context) => context.editText("Message edited!"),
-   *     }
-   * );
-   * ```
-   * */
-  inlineQuery(trigger, handler, options) {
+  inlineQuery(triggerOrHandler, handler, options) {
     this.updates.composer.inlineQuery(
-      trigger,
+      triggerOrHandler,
       handler,
       options
     );
     return this;
   }
+  guestQuery(triggerOrHandler, handler, options) {
+    this.updates.composer.guestQuery(triggerOrHandler, handler, options);
+    return this;
+  }
   /**
    * Register handler to `message` and `business_message` event
    *

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
 	"name": "gramio",
 	"type": "module",
-	"version": "0.8.3",
+	"version": "0.10.0",
 	"description": "Powerful, extensible and really type-safe Telegram Bot API framework",
 	"main": "dist/index.cjs",
 	"module": "dist/index.js",
@@ -55,25 +55,28 @@
 	"author": "kravets",
 	"license": "MIT",
 	"devDependencies": {
-		"@biomejs/biome": "2.4.4",
-		"@gramio/test": "^0.3.1",
-		"@types/bun": "^1.3.9",
-		"@types/debug": "^4.1.12",
+		"@biomejs/biome": "2.4.14",
+		"@gramio/test": "^0.7.0",
+		"@types/bun": "^1.3.13",
+		"@types/debug": "^4.1.13",
 		"expect-type": "^1.3.0",
 		"pkgroll": "^2.27.0",
 		"typescript": "^5.9.3"
 	},
 	"dependencies": {
 		"@gramio/callback-data": "^0.1.0",
-		"@gramio/composer": "0.4.1",
-		"@gramio/contexts": "0.5.1",
-		"@gramio/files": "^0.3.2",
-		"@gramio/format": "^0.5.0",
-		"@gramio/keyboards": "^1.3.1",
-		"@gramio/types": "^9.5.0",
+		"@gramio/composer": "^0.4.1",
+		"@gramio/contexts": "^0.7.0",
+		"@gramio/files": "^0.5.0",
+		"@gramio/format": "^0.8.0",
+		"@gramio/keyboards": "^1.4.0",
+		"@gramio/types": "^10.0.0",
 		"debug": "^4.4.3"
 	},
 	"files": [
 		"dist"
-	]
+	],
+	"overrides": {
+		"@gramio/types": "$@gramio/types"
+	}
 }