@grammyjs/types 2.5.1 → 2.7.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 KnorpelSenf
+Copyright (c) 2022 KnorpelSenf
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

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