@telegram.ts/types 1.5.0 → 1.7.0

package/src/inlineTypes.d.ts

@@ -604,7 +604,7 @@ export interface InputTextMessageContent {
   parse_mode?: ParseMode;
   /** List of special entities that appear in message text, which can be specified instead of parse_mode */
   entities?: MessageEntity[];
-/** Link preview generation options for the message */
+  /** Link preview generation options for the message */
   link_preview_options?: LinkPreviewOptions;
 }
 /** Represents the content of a location message to be sent as the result of an inline query. */

package/src/manageTypes.d.ts

@@ -1,4 +1,9 @@
-import type { Location, Message, PhotoSize, ReactionType } from "./messageTypes";
+import type {
+  Location,
+  Message,
+  PhotoSize,
+  ReactionType,
+} from "./messageTypes";
 import type { Update } from "./updateTypes";
 
 /** Describes the current status of a webhook. */
@@ -92,7 +97,9 @@ export declare namespace Chat {
   }
   /** Internal type representing super group chats. */
   export interface SupergroupChat
-    extends AbstractChat, UserNameChat, TitleChat {
+    extends AbstractChat,
+      UserNameChat,
+      TitleChat {
     type: "supergroup";
     /** True, if the supergroup chat is a forum (has topics enabled) */
     is_forum?: true;
@@ -132,8 +139,6 @@ export declare namespace Chat {
   interface MultiUserGetChat {
     /** Default chat member permissions, for groups and supergroups. Returned only in getChat. */
     permissions?: ChatPermissions;
-    /** True, if the bot can change the group sticker set. Returned only in getChat. */
-    can_set_sticker_set?: true;
   }
   /** Internal type holding properties that those private and channel chats returned from `getChat` share. */
   interface NonMultiUserGetChat {
@@ -155,7 +160,10 @@ export declare namespace Chat {
   // ==> GET CHATS
   /** Internal type representing private chats returned from `getChat`. */
   export interface PrivateGetChat
-    extends PrivateChat, GetChat, NonGroupGetChat, NonMultiUserGetChat {
+    extends PrivateChat,
+      GetChat,
+      NonGroupGetChat,
+      NonMultiUserGetChat {
     /** 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. */
@@ -165,11 +173,13 @@ export declare namespace Chat {
   }
   /** Internal type representing group chats returned from `getChat`. */
   export interface GroupGetChat
-    extends GroupChat, GetChat, NonPrivateGetChat, MultiUserGetChat {}
+    extends GroupChat,
+      GetChat,
+      NonPrivateGetChat,
+      MultiUserGetChat {}
   /** Internal type representing supergroup chats returned from `getChat`. */
   export interface SupergroupGetChat
-    extends
-      SupergroupChat,
+    extends SupergroupChat,
       GetChat,
       NonGroupGetChat,
       NonPrivateGetChat,
@@ -181,19 +191,24 @@ export declare namespace Chat {
     join_by_request?: true;
     /** 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, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions. Returned only in getChat. */
+    unrestrict_boost_count?: number;
     /** True, if new chat members will have access to old messages; available only to chat administrators. Returned only in getChat. */
     has_visible_history?: boolean;
     /** True, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators. Returned only in getChat. */
     has_aggressive_anti_spam_enabled?: true;
     /** For supergroups, name of group sticker set. Returned only in getChat. */
     sticker_set_name?: string;
+    /** True, if the bot can change the group sticker set. Returned only in getChat. */
+    can_set_sticker_set?: true;
+    /** For supergroups, the name of the group's custom emoji sticker set. Custom emoji from this set can be used by all users and bots in the group. Returned only in getChat. */
+    custom_emoji_sticker_set_name?: string;
     /** For supergroups, the location to which the supergroup is connected. Returned only in getChat. */
     location?: ChatLocation;
   }
   /** Internal type representing channel chats returned from `getChat`. */
   export interface ChannelGetChat
-    extends
-      ChannelChat,
+    extends ChannelChat,
       GetChat,
       NonGroupGetChat,
       NonPrivateGetChat,
@@ -266,7 +281,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, boost list in channels, see channel members, report spam messages, 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, get boost list, see hidden supergroup and channel members, report spam messages 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;
@@ -286,9 +301,9 @@ 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 */
+  /** True, if the administrator can post stories to the chat */
   can_post_stories?: boolean;
-  /** True, if the administrator can edit stories posted by other users; channels only */
+  /** True, if the administrator can edit stories posted by other users */
   can_edit_stories?: boolean;
   /** True, if the administrator can delete stories posted by other users; channels only */
   can_delete_stories?: boolean;
@@ -351,7 +366,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, boost list in channels, see channel members, report spam messages, 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, get boost list, see hidden supergroup and channel members, report spam messages 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;
@@ -371,11 +386,11 @@ 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 */
+  /** True, if the administrator can post stories to the chat */
   can_post_stories?: boolean;
-  /** True, if the administrator can edit stories posted by other users; channels only */
+  /** True, if the administrator can edit stories posted by other users */
   can_edit_stories?: boolean;
-  /** True, if the administrator can delete stories posted by other users; channels only */
+  /** True, if the administrator can delete stories posted by other users */
   can_delete_stories?: boolean;
   /** True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only */
   can_manage_topics?: boolean;
@@ -595,4 +610,4 @@ export interface ChatBoostRemoved {
 export interface UserChatBoosts {
   /** The list of boosts added to the chat by the user */
   boosts: ChatBoost[];
-}
+}

package/src/messageTypes.d.ts

@@ -23,6 +23,8 @@ export declare namespace Message {
     is_topic_message?: boolean;
   }
   export interface CommonMessage extends ServiceMessage {
+    /** If the sender of the message boosted the chat, the number of boosts added by the user */
+    sender_boost_count?: number;
     /** Information about the original message for forwarded messages */
     forward_origin?: MessageOrigin;
     /** True, if the message is a channel post that was automatically forwarded to the connected discussion group */
@@ -33,6 +35,8 @@ export declare namespace Message {
     external_reply?: ExternalReplyInfo;
     /** For replies that quote part of the original message, the quoted part of the message */
     quote?: TextQuote;
+    /** For replies to a story, the original message */
+    reply_to_story?: Story;
     /** Bot through which the message was sent */
     via_bot?: User;
     /** Date the message was last edited in Unix time */
@@ -75,92 +79,67 @@ export declare 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 SuccessfulPaymentMessage = ServiceMessage &
+    MsgWith<"successful_payment">;
   export type UsersSharedMessage = ServiceMessage & MsgWith<"users_shared">;
   export type ChatSharedMessage = ServiceMessage & MsgWith<"chat_shared">;
-  export type ConnectedWebsiteMessage =
-    & ServiceMessage
-    & MsgWith<"connected_website">;
-  export type WriteAccessAllowedMessage =
-    & ServiceMessage
-    & MsgWith<"write_access_allowed">;
+  export type ConnectedWebsiteMessage = ServiceMessage &
+    MsgWith<"connected_website">;
+  export type WriteAccessAllowedMessage = ServiceMessage &
+    MsgWith<"write_access_allowed">;
   export type PassportDataMessage = ServiceMessage & MsgWith<"passport_data">;
-  export type ProximityAlertTriggeredMessage =
-    & ServiceMessage
-    & MsgWith<"proximity_alert_triggered">;
-  export type ForumTopicCreatedMessage =
-    & ServiceMessage
-    & MsgWith<"forum_topic_created">;
-  export type ForumTopicEditedMessage =
-    & ServiceMessage
-    & MsgWith<"forum_topic_edited">;
-  export type ForumTopicClosedMessage =
-    & ServiceMessage
-    & MsgWith<"forum_topic_closed">;
-  export type ForumTopicReopenedMessage =
-    & ServiceMessage
-    & MsgWith<"forum_topic_reopened">;
-  export type GeneralForumTopicHiddenMessage =
-    & ServiceMessage
-    & MsgWith<"general_forum_topic_hidden">;
-  export type GeneralForumTopicUnhiddenMessage =
-    & ServiceMessage
-    & MsgWith<"general_forum_topic_unhidden">;
-  export type GiveawayCreatedMessage =
-    & ServiceMessage
-    & MsgWith<"giveaway_created">;
+  export type ProximityAlertTriggeredMessage = ServiceMessage &
+    MsgWith<"proximity_alert_triggered">;
+  export type BoostAddedMessage = ServiceMessage & MsgWith<"boost_added">;
+  export type ForumTopicCreatedMessage = ServiceMessage &
+    MsgWith<"forum_topic_created">;
+  export type ForumTopicEditedMessage = ServiceMessage &
+    MsgWith<"forum_topic_edited">;
+  export type ForumTopicClosedMessage = ServiceMessage &
+    MsgWith<"forum_topic_closed">;
+  export type ForumTopicReopenedMessage = ServiceMessage &
+    MsgWith<"forum_topic_reopened">;
+  export type GeneralForumTopicHiddenMessage = ServiceMessage &
+    MsgWith<"general_forum_topic_hidden">;
+  export type GeneralForumTopicUnhiddenMessage = ServiceMessage &
+    MsgWith<"general_forum_topic_unhidden">;
+  export type GiveawayCreatedMessage = ServiceMessage &
+    MsgWith<"giveaway_created">;
   export type GiveawayMessage = ServiceMessage & MsgWith<"giveaway">;
-  export type GiveawayWinnersMessage =
-    & ServiceMessage
-    & MsgWith<"giveaway_winners">;
-  export type GiveawayCompletedMessage =
-    & ServiceMessage
-    & MsgWith<"giveaway_completed">;
-  export type VideoChatScheduledMessage =
-    & ServiceMessage
-    & MsgWith<"video_chat_scheduled">;
-  export type VideoChatStartedMessage =
-    & ServiceMessage
-    & MsgWith<"video_chat_started">;
-  export type VideoChatEndedMessage =
-    & ServiceMessage
-    & MsgWith<"video_chat_ended">;
-  export type VideoChatParticipantsInvitedMessage =
-    & ServiceMessage
-    & MsgWith<"video_chat_participants_invited">;
+  export type GiveawayWinnersMessage = ServiceMessage &
+    MsgWith<"giveaway_winners">;
+  export type GiveawayCompletedMessage = ServiceMessage &
+    MsgWith<"giveaway_completed">;
+  export type VideoChatScheduledMessage = ServiceMessage &
+    MsgWith<"video_chat_scheduled">;
+  export type VideoChatStartedMessage = ServiceMessage &
+    MsgWith<"video_chat_started">;
+  export type VideoChatEndedMessage = ServiceMessage &
+    MsgWith<"video_chat_ended">;
+  export type VideoChatParticipantsInvitedMessage = ServiceMessage &
+    MsgWith<"video_chat_participants_invited">;
   export type WebAppDataMessage = ServiceMessage & MsgWith<"web_app_data">;
 }
 
@@ -241,6 +220,8 @@ export interface Message extends Message.MediaMessage {
   passport_data?: PassportData;
   /** Service message. A user in the chat triggered another user's proximity alert while sharing Live Location. */
   proximity_alert_triggered?: ProximityAlertTriggered;
+  /** Service message: user boosted the chat */
+  boost_added?: ChatBoostAdded;
   /** Service message: forum topic created */
   forum_topic_created?: ForumTopicCreated;
   /** Service message: forum topic edited */
@@ -286,8 +267,8 @@ export interface SentWebAppMessage {
 }
 
 /** This object describes a message that was deleted or is otherwise inaccessible to the bot. */
-export interface InaccessibleMessage extends
-  Omit<
+export interface InaccessibleMessage
+  extends Omit<
     // TypeScript cannot discriminate union types based on `0` and `number` so
     // we work around this by including all other properties here. This mostly
     // negates the benefit of having this interface in the first place, but not
@@ -307,9 +288,7 @@ export interface InaccessibleMessage extends
 /** This object describes a message that can be inaccessible to the bot. It can be one of
 - Message
 - InaccessibleMessage */
-export type MaybeInaccessibleMessage =
-  | Message
-  | InaccessibleMessage;
+export type MaybeInaccessibleMessage = Message | InaccessibleMessage;
 
 /** The Bot API supports basic formatting for messages. You can use bold, italic, underlined, strikethrough, spoiler text, block quotations as well as inline links and pre-formatted code in your bots' messages. Telegram clients will render them accordingly. You can specify text entities directly, or use markdown-style or HTML-style formatting.
 
@@ -350,7 +329,9 @@ pre-formatted fixed-width code block written in the Python programming language
 ```
 >Block quotation started
 >Block quotation continued
->The last line of the block quotation
+>The last line of the block quotation**
+>The second block quotation started right after the previous\r
+>The third block quotation started right after the previous
 ```
 Please note:
 
@@ -840,8 +821,13 @@ export interface Venue {
   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 a story. */
+export interface Story {
+  /** Chat that posted the story */
+  chat: Chat;
+  /** Unique identifier for the story in the chat */
+  id: number;
+}
 
 /** 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 {
@@ -889,6 +875,12 @@ export interface GeneralForumTopicHidden {}
 /** This object represents a service message about General forum topic unhidden in the chat. Currently holds no information. */
 export interface GeneralForumTopicUnhidden {}
 
+/** This object represents a service message about a user boosting a chat. */
+export interface ChatBoostAdded {
+  /** Number of boosts added by the user */
+  boost_count: number;
+}
+
 /** This object contains information about the user whose identifier was shared with the bot using a KeyboardButtonRequestUsers button. */
 export interface UsersShared {
   /** Identifier of the request */
@@ -1245,4 +1237,4 @@ export interface MessageReactionCountUpdated {
   date: number;
   /** List of reactions that are present on the message */
   reactions: ReactionCount[];
-}
+}

package/src/telegramTypes.d.ts

@@ -31,7 +31,7 @@ export interface ApiSuccess<T> {
  * Describes additional parameters provided in an API error response.
  */
 export interface ResponseParameters {
-/** The group has been migrated to a supergroup with the specified identifier. */
+  /** The group has been migrated to a supergroup with the specified identifier. */
   migrate_to_chat_id?: number;
   /**
    * In case of exceeding flood control, the number of seconds left to wait before the request can be repeated.

package/src/updateTypes.d.ts

@@ -78,10 +78,10 @@ export interface Update {
    * New version of a channel post known to the bot that has been edited.
    */
   edited_channel_post?: Message & Update.Edited & Update.Channel;
-  
+
   /** A reaction to a message was changed by a user. The bot must be an administrator in the chat and must explicitly specify "message_reaction" in the list of allowed_updates to receive these updates. The update isn't received for reactions set by bots. */
   message_reaction?: MessageReactionUpdated;
-  
+
   /** Reactions to a message with anonymous reactions were changed. The bot must be an administrator in the chat and must explicitly specify "message_reaction_count" in the list of allowed_updates to receive these updates. */
   message_reaction_count?: MessageReactionCountUpdated;
 
@@ -139,10 +139,10 @@ export interface Update {
    * The bot must have the can_invite_users administrator right in the chat to receive these updates.
    */
   chat_join_request?: ChatJoinRequest;
-  
+
   /** A chat boost was added or changed. The bot must be an administrator in the chat to receive these updates. */
   chat_boost?: ChatBoostUpdated;
-  
+
   /** A boost was removed from a chat. The bot must be an administrator in the chat to receive these updates. */
   removed_chat_boost?: ChatBoostRemoved;
 }