@grammyjs/types 3.2.1 → 3.3.0

package/inline.d.ts

@@ -72,7 +72,7 @@ export interface InlineQueryResultPhoto {
     type: "photo";
     /** Unique identifier for this result, 1-64 bytes */
     id: string;
-    /** A valid URL of the photo. Photo must be in jpeg format. Photo size must not exceed 5MB */
+    /** A valid URL of the photo. Photo must be in JPEG format. Photo size must not exceed 5MB */
     photo_url: string;
     /** URL of the thumbnail for the photo */
     thumbnail_url: string;
@@ -119,6 +119,8 @@ export interface InlineQueryResultGif {
     caption?: string;
     /** Mode for parsing entities in the 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 */
+    caption_entities?: MessageEntity[];
     /** Inline keyboard attached to the message */
     reply_markup?: InlineKeyboardMarkup;
     /** Content of the message to be sent instead of the GIF animation */
@@ -148,6 +150,8 @@ export interface InlineQueryResultMpeg4Gif {
     caption?: string;
     /** Mode for parsing entities in the 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 */
+    caption_entities?: MessageEntity[];
     /** Inline keyboard attached to the message */
     reply_markup?: InlineKeyboardMarkup;
     /** Content of the message to be sent instead of the video animation */
@@ -155,7 +159,7 @@ export interface InlineQueryResultMpeg4Gif {
 }
 /** Represents a link to a page containing an embedded video player or a video file. By default, this video file will be sent by the user with an optional caption. Alternatively, you can use input_message_content to send a message with the specified content instead of the video.
 
-If an InlineQueryResultVideo message contains an embedded video (e.g., YouTube), you must replace its content using input_message_content. */
+> If an InlineQueryResultVideo message contains an embedded video (e.g., YouTube), you must replace its content using input_message_content. */
 export interface InlineQueryResultVideo {
     /** Type of the result, must be video */
     type: "video";
@@ -231,6 +235,8 @@ export interface InlineQueryResultVoice {
     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 */
+    caption_entities?: MessageEntity[];
     /** Recording duration in seconds */
     voice_duration?: number;
     /** Inline keyboard attached to the message */
@@ -289,9 +295,9 @@ export interface InlineQueryResultLocation {
     horizontal_accuracy?: number;
     /** Period in seconds for which the location can be updated, should be between 60 and 86400. */
     live_period?: number;
-    /** The direction in which user is moving, in degrees; 1-360. For active live locations only. */
+    /** For live locations, a direction in which the user is moving, in degrees. Must be between 1 and 360 if specified. */
     heading?: number;
-    /** The maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only. */
+    /** For live locations, a maximum distance for proximity alerts about approaching another chat member, in meters. Must be between 1 and 100000 if specified. */
     proximity_alert_radius?: number;
     /** Inline keyboard attached to the message */
     reply_markup?: InlineKeyboardMarkup;
@@ -416,6 +422,8 @@ export interface InlineQueryResultCachedGif {
     caption?: string;
     /** Mode for parsing entities in the 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 */
+    caption_entities?: MessageEntity[];
     /** Inline keyboard attached to the message */
     reply_markup?: InlineKeyboardMarkup;
     /** Content of the message to be sent instead of the GIF animation */
@@ -435,6 +443,8 @@ export interface InlineQueryResultCachedMpeg4Gif {
     caption?: string;
     /** Mode for parsing entities in the 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 */
+    caption_entities?: MessageEntity[];
     /** Inline keyboard attached to the message */
     reply_markup?: InlineKeyboardMarkup;
     /** Content of the message to be sent instead of the video animation */
@@ -442,8 +452,7 @@ export interface InlineQueryResultCachedMpeg4Gif {
 }
 /** Represents a link to a sticker stored on the Telegram servers. By default, this sticker will be sent by the user. Alternatively, you can use input_message_content to send a message with the specified content instead of the sticker.
 
-Note: This will only work in Telegram versions released after 9 April, 2016 for static stickers and after 06 July, 2019 for animated stickers. Older clients will ignore them.
-*/
+Note: This will only work in Telegram versions released after 9 April, 2016 for static stickers and after 06 July, 2019 for animated stickers. Older clients will ignore them. */
 export interface InlineQueryResultCachedSticker {
     /** Type of the result, must be sticker */
     type: "sticker";
@@ -520,6 +529,8 @@ export interface InlineQueryResultCachedVoice {
     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 */
+    caption_entities?: MessageEntity[];
     /** Inline keyboard attached to the message */
     reply_markup?: InlineKeyboardMarkup;
     /** Content of the message to be sent instead of the voice message */

package/manage.d.ts

@@ -208,7 +208,7 @@ export interface ChatInviteLink {
 export interface ChatAdministratorRights {
     /** True, if the user's presence in the chat is hidden */
     is_anonymous: boolean;
-    /** True, if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege */
+    /** True, if the administrator can access the chat event log, chat statistics, boost list in channels, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege */
     can_manage_chat: boolean;
     /** True, if the administrator can delete messages of other users */
     can_delete_messages: boolean;
@@ -222,12 +222,18 @@ export interface ChatAdministratorRights {
     can_change_info: boolean;
     /** True, if the user is allowed to invite new users to the chat */
     can_invite_users: boolean;
-    /** True, if the administrator can post in the channel; channels only */
+    /** True, if the administrator can post messages in the channel; channels only */
     can_post_messages?: boolean;
     /** True, if the administrator can edit messages of other users and can pin messages; channels only */
     can_edit_messages?: boolean;
     /** True, if the user is allowed to pin messages; groups and supergroups only */
     can_pin_messages?: boolean;
+    /** True, if the administrator can post stories in the channel; channels only */
+    can_post_stories?: boolean;
+    /** True, if the administrator can edit stories posted by other users; channels only */
+    can_edit_stories?: boolean;
+    /** True, if the administrator can delete stories posted by other users; channels only */
+    can_delete_stories?: boolean;
     /** True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only */
     can_manage_topics?: boolean;
 }
@@ -260,7 +266,7 @@ export interface ChatMemberAdministrator {
     can_be_edited: boolean;
     /** True, if the user's presence in the chat is hidden */
     is_anonymous: boolean;
-    /** True, if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege */
+    /** True, if the administrator can access the chat event log, chat statistics, boost list in channels, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege */
     can_manage_chat: boolean;
     /** True, if the administrator can delete messages of other users */
     can_delete_messages: boolean;
@@ -274,12 +280,18 @@ export interface ChatMemberAdministrator {
     can_change_info: boolean;
     /** True, if the user is allowed to invite new users to the chat */
     can_invite_users: boolean;
-    /** True, if the administrator can post in the channel; channels only */
+    /** True, if the administrator can post messages in the channel; channels only */
     can_post_messages?: boolean;
     /** True, if the administrator can edit messages of other users and can pin messages; channels only */
     can_edit_messages?: boolean;
     /** True, if the user is allowed to pin messages; groups and supergroups only */
     can_pin_messages?: boolean;
+    /** True, if the administrator can post stories in the channel; channels only */
+    can_post_stories?: boolean;
+    /** True, if the administrator can edit stories posted by other users; channels only */
+    can_edit_stories?: boolean;
+    /** True, if the administrator can delete stories posted by other users; channels only */
+    can_delete_stories?: boolean;
     /** True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only */
     can_manage_topics?: boolean;
     /** Custom title for this user */

package/message.d.ts

@@ -180,7 +180,7 @@ export interface Message extends Message.MediaMessage {
     chat_shared?: ChatShared;
     /** The domain name of the website on which the user has logged in. More about Telegram Login » */
     connected_website?: string;
-    /** Service message: the user allowed the bot added to the attachment menu to write messages */
+    /** Service message: the user allowed the bot to write messages after adding it to the attachment or side menu, launching a Web App from a link, or accepting an explicit request from a Web App sent by the method requestWriteAccess */
     write_access_allowed?: WriteAccessAllowed;
     /** Telegram Passport data */
     passport_data?: PassportData;
@@ -627,10 +627,14 @@ export interface ChatShared {
     /** Identifier of the shared chat. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier. The bot may not have access to the chat and could be unable to use this identifier, unless the chat is already known to the bot by some other means. */
     chat_id: number;
 }
-/** This object represents a service message about a user allowing a bot to write messages after adding the bot to the attachment menu or launching a Web App from a link. */
+/** This object represents a service message about a user allowing a bot to write messages after adding it to the attachment menu, launching a Web App from a link, or accepting an explicit request from a Web App sent by the method requestWriteAccess. */
 export interface WriteAccessAllowed {
-    /** Name of the Web App which was launched from a link */
+    /** True, if the access was granted after the user accepted an explicit request from a Web App sent by the method requestWriteAccess */
+    from_request?: boolean;
+    /** Name of the Web App, if the access was granted when the Web App was launched from a link */
     web_app_name?: string;
+    /** True, if the access was granted when the bot was added to the attachment or side menu */
+    from_attachment_menu?: boolean;
 }
 /** This object represents a service message about a video chat scheduled in the chat. */
 export interface VideoChatScheduled {

package/methods.d.ts

@@ -624,14 +624,20 @@ export type ApiMethods<F> = {
         user_id: number;
         /** 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, boost list in channels, 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 post messages in the channel; 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 */
         can_delete_messages?: boolean;
+        /** Pass True if the administrator can post stories in the channel; channels only */
+        can_post_stories?: boolean;
+        /** Pass True if the administrator can edit stories posted by other users; channels only */
+        can_edit_stories?: boolean;
+        /** Pass True if the administrator can delete stories posted by other users; channels only */
+        can_delete_stories?: boolean;
         /** Pass True if the administrator can manage video chats */
         can_manage_video_chats?: boolean;
         /** Pass True if the administrator can restrict, ban or unban chat members */

package/package.json

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