@grammyjs/types 2.2.5 → 2.4.0

package/bot-command-scope.d.ts

@@ -22,12 +22,12 @@ The following algorithm is used to determine the list of commands for a particul
 ### Commands in group and supergroup chats
 - botCommandScopeChatMember + language_code
 - botCommandScopeChatMember
-- botCommandScopeChatAdministrators + language_code (admins only)
-- botCommandScopeChatAdministrators (admins only)
+- botCommandScopeChatAdministrators + language_code (administrators only)
+- botCommandScopeChatAdministrators (administrators only)
 - botCommandScopeChat + language_code
 - botCommandScopeChat
-- botCommandScopeAllChatAdministrators + language_code (admins only)
-- botCommandScopeAllChatAdministrators (admins only)
+- botCommandScopeAllChatAdministrators + language_code (administrators only)
+- botCommandScopeAllChatAdministrators (administrators only)
 - botCommandScopeAllGroupChats + language_code
 - botCommandScopeAllGroupChats
 - botCommandScopeDefault + language_code

package/inline.d.ts

@@ -30,7 +30,7 @@ export namespace InlineKeyboardButton {
     text: string;
   }
   export interface UrlButton extends AbstractInlineKeyboardButton {
-    /** HTTP or tg:// url to be opened when button is pressed */
+    /** 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 {
@@ -63,7 +63,7 @@ export namespace InlineKeyboardButton {
   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. */
+    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;
   }
 }
@@ -209,7 +209,7 @@ export interface InlineQueryResultGif {
   gif_width?: number;
   /** Height of the GIF */
   gif_height?: number;
-  /** Duration of the GIF */
+  /** Duration of the GIF in seconds */
   gif_duration?: number;
   /** URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result */
   thumb_url: string;
@@ -239,7 +239,7 @@ export interface InlineQueryResultMpeg4Gif {
   mpeg4_width?: number;
   /** Video height */
   mpeg4_height?: number;
-  /** Video duration */
+  /** Video duration in seconds */
   mpeg4_duration?: number;
   /** URL of the static (JPEG or GIF) or animated (MPEG4) thumbnail for the result */
   thumb_url: string;
@@ -269,7 +269,7 @@ export interface InlineQueryResultVideo {
   video_url: string;
   /** 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 */
+  /** URL of the thumbnail (JPEG only) for the video */
   thumb_url: string;
   /** Title for the result */
   title: string;
@@ -371,7 +371,7 @@ export interface InlineQueryResultDocument {
   reply_markup?: InlineKeyboardMarkup;
   /** Content of the message to be sent instead of the file */
   input_message_content?: InputMessageContent;
-  /** URL of the thumbnail (jpeg only) for the file */
+  /** URL of the thumbnail (JPEG only) for the file */
   thumb_url?: string;
   /** Thumbnail width */
   thumb_width?: number;

package/manage.d.ts

@@ -86,9 +86,7 @@ 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. */
@@ -105,6 +103,8 @@ export namespace Chat {
     pinned_message?: Message;
     /** The time after which all messages sent to the chat will be automatically deleted; in seconds. Returned only in getChat. */
     message_auto_delete_time?: number;
+    /** True, if messages from the chat can't be forwarded to other chats. Returned only in getChat. */
+    has_protected_content?: true;
   }
   /** Internal type holding properties that those group, supergroup, and channel chats returned from `getChat` share. */
   interface NonPrivateGetChat extends GetChat {
@@ -131,15 +131,15 @@ export namespace Chat {
   export interface PrivateGetChat extends PrivateChat, GetChat {
     /** Bio of the other party in a private chat. Returned only in getChat. */
     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;
   }
   /** Internal type representing group chats returned from `getChat`. */
   export interface GroupGetChat extends GroupChat, MultiUserGetChat {}
   /** Internal type representing supergroup chats returned from `getChat`. */
   export interface SupergroupGetChat
-    extends SupergroupChat,
-      MultiUserGetChat,
-      LargeGetChat {
-    /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user. Returned only in getChat. */
+    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. */
     sticker_set_name?: string;
@@ -190,14 +190,20 @@ export interface ChatInviteLink {
   invite_link: string;
   /** Creator of the link */
   creator: User;
+  /** True, if users joining the chat via the link need to be approved by chat administrators */
+  creates_join_request: boolean;
   /** True, if the link is primary */
   is_primary: boolean;
   /** True, if the link is revoked */
   is_revoked: boolean;
+  /** Invite link name */
+  name?: string;
   /** Point in time (Unix timestamp) when the link will expire or has been expired */
   expire_date?: number;
   /** Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 */
   member_limit?: number;
+  /** Number of pending join requests created using this link */
+  pending_join_request_count?: number;
 }
 
 /** This object contains information about one member of a chat. Currently, the following 6 types of chat members are supported:
@@ -331,6 +337,20 @@ export interface ChatMemberUpdated {
   invite_link?: ChatInviteLink;
 }
 
+/** Represents a join request sent to a chat. */
+export interface ChatJoinRequest {
+  /** Chat to which the request was sent */
+  chat: Chat;
+  /** User that sent the join request */
+  from: User;
+  /** Date the request was sent in Unix time */
+  date: number;
+  /** Bio of the user. */
+  bio?: string;
+  /** Chat invite link that was used by the user to send the join request */
+  invite_link?: ChatInviteLink;
+}
+
 /** Describes actions that a non-administrator user is allowed to take in a chat. */
 export interface ChatPermissions {
   /** True, if the user is allowed to send text messages, contacts, locations and venues */
@@ -373,7 +393,7 @@ export interface File {
   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;
-  /** File size, if known */
+  /** File size in bytes, if known */
   file_size?: number;
   /** File path. Use https://api.telegram.org/file/bot<token>/<file_path> to get the file. */
   file_path?: string;

package/message.d.ts

@@ -31,12 +31,16 @@ export namespace Message {
     forward_sender_name?: string;
     /** For forwarded messages, date the original message was sent in Unix time */
     forward_date?: number;
+    /** True, if the message is a channel post that was automatically forwarded to the connected discussion group */
+    is_automatic_forward?: true;
     /** For replies, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply. */
     reply_to_message?: ReplyMessage;
     /** Bot through which the message was sent */
     via_bot?: User;
     /** Date the message was last edited in Unix time */
     edit_date?: number;
+    /** True, if the message can't be forwarded */
+    has_protected_content?: true;
     /** Signature of the post author for messages in channels, or the custom title of an anonymous group administrator */
     author_signature?: string;
     /** Inline keyboard attached to the message. login_url buttons are represented as ordinary url buttons. */
@@ -68,43 +72,59 @@ 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 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">;
 }
 
 type ReplyMessage = Message & { reply_to_message: undefined };
@@ -203,8 +223,8 @@ Message entities can be nested, providing following restrictions are met:
 
 Links `tg://user?id=<user_id>` can be used to mention a user by their ID without using a username. Please note:
 
-- These links will work only if they are used inside an inline link. For example, they will not work, when used in an inline keyboard button or in a message text.
-- These mentions are only guaranteed to work if the user has contacted the bot in the past, has sent a callback query to the bot via inline button or is a member in the group where he was mentioned.
+- These links will work only if they are used inside an inline link or in an inline keyboard button. For example, they will not work, when used in a message text.
+- These mentions are only guaranteed to work if the user has contacted the bot in the past, has sent a callback query to the bot via an inline button or is a member in the group where he was mentioned.
 
 #### MarkdownV2 style
 To use this mode, pass *MarkdownV2* in the *parse_mode* field. Use the following syntax in your message:
@@ -339,7 +359,7 @@ export interface PhotoSize {
   width: number;
   /** Photo height */
   height: number;
-  /** File size */
+  /** File size in bytes */
   file_size?: number;
 }
 
@@ -361,7 +381,7 @@ export interface Animation {
   file_name?: string;
   /** MIME type of the file as defined by sender */
   mime_type?: string;
-  /** File size */
+  /** File size in bytes */
   file_size?: number;
 }
 
@@ -381,7 +401,7 @@ export interface Audio {
   file_name?: string;
   /** MIME type of the file as defined by sender */
   mime_type?: string;
-  /** File size */
+  /** File size in bytes */
   file_size?: number;
   /** Thumbnail of the album cover to which the music file belongs */
   thumb?: PhotoSize;
@@ -399,7 +419,7 @@ export interface Document {
   file_name?: string;
   /** MIME type of the file as defined by sender */
   mime_type?: string;
-  /** File size */
+  /** File size in bytes */
   file_size?: number;
 }
 
@@ -421,7 +441,7 @@ export interface Video {
   file_name?: string;
   /** Mime type of a file as defined by sender */
   mime_type?: string;
-  /** File size */
+  /** File size in bytes */
   file_size?: number;
 }
 
@@ -437,7 +457,7 @@ export interface VideoNote {
   duration: number;
   /** Video thumbnail */
   thumb?: PhotoSize;
-  /** File size */
+  /** File size in bytes */
   file_size?: number;
 }
 
@@ -451,7 +471,7 @@ export interface Voice {
   duration: number;
   /** MIME type of the file as defined by sender */
   mime_type?: string;
-  /** File size */
+  /** File size in bytes */
   file_size?: number;
 }
 
@@ -533,7 +553,7 @@ export interface Location {
   latitude: number;
   /** The radius of uncertainty for the location, measured in meters; 0-1500 */
   horizontal_accuracy?: number;
-  /** Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only. */
+  /** Time relative to the message sending date, during which the location can be updated; in seconds. For active live locations only. */
   live_period?: number;
   /** The direction in which user is moving, in degrees; 1-360. For active live locations only. */
   heading?: number;
@@ -571,7 +591,7 @@ export interface ProximityAlertTriggered {
 
 /** This object represents a service message about a change in auto-delete timer settings. */
 export interface MessageAutoDeleteTimerChanged {
-  /** New auto-delete time for messages in the chat */
+  /** New auto-delete time for messages in the chat; in seconds */
   message_auto_delete_time: number;
 }
 
@@ -586,7 +606,7 @@ export interface VoiceChatStarted {}
 
 /** This object represents a service message about a voice chat ended in the chat. */
 export interface VoiceChatEnded {
-  /** Voice chat duration; in seconds */
+  /** Voice chat duration in seconds */
   duration: number;
 }
 
@@ -616,7 +636,7 @@ export interface Sticker {
   set_name?: string;
   /** For mask stickers, the position where the mask should be placed */
   mask_position?: MaskPosition;
-  /** File size */
+  /** File size in bytes */
   file_size?: number;
 }
 

package/package.json

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

package/passport.d.ts

@@ -12,7 +12,7 @@ export interface PassportFile {
   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;
-  /** File size */
+  /** File size in bytes */
   file_size: number;
   /** Unix time when the file was uploaded */
   file_date: number;

package/proxied.d.ts

@@ -42,8 +42,7 @@ export interface InputFileProxy<F> {
     [M in keyof InputFileProxy<F>["Telegram"]]: Params<
       M,
       F
-    >[0] extends undefined
-      ? {}
+    >[0] extends undefined ? {}
       : NonNullable<Params<M, F>[0]>;
   };
 
@@ -102,7 +101,7 @@ export interface InputFileProxy<F> {
     /** Use this method to get current webhook status. Requires no parameters. On success, returns a WebhookInfo object. If the bot is using getUpdates, will return an object with the url field empty. */
     getWebhookInfo(): WebhookInfo;
 
-    /** A simple method for testing your bot's auth token. Requires no parameters. Returns basic information about the bot in form of a User object. */
+    /** A simple method for testing your bot's authentication token. Requires no parameters. Returns basic information about the bot in form of a User object. */
     getMe(): UserFromGetMe;
 
     /** Use this method to log out from the cloud Bot API server before launching the bot locally. You must log out the bot before running it locally, otherwise there is no guarantee that the bot will receive updates. After a successful call, you can immediately log in on a local server, but will not be able to log in back to the cloud Bot API server for 10 minutes. Returns True on success. Requires no parameters. */
@@ -119,7 +118,7 @@ export interface InputFileProxy<F> {
       text: string;
       /** Mode for parsing entities in the message text. See formatting options for more details. */
       parse_mode?: ParseMode;
-      /** List of special entities that appear in message text, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in message text, which can be specified instead of parse_mode */
       entities?: MessageEntity[];
       /** Boolean Disables link previews for links in this message */
       disable_web_page_preview?: boolean;
@@ -161,7 +160,7 @@ export interface InputFileProxy<F> {
       caption?: string;
       /** Mode for parsing entities in the new caption. See formatting options for more details. */
       parse_mode?: string;
-      /** List of special entities that appear in the new caption, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in the new caption, which can be specified instead of parse_mode */
       caption_entities?: MessageEntity[];
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
@@ -187,7 +186,7 @@ export interface InputFileProxy<F> {
       caption?: string;
       /** Mode for parsing entities in the photo caption. See formatting options for more details. */
       parse_mode?: ParseMode;
-      /** List of special entities that appear in the caption, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
       caption_entities?: MessageEntity[];
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
@@ -215,7 +214,7 @@ export interface InputFileProxy<F> {
       caption?: string;
       /** Mode for parsing entities in the audio caption. See formatting options for more details. */
       parse_mode?: ParseMode;
-      /** List of special entities that appear in the caption, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
       caption_entities?: MessageEntity[];
       /** Duration of the audio in seconds */
       duration?: number;
@@ -224,7 +223,7 @@ export interface InputFileProxy<F> {
       /** 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>. */
-      thumb?: F | string;
+      thumb?: F;
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
       /** If the message is a reply, ID of the original message */
@@ -246,12 +245,12 @@ export interface InputFileProxy<F> {
       /** 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>. */
-      thumb?: F | string;
+      thumb?: F;
       /** Document caption (may also be used when resending documents by file_id), 0-1024 characters after entities parsing */
       caption?: string;
       /** Mode for parsing entities in the document caption. See formatting options for more details. */
       parse_mode?: ParseMode;
-      /** List of special entities that appear in the caption, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
       caption_entities?: MessageEntity[];
       /** Disables automatic server-side content type detection for files uploaded using multipart/form-data. Always true, if the document is sent as part of an album. */
       disable_content_type_detection?: boolean;
@@ -282,12 +281,12 @@ export interface InputFileProxy<F> {
       /** 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>. */
-      thumb?: F | string;
+      thumb?: F;
       /** Video caption (may also be used when resending videos by file_id), 0-1024 characters after entities parsing */
       caption?: string;
       /** Mode for parsing entities in the video caption. See formatting options for more details. */
       parse_mode?: ParseMode;
-      /** List of special entities that appear in the caption, which can be specified instead of parse_mode */
+      /** 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 */
       supports_streaming?: boolean;
@@ -318,12 +317,12 @@ export interface InputFileProxy<F> {
       /** 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>. */
-      thumb?: F | string;
+      thumb?: F;
       /** Animation caption (may also be used when resending animation by file_id), 0-1024 characters after entities parsing */
       caption?: string;
       /** Mode for parsing entities in the animation caption. See formatting options for more details. */
       parse_mode?: ParseMode;
-      /** List of special entities that appear in the caption, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
       caption_entities?: MessageEntity[];
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
@@ -349,7 +348,7 @@ export interface InputFileProxy<F> {
       caption?: string;
       /** Mode for parsing entities in the voice message caption. See formatting options for more details. */
       parse_mode?: ParseMode;
-      /** List of special entities that appear in the caption, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
       caption_entities?: MessageEntity[];
       /** Duration of the voice message in seconds */
       duration?: number;
@@ -379,7 +378,7 @@ export interface InputFileProxy<F> {
       /** 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>. */
-      thumb?: F | string;
+      thumb?: F;
       /** Sends the message silently. Users will receive a notification with no sound. */
       disable_notification?: boolean;
       /** If the message is a reply, ID of the original message */
@@ -562,7 +561,7 @@ export interface InputFileProxy<F> {
       explanation?: string;
       /** Mode for parsing entities in the explanation. See formatting options for more details. */
       explanation_parse_mode?: ParseMode;
-      /** List of special entities that appear in the poll explanation, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in the poll explanation, which can be specified instead of parse_mode */
       explanation_entities?: MessageEntity[];
       /** Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with close_date. */
       open_period?: number;
@@ -612,7 +611,7 @@ export interface InputFileProxy<F> {
     sendChatAction(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
-      /** Type of action to broadcast. Choose one, depending on what the user is about to receive: typing for text messages, upload_photo for photos, record_video or upload_video for videos, record_voice or upload_voice for voice notes, upload_document for general files, find_location for location data, record_video_note or upload_video_note for video notes. */
+      /** Type of action to broadcast. Choose one, depending on what the user is about to receive: typing for text messages, upload_photo for photos, record_video or upload_video for videos, record_voice or upload_voice for voice notes, upload_document for general files, choose_sticker for stickers, find_location for location data, record_video_note or upload_video_note for video notes. */
       action:
         | "typing"
         | "upload_photo"
@@ -621,6 +620,7 @@ export interface InputFileProxy<F> {
         | "record_voice"
         | "upload_voice"
         | "upload_document"
+        | "choose_sticker"
         | "find_location"
         | "record_video_note"
         | "upload_video_note";
@@ -644,11 +644,11 @@ export interface InputFileProxy<F> {
       file_id: string;
     }): File;
 
-    /** Use this method to ban a user in a group, a supergroup or a channel. In the case of supergroups and channels, the user will not be able to return to the chat on their own using invite links, etc., unless unbanned first. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns True on success.
+    /** Use this method to ban a user in a group, a supergroup or a channel. In the case of supergroups and channels, the user will not be able to return to the chat on their own using invite links, etc., unless unbanned first. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns True on success.
      * @deprecated Use `banChatMember` instead. */
     kickChatMember: InputFileProxy<F>["Telegram"]["banChatMember"];
 
-    /** Use this method to ban a user in a group, a supergroup or a channel. In the case of supergroups and channels, the user will not be able to return to the chat on their own using invite links, etc., unless unbanned first. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns True on success. */
+    /** Use this method to ban a user in a group, a supergroup or a channel. In the case of supergroups and channels, the user will not be able to return to the chat on their own using invite links, etc., unless unbanned first. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns True on success. */
     banChatMember(args: {
       /** Unique identifier for the target group or username of the target supergroup or channel (in the format @channelusername) */
       chat_id: number | string;
@@ -670,7 +670,7 @@ export interface InputFileProxy<F> {
       only_if_banned?: boolean;
     }): true;
 
-    /** Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for this to work and must have the appropriate admin rights. Pass True for all permissions to lift restrictions from a user. Returns True on success. */
+    /** Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for this to work and must have the appropriate administrator rights. Pass True for all permissions to lift restrictions from a user. Returns True on success. */
     restrictChatMember(args: {
       /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */
       chat_id: number | string;
@@ -682,7 +682,7 @@ export interface InputFileProxy<F> {
       until_date?: number;
     }): true;
 
-    /** Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Pass False for all boolean parameters to demote a user. Returns True on success. */
+    /** Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Pass False for all boolean parameters to demote a user. Returns True on success. */
     promoteChatMember(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
@@ -722,15 +722,33 @@ export interface InputFileProxy<F> {
       custom_title: string;
     }): true;
 
-    /** Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the can_restrict_members admin rights. Returns True on success. */
+    /** Use this method to ban a channel chat in a supergroup or a channel. The owner of the chat will not be able to send messages and join live streams on behalf of the chat, unless it is unbanned first. The bot must be an administrator in the supergroup or channel for this to work and must have the appropriate administrator rights. Returns True on success. */
+    banChatSenderChat(args: {
+      /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+      chat_id: number | string;
+      /** Unique identifier of the target sender chat */
+      sender_chat_id: number;
+      /** Date when the sender chat will be unbanned, unix time. If the chat is banned for more than 366 days or less than 30 seconds from the current time they are considered to be banned forever. */
+      until_date?: number;
+    }): true;
+
+    /** Use this method to unban a previously banned channel chat in a supergroup or channel. The bot must be an administrator for this to work and must have the appropriate administrator rights. Returns True on success. */
+    unbanChatSenderChat(args: {
+      /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+      chat_id: number | string;
+      /** Unique identifier of the target sender chat */
+      sender_chat_id: number;
+    }): true;
+
+    /** Use this method to set default chat permissions for all members. The bot must be an administrator in the group or a supergroup for this to work and must have the can_restrict_members administrator rights. Returns True on success. */
     setChatPermissions(args: {
       /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */
       chat_id: number | string;
-      /** New default chat permissions */
+      /** An object for new default chat permissions */
       permissions: ChatPermissions;
     }): true;
 
-    /** Use this method to generate a new primary invite link for a chat; any previously generated primary link is revoked. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns the new invite link as String on success.
+    /** Use this method to generate a new primary invite link for a chat; any previously generated primary link is revoked. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the new invite link as String on success.
 
     Note: Each administrator in a chat generates their own invite links. Bots can't use invite links generated by other administrators. If you want your bot to work with invite links, it will need to generate its own link using exportChatInviteLink or by calling the getChat method. If your bot needs to generate a new primary invite link replacing its previous one, use exportChatInviteLink again. */
     exportChatInviteLink(args: {
@@ -738,29 +756,37 @@ export interface InputFileProxy<F> {
       chat_id: number | string;
     }): string;
 
-    /** Use this method to create an additional invite link for a chat. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. The link can be revoked using the method revokeChatInviteLink. Returns the new invite link as ChatInviteLink object. */
+    /** Use this method to create an additional invite link for a chat. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. The link can be revoked using the method revokeChatInviteLink. Returns the new invite link as ChatInviteLink object. */
     createChatInviteLink(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
+      /** Invite link name; 0-32 characters */
+      name?: string;
       /** Point in time (Unix timestamp) when the link will expire */
       expire_date?: number;
       /** Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 */
       member_limit?: number;
+      /** True, if users joining the chat via the link need to be approved by chat administrators. If True, member_limit can't be specified */
+      creates_join_request?: boolean;
     }): ChatInviteLink;
 
-    /** Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns the edited invite link as a ChatInviteLink object. */
+    /** Use this method to edit a non-primary invite link created by the bot. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the edited invite link as a ChatInviteLink object. */
     editChatInviteLink(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
       /** The invite link to edit */
       invite_link: string;
+      /** Invite link name; 0-32 characters */
+      name?: string;
       /** Point in time (Unix timestamp) when the link will expire */
       expire_date?: number;
       /** Maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999 */
       member_limit?: number;
+      /** True, if users joining the chat via the link need to be approved by chat administrators. If True, member_limit can't be specified */
+      creates_join_request?: boolean;
     }): ChatInviteLink;
 
-    /** Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns the revoked invite link as ChatInviteLink object. */
+    /** Use this method to revoke an invite link created by the bot. If the primary link is revoked, a new link is automatically generated. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns the revoked invite link as ChatInviteLink object. */
     revokeChatInviteLink(args: {
       /** Unique identifier of the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
@@ -768,7 +794,23 @@ export interface InputFileProxy<F> {
       invite_link: string;
     }): ChatInviteLink;
 
-    /** Use this method to set a new profile photo for the chat. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns True on success. */
+    /** Use this method to approve a chat join request. The bot must be an administrator in the chat for this to work and must have the can_invite_users administrator right. Returns True on success. */
+    approveChatJoinRequest(args: {
+      /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+      chat_id: number | string;
+      /** Unique identifier of the target user */
+      user_id: number;
+    }): true;
+
+    /** Use this method to decline a chat join request. The bot must be an administrator in the chat for this to work and must have the can_invite_users administrator right. Returns True on success. */
+    declineChatJoinRequest(args: {
+      /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+      chat_id: number | string;
+      /** Unique identifier of the target user */
+      user_id: number;
+    }): true;
+
+    /** Use this method to set a new profile photo for the chat. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns True on success. */
     setChatPhoto(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
@@ -776,13 +818,13 @@ export interface InputFileProxy<F> {
       photo: F;
     }): true;
 
-    /** Use this method to delete a chat photo. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns True on success. */
+    /** Use this method to delete a chat photo. Photos can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns True on success. */
     deleteChatPhoto(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
     }): true;
 
-    /** Use this method to change the title of a chat. Titles can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns True on success. */
+    /** Use this method to change the title of a chat. Titles can't be changed for private chats. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns True on success. */
     setChatTitle(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
@@ -790,7 +832,7 @@ export interface InputFileProxy<F> {
       title: string;
     }): true;
 
-    /** Use this method to change the description of a group, a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Returns True on success. */
+    /** Use this method to change the description of a group, a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Returns True on success. */
     setChatDescription(args: {
       /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
       chat_id: number | string;
@@ -858,7 +900,7 @@ export interface InputFileProxy<F> {
       user_id: number;
     }): ChatMember;
 
-    /** Use this method to set a new group sticker set for a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Use the field can_set_sticker_set ly returned in getChat requests to check if the bot can use this method. Returns True on success. */
+    /** Use this method to set a new group sticker set for a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field can_set_sticker_set ly returned in getChat requests to check if the bot can use this method. Returns True on success. */
     setChatStickerSet(args: {
       /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */
       chat_id: number | string;
@@ -866,7 +908,7 @@ export interface InputFileProxy<F> {
       sticker_set_name: string;
     }): true;
 
-    /** Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate admin rights. Use the field can_set_sticker_set ly returned in getChat requests to check if the bot can use this method. Returns True on success. */
+    /** Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Use the field can_set_sticker_set ly returned in getChat requests to check if the bot can use this method. Returns True on success. */
     deleteChatStickerSet(args: {
       /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */
       chat_id: number | string;
@@ -880,7 +922,7 @@ export interface InputFileProxy<F> {
       callback_query_id: string;
       /** Text of the notification. If not specified, nothing will be shown to the user, 0-200 characters */
       text?: string;
-      /** If true, an alert will be shown by the client instead of a notification at the top of the chat screen. Defaults to false. */
+      /** If True, an alert will be shown by the client instead of a notification at the top of the chat screen. Defaults to false. */
       show_alert?: boolean;
       /** URL that will be opened by the user's client. If you have created a Game and accepted the conditions via @Botfather, specify the URL that opens your game — note that this will only work if the query comes from a callback_game button.
 
@@ -928,7 +970,7 @@ export interface InputFileProxy<F> {
       text: string;
       /** Mode for parsing entities in the message text. See formatting options for more details. */
       parse_mode?: ParseMode;
-      /** List of special entities that appear in message text, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in message text, which can be specified instead of parse_mode */
       entities?: MessageEntity[];
       /** Disables link previews for links in this message */
       disable_web_page_preview?: boolean;
@@ -948,7 +990,7 @@ export interface InputFileProxy<F> {
       caption?: string;
       /** Mode for parsing entities in the message caption. See formatting options for more details. */
       parse_mode?: ParseMode;
-      /** List of special entities that appear in the caption, which can be specified instead of parse_mode */
+      /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
       caption_entities?: MessageEntity[];
       /** An object for an inline keyboard. */
       reply_markup?: InlineKeyboardMarkup;
@@ -1109,7 +1151,7 @@ export interface InputFileProxy<F> {
     /** Use this method to send answers to an inline query. On success, True is returned.
     No more than 50 results per query are allowed.
 
-    Example: An inline bot that sends YouTube videos can ask the user to connect the bot to their YouTube account to adapt search results accordingly. To do this, it displays a 'Connect your YouTube account' button above the results, or even before showing any. The user presses the button, switches to a private chat with the bot and, in doing so, passes a start parameter that instructs the bot to return an oauth link. Once done, the bot can offer a switch_inline button so that the user can easily return to the chat where they wanted to use the bot's inline capabilities. */
+    Example: An inline bot that sends YouTube videos can ask the user to connect the bot to their YouTube account to adapt search results accordingly. To do this, it displays a 'Connect your YouTube account' button above the results, or even before showing any. The user presses the button, switches to a private chat with the bot and, in doing so, passes a start parameter that instructs the bot to return an OAuth link. Once done, the bot can offer a switch_inline button so that the user can easily return to the chat where they wanted to use the bot's inline capabilities. */
     answerInlineQuery(args: {
       /** Unique identifier for the answered query */
       inline_query_id: string;
@@ -1298,7 +1340,7 @@ export interface InputFileProxy<F> {
     /** 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>. */
-    thumb?: F | string;
+    thumb?: F;
     /** Caption of the video to be sent, 0-1024 characters after entities parsing */
     caption?: string;
     /** Mode for parsing entities in the video caption. See formatting options for more details. */
@@ -1309,7 +1351,7 @@ export interface InputFileProxy<F> {
     width?: number;
     /** Video height */
     height?: number;
-    /** Video duration */
+    /** Video duration in seconds */
     duration?: number;
     /** Pass True, if the uploaded video is suitable for streaming */
     supports_streaming?: boolean;
@@ -1322,7 +1364,7 @@ export interface InputFileProxy<F> {
     /** 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>. */
-    thumb?: F | string;
+    thumb?: F;
     /** Caption of the animation to be sent, 0-1024 characters after entities parsing */
     caption?: string;
     /** Mode for parsing entities in the animation caption. See formatting options for more details. */
@@ -1333,7 +1375,7 @@ export interface InputFileProxy<F> {
     width?: number;
     /** Animation height */
     height?: number;
-    /** Animation duration */
+    /** Animation duration in seconds */
     duration?: number;
   };
 
@@ -1344,7 +1386,7 @@ export interface InputFileProxy<F> {
     /** 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>. */
-    thumb?: F | string;
+    thumb?: F;
     /** Caption of the audio to be sent, 0-1024 characters after entities parsing */
     caption?: string;
     /** Mode for parsing entities in the audio caption. See formatting options for more details. */
@@ -1366,7 +1408,7 @@ export interface InputFileProxy<F> {
     /** 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>. */
-    thumb?: F | string;
+    thumb?: F;
     /** Caption of the document to be sent, 0-1024 characters after entities parsing */
     caption?: string;
     /** Mode for parsing entities in the document caption. See formatting options for more details. */

package/update.d.ts

@@ -1,6 +1,6 @@
 import { CallbackQuery } from "./callback";
 import { ChosenInlineResult, InlineQuery } from "./inline";
-import { Chat, ChatMemberUpdated, User } from "./manage";
+import { Chat, ChatJoinRequest, ChatMemberUpdated, User } from "./manage";
 import { Message, Poll, PollAnswer } from "./message";
 import { PreCheckoutQuery, ShippingQuery } from "./payment";
 
@@ -66,4 +66,6 @@ export interface Update {
   my_chat_member?: ChatMemberUpdated;
   /** A chat member's status was updated in a chat. The bot must be an administrator in the chat and must explicitly specify “chat_member” in the list of allowed_updates to receive these updates. */
   chat_member?: ChatMemberUpdated;
+  /** A request to join the chat has been sent. The bot must have the can_invite_users administrator right in the chat to receive these updates. */
+  chat_join_request?: ChatJoinRequest;
 }