@grammyjs/types 3.8.0 → 3.9.0

package/langs.d.ts

@@ -0,0 +1,193 @@
+/** A two-letter ISO 639-1 language code.
+ * @see https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes
+ * @see https://www.loc.gov/standards/iso639-2/php/code_list.php
+ */
+export type LanguageCode = typeof LanguageCodes[keyof typeof LanguageCodes];
+/**
+ * @see {@link LanguageCode}
+ */
+export declare const LanguageCodes: {
+    readonly Abkhazian: "ab";
+    readonly Afar: "aa";
+    readonly Afrikaans: "af";
+    readonly Akan: "ak";
+    readonly Albanian: "sq";
+    readonly Amharic: "am";
+    readonly Arabic: "ar";
+    readonly Aragonese: "an";
+    readonly Armenian: "hy";
+    readonly Assamese: "as";
+    readonly Avaric: "av";
+    readonly Avestan: "ae";
+    readonly Aymara: "ay";
+    readonly Azerbaijani: "az";
+    readonly Bambara: "bm";
+    readonly Bashkir: "ba";
+    readonly Basque: "eu";
+    readonly Belarusian: "be";
+    readonly Bengali: "bn";
+    readonly Bislama: "bi";
+    readonly Bosnian: "bs";
+    readonly Breton: "br";
+    readonly Bulgarian: "bg";
+    readonly Burmese: "my";
+    readonly Catalan: "ca";
+    readonly Chamorro: "ch";
+    readonly Chechen: "ce";
+    readonly Chichewa: "ny";
+    readonly Chinese: "zh";
+    readonly ChurchSlavonic: "cu";
+    readonly Chuvash: "cv";
+    readonly Cornish: "kw";
+    readonly Corsican: "co";
+    readonly Cree: "cr";
+    readonly Croatian: "hr";
+    readonly Czech: "cs";
+    readonly Danish: "da";
+    readonly Divehi: "dv";
+    readonly Dutch: "nl";
+    readonly Dzongkha: "dz";
+    readonly English: "en";
+    readonly Esperanto: "eo";
+    readonly Estonian: "et";
+    readonly Ewe: "ee";
+    readonly Faroese: "fo";
+    readonly Fijian: "fj";
+    readonly Finnish: "fi";
+    readonly French: "fr";
+    readonly WesternFrisian: "fy";
+    readonly Fulah: "ff";
+    readonly Gaelic: "gd";
+    readonly Galician: "gl";
+    readonly Ganda: "lg";
+    readonly Georgian: "ka";
+    readonly German: "de";
+    readonly Greek: "el";
+    readonly Kalaallisut: "kl";
+    readonly Guarani: "gn";
+    readonly Gujarati: "gu";
+    readonly Haitian: "ht";
+    readonly Hausa: "ha";
+    readonly Hebrew: "he";
+    readonly Herero: "hz";
+    readonly Hindi: "hi";
+    readonly HiriMotu: "ho";
+    readonly Hungarian: "hu";
+    readonly Icelandic: "is";
+    readonly Ido: "io";
+    readonly Igbo: "ig";
+    readonly Indonesian: "id";
+    readonly Interlingua: "ia";
+    readonly Interlingue: "ie";
+    readonly Inuktitut: "iu";
+    readonly Inupiaq: "ik";
+    readonly Irish: "ga";
+    readonly Italian: "it";
+    readonly Japanese: "ja";
+    readonly Javanese: "jv";
+    readonly Kannada: "kn";
+    readonly Kanuri: "kr";
+    readonly Kashmiri: "ks";
+    readonly Kazakh: "kk";
+    readonly CentralKhmer: "km";
+    readonly Kikuyu: "ki";
+    readonly Kinyarwanda: "rw";
+    readonly Kirghiz: "ky";
+    readonly Komi: "kv";
+    readonly Kongo: "kg";
+    readonly Korean: "ko";
+    readonly Kuanyama: "kj";
+    readonly Kurdish: "ku";
+    readonly Lao: "lo";
+    readonly Latin: "la";
+    readonly Latvian: "lv";
+    readonly Limburgan: "li";
+    readonly Lingala: "ln";
+    readonly Lithuanian: "lt";
+    readonly LubaKatanga: "lu";
+    readonly Luxembourgish: "lb";
+    readonly Macedonian: "mk";
+    readonly Malagasy: "mg";
+    readonly Malay: "ms";
+    readonly Malayalam: "ml";
+    readonly Maltese: "mt";
+    readonly Manx: "gv";
+    readonly Maori: "mi";
+    readonly Marathi: "mr";
+    readonly Marshallese: "mh";
+    readonly Mongolian: "mn";
+    readonly Nauru: "na";
+    readonly Navajo: "nv";
+    readonly NorthNdebele: "nd";
+    readonly SouthNdebele: "nr";
+    readonly Ndonga: "ng";
+    readonly Nepali: "ne";
+    readonly Norwegian: "no";
+    readonly NorwegianBokmål: "nb";
+    readonly NorwegianNynorsk: "nn";
+    readonly SichuanYi: "ii";
+    readonly Occitan: "oc";
+    readonly Ojibwa: "oj";
+    readonly Oriya: "or";
+    readonly Oromo: "om";
+    readonly Ossetian: "os";
+    readonly Pali: "pi";
+    readonly Pashto: "ps";
+    readonly Persian: "fa";
+    readonly Polish: "pl";
+    readonly Portuguese: "pt";
+    readonly Punjabi: "pa";
+    readonly Quechua: "qu";
+    readonly Romanian: "ro";
+    readonly Romansh: "rm";
+    readonly Rundi: "rn";
+    readonly Russian: "ru";
+    readonly NorthernSami: "se";
+    readonly Samoan: "sm";
+    readonly Sango: "sg";
+    readonly Sanskrit: "sa";
+    readonly Sardinian: "sc";
+    readonly Serbian: "sr";
+    readonly Shona: "sn";
+    readonly Sindhi: "sd";
+    readonly Sinhala: "si";
+    readonly Slovak: "sk";
+    readonly Slovenian: "sl";
+    readonly Somali: "so";
+    readonly SouthernSotho: "st";
+    readonly Spanish: "es";
+    readonly Sundanese: "su";
+    readonly Swahili: "sw";
+    readonly Swati: "ss";
+    readonly Swedish: "sv";
+    readonly Tagalog: "tl";
+    readonly Tahitian: "ty";
+    readonly Tajik: "tg";
+    readonly Tamil: "ta";
+    readonly Tatar: "tt";
+    readonly Telugu: "te";
+    readonly Thai: "th";
+    readonly Tibetan: "bo";
+    readonly Tigrinya: "ti";
+    readonly Tonga: "to";
+    readonly Tsonga: "ts";
+    readonly Tswana: "tn";
+    readonly Turkish: "tr";
+    readonly Turkmen: "tk";
+    readonly Twi: "tw";
+    readonly Uighur: "ug";
+    readonly Ukrainian: "uk";
+    readonly Urdu: "ur";
+    readonly Uzbek: "uz";
+    readonly Venda: "ve";
+    readonly Vietnamese: "vi";
+    readonly Volapük: "vo";
+    readonly Walloon: "wa";
+    readonly Welsh: "cy";
+    readonly Wolof: "wo";
+    readonly Xhosa: "xh";
+    readonly Yiddish: "yi";
+    readonly Yoruba: "yo";
+    readonly Zhuang: "za";
+    readonly Zulu: "zu";
+};

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/methods.d.ts

@@ -4,9 +4,10 @@ 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";
 /** Extracts the parameters of a given method name */
 type Params<F, M extends keyof ApiMethods<F>> = Parameters<ApiMethods<F>[M]>;
 /** Utility type providing the argument type for the given method name or `{}` if the method does not take any parameters */
@@ -93,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;
@@ -202,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;
@@ -241,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;
@@ -274,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;
@@ -317,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;
@@ -358,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;
@@ -389,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;
@@ -419,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;
@@ -442,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;
@@ -473,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;
@@ -484,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 */
@@ -507,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 */
@@ -544,7 +549,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;
@@ -573,7 +578,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;
@@ -622,7 +627,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;
@@ -645,7 +650,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;
@@ -1066,57 +1071,57 @@ export type ApiMethods<F> = {
         /** An object, describing scope of users for which the commands are relevant. Defaults to BotCommandScopeDefault. */
         scope?: BotCommandScope;
         /** A two-letter ISO 639-1 language code. If empty, commands will be applied to all users from the given scope, for whose language there are no dedicated commands */
-        language_code?: string;
+        language_code?: LanguageCode;
     }): true;
     /** Use this method to delete the list of the bot's commands for the given scope and user language. After deletion, higher level commands will be shown to affected users. Returns True on success. */
     deleteMyCommands(args: {
         /** An object, describing scope of users for which the commands are relevant. Defaults to BotCommandScopeDefault. */
         scope?: BotCommandScope;
         /** A two-letter ISO 639-1 language code. If empty, commands will be applied to all users from the given scope, for whose language there are no dedicated commands */
-        language_code?: string;
+        language_code?: LanguageCode;
     }): true;
     /** Use this method to get the current list of the bot's commands for the given scope and user language. Returns an Array of BotCommand objects. If commands aren't set, an empty list is returned. */
     getMyCommands(args: {
         /** An object, describing scope of users. Defaults to BotCommandScopeDefault. */
         scope?: BotCommandScope;
         /** A two-letter ISO 639-1 language code or an empty string */
-        language_code?: string;
+        language_code?: LanguageCode;
     }): BotCommand[];
     /** Use this method to change the bot's name. Returns True on success. */
     setMyName(args: {
         /** New bot name; 0-64 characters. Pass an empty string to remove the dedicated name for the given language. */
         name?: string;
         /** A two-letter ISO 639-1 language code. If empty, the name will be shown to all users for whose language there is no dedicated name. */
-        language_code?: string;
+        language_code?: LanguageCode;
     }): true;
     /** Use this method to get the current bot name for the given user language. Returns BotName on success. */
     getMyName(args: {
         /** A two-letter ISO 639-1 language code or an empty string */
-        language_code?: string;
+        language_code?: LanguageCode;
     }): BotName;
     /** Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty. Returns True on success. */
     setMyDescription(args: {
         /** New bot description; 0-512 characters. Pass an empty string to remove the dedicated description for the given language. */
         description?: string;
         /** A two-letter ISO 639-1 language code. If empty, the description will be applied to all users for whose language there is no dedicated description. */
-        language_code?: string;
+        language_code?: LanguageCode;
     }): true;
     /** Use this method to get the current bot description for the given user language. Returns BotDescription on success. */
     getMyDescription(args: {
         /** A two-letter ISO 639-1 language code or an empty string */
-        language_code?: string;
+        language_code?: LanguageCode;
     }): BotDescription;
     /** Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot. Returns True on success. */
     setMyShortDescription(args: {
         /** New short description for the bot; 0-120 characters. Pass an empty string to remove the dedicated short description for the given language. */
         short_description?: string;
         /** A two-letter ISO 639-1 language code. If empty, the short description will be applied to all users for whose language there is no dedicated short description. */
-        language_code?: string;
+        language_code?: LanguageCode;
     }): true;
     /** Use this method to get the current bot short description for the given user language. Returns BotShortDescription on success. */
     getMyShortDescription(args: {
         /** A two-letter ISO 639-1 language code or an empty string */
-        language_code?: string;
+        language_code?: LanguageCode;
     }): BotShortDescription;
     /** Use this method to change the bot's menu button in a private chat, or the default menu button. Returns True on success. */
     setChatMenuButton(args: {
@@ -1142,8 +1147,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 */
@@ -1161,8 +1168,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 */
@@ -1180,8 +1189,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 */
@@ -1193,8 +1204,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 */
@@ -1206,6 +1219,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 */
@@ -1252,7 +1267,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;
@@ -1455,7 +1470,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;
@@ -1527,6 +1542,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 */
@@ -1557,7 +1579,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;

package/mod.d.ts

@@ -8,3 +8,4 @@ export * from "./passport.js";
 export * from "./payment.js";
 export * from "./settings.js";
 export * from "./update.js";
+export * from "./langs.js";

package/package.json

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

package/payment.d.ts

@@ -99,3 +99,71 @@ 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
+
+- TransactionPartnerFragment
+- TransactionPartnerUser
+- TransactionPartnerOther */
+export type TransactionPartner = TransactionPartnerFragment | TransactionPartnerUser | TransactionPartnerOther;
+/** 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 transaction with a user. */
+export interface TransactionPartnerUser {
+    /** Type of the transaction partner, always “user” */
+    type: "user";
+    /** Information about the user */
+    user: User;
+}
+/** 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[];
+}