@grammyjs/types 3.20.0 → 3.22.0

package/checklist.d.ts

@@ -0,0 +1,70 @@
+import type { User } from "./manage.js";
+import type { Message, MessageEntity, ParseMode } from "./message.js";
+/** Describes a task in a checklist. */
+export interface ChecklistTask {
+    /** Unique identifier of the task */
+    id: number;
+    /** Text of the task */
+    text: string;
+    /** Special entities that appear in the task text */
+    text_entities?: MessageEntity[];
+    /** User that completed the task; omitted if the task wasn't completed */
+    completed_by_user?: User;
+    /** Point in time (Unix timestamp) when the task was completed; 0 if the task wasn't completed */
+    completion_date?: number;
+}
+/** Describes a checklist. */
+export interface Checklist {
+    /** Title of the checklist */
+    title: string;
+    /** Special entities that appear in the checklist title */
+    title_entities?: MessageEntity[];
+    /** List of tasks in the checklist */
+    tasks: ChecklistTask[];
+    /** True, if users other than the creator of the list can add tasks to the list */
+    others_can_add_tasks?: true;
+    /** True, if users other than the creator of the list can mark tasks as done or not done */
+    others_can_mark_tasks_as_done?: true;
+}
+/** Describes a task to add to a checklist. */
+export interface InputChecklistTask {
+    /** Unique identifier of the task; must be positive and unique among all task identifiers currently present in the checklist */
+    id: number;
+    /** Text of the task; 1-100 characters after entities parsing */
+    text: string;
+    /** Mode for parsing entities in the text. See formatting options for more details. */
+    parse_mode?: string;
+    /** List of special entities that appear in the text, which can be specified instead of parse_mode. Currently, only bold, italic, underline, strikethrough, spoiler, and custom_emoji entities are allowed. */
+    text_entities?: MessageEntity[];
+}
+/** Describes a checklist to create. */
+export interface InputChecklist {
+    /** Title of the checklist; 1-255 characters after entities parsing */
+    title: string;
+    /** Mode for parsing entities in the title. See formatting options for more details. */
+    parse_mode?: ParseMode;
+    /** List of special entities that appear in the title, which can be specified instead of parse_mode. Currently, only bold, italic, underline, strikethrough, spoiler, and custom_emoji entities are allowed. */
+    title_entities?: MessageEntity[];
+    /** List of 1-30 tasks in the checklist */
+    tasks: InputChecklistTask[];
+    /** Pass True if other users can add tasks to the checklist */
+    others_can_add_tasks?: boolean;
+    /** Pass True if other users can mark tasks as done or not done in the checklist */
+    others_can_mark_tasks_as_done?: true;
+}
+/** Describes a service message about checklist tasks marked as done or not done. */
+export interface ChecklistTasksDone {
+    /** Message containing the checklist whose tasks were marked as done or not done. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply. */
+    checklist_message?: Message;
+    /** Identifiers of the tasks that were marked as done */
+    marked_as_done_task_ids?: number[];
+    /** Identifiers of the tasks that were marked as not done */
+    marked_as_not_done_task_ids?: number[];
+}
+/** Describes a service message about tasks added to a checklist. */
+export interface ChecklistTasksAdded {
+    /** Message containing the checklist to which the tasks were added. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply. */
+    checklist_message?: Message;
+    /** List of tasks added to the checklist */
+    tasks: ChecklistTask[];
+}

package/manage.d.ts

@@ -83,6 +83,8 @@ export declare namespace Chat {
         last_name?: string;
         /** True, if the supergroup chat is a forum (has topics enabled) */
         is_forum?: undefined;
+        /** True, if the chat is the direct messages chat of a channel */
+        is_direct_messages?: undefined;
     }
     /** Internal type for group chats */
     interface GroupChat {
@@ -100,6 +102,8 @@ export declare namespace Chat {
         last_name?: undefined;
         /** True, if the supergroup chat is a forum (has topics enabled) */
         is_forum?: undefined;
+        /** True, if the chat is the direct messages chat of a channel */
+        is_direct_messages?: undefined;
     }
     /** Internal type for supergroup chats */
     interface SupergroupChat {
@@ -117,6 +121,8 @@ export declare namespace Chat {
         last_name?: undefined;
         /** True, if the supergroup chat is a forum (has topics enabled) */
         is_forum?: true;
+        /** True, if the chat is the direct messages chat of a channel */
+        is_direct_messages?: true;
     }
     /** Internal type for channel chats */
     interface ChannelChat {
@@ -134,6 +140,8 @@ export declare namespace Chat {
         last_name?: undefined;
         /** True, if the supergroup chat is a forum (has topics enabled) */
         is_forum?: undefined;
+        /** True, if the chat is the direct messages chat of a channel */
+        is_direct_messages?: undefined;
     }
 }
 /** This object represents a chat. */
@@ -229,6 +237,8 @@ export declare namespace ChatFullInfo {
         custom_emoji_sticker_set_name?: undefined;
         /** Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. */
         linked_chat_id?: undefined;
+        /** Information about the corresponding channel chat; for direct messages chats only */
+        parent_chat?: undefined;
         /** For supergroups, the location to which the supergroup is connected */
         location?: undefined;
     }
@@ -322,6 +332,8 @@ export declare namespace ChatFullInfo {
         custom_emoji_sticker_set_name?: undefined;
         /** Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. */
         linked_chat_id?: undefined;
+        /** Information about the corresponding channel chat; for direct messages chats only */
+        parent_chat?: undefined;
         /** For supergroups, the location to which the supergroup is connected */
         location?: undefined;
     }
@@ -415,6 +427,8 @@ export declare namespace ChatFullInfo {
         custom_emoji_sticker_set_name?: string;
         /** Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. */
         linked_chat_id?: number;
+        /** Information about the corresponding channel chat; for direct messages chats only */
+        parent_chat?: Chat.ChannelChat;
         /** For supergroups, the location to which the supergroup is connected */
         location?: ChatLocation;
     }
@@ -508,6 +522,8 @@ export declare namespace ChatFullInfo {
         custom_emoji_sticker_set_name?: undefined;
         /** Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. */
         linked_chat_id?: number;
+        /** Information about the corresponding channel chat; for direct messages chats only */
+        parent_chat?: undefined;
         /** For supergroups, the location to which the supergroup is connected */
         location?: undefined;
     }
@@ -563,7 +579,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, get boost list, see hidden supergroup and channel members, report spam messages 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, ignore slow mode, and send messages to the chat without paying Telegram Stars. Implied by any other administrator privilege. */
     can_manage_chat: boolean;
     /** True, if the administrator can delete messages of other users */
     can_delete_messages: boolean;
@@ -583,7 +599,7 @@ export interface ChatAdministratorRights {
     can_edit_stories: boolean;
     /** True, if the administrator can delete stories posted by other users */
     can_delete_stories: boolean;
-    /** True, if the administrator can post messages in the channel, or access channel statistics; for channels only */
+    /** True, if the administrator can post messages in the channel, approve suggested posts, or access channel statistics; for channels only */
     can_post_messages?: boolean;
     /** True, if the administrator can edit messages of other users and can pin messages; for channels only */
     can_edit_messages?: boolean;
@@ -591,6 +607,8 @@ export interface ChatAdministratorRights {
     can_pin_messages?: boolean;
     /** True, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only */
     can_manage_topics?: boolean;
+    /** True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only */
+    can_manage_direct_messages?: boolean;
 }
 /** This object represents changes in the status of a chat member. */
 export interface ChatMemberUpdated {
@@ -640,7 +658,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, get boost list, see hidden supergroup and channel members, report spam messages 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, ignore slow mode, and send messages to the chat without paying Telegram Stars. Implied by any other administrator privilege. */
     can_manage_chat: boolean;
     /** True, if the administrator can delete messages of other users */
     can_delete_messages: boolean;
@@ -660,7 +678,7 @@ export interface ChatMemberAdministrator {
     can_edit_stories: boolean;
     /** True, if the administrator can delete stories posted by other users */
     can_delete_stories: boolean;
-    /** True, if the administrator can post messages in the channel, or access channel statistics; for channels only */
+    /** True, if the administrator can post messages in the channel, approve suggested posts, or access channel statistics; for channels only */
     can_post_messages?: boolean;
     /** True, if the administrator can edit messages of other users and can pin messages; for channels only */
     can_edit_messages?: boolean;
@@ -668,6 +686,8 @@ export interface ChatMemberAdministrator {
     can_pin_messages?: boolean;
     /** True, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only */
     can_manage_topics?: boolean;
+    /** True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only */
+    can_manage_direct_messages?: boolean;
     /** Custom title for this user */
     custom_title?: string;
 }
@@ -702,7 +722,7 @@ export interface ChatMemberRestricted {
     can_send_video_notes: boolean;
     /** True, if the user is allowed to send voice notes */
     can_send_voice_notes: boolean;
-    /** True, if the user is allowed to send polls */
+    /** True, if the user is allowed to send polls and checklists */
     can_send_polls: boolean;
     /** True, if the user is allowed to send animations, games, stickers and use inline bots */
     can_send_other_messages: boolean;
@@ -766,7 +786,7 @@ export interface ChatPermissions {
     can_send_video_notes?: boolean;
     /** True, if the user is allowed to send voice notes */
     can_send_voice_notes?: boolean;
-    /** True, if the user is allowed to send polls */
+    /** True, if the user is allowed to send polls and checklists */
     can_send_polls?: boolean;
     /** True, if the user is allowed to send animations, games, stickers and use inline bots */
     can_send_other_messages?: boolean;

package/markup.d.ts

@@ -27,17 +27,17 @@ export declare namespace InlineKeyboardButton {
         login_url: LoginUrl;
     }
     interface SwitchInlineButton extends AbstractInlineKeyboardButton {
-        /** If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. Not supported for messages sent on behalf of a Telegram Business account. */
+        /** If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. Not supported for messages sent in channel direct messages chats and on behalf of a Telegram Business account. */
         switch_inline_query: string;
     }
     interface SwitchInlineCurrentChatButton extends AbstractInlineKeyboardButton {
-        /** If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. Can be empty, in which case only the bot's username will be inserted.
+        /** If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted.
     
-        This offers a quick way for the user to open your bot in inline mode in the same chat – good for selecting something from multiple options. Not supported in channels and for messages sent on behalf of a Telegram Business account. */
+        This offers a quick way for the user to open your bot in inline mode in the same chat - good for selecting something from multiple options. Not supported in channels and for messages sent in channel direct messages chats and on behalf of a Telegram Business account. */
         switch_inline_query_current_chat: string;
     }
     interface SwitchInlineChosenChatButton extends AbstractInlineKeyboardButton {
-        /** If set, pressing the button will prompt the user to select one of their chats of the specified type, open that chat and insert the bot's username and the specified inline query in the input field. Not supported for messages sent on behalf of a Telegram Business account. */
+        /** If set, pressing the button will prompt the user to select one of their chats of the specified type, open that chat and insert the bot's username and the specified inline query in the input field. Not supported for messages sent in channel direct messages chats and on behalf of a Telegram Business account. */
         switch_inline_query_chosen_chat: SwitchInlineQueryChosenChat;
     }
     interface CopyTextButtonButton extends AbstractInlineKeyboardButton {

package/message.d.ts

@@ -1,7 +1,8 @@
+import type { Checklist, ChecklistTasksAdded, ChecklistTasksDone } from "./checklist.js";
 import type { Chat, User } from "./manage.js";
 import type { InlineKeyboardMarkup } from "./markup.js";
 import type { PassportData } from "./passport.js";
-import type { GiftInfo, Invoice, PaidMessagePriceChanged, RefundedPayment, SuccessfulPayment, UniqueGiftInfo } from "./payment.js";
+import type { GiftInfo, Invoice, PaidMessagePriceChanged, RefundedPayment, SuccessfulPayment, SuggestedPostApprovalFailed, SuggestedPostApproved, SuggestedPostDeclined, SuggestedPostInfo, SuggestedPostPaid, SuggestedPostPrice, SuggestedPostRefunded, UniqueGiftInfo } from "./payment.js";
 type MsgWith<P extends keyof Message> = Record<P, NonNullable<Message[P]>>;
 export declare namespace Message {
     interface ServiceMessage {
@@ -21,6 +22,8 @@ export declare namespace Message {
         chat: Chat;
         /** True, if the message is sent to a forum topic */
         is_topic_message?: boolean;
+        /** Information about the direct messages chat topic that contains the message */
+        direct_messages_topic?: DirectMessagesTopic;
     }
     interface CommonMessage extends ServiceMessage {
         /** If the sender of the message boosted the chat, the number of boosts added by the user */
@@ -33,6 +36,10 @@ export declare namespace Message {
         is_automatic_forward?: true;
         /** For replies in the same chat and message thread, 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;
+        /** Identifier of the specific checklist task that is being replied to */
+        reply_to_checklist_task_id?: number;
+        /** True, if the message is a paid post. Note that such posts must not be deleted for 24 hours to receive the payment and can't be edited. */
+        is_paid_post?: true;
         /** Information about the message that is being replied to, which may come from another chat or forum topic */
         external_reply?: ExternalReplyInfo;
         /** For replies that quote part of the original message, the quoted part of the message */
@@ -89,6 +96,16 @@ export declare namespace Message {
     type VenueMessage = LocationMessage & MsgWith<"venue">;
     type LocationMessage = CommonMessage & MsgWith<"location">;
     type PaidMediaMessage = CommonMessage & MsgWith<"paid_media">;
+    type DirectMessagePriceChangedMessage = ServiceMessage & MsgWith<"direct_message_price_changed">;
+    type ChecklistMessage = CommonMessage & MsgWith<"checklist">;
+    type ChecklistTasksDoneMessage = ServiceMessage & MsgWith<"checklist_tasks_done">;
+    type ChecklistTasksAddedMessage = ServiceMessage & MsgWith<"checklist_tasks_added">;
+    type SuggestedPostInfoMessage = ServiceMessage & MsgWith<"suggested_post_info">;
+    type SuggestedPostApprovedMessage = ServiceMessage & MsgWith<"suggested_post_approved">;
+    type SuggestedPostApprovalFailedMessage = ServiceMessage & MsgWith<"suggested_post_approval_failed">;
+    type SuggestedPostDeclinedMessage = ServiceMessage & MsgWith<"suggested_post_declined">;
+    type SuggestedPostPaidMessage = ServiceMessage & MsgWith<"suggested_post_paid">;
+    type SuggestedPostRefundedMessage = ServiceMessage & MsgWith<"suggested_post_refunded">;
     type NewChatMembersMessage = ServiceMessage & MsgWith<"new_chat_members">;
     type LeftChatMemberMessage = ServiceMessage & MsgWith<"left_chat_member">;
     type NewChatTitleMessage = ServiceMessage & MsgWith<"new_chat_title">;
@@ -172,6 +189,24 @@ export interface Message extends Message.MediaMessage {
     location?: Location;
     /** Message contains paid media; information about the paid media */
     paid_media?: PaidMediaInfo;
+    /** Message is a checklist */
+    checklist?: Checklist;
+    /** Service message: some tasks in a checklist were marked as done or not done */
+    checklist_tasks_done?: ChecklistTasksDone;
+    /** Service message: tasks were added to a checklist */
+    checklist_tasks_added?: ChecklistTasksAdded;
+    /** Information about suggested post parameters if the message is a suggested post in a channel direct messages chat. If the message is a suggested post, then it can't be edited. */
+    suggested_post_info?: SuggestedPostInfo;
+    /** Service message: a suggested post was approved */
+    suggested_post_approved?: SuggestedPostApproved;
+    /** Service message: approval of a suggested post has failed */
+    suggested_post_approval_failed?: SuggestedPostApprovalFailed;
+    /** Service message: a suggested post was declined */
+    suggested_post_declined?: SuggestedPostDeclined;
+    /** Service message: payment for a suggested post was received */
+    suggested_post_paid?: SuggestedPostPaid;
+    /** Service message: payment for a suggested post was refunded */
+    suggested_post_refunded?: SuggestedPostRefunded;
     /** New members that were added to the group or supergroup and information about them (the bot itself may be one of these members) */
     new_chat_members?: User[];
     /** A member was removed from the group, information about them (this member may be the bot itself) */
@@ -243,6 +278,8 @@ export interface Message extends Message.MediaMessage {
     unique_gift?: UniqueGiftInfo;
     /** Service message: the price for paid messages has changed in the chat */
     paid_message_price_changed?: PaidMessagePriceChanged;
+    /** Service message: the price for paid messages in the corresponding direct messages chat of a channel has changed */
+    direct_message_price_changed?: DirectMessagePriceChanged;
     /** Service message: video chat scheduled */
     video_chat_scheduled?: VideoChatScheduled;
     /** Service message: video chat started */
@@ -484,6 +521,8 @@ export interface ExternalReplyInfo {
     paid_media?: PaidMediaInfo;
     /** Message is a native poll, information about the poll */
     poll?: Poll;
+    /** Message is a checklist */
+    checklist?: Checklist;
     /** Message is a venue, information about the venue */
     venue?: Venue;
 }
@@ -491,8 +530,10 @@ export interface ExternalReplyInfo {
 export interface ReplyParameters {
     /** Identifier of the message that will be replied to in the current chat, or in the chat chat_id if it is specified */
     message_id: number;
-    /** If the message to be replied to is from a different chat, unique identifier for the chat or username of the channel (in the format @channelusername). Not supported for messages sent on behalf of a business account. */
+    /** If the message to be replied to is from a different chat, unique identifier for the chat or username of the channel (in the format @channelusername). Not supported for messages sent on behalf of a business account and messages from channel direct messages chats. */
     chat_id?: number | string;
+    /** Identifier of the specific checklist task to be replied to */
+    checklist_task_id?: number;
     /** Pass True if the message should be sent even if the specified message to be replied to is not found; can be used only for replies in the same chat and forum topic. Always True for messages sent on behalf of a business account. */
     allow_sending_without_reply?: boolean;
     /** Quoted part of the message to be replied to; 0-1024 characters after entities parsing. The quote must be an exact substring of the message to be replied to, including bold, italic, underline, strikethrough, spoiler, and custom_emoji entities. The message will fail to send if the quote isn't found in the original message. */
@@ -1017,6 +1058,13 @@ export interface WriteAccessAllowed {
     /** True, if the access was granted when the bot was added to the attachment or side menu */
     from_attachment_menu?: boolean;
 }
+/** Describes a service message about a change in the price of direct messages sent to a channel chat. */
+export interface DirectMessagePriceChanged {
+    /** True, if direct messages are enabled for the channel chat; false otherwise */
+    are_direct_messages_enabled: boolean;
+    /** The new number of Telegram Stars that must be paid by users for each direct message sent to the channel. Defaults to 0. */
+    direct_message_star_count?: number;
+}
 /** This object represents a service message about a video chat scheduled in the chat. */
 export interface VideoChatScheduled {
     /** Point in time (Unix timestamp) when the video chat is supposed to be started by a chat administrator */
@@ -1269,4 +1317,18 @@ export interface PreparedInlineMessage {
     /** Expiration date of the prepared message, in Unix time. Expired prepared messages can no longer be used */
     expiration_date: number;
 }
+/** Describes a topic of a direct messages chat. */
+export interface DirectMessagesTopic {
+    /** Unique identifier of the topic */
+    topic_id: number;
+    /** Information about the user that created the topic. Currently, it is always present */
+    user: User;
+}
+/** Contains parameters of a post that is being suggested by the bot. */
+export interface SuggestedPostParameters {
+    /** Proposed price for the post. If the field is omitted, then the post is unpaid. */
+    price?: SuggestedPostPrice;
+    /** Proposed send date of the post. If the field is omitted, then the post can be published at any time within 30 days at the sole discretion of the user who approves it. */
+    send_date?: number;
+}
 export {};

package/methods.d.ts

@@ -1,8 +1,9 @@
+import type { InputChecklist } from "./checklist.js";
 import type { InlineQueryResult, InlineQueryResultsButton } from "./inline.js";
 import type { LanguageCode } from "./langs.js";
 import type { AcceptedGiftTypes, BotCommand, BusinessConnection, ChatAdministratorRights, ChatFullInfo, ChatInviteLink, ChatMember, ChatMemberAdministrator, ChatMemberOwner, ChatPermissions, ForumTopic, UserChatBoosts, UserFromGetMe, UserProfilePhotos, WebhookInfo } from "./manage.js";
 import type { ForceReply, InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove } from "./markup.js";
-import type { File, GameHighScore, InputPollOption, LinkPreviewOptions, MaskPosition, Message, MessageEntity, MessageId, ParseMode, Poll, PreparedInlineMessage, ReactionType, ReplyParameters, SentWebAppMessage, Sticker, StickerSet, Story } from "./message.js";
+import type { File, GameHighScore, InputPollOption, LinkPreviewOptions, MaskPosition, Message, MessageEntity, MessageId, ParseMode, Poll, PreparedInlineMessage, ReactionType, ReplyParameters, SentWebAppMessage, Sticker, StickerSet, Story, SuggestedPostParameters } from "./message.js";
 import type { PassportElementError } from "./passport.js";
 import type { Gifts, LabeledPrice, OwnedGifts, ShippingOption, StarAmount, StarTransactions } from "./payment.js";
 import type { BotCommandScope, BotDescription, BotName, BotShortDescription, MenuButton } from "./settings.js";
@@ -82,6 +83,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Text of the message to be sent, 1-4096 characters after entities parsing */
         text: string;
         /** Mode for parsing entities in the message text. See formatting options for more details. */
@@ -96,6 +99,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -111,10 +116,14 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be forwarded; required if the message is forwarded to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Unique identifier for the chat where the original message was sent (or channel username in the format @channelusername) */
         from_chat_id: number | string;
         /** New start timestamp for the copied video in the message */
         video_start_timestamp?: number;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Sends the message silently. Users will receive a notification with no sound. */
         disable_notification?: boolean;
         /** Protects the contents of the forwarded message from forwarding and saving */
@@ -128,6 +137,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the messages will be forwarded; required if the messages are forwarded to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername) */
         from_chat_id: number | string;
         /** A list of 1-100 identifiers of messages in the chat from_chat_id to forward. The identifiers must be specified in a strictly increasing order. */
@@ -143,6 +154,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Unique identifier for the chat where the original message was sent (or channel username in the format @channelusername) */
         from_chat_id: number | string;
         /** Message identifier in the chat specified in from_chat_id */
@@ -163,6 +176,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
         /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
@@ -176,6 +191,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the messages will be sent; required if the messages are sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername) */
         from_chat_id: number | string;
         /** A list of 1-100 identifiers of messages in the chat from_chat_id to copy. The identifiers must be specified in a strictly increasing order. */
@@ -195,6 +212,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Photo to send. Pass a file_id as String to send a photo that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a photo from the Internet, or upload a new photo using multipart/form-data. The photo must be at most 10 MB in size. The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20. */
         photo: F | string;
         /** Photo caption (may also be used when resending photos by file_id), 0-1024 characters after entities parsing */
@@ -213,6 +232,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -232,6 +253,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. */
         audio: F | string;
         /** Audio caption, 0-1024 characters after entities parsing */
@@ -254,6 +277,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -271,6 +296,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** 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>. */
@@ -289,6 +316,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -306,6 +335,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Video to send. Pass a file_id as String to send a video that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a video from the Internet, or upload a new video using multipart/form-data. */
         video: F | string;
         /** Duration of sent video in seconds */
@@ -338,6 +369,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -355,6 +388,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Animation to send. Pass a file_id as String to send an animation that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an animation from the Internet, or upload a new animation using multipart/form-data. */
         animation: F | string;
         /** Duration of sent animation in seconds */
@@ -381,6 +416,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -398,6 +435,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Audio 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. */
         voice: F | string;
         /** Voice message caption, 0-1024 characters after entities parsing */
@@ -414,6 +453,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -432,6 +473,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data.. Sending video notes by a URL is currently unsupported */
         video_note: F | string;
         /** Duration of sent video in seconds */
@@ -446,6 +489,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -463,6 +508,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the messages will be sent; required if the messages are sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** An array describing messages to be sent, must include 2-10 items */
         media: ReadonlyArray<InputMediaAudio<F> | InputMediaDocument<F> | InputMediaPhoto<F> | InputMediaVideo<F>>;
         /** Sends the messages silently. Users will receive a notification with no sound. */
@@ -486,6 +533,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Latitude of the location */
         latitude: number;
         /** Longitude of the location */
@@ -504,6 +553,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -557,6 +608,8 @@ export type ApiMethods<F> = {
         business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername). If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance. */
         chat_id: number | string;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** The number of Telegram Stars that must be paid to buy access to the media; 1-2500 */
         star_count: number;
         /** An array describing the media to be sent; up to 10 items */
@@ -577,6 +630,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
         /** Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user */
@@ -590,6 +645,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Latitude of the venue */
         latitude: number;
         /** Longitude of the venue */
@@ -612,6 +669,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -629,6 +688,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Contact's phone number */
         phone_number: string;
         /** Contact's first name */
@@ -643,6 +704,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -656,7 +719,7 @@ export type ApiMethods<F> = {
     sendPoll(args: {
         /** Unique identifier of the business connection on behalf of which the message will be sent */
         business_connection_id?: string;
-        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername). Polls can't be sent to channel direct messages chats. */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
@@ -666,7 +729,7 @@ export type ApiMethods<F> = {
         question_parse_mode?: ParseMode;
         /** A list of special entities that appear in the poll question. It can be specified instead of question_parse_mode */
         question_entities?: MessageEntity[];
-        /** A list of 2-10 answer options */
+        /** A list of 2-12 answer options */
         options: InputPollOption[];
         /** True, if the poll needs to be anonymous, defaults to True */
         is_anonymous?: boolean;
@@ -703,6 +766,38 @@ export type ApiMethods<F> = {
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): Message.PollMessage;
+    /** Use this method to send a checklist on behalf of a connected business account. On success, the sent Message is returned. */
+    sendChecklist(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id: string;
+        /** Unique identifier for the target chat */
+        chat_id: number;
+        /** An object for the checklist to send */
+        checklist: InputChecklist;
+        /** Sends the message silently. Users will receive a notification with no sound. */
+        disable_notification?: boolean;
+        /** Protects the contents of the sent message from forwarding and saving */
+        protect_content?: boolean;
+        /** Unique identifier of the message effect to be added to the message */
+        message_effect_id?: string;
+        /** An object for description of the message to reply to */
+        reply_parameters?: ReplyParameters;
+        /** An object for an inline keyboard */
+        reply_markup?: InlineKeyboardMarkup;
+    }): Message.ChecklistMessage;
+    /** Use this method to edit a checklist on behalf of a connected business account. On success, the edited Message is returned. */
+    editMessageChecklist(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id: string;
+        /** Unique identifier for the target chat */
+        chat_id: number;
+        /** Unique identifier for the target message */
+        message_id: number;
+        /** An object for the new checklist */
+        checklist: InputChecklist;
+        /** An object for the new inline keyboard for the message */
+        reply_markup?: InlineKeyboardMarkup;
+    }): Message.ChecklistMessage;
     /** Use this method to send an animated emoji that will display a random value. On success, the sent Message is returned. */
     sendDice(args: {
         /** Unique identifier of the business connection on behalf of which the message will be sent */
@@ -711,6 +806,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Emoji on which the dice throw animation is based. Currently, must be one of "🎲", "🎯", "🏀", "⚽", "🎳", or "🎰". Dice can have values 1-6 for "🎲", "🎯" and "🎳", values 1-5 for "🏀" and "⚽", and values 1-64 for "🎰". Defaults to "🎲" */
         emoji?: (string & Record<never, never>) | "🎲" | "🎯" | "🏀" | "⚽" | "🎳" | "🎰";
         /** Sends the message silently. Users will receive a notification with no sound. */
@@ -719,6 +816,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -736,7 +835,7 @@ export type ApiMethods<F> = {
     sendChatAction(args: {
         /** Unique identifier of the business connection on behalf of which the action will be sent */
         business_connection_id?: string;
-        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+        /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername). Channel chats and channel direct messages chats aren't supported. */
         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, choose_sticker for stickers, find_location for location data, record_video_note or upload_video_note for video notes. */
         action: "typing" | "upload_photo" | "record_video" | "upload_video" | "record_voice" | "upload_voice" | "upload_document" | "choose_sticker" | "find_location" | "record_video_note" | "upload_video_note";
@@ -823,7 +922,7 @@ 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, get boost list, see hidden supergroup and channel members, report spam messages and ignore slow mode. Implied by any other administrator privilege. */
+        /** Pass True if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages, ignore slow mode, and send messages to the chat without paying Telegram Stars. Implied by any other administrator privilege. */
         can_manage_chat?: boolean;
         /** Pass True if the administrator can delete messages of other users */
         can_delete_messages?: boolean;
@@ -843,7 +942,7 @@ export type ApiMethods<F> = {
         can_edit_stories?: boolean;
         /** True if the administrator can delete stories posted by other users */
         can_delete_stories?: boolean;
-        /** True if the administrator can post messages in the channel, or access channel statistics; for channels only */
+        /** Pass True if the administrator can post messages in the channel, approve suggested posts, or access channel statistics; for channels only */
         can_post_messages?: boolean;
         /** True if the administrator can edit messages of other users and can pin messages; for channels only */
         can_edit_messages?: boolean;
@@ -851,6 +950,8 @@ export type ApiMethods<F> = {
         can_pin_messages?: boolean;
         /** True if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only */
         can_manage_topics?: boolean;
+        /** Pass True if the administrator can manage direct messages within the channel and decline suggested posts; for channels only */
+        can_manage_direct_messages?: boolean;
     }): true;
     /** Use this method to set a custom title for an administrator in a supergroup promoted by the bot. Returns True on success. */
     setChatAdministratorCustomTitle(args: {
@@ -960,6 +1061,24 @@ export type ApiMethods<F> = {
         /** Unique identifier of the target user */
         user_id: number;
     }): true;
+    /** Use this method to approve a suggested post in a direct messages chat. The bot must have the 'can_post_messages' administrator right in the corresponding channel chat. Returns True on success. */
+    approveSuggestedPost(args: {
+        /** Unique identifier for the target direct messages chat */
+        chat_id: number;
+        /** Identifier of a suggested post message to approve */
+        message_id: number;
+        /** Point in time (Unix timestamp) when the post is expected to be published; omit if the date has already been specified when the suggested post was created */
+        send_date?: number;
+    }): true;
+    /** Use this method to decline a suggested post in a direct messages chat. The bot must have the 'can_manage_direct_messages' administrator right in the corresponding channel chat. Returns True on success. */
+    declineSuggestedPost(args: {
+        /** Unique identifier for the target direct messages chat */
+        chat_id: number;
+        /** Identifier of a suggested post message to decline */
+        message_id: number;
+        /** Comment for the creator of the suggested post */
+        comment?: string;
+    }): 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) */
@@ -986,7 +1105,7 @@ export type ApiMethods<F> = {
         /** New chat description, 0-255 characters */
         description?: string;
     }): true;
-    /** Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' admin right in a supergroup or 'can_edit_messages' admin right in a channel. Returns True on success. */
+    /** Use this method to add a message to the list of pinned messages in a chat. In private chats and channel direct messages chats, all non-service messages can be pinned. Conversely, the bot must be an administrator with the 'can_pin_messages' right or the 'can_edit_messages' right to pin messages in groups and channels respectively. Returns True on success. */
     pinChatMessage(args: {
         /** Unique identifier of the business connection on behalf of which the message will be pinned */
         business_connection_id?: string;
@@ -997,7 +1116,7 @@ export type ApiMethods<F> = {
         /** Pass True if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats. */
         disable_notification?: boolean;
     }): true;
-    /** Use this method to remove a message from the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' admin right in a supergroup or 'can_edit_messages' admin right in a channel. Returns True on success. */
+    /** Use this method to remove a message from the list of pinned messages in a chat. In private chats and channel direct messages chats, all messages can be unpinned. Conversely, the bot must be an administrator with the 'can_pin_messages' right or the 'can_edit_messages' right to unpin messages in groups and channels respectively. Returns True on success. */
     unpinChatMessage(args: {
         /** Unique identifier of the business connection on behalf of which the message will be unpinned */
         business_connection_id?: string;
@@ -1006,14 +1125,14 @@ export type ApiMethods<F> = {
         /** Identifier of the message to unpin. Required if business_connection_id is specified. If not specified, the most recent pinned message (by sending date) will be unpinned. */
         message_id?: number;
     }): true;
-    /** Use this method to clear the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the 'can_pin_messages' admin right in a supergroup or 'can_edit_messages' admin right in a channel. Returns True on success. */
+    /** Use this method to clear the list of pinned messages in a chat. In private chats and channel direct messages chats, no additional rights are required to unpin all pinned messages. Conversely, the bot must be an administrator with the 'can_pin_messages' right or the 'can_edit_messages' right to unpin all pinned messages in groups and channels respectively. Returns True on success. */
     unpinAllChatMessages(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 for your bot to leave a group, supergroup or channel. Returns True on success. */
     leaveChat(args: {
-        /** Unique identifier for the target chat or username of the target supergroup or channel (in the format @channelusername) */
+        /** Unique identifier for the target chat or username of the target supergroup or channel (in the format @channelusername). Channel direct messages chats aren't supported; leave the corresponding channel instead. */
         chat_id: number | string;
     }): true;
     /** Use this method to get up-to-date information about the chat. Returns a ChatFullInfo object on success. */
@@ -1249,6 +1368,8 @@ export type ApiMethods<F> = {
         /** Pass True to get default administrator rights of the bot in channels. Otherwise, default administrator rights of the bot for groups and supergroups will be returned. */
         for_channels?: boolean;
     }): ChatAdministratorRights;
+    /** A method to get the current Telegram Stars balance of the bot. Requires no parameters. On success, returns a StarAmount object. */
+    getMyStarBalance(): StarAmount;
     /** Use this method to edit text and game messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within 48 hours from the time they were sent. */
     editMessageText(args: {
         /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
@@ -1338,7 +1459,8 @@ export type ApiMethods<F> = {
     - Bots can delete incoming messages in private chats.
     - Bots granted can_post_messages permissions can delete outgoing messages in channels.
     - If the bot is an administrator of a group, it can delete any message there.
-    - If the bot has can_delete_messages permission in a supergroup or a channel, it can delete any message there.
+    - If the bot has can_delete_messages administrator right in a supergroup or a channel, it can delete any message there.
+    - If the bot has can_manage_direct_messages administrator right in a channel, it can delete any message in the corresponding direct messages chat.
     Returns True on success. */
     deleteMessage(args: {
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
@@ -1523,6 +1645,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Sticker 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 .WEBP sticker from the Internet, or upload a new .WEBP, .TGS, or .WEBM sticker using multipart/form-data. Video and animated stickers can't be sent via an HTTP URL. */
         sticker: F | string;
         /** Emoji associated with the sticker; only for just uploaded stickers */
@@ -1533,6 +1657,8 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance */
         allow_paid_broadcast?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Unique identifier of the message effect to be added to the message; for private chats only */
         message_effect_id?: string;
         /** Description of the message to reply to */
@@ -1739,6 +1865,8 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
+        /** Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat */
+        direct_messages_topic_id?: number;
         /** Product name, 1-32 characters */
         title: string;
         /** Product description, 1-255 characters */
@@ -1781,6 +1909,8 @@ export type ApiMethods<F> = {
         send_email_to_provider?: boolean;
         /** Pass True if the final price depends on the shipping method. Ignored for payments in Telegram Stars. */
         is_flexible?: boolean;
+        /** An object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined. */
+        suggested_post_parameters?: SuggestedPostParameters;
         /** Sends the message silently. Users will receive a notification with no sound. */
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding and saving */
@@ -1895,7 +2025,7 @@ export type ApiMethods<F> = {
     }): true;
     /** Verifies a chat on behalf of the organization which is represented by the bot. Returns True on success. */
     verifyChat(args: {
-        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername). Channel direct messages chats can't be verified. */
         chat_id: number | string;
         /** Custom description for the verification; 0-70 characters. Must be empty if the organization isn't allowed to provide a custom verification description. */
         custom_description?: string;
@@ -1932,7 +2062,7 @@ export type ApiMethods<F> = {
     sendGame(args: {
         /** Unique identifier of the business connection on behalf of which the message will be sent */
         business_connection_id?: string;
-        /** Unique identifier for the target chat */
+        /** Unique identifier for the target chat. Games can't be sent to channel direct messages chats and channel chats. */
         chat_id: number;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;

package/mod.d.ts

@@ -1,4 +1,5 @@
 export * from "./api.js";
+export * from "./checklist.js";
 export * from "./inline.js";
 export * from "./manage.js";
 export * from "./markup.js";

package/package.json

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

package/payment.d.ts

@@ -1,5 +1,5 @@
 import type { Chat, User } from "./manage.js";
-import type { MessageEntity, PaidMedia, Sticker } from "./message.js";
+import type { Message, MessageEntity, PaidMedia, Sticker } from "./message.js";
 /** This object represents a portion of the price for goods or services. */
 export interface LabeledPrice {
     /** Portion label */
@@ -263,6 +263,8 @@ export interface PaidMediaPurchased {
 export interface Gift {
     /** Unique identifier of the gift */
     id: string;
+    /** Information about the chat that published the gift */
+    publisher_chat?: Chat;
     /** The sticker that represents the gift */
     sticker: Sticker;
     /** The number of Telegram Stars that must be paid to send the sticker */
@@ -323,6 +325,8 @@ export interface UniqueGift {
     base_name: string;
     /** Unique name of the gift. This name can be used in https://t.me/nft/... links and story areas */
     name: string;
+    /** Information about the chat that published the gift */
+    publisher_chat?: Chat;
     /** Unique number of the upgraded gift among gifts upgraded from the same regular gift */
     number: number;
     /** Model of the gift */
@@ -355,12 +359,16 @@ export interface GiftInfo {
 export interface UniqueGiftInfo {
     /** Information about the gift */
     gift: UniqueGift;
-    /** Origin of the gift. Currently, either “upgrade” or “transfer” */
-    origin: "upgrade" | "transfer";
+    /** Origin of the gift. Currently, either “upgrade” for gifts upgraded from regular gifts, “transfer” for gifts transferred from other users or channels, or “resale” for gifts bought from other users */
+    origin: "upgrade" | "transfer" | "resale";
     /** Unique identifier of the received gift for the bot; only present for gifts received on behalf of business accounts */
     owned_gift_id?: string;
     /** Number of Telegram Stars that must be paid to transfer the gift; omitted if the bot cannot transfer the gift */
     transfer_star_count?: number;
+    /** For gifts bought from other users, the price paid for the gift */
+    last_resale_star_count?: number;
+    /** Point in time (Unix timestamp) when the gift can be transferred. If it is in the past, then the gift can be transferred now */
+    next_transfer_date?: string;
 }
 /** Describes a service message about a change in the price of paid messages within a chat. */
 export interface PaidMessagePriceChanged {
@@ -426,6 +434,8 @@ export interface OwnedGiftUnique {
     can_be_transferred?: true;
     /** Number of Telegram Stars that must be paid to transfer the gift; omitted if the bot cannot transfer the gift */
     transfer_star_count?: number;
+    /** Point in time (Unix timestamp) when the gift can be transferred. If it is in the past, then the gift can be transferred now */
+    next_transfer_date?: string;
 }
 /** Contains the list of gifts received and owned by a user or a chat. */
 export interface OwnedGifts {
@@ -436,3 +446,60 @@ export interface OwnedGifts {
     /** Offset for the next request. If empty, then there are no more results */
     next_offset?: string;
 }
+/** Desribes price of a suggested post. */
+export interface SuggestedPostPrice {
+    /** Currency in which the post will be paid. Currently, must be one of “XTR” for Telegram Stars or “TON” for toncoins */
+    currency: "XTR" | "TON";
+    /** The amount of the currency that will be paid for the post in the smallest units of the currency, i.e. Telegram Stars or nanotoncoins. Currently, price in Telegram Stars must be between 5 and 100000, and price in nanotoncoins must be between 10000000 and 10000000000000. */
+    amount: number;
+}
+/** Contains information about a suggested post. */
+export interface SuggestedPostInfo {
+    /** State of the suggested post. Currently, it can be one of “pending”, “approved”, “declined”. */
+    state: "pending" | "approved" | "declined";
+    /** Proposed price of the post. If the field is omitted, then the post is unpaid. */
+    price?: SuggestedPostPrice;
+    /** Proposed send date of the post. If the field is omitted, then the post can be published at any time within 30 days at the sole discretion of the user or administrator who approves it. */
+    send_date?: number;
+}
+/** Describes a service message about the approval of a suggested post. */
+export interface SuggestedPostApproved {
+    /** Message containing the suggested post. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply. */
+    suggested_post_message?: Message;
+    /** Amount paid for the post */
+    price?: SuggestedPostPrice;
+    /** Date when the post will be published */
+    send_date: number;
+}
+/** Describes a service message about the failed approval of a suggested post. Currently, only caused by insufficient user funds at the time of approval. */
+export interface SuggestedPostApprovalFailed {
+    /** Message containing the suggested post whose approval has failed. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply. */
+    suggested_post_message?: Message;
+    /** Expected price of the post */
+    price: SuggestedPostPrice;
+}
+/** Describes a service message about the rejection of a suggested post. */
+export interface SuggestedPostDeclined {
+    /** Message containing the suggested post. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply. */
+    suggested_post_message?: Message;
+    /** Comment with which the post was declined */
+    comment?: string;
+}
+/** Describes a service message about a successful payment for a suggested post. */
+export interface SuggestedPostPaid {
+    /** Message containing the suggested post. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply. */
+    suggested_post_message?: Message;
+    /** Currency in which the payment was made. Currently, one of “XTR” for Telegram Stars or “TON” for toncoins */
+    currency: string;
+    /** The amount of the currency that was received by the channel in nanotoncoins; for payments in toncoins only */
+    amount?: number;
+    /** The amount of Telegram Stars that was received by the channel; for payments in Telegram Stars only */
+    star_amount?: StarAmount;
+}
+/** Describes a service message about a payment refund for a suggested post. */
+export interface SuggestedPostRefunded {
+    /** Message containing the suggested post. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply. */
+    suggested_post_message?: Message;
+    /** Reason for the refund. Currently, one of “post_deleted” if the post was deleted within 24 hours of being posted or removed from scheduled messages without being posted, or “payment_refunded” if the payer refunded their payment. */
+    reason: string;
+}

package/settings.d.ts

@@ -99,21 +99,21 @@ export interface BotCommandScopeAllChatAdministrators {
 export interface BotCommandScopeChat {
     /** Scope type, must be chat */
     type: "chat";
-    /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */
+    /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername). Channel direct messages chats and channel chats aren't supported. */
     chat_id: number | string;
 }
 /** Represents the scope of bot commands, covering all administrators of a specific group or supergroup chat. */
 export interface BotCommandScopeChatAdministrators {
     /** Scope type, must be chat_administrators */
     type: "chat_administrators";
-    /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */
+    /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername). Channel direct messages chats and channel chats aren't supported. */
     chat_id: number | string;
 }
 /** Represents the scope of bot commands, covering a specific member of a group or supergroup chat. */
 export interface BotCommandScopeChatMember {
     /** Scope type, must be chat_member */
     type: "chat_member";
-    /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername) */
+    /** Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername). Channel direct messages chats and channel chats aren't supported. */
     chat_id: number | string;
     /** Unique identifier of the target user */
     user_id: number;