@grammyjs/types 2.8.0 → 2.9.0

package/README.md

@@ -82,7 +82,7 @@ The actual type definitions themselves are never different.
 1. No formatting.
    We do not leverage the markdown capabilities of JSDoc for the sake of easier copying and thus reduced maintenance efforts.
 2. No mentions of `JSON-serialized`.
-   As underlying libraries handle serialization, these words are removed from the explantions.
+   As underlying libraries handle serialization, these words are removed from the explanations.
 3. No mentions of integer numbers that exceed 2^31 but not 2^51.
    All numbers are 64-bit floats in JS, so this is irrelevant.
    Note that JS bit operators cast numbers to 32-bit integers and back, but we deliberately ignore this because people who use bit operators on identifiers or file sizes should know what they're doing, and they should also know that it's a bad idea.

package/inline.d.ts

@@ -78,7 +78,7 @@ export interface InlineQueryResultArticle {
   reply_markup?: InlineKeyboardMarkup;
   /** URL of the result */
   url?: string;
-  /** Pass True, if you don't want the URL to be shown in the message */
+  /** Pass True if you don't want the URL to be shown in the message */
   hide_url?: boolean;
   /** Short description of the result */
   description?: string;
@@ -691,19 +691,19 @@ export interface InputInvoiceMessageContent {
   photo_width?: number;
   /** Photo height */
   photo_height?: number;
-  /** Pass True, if you require the user's full name to complete the order */
+  /** Pass True if you require the user's full name to complete the order */
   need_name?: boolean;
-  /** Pass True, if you require the user's phone number to complete the order */
+  /** Pass True if you require the user's phone number to complete the order */
   need_phone_number?: boolean;
-  /** Pass True, if you require the user's email address to complete the order */
+  /** Pass True if you require the user's email address to complete the order */
   need_email?: boolean;
-  /** Pass True, if you require the user's shipping address to complete the order */
+  /** Pass True if you require the user's shipping address to complete the order */
   need_shipping_address?: boolean;
-  /** Pass True, if the user's phone number should be sent to provider */
+  /** Pass True if the user's phone number should be sent to provider */
   send_phone_number_to_provider?: boolean;
-  /** Pass True, if the user's email address should be sent to provider */
+  /** Pass True if the user's email address should be sent to provider */
   send_email_to_provider?: boolean;
-  /** Pass True, if the final price depends on the shipping method */
+  /** Pass True if the final price depends on the shipping method */
   is_flexible?: boolean;
 }
 

package/manage.d.ts

@@ -143,6 +143,8 @@ export namespace Chat {
     bio?: string;
     /** True, if privacy settings of the other party in the private chat allows to use tg://user?id=<user_id> links only in chats with the user. Returned only in getChat. */
     has_private_forwards?: true;
+    /** True, if the privacy settings of the other party restrict sending voice and video note messages in the private chat. Returned only in getChat. */
+    has_restricted_voice_and_video_messages?: true;
   }
   /** Internal type representing group chats returned from `getChat`. */
   export interface GroupGetChat extends GroupChat, MultiUserGetChat {}

package/markup.d.ts

@@ -69,7 +69,7 @@ export type InlineKeyboardButton =
 /** 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.
+  /** An HTTPS 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;

package/message.d.ts

@@ -315,7 +315,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), “custom_emoji” (for inline custom emoji stickers) */
     type: string;
     /** Offset in UTF-16 code units to the start of the entity */
     offset: number;
@@ -338,6 +338,11 @@ export namespace MessageEntity {
       | "spoiler"
       | "code";
   }
+  export interface PreMessageEntity extends AbstractMessageEntity {
+    type: "pre";
+    /** For “pre” only, the programming language of the entity text */
+    language?: string;
+  }
   export interface TextLinkMessageEntity extends AbstractMessageEntity {
     type: "text_link";
     /** For “text_link” only, URL that will be opened after user taps on the text */
@@ -348,16 +353,17 @@ export namespace MessageEntity {
     /** 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 */
-    language?: string;
+  export interface CustomEmojiMessageEntity extends AbstractMessageEntity {
+    type: "custom_emoji";
+    /** For “custom_emoji” only, unique identifier of the custom emoji. Use getCustomEmojiStickers to get full information about the sticker */
+    custom_emoji_id: string;
   }
 }
 
 /** This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc. */
 export type MessageEntity =
   | MessageEntity.CommonMessageEntity
+  | MessageEntity.CustomEmojiMessageEntity
   | MessageEntity.PreMessageEntity
   | MessageEntity.TextLinkMessageEntity
   | MessageEntity.TextMentionMessageEntity;
@@ -643,6 +649,8 @@ export interface Sticker {
   file_id: string;
   /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
   file_unique_id: string;
+  /** Type of the sticker, currently one of “regular”, “mask”, “custom_emoji”. The type of the sticker is independent from its format, which is determined by the fields is_animated and is_video. */
+  type: "regular" | "mask" | "custom_emoji";
   /** Sticker width */
   width: number;
   /** Sticker height */
@@ -657,10 +665,12 @@ export interface Sticker {
   emoji?: string;
   /** Name of the sticker set to which the sticker belongs */
   set_name?: string;
-  /** Premium animation for the sticker, if the sticker is premium  */
+  /** For premium regular stickers, premium animation for the sticker */
   premium_animation?: File;
   /** For mask stickers, the position where the mask should be placed */
   mask_position?: MaskPosition;
+  /** For custom emoji stickers, unique identifier of the custom emoji */
+  custom_emoji_id?: string;
   /** File size in bytes */
   file_size?: number;
 }
@@ -671,12 +681,12 @@ export interface StickerSet {
   name: string;
   /** Sticker set title */
   title: string;
+  /** Type of stickers in the set, currently one of “regular”, “mask”, “custom_emoji” */
+  sticker_type: "regular" | "mask" | "custom_emoji";
   /** True, if the sticker set contains animated stickers */
   is_animated: boolean;
   /** True, if the sticker set contains video stickers */
   is_video: boolean;
-  /** True, if the sticker set contains masks */
-  contains_masks: boolean;
   /** List of all set stickers */
   stickers: Sticker[];
   /** Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format */

package/package.json

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

package/proxied.d.ts

@@ -12,6 +12,8 @@ import {
   ChatFromGetChat,
   ChatInviteLink,
   ChatMember,
+  ChatMemberAdministrator,
+  ChatMemberOwner,
   ChatPermissions,
   File,
   UserFromGetMe,
@@ -27,6 +29,7 @@ import {
   ParseMode,
   Poll,
   SentWebAppMessage,
+  Sticker,
   StickerSet,
 } from "./message";
 import { PassportElementError } from "./passport";
@@ -48,7 +51,7 @@ export interface InputFileProxy<F> {
 
   /** Wrapper type to bundle all methods of the Telegram API */
   Telegram: {
-    /** Use this method to receive incoming updates using long polling (wiki). An Array of Update objects is returned.
+    /** Use this method to receive incoming updates using long polling (wiki). Returns an Array of Update objects.
 
     Notes
     1. This method will not work if an outgoing webhook is set up.
@@ -86,12 +89,13 @@ export interface InputFileProxy<F> {
       /** The 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 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 */
-       drop_pending_updates?: boolean;
-       /** A secret token to be sent in a header “X-Telegram-Bot-Api-Secret-Token” in every webhook request, 1-256 characters. Only characters A-Z, a-z, 0-9, _ and - are allowed. The header is useful to ensure that the request comes from a webhook set by you. */
-       secret_token?: string;
+
+      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 */
+      drop_pending_updates?: boolean;
+      /** A secret token to be sent in a header “X-Telegram-Bot-Api-Secret-Token” in every webhook request, 1-256 characters. Only characters A-Z, a-z, 0-9, _ and - are allowed. The header is useful to ensure that the request comes from a webhook set by you. */
+      secret_token?: string;
     }): true;
 
     /** Use this method to remove webhook integration if you decide to switch back to getUpdates. Returns True on success. */
@@ -130,7 +134,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -154,7 +158,7 @@ export interface InputFileProxy<F> {
       message_id: number;
     }): Message;
 
-    /** Use this method to copy messages of any kind. Service messages and invoice messages can't be copied. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success. */
+    /** Use this method to copy messages of any kind. Service messages and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success. */
     copyMessage(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
@@ -174,7 +178,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -202,7 +206,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -240,7 +244,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -272,7 +276,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -302,7 +306,7 @@ export interface InputFileProxy<F> {
       parse_mode?: ParseMode;
       /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
       caption_entities?: MessageEntity[];
-      /** Pass True, if the uploaded video is suitable for streaming */
+      /** Pass True if the uploaded video is suitable for streaming */
       supports_streaming?: boolean;
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
@@ -310,7 +314,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -346,7 +350,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -376,7 +380,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -405,7 +409,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -432,7 +436,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If messages are a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
     }): Array<
       | Message.AudioMessage
@@ -463,7 +467,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -533,7 +537,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -561,7 +565,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove keyboard or to force a reply from the user. */
       reply_markup?:
@@ -597,7 +601,7 @@ export interface InputFileProxy<F> {
       open_period?: number;
       /** Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with open_period. */
       close_date?: number;
-      /** Pass True, if the poll needs to be immediately closed. This can be useful for poll preview. */
+      /** Pass True if the poll needs to be immediately closed. This can be useful for poll preview. */
       is_closed?: boolean;
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
@@ -605,7 +609,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -627,7 +631,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -722,27 +726,27 @@ export interface InputFileProxy<F> {
       chat_id: number | string;
       /** Unique identifier of the target user */
       user_id: number;
-      /** Pass True, if the administrator's presence in the chat is hidden */
+      /** Pass True if the administrator's presence in the chat is hidden */
       is_anonymous?: boolean;
-      /** Pass 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 */
+      /** Pass 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;
-      /** Pass True, if the administrator can create channel posts, channels only */
+      /** Pass True if the administrator can create channel posts, channels only */
       can_post_messages?: boolean;
-      /** Pass True, if the administrator can edit messages of other users and can pin messages, channels only */
+      /** Pass True if the administrator can edit messages of other users and can pin messages, channels only */
       can_edit_messages?: boolean;
-      /** Pass True, if the administrator can delete messages of other users */
+      /** Pass True if the administrator can delete messages of other users */
       can_delete_messages?: boolean;
-      /** Pass True, if the administrator can manage video chats */
+      /** 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 */
+      /** 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) */
+      /** 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) */
       can_promote_members?: boolean;
-      /** Pass True, if the administrator can change chat title, photo and other settings */
+      /** Pass True if the administrator can change chat title, photo and other settings */
       can_change_info?: boolean;
-      /** Pass True, if the administrator can invite new users to the chat */
+      /** Pass True if the administrator can invite new users to the chat */
       can_invite_users?: boolean;
-      /** Pass True, if the administrator can pin messages, supergroups only */
+      /** Pass True if the administrator can pin messages, supergroups only */
       can_pin_messages?: boolean;
     }): true;
 
@@ -878,7 +882,7 @@ export interface InputFileProxy<F> {
       chat_id: number | string;
       /** Identifier of a message to pin */
       message_id: number;
-      /** Pass True, if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats. */
+      /** Pass True if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats. */
       disable_notification?: boolean;
     }): true;
 
@@ -908,11 +912,11 @@ export interface InputFileProxy<F> {
       chat_id: number | string;
     }): ChatFromGetChat;
 
-    /** Use this method to get a list of administrators in a chat. On success, returns an Array of ChatMember objects that contains information about all chat administrators except other bots. If the chat is a group or a supergroup and no administrators were appointed, only the creator will be returned. */
+    /** Use this method to get a list of administrators in a chat, which aren't bots. Returns an Array of ChatMember objects. */
     getChatAdministrators(args: {
       /** Unique identifier for the target chat or username of the target supergroup or channel (in the format @channelusername) */
       chat_id: number | string;
-    }): ChatMember[];
+    }): Array<ChatMemberOwner | ChatMemberAdministrator>;
 
     /** Use this method to get the number of members in a chat. Returns Int on success.
      * @deprecated Use `getChatMemberCount` instead. */
@@ -982,7 +986,7 @@ export interface InputFileProxy<F> {
       language_code?: string;
     }): true;
 
-    /** Use this method to get the current list of the bot's commands for the given scope and user language. Returns Array of BotCommand on success. If commands aren't set, an empty list is returned. */
+    /** Use this method to get the current list of the bot's commands for the given scope and user language. Returns an Array of BotCommand objects. If commands aren't set, an empty list is returned. */
     getMyCommands(args: {
       /** An object, describing scope of users. Defaults to BotCommandScopeDefault. */
       scope?: BotCommandScope;
@@ -1126,7 +1130,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
       reply_markup?:
@@ -1142,6 +1146,12 @@ export interface InputFileProxy<F> {
       name: string;
     }): StickerSet;
 
+    /** Use this method to get information about custom emoji stickers by their identifiers. Returns an Array of Sticker objects. */
+    getCustomEmojiStickers(args: {
+      /** List of custom emoji identifiers. At most 200 custom emoji identifiers can be specified. */
+      custom_emoji_ids: string[];
+    }): Sticker[];
+
     /** Use this method to upload a .PNG file with a sticker for later use in createNewStickerSet and addStickerToSet methods (can be used multiple times). Returns the uploaded File on success. */
     uploadStickerFile(args: {
       /** User identifier of sticker file owner */
@@ -1164,10 +1174,10 @@ export interface InputFileProxy<F> {
       tgs_sticker?: F;
       /** WEBM video with the sticker, uploaded using multipart/form-data. See https://core.telegram.org/stickers#video-sticker-requirements for technical requirements */
       webm_sticker?: F;
+      /** Type of stickers in the set, pass “regular” or “mask”. Custom emoji sticker sets can't be created via the Bot API at the moment. By default, a regular sticker set is created. */
+      sticker_type?: "regular" | "mask";
       /** One or more emoji corresponding to the sticker */
       emojis: string;
-      /** Pass True, if a set of mask stickers should be created */
-      contains_masks?: boolean;
       /** An object for position where the mask should be placed on faces */
       mask_position?: MaskPosition;
     }): true;
@@ -1225,7 +1235,7 @@ export interface InputFileProxy<F> {
       results: readonly InlineQueryResult[];
       /** The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300. */
       cache_time?: number;
-      /** Pass True, if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query */
+      /** Pass True if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query */
       is_personal?: boolean;
       /** Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don't support pagination. Offset length can't exceed 64 bytes. */
       next_offset?: string;
@@ -1275,19 +1285,19 @@ export interface InputFileProxy<F> {
       photo_width?: number;
       /** Photo height */
       photo_height?: number;
-      /** Pass True, if you require the user's full name to complete the order */
+      /** Pass True if you require the user's full name to complete the order */
       need_name?: boolean;
-      /** Pass True, if you require the user's phone number to complete the order */
+      /** Pass True if you require the user's phone number to complete the order */
       need_phone_number?: boolean;
-      /** Pass True, if you require the user's email address to complete the order */
+      /** Pass True if you require the user's email address to complete the order */
       need_email?: boolean;
-      /** Pass True, if you require the user's shipping address to complete the order */
+      /** Pass True if you require the user's shipping address to complete the order */
       need_shipping_address?: boolean;
-      /** Pass True, if the user's phone number should be sent to provider */
+      /** Pass True if the user's phone number should be sent to provider */
       send_phone_number_to_provider?: boolean;
-      /** Pass True, if the user's email address should be sent to provider */
+      /** Pass True if the user's email address should be sent to provider */
       send_email_to_provider?: boolean;
-      /** Pass True, if the final price depends on the shipping method */
+      /** Pass True if the final price depends on the shipping method */
       is_flexible?: boolean;
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
@@ -1295,7 +1305,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** An object for an inline keyboard. If empty, one 'Pay total price' button will be shown. If not empty, the first button must be a Pay button. */
       reply_markup?: InlineKeyboardMarkup;
@@ -1329,19 +1339,19 @@ export interface InputFileProxy<F> {
       photo_width?: number;
       /** Photo height */
       photo_height?: number;
-      /** Pass True, if you require the user's full name to complete the order */
+      /** Pass True if you require the user's full name to complete the order */
       need_name?: boolean;
-      /** Pass True, if you require the user's phone number to complete the order */
+      /** Pass True if you require the user's phone number to complete the order */
       need_phone_number?: boolean;
-      /** Pass True, if you require the user's email address to complete the order */
+      /** Pass True if you require the user's email address to complete the order */
       need_email?: boolean;
-      /** Pass True, if you require the user's shipping address to complete the order */
+      /** Pass True if you require the user's shipping address to complete the order */
       need_shipping_address?: boolean;
-      /** Pass True, if the user's phone number should be sent to the provider */
+      /** Pass True if the user's phone number should be sent to the provider */
       send_phone_number_to_provider?: boolean;
-      /** Pass True, if the user's email address should be sent to the provider */
+      /** Pass True if the user's email address should be sent to the provider */
       send_email_to_provider?: boolean;
-      /** Pass True, if the final price depends on the shipping method */
+      /** Pass True if the final price depends on the shipping method */
       is_flexible?: boolean;
     }): string;
 
@@ -1349,7 +1359,7 @@ export interface InputFileProxy<F> {
     answerShippingQuery(args: {
       /** Unique identifier for the query to be answered */
       shipping_query_id: string;
-      /** Specify True if delivery to the specified address is possible and False if there are any problems (for example, if delivery to the specified address is not possible) */
+      /** Pass True if delivery to the specified address is possible and False if there are any problems (for example, if delivery to the specified address is not possible) */
       ok: boolean;
       /** Required if ok is True. An array of available shipping options. */
       shipping_options?: readonly ShippingOption[];
@@ -1389,7 +1399,7 @@ export interface InputFileProxy<F> {
       protect_content?: boolean;
       /** If the message is a reply, ID of the original message */
       reply_to_message_id?: number;
-      /** Pass True, if the message should be sent even if the specified replied-to message is not found */
+      /** Pass True if the message should be sent even if the specified replied-to message is not found */
       allow_sending_without_reply?: boolean;
       /** An object for an inline keyboard. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. */
       reply_markup?: InlineKeyboardMarkup;
@@ -1401,9 +1411,9 @@ export interface InputFileProxy<F> {
       user_id: number;
       /** New score, must be non-negative */
       score: number;
-      /** Pass True, if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters */
+      /** Pass True if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters */
       force?: boolean;
-      /** Pass True, if the game message should not be automatically edited to include the current scoreboard */
+      /** Pass True if the game message should not be automatically edited to include the current scoreboard */
       disable_edit_message?: boolean;
       /** Required if inline_message_id is not specified. Unique identifier for the target chat */
       chat_id?: number;
@@ -1413,7 +1423,7 @@ export interface InputFileProxy<F> {
       inline_message_id?: string;
     }): (Update.Edited & Message.GameMessage) | true;
 
-    /** Use this method to get data for high score tables. Will return the score of the specified user and several of their neighbors in a game. On success, returns an Array of GameHighScore objects.
+    /** Use this method to get data for high score tables. Will return the score of the specified user and several of their neighbors in a game. Returns an Array of GameHighScore objects.
 
     This method will currently return scores for the target user, plus two of their closest neighbors on each side. Will also return the top three users if the user and their neighbors are not among them. Please note that this behavior is subject to change. */
     getGameHighScores(args: {
@@ -1475,7 +1485,7 @@ export interface InputFileProxy<F> {
     height?: number;
     /** Video duration in seconds */
     duration?: number;
-    /** Pass True, if the uploaded video is suitable for streaming */
+    /** Pass True if the uploaded video is suitable for streaming */
     supports_streaming?: boolean;
   };