@telegram.ts/types 1.15.1 → 1.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telegram.ts/types",
-  "version": "1.15.1",
+  "version": "1.17.0",
   "description": "Comprehensive Type Declarations for Telegram Bot API with telegramsjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
@@ -11,7 +11,7 @@
     "api",
     "types"
   ],
-  "homepage": "https://telegramsjs.vercel.app/",
+  "homepage": "https://docs-telegramsjs.vercel.app/",
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/telegramsjs/types/issues"

package/src/apiMethodsTypes.d.ts

@@ -1,9 +1,10 @@
 import type { ReadStream } from "node:fs";
 import type { Buffer } from "node:buffer";
+import type { LanguageCode } from "./languageTypes";
 import type {
   InlineQueryResult,
   InlineQueryResultsButton,
-} from "./inlineTypes.ts";
+} from "./inlineTypes";
 import type {
   BotCommand,
   BusinessConnection,
@@ -19,13 +20,13 @@ import type {
   UserFromGetMe,
   UserProfilePhotos,
   WebhookInfo,
-} from "./manageTypes.ts";
+} from "./manageTypes";
 import type {
   ForceReply,
   InlineKeyboardMarkup,
   ReplyKeyboardMarkup,
   ReplyKeyboardRemove,
-} from "./markupTypes.ts";
+} from "./markupTypes";
 import type {
   File,
   GameHighScore,
@@ -42,21 +43,21 @@ import type {
   SentWebAppMessage,
   Sticker,
   StickerSet,
-} from "./messageTypes.ts";
-import type { PassportElementError } from "./passportTypes.ts";
+} from "./messageTypes";
+import type { PassportElementError } from "./passportTypes";
 import type {
   LabeledPrice,
   ShippingOption,
   StarTransactions,
-} from "./invoiceTypes.ts";
+} from "./invoiceTypes";
 import type {
   BotCommandScope,
   BotDescription,
   BotName,
   BotShortDescription,
   MenuButton,
-} from "./botCommandTypes.ts";
-import type { Update } from "./updateTypes.ts";
+} from "./botCommandTypes";
+import type { Update } from "./updateTypes";
 
 /** Wrapper type to bundle all methods of the Telegram Bot API */
 export type ApiMethods = {
@@ -145,6 +146,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -209,6 +212,8 @@ export type ApiMethods = {
     show_caption_above_media?: boolean;
     /** Sends the message silently. Users will receive a notification with no sound. */
     disable_notification?: 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;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
     /** Description of the message to reply to */
@@ -263,6 +268,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -305,6 +312,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -341,6 +350,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -387,6 +398,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -431,6 +444,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -465,6 +480,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -498,6 +515,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -516,9 +535,9 @@ export type ApiMethods = {
     business_connection_id?: string;
     /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
     chat_id: number | string;
-    /** An array describing messages to be sent, must include 2-10 items */
     /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
     message_thread_id?: number;
+    /** An array describing messages to be sent, must include 2-10 items */
     media: ReadonlyArray<
       InputMediaAudio | InputMediaDocument | InputMediaPhoto | InputMediaVideo
     >;
@@ -526,6 +545,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent messages from forwarding and saving */
     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;
     /** 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 */
@@ -561,6 +582,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -635,6 +658,8 @@ export type ApiMethods = {
     show_caption_above_media?: boolean;
     /** Sends the message silently. Users will receive a notification with no sound. */
     disable_notification?: 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;
     /** Protects the contents of the sent message from forwarding and saving */
     protect_content?: boolean;
     /** Description of the message to reply to */
@@ -675,6 +700,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -707,6 +734,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -759,6 +788,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -785,6 +816,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding */
     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;
     /** 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 */
@@ -1296,7 +1329,7 @@ export type ApiMethods = {
     /** 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. */
@@ -1304,7 +1337,7 @@ export type ApiMethods = {
     /** 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. */
@@ -1312,7 +1345,7 @@ export type ApiMethods = {
     /** 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. */
@@ -1320,13 +1353,13 @@ export type ApiMethods = {
     /** 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. */
@@ -1334,13 +1367,13 @@ export type ApiMethods = {
     /** 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. */
@@ -1348,13 +1381,13 @@ export type ApiMethods = {
     /** 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. */
@@ -1429,7 +1462,7 @@ export type ApiMethods = {
     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. 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. */
+  /** Use this method to edit animation, audio, document, photo, or video messages, or  to add media to text 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;
@@ -1512,6 +1545,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -1735,6 +1770,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */
@@ -1849,6 +1886,8 @@ export type ApiMethods = {
     disable_notification?: boolean;
     /** Protects the contents of the sent message from forwarding and saving */
     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;
     /** 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 */

package/src/botCommandTypes.d.ts

@@ -1,4 +1,4 @@
-import type { WebAppInfo } from "./markupTypes.js";
+import type { WebAppInfo } from "./markupTypes";
 
 /**
  * This interface represents the name of the bot.

package/src/index.d.ts

@@ -6,5 +6,6 @@ export * from "./messageTypes";
 export * from "./apiMethodsTypes";
 export * from "./passportTypes";
 export * from "./invoiceTypes";
+export * from "./languageTypes";
 export * from "./botCommandTypes";
 export * from "./updateTypes";

package/src/invoiceTypes.d.ts

@@ -160,11 +160,13 @@ export interface RevenueWithdrawalStateFailed {
 - TransactionPartnerUser
 - TransactionPartnerFragment
 - TransactionPartnerTelegramAds
+- TransactionPartnerTelegramApi 
 - TransactionPartnerOther */
 export type TransactionPartner =
   | TransactionPartnerUser
   | TransactionPartnerFragment
   | TransactionPartnerTelegramAds
+  | TransactionPartnerTelegramApi
   | TransactionPartnerOther;
 
 /** Describes a transaction with a user. */
@@ -189,6 +191,14 @@ export interface TransactionPartnerFragment {
   withdrawal_state?: RevenueWithdrawalState;
 }
 
+/** Describes a transaction with payment for paid broadcasting. */
+export interface TransactionPartnerTelegramApi {
+  /** Type of the transaction partner, always “telegram_api” */
+  type: "telegram_api";
+  /** The number of successful requests that exceeded regular limits and were therefore billed */
+  request_count: number;
+}
+
 /** Describes a withdrawal transaction to the Telegram Ads platform. */
 export interface TransactionPartnerTelegramAds {
   /** Type of the transaction partner, always “telegram_ads” */

package/src/languageTypes.d.ts

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

package/src/manageTypes.d.ts

@@ -5,6 +5,7 @@ import type {
   ReactionType,
   Sticker,
 } from "./messageTypes";
+import type { LanguageCode } from "./languageTypes";
 import type { Update } from "./updateTypes";
 
 /** Describes the current status of a webhook. */
@@ -42,7 +43,7 @@ export interface User {
   /** User's or bot's username */
   username?: string;
   /** IETF language tag of the user's language */
-  language_code?: string;
+  language_code?: LanguageCode;
   /** True, if this user is a Telegram Premium user */
   is_premium?: true;
   /** True, if this user added the bot to the attachment menu */

package/src/markupTypes.d.ts

@@ -44,6 +44,10 @@ export declare namespace InlineKeyboardButton {
     /** 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. */
     switch_inline_query_chosen_chat: SwitchInlineQueryChosenChat;
   }
+  export interface CopyTextButton extends AbstractInlineKeyboardButton {
+    /**  Description of the button that copies the specified text to the clipboard. */
+    copy_text: CopyTextButton;
+  }
   export interface GameButton extends AbstractInlineKeyboardButton {
     /** Description of the game that will be launched when the user presses the button.
 
@@ -67,6 +71,7 @@ export type InlineKeyboardButton =
   | InlineKeyboardButton.SwitchInlineButton
   | InlineKeyboardButton.SwitchInlineCurrentChatButton
   | InlineKeyboardButton.SwitchInlineChosenChatButton
+  | InlineKeyboardButton.CopyTextButton
   | InlineKeyboardButton.UrlButton
   | InlineKeyboardButton.WebAppButton;
 
@@ -216,6 +221,12 @@ export interface ForceReply {
   selective?: boolean;
 }
 
+/** This object represents an inline keyboard button that copies specified text to the clipboard. */
+export interface CopyTextButton {
+  /** The text to be copied to the clipboard; 1-256 characters */
+  text: string;
+}
+
 /** Describes a Web App. */
 export interface WebAppInfo {
   /** An HTTPS URL of a Web App to be opened with additional data as specified in Initializing Web Apps */

package/src/messageTypes.d.ts

@@ -1,4 +1,5 @@
 import type { Chat, User } from "./manageTypes";
+import type { LanguageCode } from "./languageTypes";
 import type { InlineKeyboardMarkup } from "./markupTypes";
 import type { PassportData } from "./passportTypes";
 import type {
@@ -11,7 +12,7 @@ type MsgWith<P extends keyof Message> = Record<P, NonNullable<Message[P]>>;
 
 export declare namespace Message {
   interface ServiceMessage {
-    /** Unique message identifier inside this chat */
+    /** Unique message identifier inside this chat. In specific instances (e.g., message containing a video sent to a big chat), the server might automatically schedule a message instead of sending it immediately. In such cases, this field will be 0 and the relevant message will be unusable until it is actually sent */
     message_id: number;
     /** Unique identifier of a message thread or a forum topic to which the message belongs; for supergroups only */
     message_thread_id?: number;
@@ -281,7 +282,7 @@ export interface Message extends Message.MediaMessage {
 
 /** This object represents a unique message identifier. */
 export interface MessageId {
-  /** Unique message identifier */
+  /** Unique message identifier. In specific instances (e.g., message containing a video sent to a big chat), the server might automatically schedule a message instead of sending it immediately. In such cases, this field will be 0 and the relevant message will be unusable until it is actually sent */
   message_id: number;
 }
 
@@ -430,7 +431,7 @@ export type ParseMode = "Markdown" | "MarkdownV2" | "HTML";
 
 export declare namespace MessageEntity {
   interface AbstractMessageEntity {
-    /** Type of the entity. Currently, can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers) */
+    /** Type of the entity. Currently, can be “mention” (@username), “hashtag” (#hashtag or #hashtag@chatusername), “cashtag” ($USD or $USD@chatusername), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames), “custom_emoji” (for inline custom emoji stickers) */
     type: string;
     /** Offset in UTF-16 code units to the start of the entity */
     offset: number;
@@ -458,7 +459,7 @@ export declare namespace MessageEntity {
   export interface PreMessageEntity extends AbstractMessageEntity {
     type: "pre";
     /** For “pre” only, the programming language of the entity text */
-    language?: string;
+    language?: LanguageCode;
   }
   export interface TextLinkMessageEntity extends AbstractMessageEntity {
     type: "text_link";