@grammyjs/types 3.2.0 → 3.2.2

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

@@ -130,7 +130,7 @@ export declare namespace Chat {
     interface PrivateGetChat extends PrivateChat, NonGroupGetChat, GetChat {
         /** Custom emoji identifier of emoji status of the other party in a private chat. Returned only in getChat. */
         emoji_status_custom_emoji_id?: string;
-        /** Expiration date of the emoji status of the other party in a private chat, if any. Returned only in getChat. */
+        /** Expiration date of the emoji status of the other party in a private chat in Unix time, if any. Returned only in getChat. */
         emoji_status_expiration_date?: number;
         /** Bio of the other party in a private chat. Returned only in getChat. */
         bio?: string;
@@ -328,7 +328,7 @@ export interface ChatMemberRestricted {
     can_pin_messages: boolean;
     /** True, if the user is allowed to create forum topics */
     can_manage_topics: boolean;
-    /** Date when restrictions will be lifted for this user; unix time. If 0, then the user is restricted forever */
+    /** Date when restrictions will be lifted for this user; Unix time. If 0, then the user is restricted forever */
     until_date: number;
 }
 /** Represents a chat member that isn't currently a member of the chat, but may join it themselves. */
@@ -344,7 +344,7 @@ export interface ChatMemberBanned {
     status: "kicked";
     /** Information about the user */
     user: User;
-    /** Date when restrictions will be lifted for this user; unix time. If 0, then the user is banned forever */
+    /** Date when restrictions will be lifted for this user; Unix time. If 0, then the user is banned forever */
     until_date: number;
 }
 /** This object represents changes in the status of a chat member. */

package/methods.d.ts

@@ -589,7 +589,7 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier of the target user */
         user_id: number;
-        /** Date when the user will be unbanned, unix time. If user is banned for more than 366 days or less than 30 seconds from the current time they are considered to be banned forever. Applied for supergroups and channels only. */
+        /** Date when the user will be unbanned; Unix time. If user is banned for more than 366 days or less than 30 seconds from the current time they are considered to be banned forever. Applied for supergroups and channels only. */
         until_date?: number;
         /** Pass True to delete all messages from the chat for the user that is being removed. If False, the user will be able to see messages in the group that were sent before the user was removed. Always True for supergroups and channels. */
         revoke_messages?: boolean;
@@ -613,7 +613,7 @@ export type ApiMethods<F> = {
         permissions: ChatPermissions;
         /** Pass True if chat permissions are set independently. Otherwise, the can_send_other_messages and can_add_web_page_previews permissions will imply the can_send_messages, can_send_audios, can_send_documents, can_send_photos, can_send_videos, can_send_video_notes, and can_send_voice_notes permissions; the can_send_polls permission will imply the can_send_messages permission. */
         use_independent_chat_permissions?: boolean;
-        /** Date when restrictions will be lifted for the user, unix time. If user is restricted for more than 366 days or less than 30 seconds from the current time, they are considered to be restricted forever */
+        /** Date when restrictions will be lifted for the user; Unix time. If user is restricted for more than 366 days or less than 30 seconds from the current time, they are considered to be restricted forever */
         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 administrator rights. Pass False for all boolean parameters to demote a user. Returns True on success. */

package/package.json

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