@telegram.ts/types 1.3.2 → 1.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telegram.ts/types",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "@telegram.ts/types: Comprehensive Type Declarations for Telegram Bot API with telegramsjs",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/apiMethodsTypes.d.ts

@@ -750,6 +750,12 @@ export type ApiMethods<F> = {
     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 */
@@ -1027,6 +1033,11 @@ export type ApiMethods<F> = {
     /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */
     chat_id: number | string;
   }): true;
+  /** Use this method to clear the list of pinned messages in a General forum topic. The bot must be an administrator in the chat for this to work and must have the can_pin_messages administrator right in the supergroup. Returns True on success. */
+  unpinAllGeneralForumTopicMessages(args: {
+    /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */
+    chat_id: number | string;
+  }): true;
   /** Use this method to send answers to callback queries sent from inline keyboards. The answer will be displayed to the user as a notification at the top of the chat screen or as an alert. On success, True is returned.
 
   Alternatively, the user can be redirected to the specified Game URL. For this option to work, you must first create a game for your bot via @BotFather and accept the terms. Otherwise, you may use links like t.me/your_bot?start=XXXX that open your bot with a parameter. */

package/src/inlineTypes.d.ts

@@ -139,6 +139,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 */
@@ -168,6 +170,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 */
@@ -251,6 +255,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 */
@@ -309,9 +315,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;
@@ -436,6 +442,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 */
@@ -455,6 +463,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 */
@@ -540,6 +550,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/src/manageTypes.d.ts

@@ -136,6 +136,8 @@ export declare namespace Chat {
       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. */
+    emoji_status_expiration_date?: number;
     /** 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. */
@@ -246,6 +248,12 @@ export interface ChatAdministratorRights {
   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;
 }
@@ -304,6 +312,12 @@ export interface ChatMemberAdministrator {
   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/src/messageTypes.d.ts

@@ -66,6 +66,7 @@ export declare namespace Message {
   export type AnimationMessage = DocumentMessage & MsgWith<"animation">;
   export type PhotoMessage = MediaMessage & MsgWith<"photo">;
   export type StickerMessage = CommonMessage & MsgWith<"sticker">;
+  export type StoryMessage = CommonMessage & MsgWith<"story">;
   export type VideoMessage = MediaMessage & MsgWith<"video">;
   export type VideoNoteMessage = CommonMessage & MsgWith<"video_note">;
   export type VoiceMessage = CaptionableMessage & MsgWith<"voice">;
@@ -175,6 +176,8 @@ export interface Message extends Message.MediaMessage {
   new_chat_title?: string;
   /** A chat photo was change to this value */
   new_chat_photo?: PhotoSize[];
+  /** Message is a forwarded story */
+  story?: Story;
   /** Service message: the chat photo was deleted */
   delete_chat_photo?: true;
   /** Service message: the group has been created */
@@ -540,9 +543,11 @@ export interface PollOption {
 export interface PollAnswer {
   /** Unique poll identifier */
   poll_id: string;
-  /** The user, who changed the answer to the poll */
-  user: User;
-  /** 0-based identifiers of answer options, chosen by the user. May be empty if the user retracted their vote. */
+  /** The chat that changed the answer to the poll, if the voter is anonymous */
+  voter_chat?: Chat;
+  /** The user that changed the answer to the poll, if the voter isn't anonymous */
+  user?: User;
+  /** 0-based identifiers of chosen answer options. May be empty if the vote was retracted. */
   option_ids: number[];
 }
 /** This object contains information about a poll. */
@@ -606,6 +611,8 @@ export interface Venue {
   /** Google Places type of the venue. (See supported types.) */
   google_place_type?: string;
 }
+/** This object represents a message about a forwarded story in the chat. Currently holds no information. */
+export interface Story {}
 /** This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user. */
 export interface ProximityAlertTriggered {
   /** User that triggered the alert */
@@ -660,8 +667,12 @@ export interface ChatShared {
 }
 /** 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. */
 export interface WriteAccessAllowed {
+  /** 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 which 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 {