@grammyjs/types 3.8.1 → 3.10.0

package/manage.d.ts

@@ -214,6 +214,8 @@ export declare namespace ChatFullInfo {
         linked_chat_id?: undefined;
         /** For supergroups, the location to which the supergroup is connected */
         location?: undefined;
+        /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
+        can_send_paid_media?: undefined;
     }
     /** Internal type for group chats */
     interface GroupChat {
@@ -303,6 +305,8 @@ export declare namespace ChatFullInfo {
         linked_chat_id?: undefined;
         /** For supergroups, the location to which the supergroup is connected */
         location?: undefined;
+        /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
+        can_send_paid_media?: undefined;
     }
     /** Internal type for supergroup chats */
     interface SupergroupChat {
@@ -392,6 +396,8 @@ export declare namespace ChatFullInfo {
         linked_chat_id?: number;
         /** For supergroups, the location to which the supergroup is connected */
         location?: ChatLocation;
+        /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
+        can_send_paid_media?: undefined;
     }
     /** Internal type for channel chats */
     interface ChannelChat {
@@ -481,6 +487,8 @@ export declare namespace ChatFullInfo {
         linked_chat_id?: number;
         /** For supergroups, the location to which the supergroup is connected */
         location?: undefined;
+        /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
+        can_send_paid_media?: true;
     }
 }
 /** This object contains full information about a chat. */

package/markup.d.ts

@@ -15,7 +15,7 @@ export declare namespace InlineKeyboardButton {
         url: string;
     }
     interface CallbackButton extends AbstractInlineKeyboardButton {
-        /** Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes. Not supported for messages sent on behalf of a Telegram Business account. */
+        /** Data to be sent in a callback query to the bot when the button is pressed, 1-64 bytes */
         callback_data: string;
     }
     interface WebAppButton extends AbstractInlineKeyboardButton {

package/message.d.ts

@@ -84,8 +84,9 @@ export declare namespace Message {
     type DiceMessage = CommonMessage & MsgWith<"dice">;
     type GameMessage = CommonMessage & MsgWith<"game">;
     type PollMessage = CommonMessage & MsgWith<"poll">;
-    type LocationMessage = CommonMessage & MsgWith<"location">;
     type VenueMessage = LocationMessage & MsgWith<"venue">;
+    type LocationMessage = CommonMessage & MsgWith<"location">;
+    type PaidMediaMessage = CommonMessage & MsgWith<"paid_media">;
     type NewChatMembersMessage = ServiceMessage & MsgWith<"new_chat_members">;
     type LeftChatMemberMessage = ServiceMessage & MsgWith<"left_chat_member">;
     type NewChatTitleMessage = ServiceMessage & MsgWith<"new_chat_title">;
@@ -162,6 +163,8 @@ export interface Message extends Message.MediaMessage {
     venue?: Venue;
     /** Message is a shared location, information about the location */
     location?: Location;
+    /** Message contains paid media; information about the paid media */
+    paid_media?: PaidMediaInfo;
     /** 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) */
@@ -462,6 +465,8 @@ export interface ExternalReplyInfo {
     invoice?: Invoice;
     /** Message is a shared location, information about the location */
     location?: Location;
+    /** Message contains paid media; information about the paid media */
+    paid_media?: PaidMediaInfo;
     /** Message is a native poll, information about the poll */
     poll?: Poll;
     /** Message is a venue, information about the venue */
@@ -754,6 +759,44 @@ export interface Location {
     /** The maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only. */
     proximity_alert_radius?: number;
 }
+/** Describes the paid media added to a message. */
+export interface PaidMediaInfo {
+    /** The number of Telegram Stars that must be paid to buy access to the media */
+    star_count: number;
+    /** Information about the paid media */
+    paid_media: PaidMedia[];
+}
+/** This object describes paid media. Currently, it can be one of
+
+- PaidMediaPreview
+- PaidMediaPhoto
+- PaidMediaVideo */
+export type PaidMedia = PaidMediaPreview | PaidMediaPhoto | PaidMediaVideo;
+/** The paid media isn't available before the payment. */
+export interface PaidMediaPreview {
+    /** Type of the paid media, always “preview” */
+    type: "preview";
+    /** Media width as defined by the sender */
+    width?: number;
+    /** Media height as defined by the sender */
+    height?: number;
+    /** Duration of the media in seconds as defined by the sender */
+    duration?: number;
+}
+/** The paid media is a photo. */
+export interface PaidMediaPhoto {
+    /** Type of the paid media, always “photo” */
+    type: "photo";
+    /** The photo */
+    photo: PhotoSize[];
+}
+/** The paid media is a video. */
+export interface PaidMediaVideo {
+    /** Type of the paid media, always “video” */
+    type: "video";
+    /** The video */
+    video: Video;
+}
 /** This object represents a venue. */
 export interface Venue {
     /** Venue location. Can't be a live location */

package/methods.d.ts

@@ -4,7 +4,7 @@ import type { ChatFullInfo } from "./manage.js";
 import type { ForceReply, InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove } from "./markup.js";
 import type { File, GameHighScore, InputPollOption, LinkPreviewOptions, MaskPosition, Message, MessageEntity, MessageId, ParseMode, Poll, ReactionType, ReplyParameters, SentWebAppMessage, Sticker, StickerSet } from "./message.js";
 import type { PassportElementError } from "./passport.js";
-import type { LabeledPrice, ShippingOption } from "./payment.js";
+import type { LabeledPrice, ShippingOption, StarTransactions } from "./payment.js";
 import type { BotCommandScope, BotDescription, BotName, BotShortDescription, MenuButton } from "./settings.js";
 import type { Update } from "./update.js";
 import type { LanguageCode } from "./langs.js";
@@ -94,7 +94,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -133,7 +133,7 @@ export type ApiMethods<F> = {
         /** Protects the contents of the forwarded messages from forwarding and saving */
         protect_content?: boolean;
     }): MessageId[];
-    /** Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success. */
+    /** Use this method to copy messages of any kind. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success. */
     copyMessage(args: {
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
@@ -162,7 +162,7 @@ export type ApiMethods<F> = {
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): MessageId;
-    /** Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned. */
+    /** Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned. */
     copyMessages(args: {
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
@@ -203,7 +203,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -242,7 +242,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -275,7 +275,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -318,7 +318,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -359,7 +359,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -390,7 +390,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -420,7 +420,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -443,7 +443,7 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent messages from forwarding and saving */
         protect_content?: boolean;
-        /** Unique identifier of the message effect to be added to the message */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -474,7 +474,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -485,6 +485,8 @@ export type ApiMethods<F> = {
     }): Message.LocationMessage;
     /** Use this method to edit live location messages. A location can be edited until its live_period expires or editing is explicitly disabled by a call to stopMessageLiveLocation. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
     editMessageLiveLocation(args: {
+        /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+        business_connection_id?: string;
         /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id?: number | string;
         /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -508,6 +510,8 @@ export type ApiMethods<F> = {
     }): (Update.Edited & Message.LocationMessage) | true;
     /** Use this method to stop updating a live location message before live_period expires. On success, if the message is not an inline message, the edited Message is returned, otherwise True is returned. */
     stopMessageLiveLocation(args: {
+        /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+        business_connection_id?: string;
         /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id?: number | string;
         /** Required if inline_message_id is not specified. Identifier of the message with live location to stop */
@@ -517,6 +521,31 @@ export type ApiMethods<F> = {
         /** An object for a new inline keyboard. */
         reply_markup?: InlineKeyboardMarkup;
     }): (Update.Edited & Message.LocationMessage) | true;
+    /** Use this method to send paid media to channel chats. On success, the sent Message is returned. */
+    sendPaidMedia(args: {
+        /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
+        chat_id: number | string;
+        /** The number of Telegram Stars that must be paid to buy access to the media */
+        star_count: number;
+        /** An array describing the media to be sent; up to 10 items */
+        media: InputPaidMedia<F>[];
+        /** Media caption, 0-1024 characters after entities parsing */
+        caption?: string;
+        /** Mode for parsing entities in the media caption. See formatting options for more details. */
+        parse_mode?: string;
+        /** A list of special entities that appear in the caption, which can be specified instead of parse_mode */
+        caption_entities?: MessageEntity[];
+        /** Pass True, if the caption must be shown above the message media */
+        show_caption_above_media?: boolean;
+        /** 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;
+        /** 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 */
+        reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
+    }): Message.PaidMediaMessage;
     /** Use this method to send information about a venue. On success, the sent Message is returned. */
     sendVenue(args: {
         /** Unique identifier of the business connection on behalf of which the message will be sent */
@@ -545,7 +574,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -574,7 +603,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -623,7 +652,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -646,7 +675,7 @@ export type ApiMethods<F> = {
         disable_notification?: boolean;
         /** Protects the contents of the sent message from forwarding */
         protect_content?: boolean;
-        /** Unique identifier of the message effect to be added to the message */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -1143,8 +1172,10 @@ 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;
-    /** 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. */
+    /** 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 */
+        business_connection_id?: string;
         /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id?: number | string;
         /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -1162,8 +1193,10 @@ export type ApiMethods<F> = {
         /** An object for an inline keyboard. */
         reply_markup?: InlineKeyboardMarkup;
     }): (Update.Edited & Message.TextMessage) | true;
-    /** Use this method to edit captions of messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
+    /** Use this method to edit captions of 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. */
     editMessageCaption(args: {
+        /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+        business_connection_id?: string;
         /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id?: number | string;
         /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -1181,8 +1214,10 @@ export type ApiMethods<F> = {
         /** An object for an inline keyboard. */
         reply_markup?: InlineKeyboardMarkup;
     }): (Update.Edited & Message.CaptionableMessage) | true;
-    /** Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
+    /** Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its file_id or specify a URL. 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. */
     editMessageMedia(args: {
+        /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+        business_connection_id?: string;
         /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id?: number | string;
         /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -1194,8 +1229,10 @@ export type ApiMethods<F> = {
         /** An object for a new inline keyboard. */
         reply_markup?: InlineKeyboardMarkup;
     }): (Update.Edited & Message) | true;
-    /** Use this method to edit only the reply markup of messages. On success, if the edited message is not an inline message, the edited Message is returned, otherwise True is returned. */
+    /** Use this method to edit only the reply markup of 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. */
     editMessageReplyMarkup(args: {
+        /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+        business_connection_id?: string;
         /** Required if inline_message_id is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id?: number | string;
         /** Required if inline_message_id is not specified. Identifier of the message to edit */
@@ -1207,6 +1244,8 @@ export type ApiMethods<F> = {
     }): (Update.Edited & Message) | true;
     /** Use this method to stop a poll which was sent by the bot. On success, the stopped Poll is returned. */
     stopPoll(args: {
+        /** Unique identifier of the business connection on behalf of which the message to be edited was sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Identifier of the original message with the poll */
@@ -1253,7 +1292,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -1456,7 +1495,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -1528,6 +1567,13 @@ export type ApiMethods<F> = {
         /** Required if ok is False. Error message in human readable form that explains the reason for failure to proceed with the checkout (e.g. "Sorry, somebody just bought the last of our amazing black T-shirts while you were busy filling out your payment details. Please choose a different color or garment!"). Telegram will display this message to the user. */
         error_message?: string;
     }): true;
+    /** Returns the bot's Telegram Star transactions in chronological order. On success, returns a StarTransactions object. */
+    getStarTransactions(args: {
+        /** Number of transactions to skip in the response */
+        offset?: number;
+        /** The maximum number of transactions to be retrieved. Values between 1-100 are accepted. Defaults to 100. */
+        limit?: number;
+    }): StarTransactions;
     /** Refunds a successful payment in Telegram Stars. Returns True on success. */
     refundStarPayment(args: {
         /** Identifier of the user whose payment will be refunded */
@@ -1558,7 +1604,7 @@ export type ApiMethods<F> = {
         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 */
+        /** 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 */
         reply_parameters?: ReplyParameters;
@@ -1725,4 +1771,33 @@ export interface InputMediaDocument<F> {
     /** Disables automatic server-side content type detection for files uploaded using multipart/form-data. Always true, if the document is sent as part of an album. */
     disable_content_type_detection?: boolean;
 }
+/** This object describes the paid media to be sent. Currently, it can be one of
+
+- InputPaidMediaPhoto
+- InputPaidMediaVideo */
+export type InputPaidMedia<F> = InputMediaPhoto<F> | InputPaidMediaVideo<F>;
+/** The paid media to send is a photo. */
+export interface InputPaidMediaPhoto<F> {
+    /** Type of the media, must be photo */
+    type: "photo";
+    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files » */
+    media: F | string;
+}
+/** The paid media to send is a video. */
+export interface InputPaidMediaVideo<F> {
+    /** Type of the media, must be video */
+    type: "video";
+    /** File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://<file_attach_name>” to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files » */
+    media: 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>. More information on Sending Files » */
+    thumbnail?: F | string;
+    /** Video width */
+    width?: number;
+    /** Video height */
+    height?: number;
+    /** Video duration in seconds */
+    duration?: number;
+    /** Pass True if the uploaded video is suitable for streaming */
+    supports_streaming?: boolean;
+}
 export {};

package/package.json

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

package/payment.d.ts

@@ -99,3 +99,79 @@ export interface PreCheckoutQuery {
     /** Order information provided by the user */
     order_info?: OrderInfo;
 }
+/** This object describes the state of a revenue withdrawal operation. Currently, it can be one of
+
+- RevenueWithdrawalStatePending
+- RevenueWithdrawalStateSucceeded
+- RevenueWithdrawalStateFailed */
+export type RevenueWithdrawalState = RevenueWithdrawalStatePending | RevenueWithdrawalStateSucceeded | RevenueWithdrawalStateFailed;
+/** The withdrawal is in progress. */
+export interface RevenueWithdrawalStatePending {
+    /** Type of the state, always “pending” */
+    type: "pending";
+}
+/** The withdrawal succeeded. */
+export interface RevenueWithdrawalStateSucceeded {
+    /** Type of the state, always “succeeded” */
+    type: "succeeded";
+    /** Date the withdrawal was completed in Unix time */
+    date: number;
+    /** An HTTPS URL that can be used to see transaction details */
+    url: string;
+}
+/** The withdrawal failed and the transaction was refunded. */
+export interface RevenueWithdrawalStateFailed {
+    /** Type of the state, always “failed” */
+    type: "failed";
+}
+/** This object describes the source of a transaction, or its recipient for outgoing transactions. Currently, it can be one of
+
+- TransactionPartnerUser
+- TransactionPartnerFragment
+- TransactionPartnerTelegramAds
+- TransactionPartnerOther */
+export type TransactionPartner = TransactionPartnerUser | TransactionPartnerFragment | TransactionPartnerTelegramAds | TransactionPartnerOther;
+/** Describes a transaction with a user. */
+export interface TransactionPartnerUser {
+    /** Type of the transaction partner, always “user” */
+    type: "user";
+    /** Information about the user */
+    user: User;
+    /** Bot-specified invoice payload */
+    invoice_payload?: string;
+}
+/** Describes a withdrawal transaction with Fragment. */
+export interface TransactionPartnerFragment {
+    /** Type of the transaction partner, always “fragment” */
+    type: "fragment";
+    /** State of the transaction if the transaction is outgoing */
+    withdrawal_state?: RevenueWithdrawalState;
+}
+/** Describes a withdrawal transaction to the Telegram Ads platform. */
+export interface TransactionPartnerTelegramAds {
+    /** Type of the transaction partner, always “telegram_ads” */
+    type: "telegram_ads";
+}
+/** Describes a transaction with an unknown source or recipient. */
+export interface TransactionPartnerOther {
+    /** Type of the transaction partner, always “other” */
+    type: "other";
+}
+/** Describes a Telegram Star transaction. */
+export interface StarTransaction {
+    /** Unique identifier of the transaction. Coincides with the identifer of the original transaction for refund transactions. Coincides with SuccessfulPayment.telegram_payment_charge_id for successful incoming payments from users. */
+    id: string;
+    /** Number of Telegram Stars transferred by the transaction */
+    amount: number;
+    /** Date the transaction was created in Unix time */
+    date: number;
+    /** Source of an incoming transaction (e.g., a user purchasing goods or services, Fragment refunding a failed withdrawal). Only for incoming transactions */
+    source?: TransactionPartner;
+    /** Receiver of an outgoing transaction (e.g., a user for a purchase refund, Fragment for a withdrawal). Only for outgoing transactions */
+    receiver?: TransactionPartner;
+}
+/** Contains a list of Telegram Star transactions. */
+export interface StarTransactions {
+    /** The list of transactions */
+    transactions: StarTransaction[];
+}

package/settings.d.ts

@@ -32,7 +32,7 @@ export interface MenuButtonWebApp {
     type: "web_app";
     /** Text on the button */
     text: string;
-    /** Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. */
+    /** Description of the Web App that will be launched when the user presses the button. The Web App will be able to send an arbitrary message on behalf of the user using the method answerWebAppQuery. Alternatively, a t.me link to a Web App can be specified in the object instead of the Web App's URL, in which case the Web App will be opened as if the user pressed the link. */
     web_app: WebAppInfo;
 }
 /** Describes that no specific value for the menu button was set. */