grammy 1.39.2 → 1.40.0

package/README.md

@@ -10,7 +10,7 @@
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-9.3-blue?logo=telegram&style=flat&labelColor=000&color=3b82f6)](https://core.telegram.org/bots/api)
+[![Bot API](https://img.shields.io/badge/Bot%20API-9.4-blue?logo=telegram&style=flat&labelColor=000&color=3b82f6)](https://core.telegram.org/bots/api)
 [![Deno](https://shield.deno.dev/x/grammy)](https://deno.land/x/grammy)
 [![npm](https://img.shields.io/npm/v/grammy?logo=npm&style=flat&labelColor=000&color=3b82f6)](https://www.npmjs.org/package/grammy)
 [![All Contributors](https://img.shields.io/github/all-contributors/grammyjs/grammy?style=flat&labelColor=000&color=3b82f6)](#contributors-)
@@ -332,6 +332,8 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/OfficialCodinary"><img src="https://avatars.githubusercontent.com/u/133005277?v=4?s=100" width="100px;" alt="Codinary"/><br /><sub><b>Codinary</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3AOfficialCodinary" title="Reviewed Pull Requests">👀</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/dotvhs"><img src="https://avatars.githubusercontent.com/u/681416?v=4?s=100" width="100px;" alt=".vhs"/><br /><sub><b>.vhs</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Adotvhs" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Adotvhs" title="Reviewed Pull Requests">👀</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://agou.im/"><img src="https://avatars.githubusercontent.com/u/55237525?v=4?s=100" width="100px;" alt="agoudbg"/><br /><sub><b>agoudbg</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Aagoudbg" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/commits?author=agoudbg" title="Code">💻</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/arunr-inji"><img src="https://avatars.githubusercontent.com/u/5071242?v=4?s=100" width="100px;" alt="ArunR"/><br /><sub><b>ArunR</b></sub></a><br /><a href="#ideas-arunr-inji" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/grammyjs/grammY/commits?author=arunr-inji" title="Code">💻</a> <a href="https://github.com/grammyjs/grammY/commits?author=arunr-inji" title="Tests">⚠️</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="https://github.com/crwnd"><img src="https://avatars.githubusercontent.com/u/97118277?v=4?s=100" width="100px;" alt="A"/><br /><sub><b>A</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/issues?q=author%3Acrwnd" title="Bug reports">🐛</a> <a href="https://github.com/grammyjs/grammY/pulls?q=is%3Apr+reviewed-by%3Acrwnd" title="Reviewed Pull Requests">👀</a></td>
     </tr>
   </tbody>
 </table>

package/out/context.d.ts

@@ -745,13 +745,21 @@ export declare class Context implements RenamedUpdate {
     /**
      * Context-aware alias for `api.getUserProfilePhotos`. Use this method to get a list of profile pictures for a user. Returns a UserProfilePhotos object.
      *
-     * @param user_id Unique identifier of the target user
      * @param other Optional remaining parameters, confer the official reference below
      * @param signal Optional `AbortSignal` to cancel the request
      *
      * **Official reference:** https://core.telegram.org/bots/api#getuserprofilephotos
      */
     getUserProfilePhotos(other?: Other<"getUserProfilePhotos", "user_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").UserProfilePhotos>;
+    /**
+     * Context-aware alias for `api.getUserProfileAudios`. Use this method to get a list of profile audios for a user. Returns a UserProfileAudios object.
+     *
+     * @param other Optional remaining parameters, confer the official reference below
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#getuserprofileaudios
+     */
+    getUserProfileAudios(other?: Other<"getUserProfileAudios", "user_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/manage.js").UserProfileAudios>;
     /**
      * Context-aware alias for `api.serUserEmojiStatus`. Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess. Returns True on success.
      *
@@ -1152,7 +1160,7 @@ export declare class Context implements RenamedUpdate {
      */
     deleteChatStickerSet(signal?: AbortSignal): Promise<true>;
     /**
-     * Context-aware alias for `api.createForumTopic`. Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns information about the created topic as a ForumTopic object.
+     * Context-aware alias for `api.createForumTopic`. Use this method to create a topic in a forum supergroup chat or a private chat with a user. In the case of a supergroup chat the bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator right. Returns information about the created topic as a ForumTopic object.
      *
      * @param name Topic name, 1-128 characters
      * @param other Optional remaining parameters, confer the official reference below
@@ -1565,7 +1573,7 @@ export declare class Context implements RenamedUpdate {
      *
      * **Official reference:** https://core.telegram.org/bots/api#sendgift
      */
-    replyWithGift(gift_id: string, other?: Other<"sendGift", "user_id" | "chat_id" | "gift_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/payment.js").Gifts>;
+    replyWithGift(gift_id: string, other?: Other<"sendGift", "user_id" | "chat_id" | "gift_id">, signal?: AbortSignal): Promise<true>;
     /**
      * Context-aware alias for `api.giftPremiumSubscription`. Gifts a Telegram Premium subscription to the given user. Returns True on success.
      *
@@ -1586,7 +1594,7 @@ export declare class Context implements RenamedUpdate {
      *
      * **Official reference:** https://core.telegram.org/bots/api#sendgift
      */
-    replyWithGiftToChannel(gift_id: string, other?: Other<"sendGift", "user_id" | "chat_id" | "gift_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/payment.js").Gifts>;
+    replyWithGiftToChannel(gift_id: string, other?: Other<"sendGift", "user_id" | "chat_id" | "gift_id">, signal?: AbortSignal): Promise<true>;
     /**
      * Context-aware alias for `api.answerInlineQuery`. Use this method to send answers to an inline query. On success, True is returned.
      * No more than 50 results per query are allowed.

package/out/context.js

@@ -1165,7 +1165,6 @@ class Context {
     /**
      * Context-aware alias for `api.getUserProfilePhotos`. Use this method to get a list of profile pictures for a user. Returns a UserProfilePhotos object.
      *
-     * @param user_id Unique identifier of the target user
      * @param other Optional remaining parameters, confer the official reference below
      * @param signal Optional `AbortSignal` to cancel the request
      *
@@ -1174,6 +1173,17 @@ class Context {
     getUserProfilePhotos(other, signal) {
         return this.api.getUserProfilePhotos(orThrow(this.from, "getUserProfilePhotos").id, other, signal);
     }
+    /**
+     * Context-aware alias for `api.getUserProfileAudios`. Use this method to get a list of profile audios for a user. Returns a UserProfileAudios object.
+     *
+     * @param other Optional remaining parameters, confer the official reference below
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#getuserprofileaudios
+     */
+    getUserProfileAudios(other, signal) {
+        return this.api.getUserProfileAudios(orThrow(this.from, "getUserProfileAudios").id, other, signal);
+    }
     /**
      * Context-aware alias for `api.serUserEmojiStatus`. Changes the emoji status for a given user that previously allowed the bot to manage their emoji status via the Mini App method requestEmojiStatusAccess. Returns True on success.
      *
@@ -1671,7 +1681,7 @@ class Context {
         return this.api.deleteChatStickerSet(orThrow(this.chatId, "deleteChatStickerSet"), signal);
     }
     /**
-     * Context-aware alias for `api.createForumTopic`. Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns information about the created topic as a ForumTopic object.
+     * Context-aware alias for `api.createForumTopic`. Use this method to create a topic in a forum supergroup chat or a private chat with a user. In the case of a supergroup chat the bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator right. Returns information about the created topic as a ForumTopic object.
      *
      * @param name Topic name, 1-128 characters
      * @param other Optional remaining parameters, confer the official reference below

package/out/convenience/keyboard.d.ts

@@ -98,127 +98,186 @@ export declare class Keyboard {
      * Adds a new text button. This button will simply send the given text as a
      * text message back to your bot if a user clicks on it.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
+     * @param options Optional styling information
      */
-    text(text: string): this;
+    text(text: string, options?: KeyboardButton.CommonButton["style"] | Omit<KeyboardButton.CommonButton, "text">): this;
     /**
      * Creates a new text button. This button will simply send the given text as
      * a text message back to your bot if a user clicks on it.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
+     * @param options Optional styling information
      */
-    static text(text: string): KeyboardButton.CommonButton;
+    static text(text: string, options?: KeyboardButton.CommonButton["style"] | Omit<KeyboardButton.CommonButton, "text">): KeyboardButton.CommonButton;
     /**
      * Adds a new request users button. When the user presses the button, a list
      * of suitable users will be opened. Tapping on any number of users will
      * send their identifiers to the bot in a “users_shared” service message.
      * Available in private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param requestId A signed 32-bit identifier of the request
      * @param options Options object for further requirements
      */
-    requestUsers(text: string, requestId: number, options?: Omit<KeyboardButtonRequestUsers, "request_id">): this;
+    requestUsers(text: string | KeyboardButton.CommonButton, requestId: number, options?: Omit<KeyboardButtonRequestUsers, "request_id">): this;
     /**
      * Creates a new request users button. When the user presses the button, a
      * list of suitable users will be opened. Tapping on any number of users
      * will send their identifiers to the bot in a “users_shared” service
      * message. Available in private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param requestId A signed 32-bit identifier of the request
      * @param options Options object for further requirements
      */
-    static requestUsers(text: string, requestId: number, options?: Omit<KeyboardButtonRequestUsers, "request_id">): KeyboardButton.RequestUsersButton;
+    static requestUsers(text: string | KeyboardButton.CommonButton, requestId: number, options?: Omit<KeyboardButtonRequestUsers, "request_id">): KeyboardButton.RequestUsersButton;
     /**
      * Adds a new request chat button. When the user presses the button, a list
      * of suitable users will be opened. Tapping on a chat will send its
      * identifier to the bot in a “chat_shared” service message. Available in
      * private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param requestId A signed 32-bit identifier of the request
      * @param options Options object for further requirements
      */
-    requestChat(text: string, requestId: number, options?: Omit<KeyboardButtonRequestChat, "request_id">): this;
+    requestChat(text: string | KeyboardButton.CommonButton, requestId: number, options?: Omit<KeyboardButtonRequestChat, "request_id">): this;
     /**
      * Creates a new request chat button. When the user presses the button, a
      * list of suitable users will be opened. Tapping on a chat will send its
      * identifier to the bot in a “chat_shared” service message. Available in
      * private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param requestId A signed 32-bit identifier of the request
      * @param options Options object for further requirements
      */
-    static requestChat(text: string, requestId: number, options?: Omit<KeyboardButtonRequestChat, "request_id">): KeyboardButton.RequestChatButton;
+    static requestChat(text: string | KeyboardButton.CommonButton, requestId: number, options?: Omit<KeyboardButtonRequestChat, "request_id">): KeyboardButton.RequestChatButton;
     /**
      * Adds a new contact request button. The user's phone number will be sent
      * as a contact when the button is pressed. Available in private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      */
-    requestContact(text: string): this;
+    requestContact(text: string | KeyboardButton.CommonButton): this;
     /**
      * Creates a new contact request button. The user's phone number will be
      * sent as a contact when the button is pressed. Available in private chats
      * only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      */
-    static requestContact(text: string): KeyboardButton.RequestContactButton;
+    static requestContact(text: string | KeyboardButton.CommonButton): KeyboardButton.RequestContactButton;
     /**
      * Adds a new location request button. The user's current location will be
      * sent when the button is pressed. Available in private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      */
-    requestLocation(text: string): this;
+    requestLocation(text: string | KeyboardButton.CommonButton): this;
     /**
      * Creates a new location request button. The user's current location will
      * be sent when the button is pressed. Available in private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      */
-    static requestLocation(text: string): KeyboardButton.RequestLocationButton;
+    static requestLocation(text: string | KeyboardButton.CommonButton): KeyboardButton.RequestLocationButton;
     /**
      * Adds a new poll request button. The user will be asked to create a poll
      * and send it to the bot when the button is pressed. Available in private
      * chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param type The type of permitted polls to create, omit if the user may
      * send a poll of any type
      */
-    requestPoll(text: string, type?: KeyboardButtonPollType["type"]): this;
+    requestPoll(text: string | KeyboardButton.CommonButton, type?: KeyboardButtonPollType["type"]): this;
     /**
      * Creates a new poll request button. The user will be asked to create a
      * poll and send it to the bot when the button is pressed. Available in
      * private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param type The type of permitted polls to create, omit if the user may
      * send a poll of any type
      */
-    static requestPoll(text: string, type?: KeyboardButtonPollType["type"]): KeyboardButton.RequestPollButton;
+    static requestPoll(text: string | KeyboardButton.CommonButton, type?: KeyboardButtonPollType["type"]): KeyboardButton.RequestPollButton;
     /**
      * Adds a new web app button. The Web App that will be launched when the
      * user presses the button. The Web App will be able to send a
      * “web_app_data” service message. Available in private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param url An HTTPS URL of a Web App to be opened with additional data
      */
-    webApp(text: string, url: string): this;
+    webApp(text: string | KeyboardButton.CommonButton, url: string): this;
     /**
      * Creates a new web app button. The Web App that will be launched when the
      * user presses the button. The Web App will be able to send a
      * “web_app_data” service message. Available in private chats only.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param url An HTTPS URL of a Web App to be opened with additional data
      */
-    static webApp(text: string, url: string): KeyboardButton.WebAppButton;
+    static webApp(text: string | KeyboardButton.CommonButton, url: string): KeyboardButton.WebAppButton;
+    /**
+     * Adds a style to the last added button of the keyboard.
+     *
+     * ```ts
+     * const keyboard = new Keyboard()
+     *   .text('blue button')
+     *   .style('primary')
+     * ```
+     *
+     * @param style Style of the button
+     */
+    style(style: KeyboardButton.CommonButton["style"]): this;
+    /**
+     * Adds a danger style to the last added button of the keyboard. Alias for
+     * `.style('danger')`.
+     *
+     * ```ts
+     * const keyboard = new Keyboard()
+     *   .text('red button')
+     *   .danger()
+     * ```
+     */
+    danger(): this;
+    /**
+     * Adds a success style to the last added button of the keyboard. Alias for
+     * `.style('success')`.
+     *
+     * ```ts
+     * const keyboard = new Keyboard()
+     *   .text('green button')
+     *   .success()
+     * ```
+     */
+    success(): this;
+    /**
+     * Adds a primary style to the last added button of the keyboard. Alias for
+     * `.style('primary')`.
+     *
+     * ```ts
+     * const keyboard = new Keyboard()
+     *   .text('blue button')
+     *   .primary()
+     * ```
+     */
+    primary(): this;
+    /**
+     * Adds a custom emoji icon to the last added button of the keyboard.
+     *
+     * ```ts
+     * const keyboard = new Keyboard()
+     *   .text('button with icon')
+     *   .icon(myCustomEmojiIconIdentifier)
+     * ```
+     *
+     * @param icon Unique identifier of the custom emoji shown before the text of the button
+     */
+    icon(icon: KeyboardButton.CommonButton["icon_custom_emoji_id"]): this;
     /**
      * Make the current keyboard persistent. See
      * https://grammy.dev/plugins/keyboard#persistent-keyboards for more
@@ -438,18 +497,18 @@ export declare class InlineKeyboard {
      * Adds a new URL button. Telegram clients will open the provided URL when
      * the button is pressed.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param url HTTP or tg:// url to be opened when the button is pressed. Links tg://user?id=<user_id> can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings.
      */
-    url(text: string, url: string): this;
+    url(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, url: string): this;
     /**
      * Creates a new URL button. Telegram clients will open the provided URL
      * when the button is pressed.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param url HTTP or tg:// url to be opened when the button is pressed. Links tg://user?id=<user_id> can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings.
      */
-    static url(text: string, url: string): InlineKeyboardButton.UrlButton;
+    static url(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, url: string): InlineKeyboardButton.UrlButton;
     /**
      * Adds a new callback query button. The button contains a text and a custom
      * payload. This payload will be sent back to your bot when the button is
@@ -465,10 +524,10 @@ export declare class InlineKeyboard {
      * bot.on('callback_query:data',    ctx => { ... })
      * ```
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param data The callback data to send back to your bot (default = text)
      */
-    text(text: string, data?: string): this;
+    text(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, data?: string): this;
     /**
      * Creates a new callback query button. The button contains a text and a
      * custom payload. This payload will be sent back to your bot when the
@@ -484,42 +543,42 @@ export declare class InlineKeyboard {
      * bot.on('callback_query:data',    ctx => { ... })
      * ```
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param data The callback data to send back to your bot (default = text)
      */
-    static text(text: string, data?: string): InlineKeyboardButton.CallbackButton;
+    static text(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, data?: string): InlineKeyboardButton.CallbackButton;
     /**
      * Adds a new web app button, confer https://core.telegram.org/bots/webapps
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param url An HTTPS URL of a Web App to be opened with additional data
      */
-    webApp(text: string, url: string | WebAppInfo): this;
+    webApp(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, url: string | WebAppInfo): this;
     /**
      * Creates a new web app button, confer https://core.telegram.org/bots/webapps
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param url An HTTPS URL of a Web App to be opened with additional data
      */
-    static webApp(text: string, url: string | WebAppInfo): InlineKeyboardButton.WebAppButton;
+    static webApp(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, url: string | WebAppInfo): InlineKeyboardButton.WebAppButton;
     /**
      * Adds a new login button. This can be used as a replacement for the
      * Telegram Login Widget. You must specify an HTTPS URL used to
      * automatically authorize the user.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param loginUrl The login URL as string or `LoginUrl` object
      */
-    login(text: string, loginUrl: string | LoginUrl): this;
+    login(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, loginUrl: string | LoginUrl): this;
     /**
      * Creates a new login button. This can be used as a replacement for the
      * Telegram Login Widget. You must specify an HTTPS URL used to
      * automatically authorize the user.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param loginUrl The login URL as string or `LoginUrl` object
      */
-    static login(text: string, loginUrl: string | LoginUrl): InlineKeyboardButton.LoginButton;
+    static login(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, loginUrl: string | LoginUrl): InlineKeyboardButton.LoginButton;
     /**
      * Adds a new inline query button. Telegram clients will let the user pick a
      * chat when this button is pressed. This will start an inline query. The
@@ -532,10 +591,10 @@ export declare class InlineKeyboard {
      * bot.on('inline_query', ctx => { ... })
      * ```
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param query The (optional) inline query string to prefill
      */
-    switchInline(text: string, query?: string): this;
+    switchInline(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, query?: string): this;
     /**
      * Creates a new inline query button. Telegram clients will let the user pick a
      * chat when this button is pressed. This will start an inline query. The
@@ -548,10 +607,10 @@ export declare class InlineKeyboard {
      * bot.on('inline_query', ctx => { ... })
      * ```
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param query The (optional) inline query string to prefill
      */
-    static switchInline(text: string, query?: string): InlineKeyboardButton.SwitchInlineButton;
+    static switchInline(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, query?: string): InlineKeyboardButton.SwitchInlineButton;
     /**
      * Adds a new inline query button that acts on the current chat. The
      * selected chat will be prefilled with the name of your bot. You may
@@ -564,10 +623,10 @@ export declare class InlineKeyboard {
      * bot.on('inline_query', ctx => { ... })
      * ```
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param query The (optional) inline query string to prefill
      */
-    switchInlineCurrent(text: string, query?: string): this;
+    switchInlineCurrent(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, query?: string): this;
     /**
      * Creates a new inline query button that acts on the current chat. The
      * selected chat will be prefilled with the name of your bot. You may
@@ -580,10 +639,10 @@ export declare class InlineKeyboard {
      * bot.on('inline_query', ctx => { ... })
      * ```
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param query The (optional) inline query string to prefill
      */
-    static switchInlineCurrent(text: string, query?: string): InlineKeyboardButton.SwitchInlineCurrentChatButton;
+    static switchInlineCurrent(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, query?: string): InlineKeyboardButton.SwitchInlineCurrentChatButton;
     /**
      * Adds a new inline query button. Telegram clients will let the user pick a
      * chat when this button is pressed. This will start an inline query. The
@@ -596,10 +655,10 @@ export declare class InlineKeyboard {
      * bot.on('inline_query', ctx => { ... })
      * ```
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param query The query object describing which chats can be picked
      */
-    switchInlineChosen(text: string, query?: SwitchInlineQueryChosenChat): this;
+    switchInlineChosen(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, query?: SwitchInlineQueryChosenChat): this;
     /**
      * Creates a new inline query button. Telegram clients will let the user pick a
      * chat when this button is pressed. This will start an inline query. The
@@ -612,44 +671,44 @@ export declare class InlineKeyboard {
      * bot.on('inline_query', ctx => { ... })
      * ```
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param query The query object describing which chats can be picked
      */
-    static switchInlineChosen(text: string, query?: SwitchInlineQueryChosenChat): InlineKeyboardButton.SwitchInlineChosenChatButton;
+    static switchInlineChosen(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, query?: SwitchInlineQueryChosenChat): InlineKeyboardButton.SwitchInlineChosenChatButton;
     /**
      * Adds a new copy text button. When clicked, the specified text will be
      * copied to the clipboard.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param copyText The text to be copied to the clipboard
      */
-    copyText(text: string, copyText: string | CopyTextButton): this;
+    copyText(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, copyText: string | CopyTextButton): this;
     /**
      * Creates a new copy text button. When clicked, the specified text will be
      * copied to the clipboard.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      * @param copyText The text to be copied to the clipboard
      */
-    static copyText(text: string, copyText: string | CopyTextButton): InlineKeyboardButton.CopyTextButtonButton;
+    static copyText(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton, copyText: string | CopyTextButton): InlineKeyboardButton.CopyTextButtonButton;
     /**
      * Adds a new game query button, confer
      * https://core.telegram.org/bots/api#games
      *
      * This type of button must always be the first button in the first row.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      */
-    game(text: string): this;
+    game(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton): this;
     /**
      * Creates a new game query button, confer
      * https://core.telegram.org/bots/api#games
      *
      * This type of button must always be the first button in the first row.
      *
-     * @param text The text to display
+     * @param text The text to display, and optional styling information
      */
-    static game(text: string): InlineKeyboardButton.GameButton;
+    static game(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton): InlineKeyboardButton.GameButton;
     /**
      * Adds a new payment button, confer
      * https://core.telegram.org/bots/api#payments
@@ -657,9 +716,9 @@ export declare class InlineKeyboard {
      * This type of button must always be the first button in the first row and
      * can only be used in invoice messages.
      *
-     * @param text The text to display. Substrings “⭐” and “XTR” in the buttons's text will be replaced with a Telegram Star icon.
+     * @param text The text to display, and optional styling information. Substrings “⭐” and “XTR” in the buttons's text will be replaced with a Telegram Star icon.
      */
-    pay(text: string): this;
+    pay(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton): this;
     /**
      * Create a new payment button, confer
      * https://core.telegram.org/bots/api#payments
@@ -667,9 +726,66 @@ export declare class InlineKeyboard {
      * This type of button must always be the first button in the first row and
      * can only be used in invoice messages.
      *
-     * @param text The text to display. Substrings “⭐” and “XTR” in the buttons's text will be replaced with a Telegram Star icon.
+     * @param text The text to display, and optional styling information. Substrings “⭐” and “XTR” in the buttons's text will be replaced with a Telegram Star icon.
+     */
+    static pay(text: string | InlineKeyboardButton.AbstractInlineKeyboardButton): InlineKeyboardButton.PayButton;
+    /**
+     * Adds a style to the last added button of the inline keyboard.
+     *
+     * ```ts
+     * const keyboard = new InlineKeyboard()
+     *   .text('blue button')
+     *   .style('primary')
+     * ```
+     *
+     * @param style Style of the button
+     */
+    style(style: InlineKeyboardButton.AbstractInlineKeyboardButton["style"]): this;
+    /**
+     * Adds a danger style to the last added button of the inline keyboard.
+     * Alias for `.style('danger')`.
+     *
+     * ```ts
+     * const keyboard = new InlineKeyboard()
+     *   .text('red button')
+     *   .danger()
+     * ```
+     */
+    danger(): this;
+    /**
+     * Adds a success style to the last added button of the inline keyboard.
+     * Alias for `.style('success')`.
+     *
+     * ```ts
+     * const keyboard = new InlineKeyboard()
+     *   .text('green button')
+     *   .success()
+     * ```
+     */
+    success(): this;
+    /**
+     * Adds a primary style to the last added button of the inline keyboard.
+     * Alias for `.style('primary')`.
+     *
+     * ```ts
+     * const keyboard = new InlineKeyboard()
+     *   .text('blue button')
+     *   .primary()
+     * ```
+     */
+    primary(): this;
+    /**
+     * Adds a custom emoji icon to the last added button of the inline keyboard.
+     *
+     * ```ts
+     * const keyboard = new InlineKeyboard()
+     *   .text('button with icon')
+     *   .icon(myCustomEmojiIconIdentifier)
+     * ```
+     *
+     * @param icon Unique identifier of the custom emoji shown before the text of the button
      */
-    static pay(text: string): InlineKeyboardButton.PayButton;
+    icon(icon: InlineKeyboardButton.AbstractInlineKeyboardButton["icon_custom_emoji_id"]): this;
     /**
      * Creates a new inline keyboard that contains the transposed grid of
      * buttons of this inline keyboard. This means that the resulting inline