@grammyjs/types 2.6.0 → 2.7.0

package/index.d.ts

@@ -1,7 +1,8 @@
 export * from "./api";
-export * from "./callback";
 export * from "./inline";
 export * from "./manage";
+export * from "./markup";
+export * from "./menu-button";
 export * from "./message";
 export * from "./passport";
 export * from "./payment";

package/inline.d.ts

@@ -1,4 +1,5 @@
 import { Chat, User } from "./manage";
+import { InlineKeyboardMarkup } from "./markup";
 import { Location, MessageEntity, ParseMode } from "./message";
 import { LabeledPrice } from "./payment";
 
@@ -12,90 +13,12 @@ export interface InlineQuery {
   query: string;
   /** Offset of the results to be returned, can be controlled by the bot */
   offset: string;
-  /** Type of the chat, from which the inline query was sent. Can be either “sender” for a private chat with the inline query sender, “private”, “group”, “supergroup”, or “channel”. The chat type should be always known for requests sent from official clients and most third-party clients, unless the request was sent from a secret chat */
+  /** Type of the chat, from which the inline query was sent. Can be either "sender" for a private chat with the inline query sender, "private", "group", "supergroup", or "channel". The chat type should be always known for requests sent from official clients and most third-party clients, unless the request was sent from a secret chat */
   chat_type?: "sender" | Chat["type"];
   /** Sender location, only for bots that request user location */
   location?: Location;
 }
 
-/** This object represents an inline keyboard that appears right next to the message it belongs to. */
-export interface InlineKeyboardMarkup {
-  /** Array of button rows, each represented by an Array of InlineKeyboardButton objects */
-  inline_keyboard: InlineKeyboardButton[][];
-}
-
-export namespace InlineKeyboardButton {
-  interface AbstractInlineKeyboardButton {
-    /** Label text on the button */
-    text: string;
-  }
-  export interface UrlButton extends AbstractInlineKeyboardButton {
-    /** 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: string;
-  }
-  export interface LoginButton extends AbstractInlineKeyboardButton {
-    /** An HTTP URL used to automatically authorize the user. Can be used as a replacement for the Telegram Login Widget. */
-    login_url: LoginUrl;
-  }
-  export interface CallbackButton extends AbstractInlineKeyboardButton {
-    /** Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes */
-    callback_data: string;
-  }
-  export interface SwitchInlineButton extends AbstractInlineKeyboardButton {
-    /** If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. Can be empty, in which case just the bot's username will be inserted.
-
-    Note: This offers an easy way for users to start using your bot in inline mode when they are currently in a private chat with it. Especially useful when combined with switch_pm… actions – in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen. */
-    switch_inline_query: string;
-  }
-  export interface SwitchInlineCurrentChatButton
-    extends AbstractInlineKeyboardButton {
-    /** If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. Can be empty, in which case only the bot's username will be inserted.
-
-    This offers a quick way for the user to open your bot in inline mode in the same chat – good for selecting something from multiple options. */
-    switch_inline_query_current_chat: string;
-  }
-  export interface GameButton extends AbstractInlineKeyboardButton {
-    /** Description of the game that will be launched when the user presses the button.
-
-    NOTE: This type of button must always be the first button in the first row. */
-    callback_game: CallbackGame;
-  }
-  export interface PayButton extends AbstractInlineKeyboardButton {
-    /** Specify True, to send a Pay button.
-
-    NOTE: This type of button must always be the first button in the first row and can only be used in invoice messages. */
-    pay: boolean;
-  }
-}
-
-/** This object represents one button of an inline keyboard. You must use exactly one of the optional fields. */
-export type InlineKeyboardButton =
-  | InlineKeyboardButton.CallbackButton
-  | InlineKeyboardButton.GameButton
-  | InlineKeyboardButton.LoginButton
-  | InlineKeyboardButton.PayButton
-  | InlineKeyboardButton.SwitchInlineButton
-  | InlineKeyboardButton.SwitchInlineCurrentChatButton
-  | InlineKeyboardButton.UrlButton;
-
-/** This object represents a parameter of the inline keyboard button used to automatically authorize a user. Serves as a great replacement for the Telegram Login Widget when the user is coming from Telegram. All the user needs to do is tap/click a button and confirm that they want to log in.
-Telegram apps support these buttons as of version 5.7. */
-export interface LoginUrl {
-  /** An HTTP URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in Receiving authorization data.
-
-  NOTE: You must always check the hash of the received data to verify the authentication and the integrity of the data as described in Checking authorization. */
-  url: string;
-  /** New text of the button in forwarded messages. */
-  forward_text?: string;
-  /** Username of a bot, which will be used for user authorization. See Setting up a bot for more details. If not specified, the current bot's username will be assumed. The url's domain must be the same as the domain linked with the bot. See Linking your domain to the bot for more details. */
-  bot_username?: string;
-  /** Pass True to request the permission for your bot to send messages to the user. */
-  request_write_access?: boolean;
-}
-
-/** A placeholder, currently holds no information. Use BotFather to set up your game. */
-export interface CallbackGame {}
-
 /** This object represents one result of an inline query. Telegram clients currently support results of the following 20 types:
 - InlineQueryResultCachedAudio
 - InlineQueryResultCachedDocument
@@ -213,7 +136,7 @@ export interface InlineQueryResultGif {
   gif_duration?: number;
   /** URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result */
   thumb_url: string;
-  /** MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg” */
+  /** MIME type of the thumbnail, must be one of "image/jpeg", "image/gif", or "video/mp4". Defaults to "image/jpeg" */
   thumb_mime_type?: "image/jpeg" | "image/gif" | "video/mp4";
   /** Title for the result */
   title?: string;
@@ -243,7 +166,7 @@ export interface InlineQueryResultMpeg4Gif {
   mpeg4_duration?: number;
   /** URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result */
   thumb_url: string;
-  /** MIME type of the thumbnail, must be one of “image/jpeg”, “image/gif”, or “video/mp4”. Defaults to “image/jpeg” */
+  /** MIME type of the thumbnail, must be one of "image/jpeg", "image/gif", or "video/mp4". Defaults to "image/jpeg" */
   thumb_mime_type?: "image/jpeg" | "image/gif" | "video/mp4";
   /** Title for the result */
   title?: string;
@@ -267,7 +190,7 @@ export interface InlineQueryResultVideo {
   id: string;
   /** A valid URL for the embedded video player or video file */
   video_url: string;
-  /** Mime type of the content of video url, “text/html” or “video/mp4” */
+  /** Mime type of the content of video url, "text/html" or "video/mp4" */
   mime_type: "text/html" | "video/mp4";
   /** URL of the thumbnail (JPEG only) for the video */
   thumb_url: string;
@@ -431,7 +354,7 @@ export interface InlineQueryResultVenue {
   address: string;
   /** Foursquare identifier of the venue if known */
   foursquare_id?: string;
-  /** Foursquare type of the venue, if known. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.) */
+  /** Foursquare type of the venue, if known. (For example, "arts_entertainment/default", "arts_entertainment/aquarium" or "food/icecream".) */
   foursquare_type?: string;
   /** Google Places identifier of the venue */
   google_place_id?: string;
@@ -720,7 +643,7 @@ export interface InputVenueMessageContent {
   address: string;
   /** Foursquare identifier of the venue, if known */
   foursquare_id?: string;
-  /** Foursquare type of the venue, if known. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.) */
+  /** Foursquare type of the venue, if known. (For example, "arts_entertainment/default", "arts_entertainment/aquarium" or "food/icecream".) */
   foursquare_type?: string;
   /** Google Places identifier of the venue */
   google_place_id?: string;

package/manage.d.ts

@@ -15,6 +15,8 @@ export interface WebhookInfo {
   last_error_date: number;
   /** Error message in human-readable format for the most recent error that happened when trying to deliver an update via webhook */
   last_error_message: string;
+  /** Unix time of the most recent error that happened when trying to synchronize available updates with Telegram datacenters */
+  last_synchronization_error_date?: number;
   /** Maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery */
   max_connections: number;
   /** A list of update types the bot is subscribed to. Defaults to all update types except chat_member */
@@ -53,7 +55,7 @@ export namespace Chat {
   // ABSTRACT
   /** Internal type holding properties that all kinds of chats share. */
   interface AbstractChat {
-    /** Type of chat, can be either “private”, “group”, “supergroup” or “channel” */
+    /** Type of chat, can be either "private", "group", "supergroup" or "channel" */
     type: string;
     /** Unique identifier for this chat. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier. */
     id: number;
@@ -86,7 +88,9 @@ export namespace Chat {
   }
   /** Internal type representing super group chats. */
   export interface SupergroupChat
-    extends AbstractChat, UserNameChat, TitleChat {
+    extends AbstractChat,
+      UserNameChat,
+      TitleChat {
     type: "supergroup";
   }
   /** Internal type representing channel chats. */
@@ -138,7 +142,9 @@ export namespace Chat {
   export interface GroupGetChat extends GroupChat, MultiUserGetChat {}
   /** Internal type representing supergroup chats returned from `getChat`. */
   export interface SupergroupGetChat
-    extends SupergroupChat, MultiUserGetChat, LargeGetChat {
+    extends SupergroupChat,
+      MultiUserGetChat,
+      LargeGetChat {
     /** For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user; in seconds. Returned only in getChat. */
     slow_mode_delay?: number;
     /** For supergroups, name of group sticker set. Returned only in getChat. */
@@ -186,7 +192,7 @@ export interface ChatPhoto {
 
 /** Represents an invite link for a chat. */
 export interface ChatInviteLink {
-  /** The invite link. If the link was created by another chat administrator, then the second part of the link will be replaced with “…”. */
+  /** 	The invite link. If the link was created by another chat administrator, then the second part of the link will be replaced with "...". */
   invite_link: string;
   /** Creator of the link */
   creator: User;
@@ -206,6 +212,32 @@ export interface ChatInviteLink {
   pending_join_request_count?: number;
 }
 
+/** Represents the rights of an administrator in a chat. */
+export interface ChatAdministratorRights {
+  /** True, if the user's presence in the chat is hidden */
+  is_anonymous: boolean;
+  /** True, if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege */
+  can_manage_chat: boolean;
+  /** True, if the administrator can delete messages of other users */
+  can_delete_messages: boolean;
+  /** True, if the administrator can manage video chats */
+  can_manage_video_chats: boolean;
+  /** True, if the administrator can restrict, ban or unban chat members */
+  can_restrict_members: boolean;
+  /** True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by the user) */
+  can_promote_members: boolean;
+  /** True, if the user is allowed to change the chat title, photo and other settings */
+  can_change_info: boolean;
+  /** True, if the user is allowed to invite new users to the chat */
+  can_invite_users: boolean;
+  /** True, if the administrator can post in the channel; channels only */
+  can_post_messages?: boolean;
+  /** True, if the administrator can edit messages of other users and can pin messages; channels only */
+  can_edit_messages?: boolean;
+  /** True, if the user is allowed to pin messages; groups and supergroups only */
+  can_pin_messages?: boolean;
+}
+
 /** This object contains information about one member of a chat. Currently, the following 6 types of chat members are supported:
 - ChatMemberOwner
 - ChatMemberAdministrator
@@ -223,7 +255,7 @@ export type ChatMember =
 
 /** Represents a chat member that owns the chat and has all administrator privileges. */
 export interface ChatMemberOwner {
-  /** The member's status in the chat, always “creator” */
+  /** The member's status in the chat, always "creator" */
   status: "creator";
   /** Information about the user */
   user: User;
@@ -235,7 +267,7 @@ export interface ChatMemberOwner {
 
 /** Represents a chat member that has some additional privileges. */
 export interface ChatMemberAdministrator {
-  /** The member's status in the chat, always “administrator” */
+  /** The member's status in the chat, always "administrator" */
   status: "administrator";
   /** Information about the user */
   user: User;
@@ -247,8 +279,8 @@ export interface ChatMemberAdministrator {
   can_manage_chat: boolean;
   /** True, if the administrator can delete messages of other users */
   can_delete_messages: boolean;
-  /** True, if the administrator can manage voice chats */
-  can_manage_voice_chats: boolean;
+  /** True, if the administrator can manage video chats */
+  can_manage_video_chats: boolean;
   /** True, if the administrator can restrict, ban or unban chat members */
   can_restrict_members: boolean;
   /** True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by the user) */
@@ -269,7 +301,7 @@ export interface ChatMemberAdministrator {
 
 /** Represents a chat member that has no additional privileges or restrictions. */
 export interface ChatMemberMember {
-  /** The member's status in the chat, always “member” */
+  /** The member's status in the chat, always "member" */
   status: "member";
   /** Information about the user */
   user: User;
@@ -277,7 +309,7 @@ export interface ChatMemberMember {
 
 /** Represents a chat member that is under certain restrictions in the chat. Supergroups only. */
 export interface ChatMemberRestricted {
-  /** The member's status in the chat, always “restricted” */
+  /** The member's status in the chat, always "restricted" */
   status: "restricted";
   /** Information about the user */
   user: User;
@@ -305,7 +337,7 @@ export interface ChatMemberRestricted {
 
 /** Represents a chat member that isn't currently a member of the chat, but may join it themselves. */
 export interface ChatMemberLeft {
-  /** The member's status in the chat, always “left” */
+  /** The member's status in the chat, always "left" */
   status: "left";
   /** Information about the user */
   user: User;
@@ -313,7 +345,7 @@ export interface ChatMemberLeft {
 
 /** Represents a chat member that was banned in the chat and can't return to the chat or view chat messages. */
 export interface ChatMemberBanned {
-  /** The member's status in the chat, always “kicked” */
+  /** The member's status in the chat, always "kicked" */
   status: "kicked";
   /** Information about the user */
   user: User;

package/{callback.d.ts → markup.d.ts}

@@ -1,6 +1,109 @@
 import { User } from "./manage";
 import { Message } from "./message";
 
+/** This object represents an inline keyboard that appears right next to the message it belongs to. */
+export interface InlineKeyboardMarkup {
+  /** Array of button rows, each represented by an Array of InlineKeyboardButton objects */
+  inline_keyboard: InlineKeyboardButton[][];
+}
+
+export namespace InlineKeyboardButton {
+  interface AbstractInlineKeyboardButton {
+    /** Label text on the button */
+    text: string;
+  }
+  export interface UrlButton extends AbstractInlineKeyboardButton {
+    /** 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: string;
+  }
+  export interface CallbackButton extends AbstractInlineKeyboardButton {
+    /** Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes */
+    callback_data: string;
+  }
+  export interface WebAppButton extends AbstractInlineKeyboardButton {
+    /** Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Available only in private chats between a user and the bot. */
+    web_app: WebAppInfo;
+  }
+  export interface LoginButton extends AbstractInlineKeyboardButton {
+    /** An HTTP URL used to automatically authorize the user. Can be used as a replacement for the Telegram Login Widget. */
+    login_url: LoginUrl;
+  }
+  export interface SwitchInlineButton extends AbstractInlineKeyboardButton {
+    /** If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. Can be empty, in which case just the bot's username will be inserted.
+
+    Note: This offers an easy way for users to start using your bot in inline mode when they are currently in a private chat with it. Especially useful when combined with switch_pm... actions – in this case the user will be automatically returned to the chat they switched from, skipping the chat selection screen. */
+    switch_inline_query: string;
+  }
+  export interface SwitchInlineCurrentChatButton
+    extends AbstractInlineKeyboardButton {
+    /** If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. Can be empty, in which case only the bot's username will be inserted.
+
+    This offers a quick way for the user to open your bot in inline mode in the same chat – good for selecting something from multiple options. */
+    switch_inline_query_current_chat: string;
+  }
+  export interface GameButton extends AbstractInlineKeyboardButton {
+    /** Description of the game that will be launched when the user presses the button.
+
+    NOTE: This type of button must always be the first button in the first row. */
+    callback_game: CallbackGame;
+  }
+  export interface PayButton extends AbstractInlineKeyboardButton {
+    /** Specify True, to send a Pay button.
+
+    NOTE: This type of button must always be the first button in the first row and can only be used in invoice messages. */
+    pay: boolean;
+  }
+}
+
+/** This object represents one button of an inline keyboard. You must use exactly one of the optional fields. */
+export type InlineKeyboardButton =
+  | InlineKeyboardButton.CallbackButton
+  | InlineKeyboardButton.GameButton
+  | InlineKeyboardButton.LoginButton
+  | InlineKeyboardButton.PayButton
+  | InlineKeyboardButton.SwitchInlineButton
+  | InlineKeyboardButton.SwitchInlineCurrentChatButton
+  | InlineKeyboardButton.UrlButton
+  | InlineKeyboardButton.WebAppButton;
+
+/** This object represents a parameter of the inline keyboard button used to automatically authorize a user. Serves as a great replacement for the Telegram Login Widget when the user is coming from Telegram. All the user needs to do is tap/click a button and confirm that they want to log in.
+Telegram apps support these buttons as of version 5.7. */
+export interface LoginUrl {
+  /** An HTTP URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in Receiving authorization data.
+
+  NOTE: You must always check the hash of the received data to verify the authentication and the integrity of the data as described in Checking authorization. */
+  url: string;
+  /** New text of the button in forwarded messages. */
+  forward_text?: string;
+  /** Username of a bot, which will be used for user authorization. See Setting up a bot for more details. If not specified, the current bot's username will be assumed. The url's domain must be the same as the domain linked with the bot. See Linking your domain to the bot for more details. */
+  bot_username?: string;
+  /** Pass True to request the permission for your bot to send messages to the user. */
+  request_write_access?: boolean;
+}
+
+/** A placeholder, currently holds no information. Use BotFather to set up your game. */
+export interface CallbackGame {}
+
+/** This object represents an incoming callback query from a callback button in an inline keyboard. If the button that originated the query was attached to a message sent by the bot, the field message will be present. If the button was attached to a message sent via the bot (in inline mode), the field inline_message_id will be present. Exactly one of the fields data or game_short_name will be present.
+
+ NOTE: After the user presses a callback button, Telegram clients will display a progress bar until you call answerCallbackQuery. It is, therefore, necessary to react by calling answerCallbackQuery even if no notification to the user is needed (e.g., without specifying any of the optional parameters). */
+export interface CallbackQuery {
+  /** Unique identifier for this query */
+  id: string;
+  /** Sender */
+  from: User;
+  /** Message with the callback button that originated the query. Note that message content and message date will not be available if the message is too old */
+  message?: Message;
+  /** Identifier of the message sent via the bot in inline mode, that originated the query. */
+  inline_message_id?: string;
+  /** Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games. */
+  chat_instance: string;
+  /** Data associated with the callback button. Be aware that a bad client can send arbitrary data in this field. */
+  data?: string;
+  /** Short name of a Game to be returned, serves as the unique identifier for the game */
+  game_short_name?: string;
+}
+
 /** This object represents a custom keyboard with reply options (see Introduction to bots for details and examples). */
 export interface ReplyKeyboardMarkup {
   /** Array of button rows, each represented by an Array of KeyboardButton objects */
@@ -23,25 +126,30 @@ export namespace KeyboardButton {
     text: string;
   }
   export interface RequestContactButton extends CommonButton {
-    /** If True, the user's phone number will be sent as a contact when the button is pressed. Available in private chats only */
+    /** If True, the user's phone number will be sent as a contact when the button is pressed. Available in private chats only. */
     request_contact: boolean;
   }
   export interface RequestLocationButton extends CommonButton {
-    /** If True, the user's current location will be sent when the button is pressed. Available in private chats only */
+    /** If True, the user's current location will be sent when the button is pressed. Available in private chats only. */
     request_location: boolean;
   }
   export interface RequestPollButton extends CommonButton {
-    /** If specified, 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 */
+    /** If specified, 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. */
     request_poll: KeyboardButtonPollType;
   }
+  export interface WebAppButton extends CommonButton {
+    /** If specified, the described Web App will be launched when the button is pressed. The Web App will be able to send a “web_app_data” service message. Available in private chats only. */
+    web_app: WebAppInfo;
+  }
 }
 
-/** This object represents one button of the reply keyboard. For simple text buttons String can be used instead of this object to specify text of the button. Optional fields request_contact, request_location, and request_poll are mutually exclusive. */
+/** This object represents one button of the reply keyboard. For simple text buttons String can be used instead of this object to specify text of the button. Optional fields web_app, request_contact, request_location, and request_poll are mutually exclusive. */
 export type KeyboardButton =
   | KeyboardButton.CommonButton
   | KeyboardButton.RequestContactButton
   | KeyboardButton.RequestLocationButton
   | KeyboardButton.RequestPollButton
+  | KeyboardButton.WebAppButton
   | string;
 
 /** This object represents type of a poll, which is allowed to be created and sent when the corresponding button is pressed. */
@@ -60,26 +168,6 @@ export interface ReplyKeyboardRemove {
   selective?: boolean;
 }
 
-/** This object represents an incoming callback query from a callback button in an inline keyboard. If the button that originated the query was attached to a message sent by the bot, the field message will be present. If the button was attached to a message sent via the bot (in inline mode), the field inline_message_id will be present. Exactly one of the fields data or game_short_name will be present.
-
- NOTE: After the user presses a callback button, Telegram clients will display a progress bar until you call answerCallbackQuery. It is, therefore, necessary to react by calling answerCallbackQuery even if no notification to the user is needed (e.g., without specifying any of the optional parameters). */
-export interface CallbackQuery {
-  /** Unique identifier for this query */
-  id: string;
-  /** Sender */
-  from: User;
-  /** Message with the callback button that originated the query. Note that message content and message date will not be available if the message is too old */
-  message?: Message;
-  /** Identifier of the message sent via the bot in inline mode, that originated the query. */
-  inline_message_id?: string;
-  /** Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games. */
-  chat_instance: string;
-  /** Data associated with the callback button. Be aware that a bad client can send arbitrary data in this field. */
-  data?: string;
-  /** Short name of a Game to be returned, serves as the unique identifier for the game */
-  game_short_name?: string;
-}
-
 /** Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot's message and tapped 'Reply'). This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode.
 
 Example: A poll bot for groups runs in privacy mode (only receives commands, replies to its messages and mentions). There could be two ways to create a new poll:
@@ -97,3 +185,9 @@ export interface ForceReply {
   /** Use this parameter if you want to force reply from specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot's message is a reply (has reply_to_message_id), sender of the original message. */
   selective?: boolean;
 }
+
+/** Contains information about a Web App. */
+export interface WebAppInfo {
+  /** An HTTPS URL of a Web App to be opened with additional data as specified in Initializing Web Apps */
+  url: string;
+}

package/{bot-command-scope.d.ts → menu-button.d.ts}

@@ -1,3 +1,38 @@
+import { WebAppInfo } from "./markup";
+
+/** This object describes the bot's menu button in a private chat. It should be one of
+- MenuButtonCommands
+- MenuButtonWebApp
+- MenuButtonDefault
+
+If a menu button other than MenuButtonDefault is set for a private chat, then it is applied in the chat. Otherwise the default menu button is applied. By default, the menu button opens the list of bot commands. */
+export type MenuButton =
+  | MenuButtonCommands
+  | MenuButtonWebApp
+  | MenuButtonDefault;
+
+/** Represents a menu button, which opens the bot's list of commands. */
+export interface MenuButtonCommands {
+  /** Type of the button, must be commands */
+  type: "commands";
+}
+
+/** Represents a menu button, which launches a Web App. */
+export interface MenuButtonWebApp {
+  /** Button type, must be web_app */
+  type: "web_app";
+  /** Text on the button */
+  text: string;
+  /** Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. */
+  web_app: WebAppInfo;
+}
+
+/** Describes that no specific value for the menu button was set. */
+export interface MenuButtonDefault {
+  /** Type of the button, must be default */
+  type: "default";
+}
+
 /** This object represents the scope to which bot commands are applied. Currently, the following 7 scopes are supported:
 - BotCommandScopeDefault
 - BotCommandScopeAllPrivateChats

package/message.d.ts

@@ -1,4 +1,4 @@
-import { InlineKeyboardMarkup } from "./inline";
+import { InlineKeyboardMarkup } from "./markup";
 import { Chat, User } from "./manage";
 import { PassportData } from "./passport";
 import { Invoice, SuccessfulPayment } from "./payment";
@@ -72,59 +72,44 @@ export namespace Message {
   export type PollMessage = CommonMessage & MsgWith<"poll">;
   export type LocationMessage = CommonMessage & MsgWith<"location">;
   export type VenueMessage = LocationMessage & MsgWith<"venue">;
-  export type NewChatMembersMessage =
-    & ServiceMessage
-    & MsgWith<"new_chat_members">;
-  export type LeftChatMemberMessage =
-    & ServiceMessage
-    & MsgWith<"left_chat_member">;
+  export type NewChatMembersMessage = ServiceMessage &
+    MsgWith<"new_chat_members">;
+  export type LeftChatMemberMessage = ServiceMessage &
+    MsgWith<"left_chat_member">;
   export type NewChatTitleMessage = ServiceMessage & MsgWith<"new_chat_title">;
   export type NewChatPhotoMessage = ServiceMessage & MsgWith<"new_chat_photo">;
-  export type DeleteChatPhotoMessage =
-    & ServiceMessage
-    & MsgWith<"delete_chat_photo">;
-  export type GroupChatCreatedMessage =
-    & ServiceMessage
-    & MsgWith<"group_chat_created">;
-  export type SupergroupChatCreated =
-    & ServiceMessage
-    & MsgWith<"supergroup_chat_created">;
-  export type ChannelChatCreatedMessage =
-    & ServiceMessage
-    & MsgWith<"channel_chat_created">;
-  export type MessageAutoDeleteTimerChangedMessage =
-    & ServiceMessage
-    & MsgWith<"message_auto_delete_timer_changed">;
-  export type MigrateToChatIdMessage =
-    & ServiceMessage
-    & MsgWith<"migrate_to_chat_id">;
-  export type MigrateFromChatIdMessage =
-    & ServiceMessage
-    & MsgWith<"migrate_from_chat_id">;
+  export type DeleteChatPhotoMessage = ServiceMessage &
+    MsgWith<"delete_chat_photo">;
+  export type GroupChatCreatedMessage = ServiceMessage &
+    MsgWith<"group_chat_created">;
+  export type SupergroupChatCreated = ServiceMessage &
+    MsgWith<"supergroup_chat_created">;
+  export type ChannelChatCreatedMessage = ServiceMessage &
+    MsgWith<"channel_chat_created">;
+  export type MessageAutoDeleteTimerChangedMessage = ServiceMessage &
+    MsgWith<"message_auto_delete_timer_changed">;
+  export type MigrateToChatIdMessage = ServiceMessage &
+    MsgWith<"migrate_to_chat_id">;
+  export type MigrateFromChatIdMessage = ServiceMessage &
+    MsgWith<"migrate_from_chat_id">;
   export type PinnedMessageMessage = ServiceMessage & MsgWith<"pinned_message">;
   export type InvoiceMessage = ServiceMessage & MsgWith<"invoice">;
-  export type SuccessfulPaymentMessage =
-    & ServiceMessage
-    & MsgWith<"successful_payment">;
-  export type ConnectedWebsiteMessage =
-    & ServiceMessage
-    & MsgWith<"connected_website">;
+  export type SuccessfulPaymentMessage = ServiceMessage &
+    MsgWith<"successful_payment">;
+  export type ConnectedWebsiteMessage = ServiceMessage &
+    MsgWith<"connected_website">;
   export type PassportDataMessage = ServiceMessage & MsgWith<"passport_data">;
-  export type ProximityAlertTriggeredMessage =
-    & ServiceMessage
-    & MsgWith<"proximity_alert_triggered">;
-  export type VoiceChatScheduledMessage =
-    & ServiceMessage
-    & MsgWith<"voice_chat_scheduled">;
-  export type VoiceChatStartedMessage =
-    & ServiceMessage
-    & MsgWith<"voice_chat_started">;
-  export type VoiceChatEndedMessage =
-    & ServiceMessage
-    & MsgWith<"voice_chat_ended">;
-  export type VoiceChatParticipantsInvitedMessage =
-    & ServiceMessage
-    & MsgWith<"voice_chat_participants_invited">;
+  export type ProximityAlertTriggeredMessage = ServiceMessage &
+    MsgWith<"proximity_alert_triggered">;
+  export type VideoChatScheduledMessage = ServiceMessage &
+    MsgWith<"video_chat_scheduled">;
+  export type VideoChatStartedMessage = ServiceMessage &
+    MsgWith<"video_chat_started">;
+  export type VideoChatEndedMessage = ServiceMessage &
+    MsgWith<"video_chat_ended">;
+  export type VideoChatParticipantsInvitedMessage = ServiceMessage &
+    MsgWith<"video_chat_participants_invited">;
+  export type WebAppDataMessage = ServiceMessage & MsgWith<"web_app_data">;
 }
 
 type ReplyMessage = Message & { reply_to_message: undefined };
@@ -197,13 +182,16 @@ export interface Message extends Message.MediaMessage {
   /** Service message. A user in the chat triggered another user's proximity alert while sharing Live Location. */
   proximity_alert_triggered?: ProximityAlertTriggered;
   /** Service message: voice chat scheduled */
-  voice_chat_scheduled?: VoiceChatScheduled;
-  /** Service message: voice chat started */
-  voice_chat_started?: VoiceChatStarted;
-  /** Service message: voice chat ended */
-  voice_chat_ended?: VoiceChatEnded;
-  /** Service message: new participants invited to a voice chat */
-  voice_chat_participants_invited?: VoiceChatParticipantsInvited;
+  /** Service message: video chat scheduled */
+  video_chat_scheduled?: VideoChatScheduled;
+  /** Service message: video chat started */
+  video_chat_started?: VideoChatStarted;
+  /** Service message: video chat ended */
+  video_chat_ended?: VideoChatEnded;
+  /** Service message: new participants invited to a video chat */
+  video_chat_participants_invited?: VideoChatParticipantsInvited;
+  /** Service message: data sent by a Web App */
+  web_app_data?: WebAppData;
 }
 
 /** This object represents a unique message identifier. */
@@ -212,6 +200,12 @@ export interface MessageId {
   message_id: number;
 }
 
+/** Contains information about an inline message sent by a Web App on behalf of a user. */
+export interface SentWebAppMessage {
+  /** Identifier of the sent inline message. Available only if there is an inline keyboard attached to the message. */
+  inline_message_id: string;
+}
+
 /** The Bot API supports basic formatting for messages. You can use bold, italic, underlined, strikethrough, and spoiler text, as well as inline links and pre-formatted code in your bots' messages. Telegram clients will render them accordingly. You can use either markdown-style or HTML-style formatting.
 
 Note that Telegram clients will display an **alert** to the user before opening an inline link ('Open this link?' together with the full URL).
@@ -305,7 +299,7 @@ export type ParseMode = "Markdown" | "MarkdownV2" | "HTML";
 
 export namespace MessageEntity {
   interface AbstractMessageEntity {
-    /** Type of the entity. Currently, can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames) */
+    /** Type of the entity. Currently, can be "mention" (@username), "hashtag" (#hashtag), "cashtag" ($USD), "bot_command" (/start@jobs_bot), "url" (https://telegram.org), "email" (do-not-reply@telegram.org), "phone_number" (+1-212-555-0123), "bold" (bold text), "italic" (italic text), "underline" (underlined text), "strikethrough" (strikethrough text), "spoiler" (spoiler message), "code" (monowidth string), "pre" (monowidth block), "text_link" (for clickable text URLs), "text_mention" (for users without usernames) */
     type: string;
     /** Offset in UTF-16 code units to the start of the entity */
     offset: number;
@@ -330,17 +324,17 @@ export namespace MessageEntity {
   }
   export interface TextLinkMessageEntity extends AbstractMessageEntity {
     type: "text_link";
-    /** For “text_link” only, url that will be opened after user taps on the text */
+    /** For "text_link" only, url that will be opened after user taps on the text */
     url: string;
   }
   export interface TextMentionMessageEntity extends AbstractMessageEntity {
     type: "text_mention";
-    /** For “text_mention” only, the mentioned user */
+    /** For "text_mention" only, the mentioned user */
     user: User;
   }
   export interface PreMessageEntity extends AbstractMessageEntity {
     type: "pre";
-    /** For “pre” only, the programming language of the entity text */
+    /** For "pre" only, the programming language of the entity text */
     language?: string;
   }
 }
@@ -496,7 +490,7 @@ export interface Contact {
 export interface Dice {
   /** Emoji on which the dice throw animation is based */
   emoji: string;
-  /** Value of the dice, 1-6 for “🎲”, “🎯” and “🎳” base emoji, 1-5 for “🏀” and “⚽” base emoji, 1-64 for “🎰” base emoji */
+  /** Value of the dice, 1-6 for "🎲", "🎯" and "🎳" base emoji, 1-5 for "🏀" and "⚽" base emoji, 1-64 for "🎰" base emoji */
   value: number;
 }
 
@@ -532,7 +526,7 @@ export interface Poll {
   is_closed: boolean;
   /** True, if the poll is anonymous */
   is_anonymous: boolean;
-  /** Poll type, currently can be “regular” or “quiz” */
+  /** Poll type, currently can be "regular" or "quiz" */
   type: "regular" | "quiz";
   /** True, if the poll allows multiple answers */
   allows_multiple_answers: boolean;
@@ -574,7 +568,7 @@ export interface Venue {
   address: string;
   /** Foursquare identifier of the venue */
   foursquare_id?: string;
-  /** Foursquare type of the venue. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.) */
+  /** Foursquare type of the venue. (For example, "arts_entertainment/default", "arts_entertainment/aquarium" or "food/icecream".) */
   foursquare_type?: string;
   /** Google Places identifier of the venue */
   google_place_id?: string;
@@ -598,27 +592,35 @@ export interface MessageAutoDeleteTimerChanged {
   message_auto_delete_time: number;
 }
 
-/** This object represents a service message about a voice chat scheduled in the chat. */
-export interface VoiceChatScheduled {
-  /** Point in time (Unix timestamp) when the voice chat is supposed to be started by a chat administrator */
+/** This object represents a service message about a video chat scheduled in the chat. */
+export interface VideoChatScheduled {
+  /** Point in time (Unix timestamp) when the video chat is supposed to be started by a chat administrator */
   start_date: number;
 }
 
-/** This object represents a service message about a voice chat started in the chat. Currently holds no information. */
-export interface VoiceChatStarted {}
+/** This object represents a service message about a video chat started in the chat. Currently holds no information. */
+export interface VideoChatStarted {}
 
-/** This object represents a service message about a voice chat ended in the chat. */
-export interface VoiceChatEnded {
-  /** Voice chat duration in seconds */
+/** This object represents a service message about a video chat ended in the chat. */
+export interface VideoChatEnded {
+  /** Video chat duration in seconds */
   duration: number;
 }
 
-/** This object represents a service message about new members invited to a voice chat. */
-export interface VoiceChatParticipantsInvited {
-  /** New members that were invited to the voice chat */
+/** This object represents a service message about new members invited to a video chat. */
+export interface VideoChatParticipantsInvited {
+  /** New members that were invited to the video chat */
   users: User[];
 }
 
+/** Contains data sent from a Web App to the bot. */
+export interface WebAppData {
+  /** The data. Be aware that a bad client can send arbitrary data in this field. */
+  data: string;
+  /** Text of the web_app keyboard button, from which the Web App was opened. Be aware that a bad client can send arbitrary data in this field. */
+  button_text: string;
+}
+
 /** This object represents a sticker. */
 export interface Sticker {
   /** Identifier for this file, which can be used to download or reuse the file */
@@ -665,7 +667,7 @@ export interface StickerSet {
 
 /** This object describes the position on faces where a mask should be placed by default. */
 export interface MaskPosition {
-  /** The part of the face relative to which the mask should be placed. One of “forehead”, “eyes”, “mouth”, or “chin”. */
+  /** The part of the face relative to which the mask should be placed. One of "forehead", "eyes", "mouth", or "chin". */
   point: "forehead" | "eyes" | "mouth" | "chin";
   /** Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position. */
   x_shift: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grammyjs/types",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "Telegram Bot API type declarations for grammY",
   "main": "index.js",
   "repository": {

package/passport.d.ts

@@ -20,7 +20,7 @@ export interface PassportFile {
 
 /** Contains information about documents or other Telegram Passport elements shared with the bot by the user. */
 export interface EncryptedPassportElement {
-  /** Element type. One of “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport”, “address”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration”, “phone_number”, “email”. */
+  /** Element type. One of "personal_details", "passport", "driver_license", "identity_card", "internal_passport", "address", "utility_bill", "bank_statement", "rental_agreement", "passport_registration", "temporary_registration", "phone_number", "email". */
   type:
     | "personal_details"
     | "passport"
@@ -35,21 +35,21 @@ export interface EncryptedPassportElement {
     | "temporary_registration"
     | "phone_number"
     | "email";
-  /** Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials. */
+  /** Base64-encoded encrypted Telegram Passport element data provided by the user, available for "personal_details", "passport", "driver_license", "identity_card", "internal_passport" and "address" types. Can be decrypted and verified using the accompanying EncryptedCredentials. */
   data?: string;
-  /** User's verified phone number, available only for “phone_number” type */
+  /** User's verified phone number, available only for "phone_number" type */
   phone_number?: string;
-  /** User's verified email address, available only for “email” type */
+  /** User's verified email address, available only for "email" type */
   email?: string;
-  /** Array of encrypted files with documents provided by the user, available for “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials. */
+  /** Array of encrypted files with documents provided by the user, available for "utility_bill", "bank_statement", "rental_agreement", "passport_registration" and "temporary_registration" types. Files can be decrypted and verified using the accompanying EncryptedCredentials. */
   files?: PassportFile[];
-  /** Encrypted file with the front side of the document, provided by the user. Available for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials. */
+  /** Encrypted file with the front side of the document, provided by the user. Available for "passport", "driver_license", "identity_card" and "internal_passport". The file can be decrypted and verified using the accompanying EncryptedCredentials. */
   front_side?: PassportFile;
-  /** Encrypted file with the reverse side of the document, provided by the user. Available for “driver_license” and “identity_card”. The file can be decrypted and verified using the accompanying EncryptedCredentials. */
+  /** Encrypted file with the reverse side of the document, provided by the user. Available for "driver_license" and "identity_card". The file can be decrypted and verified using the accompanying EncryptedCredentials. */
   reverse_side?: PassportFile;
-  /** Encrypted file with the selfie of the user holding a document, provided by the user; available for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials. */
+  /** Encrypted file with the selfie of the user holding a document, provided by the user; available for "passport", "driver_license", "identity_card" and "internal_passport". The file can be decrypted and verified using the accompanying EncryptedCredentials. */
   selfie?: PassportFile;
-  /** Array of encrypted files with translated versions of documents provided by the user. Available if requested for “passport”, “driver_license”, “identity_card”, “internal_passport”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials. */
+  /** Array of encrypted files with translated versions of documents provided by the user. Available if requested for "passport", "driver_license", "identity_card", "internal_passport", "utility_bill", "bank_statement", "rental_agreement", "passport_registration" and "temporary_registration" types. Files can be decrypted and verified using the accompanying EncryptedCredentials. */
   translation?: PassportFile[];
   /** Base64-encoded element hash for using in PassportElementErrorUnspecified */
   hash: string;
@@ -91,7 +91,7 @@ export type PassportElementError =
 export interface PassportElementErrorDataField {
   /** Error source, must be data */
   source: "data";
-  /** The section of the user's Telegram Passport which has the error, one of “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport”, “address” */
+  /** The section of the user's Telegram Passport which has the error, one of "personal_details", "passport", "driver_license", "identity_card", "internal_passport", "address" */
   type:
     | "personal_details"
     | "passport"
@@ -111,7 +111,7 @@ export interface PassportElementErrorDataField {
 export interface PassportElementErrorFrontSide {
   /** Error source, must be front_side */
   source: "front_side";
-  /** The section of the user's Telegram Passport which has the issue, one of “passport”, “driver_license”, “identity_card”, “internal_passport” */
+  /** The section of the user's Telegram Passport which has the issue, one of "passport", "driver_license", "identity_card", "internal_passport" */
   type: "passport" | "driver_license" | "identity_card" | "internal_passport";
   /** Base64-encoded hash of the file with the front side of the document */
   file_hash: string;
@@ -123,7 +123,7 @@ export interface PassportElementErrorFrontSide {
 export interface PassportElementErrorReverseSide {
   /** Error source, must be reverse_side */
   source: "reverse_side";
-  /** The section of the user's Telegram Passport which has the issue, one of “driver_license”, “identity_card” */
+  /** The section of the user's Telegram Passport which has the issue, one of "driver_license", "identity_card" */
   type: "driver_license" | "identity_card";
   /** Base64-encoded hash of the file with the reverse side of the document */
   file_hash: string;
@@ -135,7 +135,7 @@ export interface PassportElementErrorReverseSide {
 export interface PassportElementErrorSelfie {
   /** Error source, must be selfie */
   source: "selfie";
-  /** The section of the user's Telegram Passport which has the issue, one of “passport”, “driver_license”, “identity_card”, “internal_passport” */
+  /** The section of the user's Telegram Passport which has the issue, one of "passport", "driver_license", "identity_card", "internal_passport" */
   type: "passport" | "driver_license" | "identity_card" | "internal_passport";
   /** Base64-encoded hash of the file with the selfie */
   file_hash: string;
@@ -147,7 +147,7 @@ export interface PassportElementErrorSelfie {
 export interface PassportElementErrorFile {
   /** Error source, must be file */
   source: "file";
-  /** The section of the user's Telegram Passport which has the issue, one of “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration” */
+  /** The section of the user's Telegram Passport which has the issue, one of "utility_bill", "bank_statement", "rental_agreement", "passport_registration", "temporary_registration" */
   type:
     | "utility_bill"
     | "bank_statement"
@@ -164,7 +164,7 @@ export interface PassportElementErrorFile {
 export interface PassportElementErrorFiles {
   /** Error source, must be files */
   source: "files";
-  /** The section of the user's Telegram Passport which has the issue, one of “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration” */
+  /** The section of the user's Telegram Passport which has the issue, one of "utility_bill", "bank_statement", "rental_agreement", "passport_registration", "temporary_registration" */
   type:
     | "utility_bill"
     | "bank_statement"
@@ -181,7 +181,7 @@ export interface PassportElementErrorFiles {
 export interface PassportElementErrorTranslationFile {
   /** Error source, must be translation_file */
   source: "translation_file";
-  /** Type of element of the user's Telegram Passport which has the issue, one of “passport”, “driver_license”, “identity_card”, “internal_passport”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration” */
+  /** Type of element of the user's Telegram Passport which has the issue, one of "passport", "driver_license", "identity_card", "internal_passport", "utility_bill", "bank_statement", "rental_agreement", "passport_registration", "temporary_registration" */
   type:
     | "passport"
     | "driver_license"
@@ -202,7 +202,7 @@ export interface PassportElementErrorTranslationFile {
 export interface PassportElementErrorTranslationFiles {
   /** Error source, must be translation_files */
   source: "translation_files";
-  /** Type of element of the user's Telegram Passport which has the issue, one of “passport”, “driver_license”, “identity_card”, “internal_passport”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration” */
+  /** Type of element of the user's Telegram Passport which has the issue, one of "passport", "driver_license", "identity_card", "internal_passport", "utility_bill", "bank_statement", "rental_agreement", "passport_registration", "temporary_registration" */
   type:
     | "passport"
     | "driver_license"

package/proxied.d.ts

@@ -1,12 +1,14 @@
-import { BotCommandScope } from "./bot-command-scope";
+import { BotCommandScope, MenuButton } from "./menu-button";
 import {
   ForceReply,
+  InlineKeyboardMarkup,
   ReplyKeyboardMarkup,
   ReplyKeyboardRemove,
-} from "./callback";
-import { InlineKeyboardMarkup, InlineQueryResult } from "./inline";
+} from "./markup";
+import { InlineQueryResult } from "./inline";
 import {
   BotCommand,
+  ChatAdministratorRights,
   ChatFromGetChat,
   ChatInviteLink,
   ChatMember,
@@ -24,6 +26,7 @@ import {
   MessageId,
   ParseMode,
   Poll,
+  SentWebAppMessage,
   StickerSet,
 } from "./message";
 import { PassportElementError } from "./passport";
@@ -42,7 +45,8 @@ export interface InputFileProxy<F> {
     [M in keyof InputFileProxy<F>["Telegram"]]: Params<
       M,
       F
-    >[0] extends undefined ? {}
+    >[0] extends undefined
+      ? {}
       : NonNullable<Params<M, F>[0]>;
   };
 
@@ -60,7 +64,7 @@ export interface InputFileProxy<F> {
       limit?: number;
       /** Timeout in seconds for long polling. Defaults to 0, i.e. usual short polling. Should be positive, short polling should be used for testing purposes only. */
       timeout?: number;
-      /** A list of the update types you want your bot to receive. For example, specify [“message”, “edited_channel_post”, “callback_query”] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member (default). If not specified, the previous setting will be used.
+      /** A list of the update types you want your bot to receive. For example, specify ["message", "edited_channel_post", "callback_query"] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member (default). If not specified, the previous setting will be used.
 
       Please note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time. */
       allowed_updates?: readonly string[];
@@ -85,7 +89,7 @@ export interface InputFileProxy<F> {
       ip_address?: string;
       /** Maximum allowed number of simultaneous HTTPS connections to the webhook for update delivery, 1-100. Defaults to 40. Use lower values to limit the load on your bot's server, and higher values to increase your bot's throughput. */
       max_connections?: number;
-      /** A list of the update types you want your bot to receive. For example, specify [“message”, “edited_channel_post”, “callback_query”] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all updates regardless of type (default). If not specified, the previous setting will be used.
+      /** A list of the update types you want your bot to receive. For example, specify ["message", "edited_channel_post", "callback_query"] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all update types except chat_member (default). If not specified, the previous setting will be used.
       Please note that this parameter doesn't affect updates created before the call to the setWebhook, so unwanted updates may be received for a short period of time. */
       allowed_updates?: ReadonlyArray<Exclude<keyof Update, "update_id">>;
       /** Pass True to drop all pending updates */
@@ -230,7 +234,7 @@ export interface InputFileProxy<F> {
       performer?: string;
       /** Track name */
       title?: string;
-      /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
+      /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
       thumb?: F;
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
@@ -254,7 +258,7 @@ export interface InputFileProxy<F> {
       chat_id: number | string;
       /** File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. */
       document: F | string;
-      /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
+      /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
       thumb?: F;
       /** Document caption (may also be used when resending documents by file_id), 0-1024 characters after entities parsing */
       caption?: string;
@@ -292,7 +296,7 @@ export interface InputFileProxy<F> {
       width?: number;
       /** Video height */
       height?: number;
-      /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
+      /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
       thumb?: F;
       /** Video caption (may also be used when resending videos by file_id), 0-1024 characters after entities parsing */
       caption?: string;
@@ -330,7 +334,7 @@ export interface InputFileProxy<F> {
       width?: number;
       /** Animation height */
       height?: number;
-      /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
+      /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
       thumb?: F;
       /** Animation caption (may also be used when resending animation by file_id), 0-1024 characters after entities parsing */
       caption?: string;
@@ -395,7 +399,7 @@ export interface InputFileProxy<F> {
       duration?: number;
       /** Video width and height, i.e. diameter of the video message */
       length?: number;
-      /**  Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
+      /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
       thumb?: F;
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
@@ -519,7 +523,7 @@ export interface InputFileProxy<F> {
       address: string;
       /** Foursquare identifier of the venue */
       foursquare_id?: string;
-      /** Foursquare type of the venue, if known. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.) */
+      /** Foursquare type of the venue, if known. (For example, "arts_entertainment/default", "arts_entertainment/aquarium" or "food/icecream".) */
       foursquare_type?: string;
       /** Google Places identifier of the venue */
       google_place_id?: string;
@@ -579,7 +583,7 @@ export interface InputFileProxy<F> {
       options: readonly string[];
       /** True, if the poll needs to be anonymous, defaults to True */
       is_anonymous?: boolean;
-      /** Poll type, “quiz” or “regular”, defaults to “regular” */
+      /** Poll type, "quiz" or "regular", defaults to "regular" */
       type?: "quiz" | "regular";
       /** True, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to False */
       allows_multiple_answers?: boolean;
@@ -617,7 +621,7 @@ export interface InputFileProxy<F> {
     sendDice(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
-      /** Emoji on which the dice throw animation is based. Currently, must be one of “🎲”, “🎯”, “🏀”, “⚽”, “🎳”, or “🎰”. Dice can have values 1-6 for “🎲”, “🎯” and “🎳”, values 1-5 for “🏀” and “⚽”, and values 1-64 for “🎰”. Defaults to “🎲” */
+      /** Emoji on which the dice throw animation is based. Currently, must be one of "🎲", "🎯", "🏀", "⚽", "🎳", or "🎰". Dice can have values 1-6 for "🎲", "🎯" and "🎳", values 1-5 for "🏀" and "⚽", and values 1-64 for "🎰". Defaults to "🎲" */
       emoji?: string;
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
@@ -637,7 +641,7 @@ export interface InputFileProxy<F> {
 
     /** Use this method when you need to tell the user that something is happening on the bot's side. The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status). Returns True on success.
 
-    Example: The ImageBot needs some time to process a request and upload the image. Instead of sending a text message along the lines of “Retrieving image, please wait…”, the bot may use sendChatAction with action = upload_photo. The user will see a “sending photo” status for the bot.
+    Example: The ImageBot needs some time to process a request and upload the image. Instead of sending a text message along the lines of "Retrieving image, please wait...", the bot may use sendChatAction with action = upload_photo. The user will see a "sending photo" status for the bot.
 
     We only recommend using this method when a response from the bot will take a noticeable amount of time to arrive. */
     sendChatAction(args: {
@@ -730,8 +734,8 @@ export interface InputFileProxy<F> {
       can_edit_messages?: boolean;
       /** Pass True, if the administrator can delete messages of other users */
       can_delete_messages?: boolean;
-      /** Pass True, if the administrator can manage voice chats */
-      can_manage_voice_chats?: boolean;
+      /** Pass True, if the administrator can manage video chats */
+      can_manage_video_chats?: boolean;
       /** Pass True, if the administrator can restrict, ban or unban chat members */
       can_restrict_members?: boolean;
       /** Pass True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by him) */
@@ -988,6 +992,34 @@ export interface InputFileProxy<F> {
       language_code?: string;
     }): BotCommand[];
 
+    /** Use this method to change the bot's menu button in a private chat, or the default menu button. Returns True on success. */
+    setChatMenuButton(args: {
+      /** Unique identifier for the target private chat. If not specified, default bot's menu button will be changed */
+      chat_id?: number;
+      /** An object for the new bot's menu button. Defaults to MenuButtonDefault */
+      menu_button?: MenuButton;
+    }): true;
+
+    /** Use this method to get the current value of the bot's menu button in a private chat, or the default menu button. Returns MenuButton on success. */
+    getChatMenuButton(args: {
+      /** Unique identifier for the target private chat. If not specified, default bot's menu button will be returned */
+      chat_id?: number;
+    }): MenuButton;
+
+    /** Use this method to the change the default administrator rights requested by the bot when it's added as an administrator to groups or channels. These rights will be suggested to users, but they are are free to modify the list before adding the bot. Returns True on success. */
+    setMyDefaultAdministratorRights(args: {
+      /** An object describing new default administrator rights. If not specified, the default administrator rights will be cleared. */
+      rights?: ChatAdministratorRights;
+      /** Pass True to change the default administrator rights of the bot in channels. Otherwise, the default administrator rights of the bot for groups and supergroups will be changed. */
+      for_channels?: boolean;
+    }): true;
+
+    /** Use this method to get the current default administrator rights of the bot. Returns ChatAdministratorRights on success. */
+    getMyDefaultAdministratorRights(args: {
+      /** Pass True to get default administrator rights of the bot in channels. Otherwise, default administrator rights of the bot for groups and supergroups will be returned. */
+      for_channels?: boolean;
+    }): ChatAdministratorRights;
+
     /** Use this method to edit text and game messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
     editMessageText(args: {
       /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
@@ -1124,7 +1156,7 @@ export interface InputFileProxy<F> {
     createNewStickerSet(args: {
       /** User identifier of created sticker set owner */
       user_id: number;
-      /** Short name of sticker set, to be used in t.me/addstickers/ URLs (e.g., animals). Can contain only english letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in “_by_<bot username>”. <bot_username> is case insensitive. 1-64 characters. */
+      /** Short name of sticker set, to be used in t.me/addstickers/ URLs (e.g., animals). Can contain only english letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in "_by_<bot username>". <bot_username> is case insensitive. 1-64 characters. */
       name: string;
       /** Sticker set title, 1-64 characters */
       title: string;
@@ -1205,6 +1237,14 @@ export interface InputFileProxy<F> {
       switch_pm_parameter?: string;
     }): true;
 
+    /** Use this method to set the result of an interaction with a Web App and send a corresponding message on behalf of the user to the chat from which the query originated. On success, a SentWebAppMessage object is returned. */
+    answerWebAppQuery(args: {
+      /** Unique identifier for the query to be answered */
+      web_app_query_id: string;
+      /** An object describing the message to be sent */
+      result: InlineQueryResult;
+    }): SentWebAppMessage;
+
     /** Use this method to send invoices. On success, the sent Message is returned. */
     sendInvoice(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
@@ -1363,7 +1403,7 @@ export interface InputFileProxy<F> {
   InputMediaPhoto: {
     /** Type of the result, must be photo */
     type: "photo";
-    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. */
+    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name. */
     media: F | string;
     /** Caption of the photo to be sent, 0-1024 characters after entities parsing */
     caption?: string;
@@ -1377,9 +1417,9 @@ export interface InputFileProxy<F> {
   InputMediaVideo: {
     /** Type of the result, must be video */
     type: "video";
-    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. */
+    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name. */
     media: F | string;
-    /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
+    /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
     thumb?: F;
     /** Caption of the video to be sent, 0-1024 characters after entities parsing */
     caption?: string;
@@ -1401,9 +1441,9 @@ export interface InputFileProxy<F> {
   InputMediaAnimation: {
     /** Type of the result, must be animation */
     type: "animation";
-    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. */
+    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name. */
     media: F | string;
-    /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
+    /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
     thumb?: F;
     /** Caption of the animation to be sent, 0-1024 characters after entities parsing */
     caption?: string;
@@ -1423,9 +1463,9 @@ export interface InputFileProxy<F> {
   InputMediaAudio: {
     /** Type of the result, must be audio */
     type: "audio";
-    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. */
+    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name. */
     media: F | string;
-    /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
+    /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
     thumb?: F;
     /** Caption of the audio to be sent, 0-1024 characters after entities parsing */
     caption?: string;
@@ -1445,9 +1485,9 @@ export interface InputFileProxy<F> {
   InputMediaDocument: {
     /** Type of the result, must be document */
     type: "document";
-    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. */
+    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name. */
     media: F | string;
-    /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
+    /** Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass "attach://<file_attach_name>" if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. */
     thumb?: F;
     /** Caption of the document to be sent, 0-1024 characters after entities parsing */
     caption?: string;

package/update.d.ts

@@ -1,4 +1,4 @@
-import { CallbackQuery } from "./callback";
+import { CallbackQuery } from "./markup";
 import { ChosenInlineResult, InlineQuery } from "./inline";
 import { Chat, ChatJoinRequest, ChatMemberUpdated, User } from "./manage";
 import { Message, Poll, PollAnswer } from "./message";