@mtkruto/node 0.0.935 → 0.0.937

package/esm/types/3_message.js

@@ -22,7 +22,59 @@ import { FileID, FileType, FileUniqueID, FileUniqueType } from "./!0_file_id.js"
 import { constructContact } from "./0_contact.js";
 import { constructGame } from "./2_game.js";
 const d = debug("types/Message");
+async function getSender(message_, getEntity) {
+    if (message_.fromId instanceof types.PeerUser) {
+        const entity = await getEntity(message_.fromId);
+        if (entity) {
+            return { from: constructUser(entity) };
+        }
+        else {
+            UNREACHABLE();
+        }
+    }
+    else if (message_.fromId instanceof types.PeerChannel) {
+        const entity = await getEntity(message_.fromId);
+        if (entity) {
+            return { senderChat: constructChat(entity) };
+        }
+        else {
+            UNREACHABLE();
+        }
+    }
+}
+async function getReply(message_, chat, getMessage) {
+    if (getMessage && message_.replyTo instanceof types.MessageReplyHeader) {
+        let isTopicMessage = false;
+        if (message_.replyTo.forumTopic) {
+            isTopicMessage = true;
+        }
+        const replyToMessage = await getMessage(chat.id, message_.replyTo.replyToMsgId);
+        if (replyToMessage) {
+            return { replyToMessage, threadId: message_.replyTo.replyToTopId, isTopicMessage };
+        }
+        else {
+            d("couldn't get replied message");
+        }
+    }
+    else {
+        return {};
+    }
+}
+async function constructServiceMessage(message_, chat, getEntity, getMessage) {
+    const message = {
+        id: message_.id,
+        chat: chat,
+        date: new Date(message_.date * 1000),
+        isTopicMessage: false,
+    };
+    Object.assign(message, await getReply(message_, chat, getMessage));
+    Object.assign(message, await getSender(message_, getEntity));
+    return message;
+}
 export async function constructMessage(message_, getEntity, getMessage, getStickerSetName) {
+    if (!(message_ instanceof types.Message) && !(message_ instanceof types.MessageService)) {
+        UNREACHABLE();
+    }
     let chat_ = null;
     if (message_.peerId instanceof types.PeerUser) {
         const entity = await getEntity(message_.peerId);
@@ -54,37 +106,25 @@ export async function constructMessage(message_, getEntity, getMessage, getStick
     else {
         UNREACHABLE();
     }
+    if (message_ instanceof types.MessageService) {
+        return await constructServiceMessage(message_, chat_, getEntity, getMessage);
+    }
     const message = {
         id: message_.id,
         chat: chat_,
+        date: new Date(message_.date * 1000),
         views: message_.views,
         isTopicMessage: false,
         hasProtectedContent: message_.noforwards || false,
     };
+    Object.assign(message, await getReply(message_, chat_, getMessage));
+    Object.assign(message, await getSender(message_, getEntity));
     if (message_.media instanceof types.MessageMediaPhoto || message_.media instanceof types.MessageMediaDocument) {
         message.hasMediaSpoiler = message_.media.spoiler || false;
     }
     if (message_.groupedId != undefined) {
         message.mediaGroupId = String(message_.groupedId);
     }
-    if (message_.fromId instanceof types.PeerUser) {
-        const entity = await getEntity(message_.fromId);
-        if (entity) {
-            message.from = constructUser(entity);
-        }
-        else {
-            UNREACHABLE();
-        }
-    }
-    else if (message_.fromId instanceof types.PeerChannel) {
-        const entity = await getEntity(message_.fromId);
-        if (entity) {
-            message.senderChat = constructChat(entity);
-        }
-        else {
-            UNREACHABLE();
-        }
-    }
     if (message_.message) {
         if (message_.media == undefined) {
             message.text = message_.message;
@@ -101,7 +141,6 @@ export async function constructMessage(message_, getEntity, getMessage, getStick
             message.captionEntities = message_.entities.map(constructMessageEntity).filter((v) => v);
         }
     }
-    message.date = new Date(message_.date * 1000);
     if (message_.editDate != undefined) {
         message.editDate = new Date(message_.editDate * 1000);
     }
@@ -122,19 +161,6 @@ export async function constructMessage(message_, getEntity, getMessage, getStick
             UNREACHABLE();
         }
     }
-    if (getMessage && message_.replyTo instanceof types.MessageReplyHeader) {
-        if (message_.replyTo.forumTopic) {
-            message.isTopicMessage = true;
-        }
-        const replyToMessage = await getMessage(message.chat.id, message_.replyTo.replyToMsgId);
-        if (replyToMessage) {
-            message.replyToMessage = replyToMessage;
-            message.threadId = message_.replyTo.replyToTopId;
-        }
-        else {
-            d("couldn't get replied message");
-        }
-    }
     if (message_.viaBotId != undefined) {
         const viaBot = await getEntity(new types.PeerUser({ userId: message_.viaBotId }));
         if (viaBot) {

package/package.json

@@ -2,7 +2,7 @@
   "module": "./esm/mod.js",
   "main": "./script/mod.js",
   "name": "@mtkruto/node",
-  "version": "0.0.935",
+  "version": "0.0.937",
   "description": "MTKruto for Node.js",
   "author": "Roj <rojvv@icloud.com>",
   "license": "LGPL-3.0-or-later",

package/script/client/3_client.js

@@ -661,7 +661,7 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
                     (update instanceof types.UpdateDeleteChannelMessages) ||
                     (update instanceof types.UpdateEditChannelMessage) ||
                     (update instanceof types.UpdateChannelWebPage))) {
-                const channelId = update instanceof types.UpdateNewChannelMessage || update instanceof types.UpdateEditChannelMessage ? update.message[_1_tl_object_js_1.as](types.Message).peerId[_1_tl_object_js_1.as](types.PeerChannel).channelId : update.channelId;
+                const channelId = update instanceof types.UpdateNewChannelMessage || update instanceof types.UpdateEditChannelMessage ? update.message.peerId[_1_tl_object_js_1.as](types.PeerChannel).channelId : update.channelId;
                 let localPts = await this.storage.getChannelPts(channelId);
                 if (!localPts) {
                     localPts = update.pts - update.ptsCount;
@@ -709,7 +709,7 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
                     (update instanceof types.UpdateDeleteChannelMessages) ||
                     (update instanceof types.UpdateEditChannelMessage) ||
                     (update instanceof types.UpdateChannelWebPage)) {
-                    const channelId = update instanceof types.UpdateNewChannelMessage || update instanceof types.UpdateEditChannelMessage ? update.message[_1_tl_object_js_1.as](types.Message).peerId[_1_tl_object_js_1.as](types.PeerChannel).channelId : update.channelId;
+                    const channelId = update instanceof types.UpdateNewChannelMessage || update instanceof types.UpdateEditChannelMessage ? update.message.peerId[_1_tl_object_js_1.as](types.PeerChannel).channelId : update.channelId;
                     await this.recoverChannelUpdateGap(channelId, "applyUpdate");
                 }
                 else if ((update instanceof types.UpdateNewMessage) ||
@@ -1109,10 +1109,10 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
         if (result instanceof types.Updates) {
             for (const update of result.updates) {
                 if (update instanceof types.UpdateNewMessage) {
-                    return (0, _3_message_js_1.constructMessage)(update.message[_1_tl_object_js_1.as](types.Message), this[exports.getEntity].bind(this), this.getMessage.bind(this), this[exports.getStickerSetName].bind(this));
+                    return (0, _3_message_js_1.constructMessage)(update.message, this[exports.getEntity].bind(this), this.getMessage.bind(this), this[exports.getStickerSetName].bind(this));
                 }
                 else if (update instanceof types.UpdateNewChannelMessage) {
-                    return (0, _3_message_js_1.constructMessage)(update.message[_1_tl_object_js_1.as](types.Message), this[exports.getEntity].bind(this), this.getMessage.bind(this), this[exports.getStickerSetName].bind(this));
+                    return (0, _3_message_js_1.constructMessage)(update.message, this[exports.getEntity].bind(this), this.getMessage.bind(this), this[exports.getStickerSetName].bind(this));
                 }
             }
         }
@@ -1140,7 +1140,7 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
         }
         const messages = new Array();
         for (const message_ of messages_.messages) {
-            messages.push(await (0, _3_message_js_1.constructMessage)(message_[_1_tl_object_js_1.as](types.Message), this[exports.getEntity].bind(this), null, this[exports.getStickerSetName].bind(this)));
+            messages.push(await (0, _3_message_js_1.constructMessage)(message_, this[exports.getEntity].bind(this), null, this[exports.getStickerSetName].bind(this)));
         }
         return messages;
     }

package/script/constants.d.ts

@@ -4,7 +4,7 @@ export declare const publicKeys: Map<bigint, [bigint, bigint]>;
 export declare const VECTOR_CONSTRUCTOR = 481674261;
 export declare const DEFAULT_INITIAL_DC: DC;
 export declare const LAYER = 158;
-export declare const DEFAULT_APP_VERSION = "MTKruto 0.0.935";
+export declare const DEFAULT_APP_VERSION = "MTKruto 0.0.937";
 export declare const DEFAULT_DEVICE_MODEL: string;
 export declare const DEFAULT_LANG_CODE: string;
 export declare const DEFAULT_LANG_PACK = "";

package/script/constants.js

@@ -88,7 +88,7 @@ exports.publicKeys = new Map([
 exports.VECTOR_CONSTRUCTOR = 0x1CB5C415;
 exports.DEFAULT_INITIAL_DC = "2-test";
 exports.LAYER = 158;
-exports.DEFAULT_APP_VERSION = "MTKruto 0.0.935";
+exports.DEFAULT_APP_VERSION = "MTKruto 0.0.937";
 // @ts-ignore: lib
 exports.DEFAULT_DEVICE_MODEL = typeof dntShim.Deno === "undefined" ? typeof navigator === "undefined" ? typeof process === "undefined" ? "Unknown" : process.platform + "-" + process.arch : navigator.userAgent.split(" ")[0] : dntShim.Deno.build.os + "-" + dntShim.Deno.build.arch;
 exports.DEFAULT_LANG_CODE = typeof navigator === "undefined" ? "en" : navigator.language.split("-")[0];

package/script/types/0_chat_administrator_rights.d.ts

@@ -1,16 +1,29 @@
 import * as types from "../tl/2_types.js";
+/** Represents the rights of an administrator in a chat. */
 export interface ChatAdministratorRights {
+    /** True, if the user's presence in the chat is hidden */
     isAnonymous: boolean;
+    /** True, if the administrator can access the chat event log, chat statistics, message statistics in channels, see channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other administrator privilege */
     canManageChat: boolean;
+    /** True, if the administrator can delete messages of other users */
     canDeleteMessages: boolean;
+    /** True, if the administrator can manage video chats */
     canManageVideoChats: boolean;
+    /** True, if the administrator can restrict, ban or unban chat members */
     canRestrictMembers: boolean;
+    /** True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by the user) */
     canPromoteMembers: boolean;
+    /** True, if the user is allowed to change the chat title, photo and other settings */
     canChangeInfo: boolean;
+    /** True, if the user is allowed to invite new users to the chat */
     canInviteUsers: boolean;
+    /** Optional. True, if the administrator can post in the channel; channels only */
     canPostMessages?: boolean;
+    /** Optional. True, if the administrator can edit messages of other users and can pin messages; channels only */
     canEditMessages?: boolean;
+    /** Optional. True, if the user is allowed to pin messages; groups and supergroups only */
     canPinMessages?: boolean;
+    /** Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only */
     canManageTopics?: boolean;
 }
 export declare function constructChatAdministratorRights(rights_: types.ChatAdminRights): ChatAdministratorRights;

package/script/types/0_chat_photo.d.ts

@@ -1,10 +1,15 @@
 import * as types from "../tl/2_types.js";
 export declare namespace ChatPhoto {
     interface Base {
+        /** File identifier of small (160x160) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed. */
         smallFileId: string;
+        /** Unique file identifier of small (160x160) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
         smallFileUniqueId: string;
+        /** File identifier of big (640x640) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed. */
         bigFileId: string;
+        /** Unique file identifier of big (640x640) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
         bigFileUniqueId: string;
+        /** True, if an [animated profile picture](https://core.telegram.org/api/files#animated-profile-pictures) is available for the user */
         hasVideo: boolean;
     }
     interface User extends Base {
@@ -12,6 +17,7 @@ export declare namespace ChatPhoto {
     }
     type Chat = Base;
 }
+/** This object represents a chat photo. */
 export type ChatPhoto = ChatPhoto.User | ChatPhoto.Chat;
 export declare function constructChatPhoto(photo: types.ChatPhoto, chatId: number, chatAccessHash: bigint): ChatPhoto.Chat;
 export declare function constructChatPhoto(photo: types.UserProfilePhoto, chatId: number, chatAccessHash: bigint): ChatPhoto.User;

package/script/types/0_force_reply.d.ts

@@ -1,7 +1,11 @@
 import * as types from "../tl/2_types.js";
+/** Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot's message and tapped 'Reply'). This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode. */
 export interface ForceReply {
+    /** Shows reply interface to the user, as if they manually selected the bot's message and tapped 'Reply' */
     forceReply: true;
+    /** Shows reply interface to the user, as if they manually selected the bot's message and tapped 'Reply' */
     inputFieldPlaceholder?: string;
+    /** Optional. Use this parameter if you want to force reply from specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot's message is a reply (has reply_to_message_id), sender of the original message. */
     selective?: boolean;
 }
 export declare function constructForceReply(replyMarkup_: types.ReplyKeyboardForceReply): ForceReply;

package/script/types/0_keyboard_button_poll_type.d.ts

@@ -1,3 +1,5 @@
+/** This object represents type of a poll, which is allowed to be created and sent when the corresponding button is pressed. */
 export interface KeyboardButtonPollType {
+    /** Optional. If quiz is passed, the user will be allowed to create only polls in the quiz mode. If regular is passed, only regular polls will be allowed. Otherwise, the user will be allowed to create a poll of any type. */
     type?: string;
 }

package/script/types/0_login_url.d.ts

@@ -1,6 +1,11 @@
+/** This object represents a parameter of the inline keyboard button used to automatically authorize a user. Serves as a great replacement for the [Telegram Login Widget](https://core.telegram.org/widgets/login) when the user is coming from Telegram. */
 export interface LoginUrl {
+    /** An HTTPS URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in [Receiving authorization data](https://core.telegram.org/widgets/login#receiving-authorization-data). */
     url: string;
+    /** Optional. New text of the button in forwarded messages. */
     forwardText?: string;
+    /** Optional. Username of a bot, which will be used for user authorization. See [Setting up a bot](https://core.telegram.org/widgets/login#setting-up-a-bot) for more details. If not specified, the current bot's username will be assumed. The url's domain must be the same as the domain linked with the bot. See [Linking your domain to the bot](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) for more details. */
     botUsername?: string;
+    /** Optional. Pass True to request the permission for your bot to send messages to the user. */
     requestWriteAccess?: boolean;
 }

package/script/types/0_message_entity.d.ts

@@ -22,7 +22,9 @@ export declare enum MessageEntityType {
 }
 export declare namespace MessageEntity {
     interface Base {
+        /** Offset in [UTF-16 code units](https://core.telegram.org/api/entities#entity-length) to the start of the entity */
         offset: number;
+        /** Length of the entity in [UTF-16 code units](https://core.telegram.org/api/entities#entity-length) */
         length: number;
     }
     interface Mention extends Base {
@@ -48,6 +50,7 @@ export declare namespace MessageEntity {
     }
     interface Pre extends Base {
         type: MessageEntityType.Pre;
+        /** Optional. For “pre” only, the programming language of the entity text */
         language: string;
     }
     interface Code extends Base {
@@ -55,10 +58,12 @@ export declare namespace MessageEntity {
     }
     interface TextURL extends Base {
         type: MessageEntityType.TextURL;
+        /** Optional. For “text_link” only, URL that will be opened after user taps on the text */
         url: string;
     }
     interface MentionName extends Base {
         type: MessageEntityType.MentionName;
+        /** Optional. For “text_mention” only, the ID of the mentioned user */
         userId: number;
     }
     interface Cashtag extends Base {
@@ -84,9 +89,11 @@ export declare namespace MessageEntity {
     }
     interface CustomEmoji extends Base {
         type: MessageEntityType.CustomEmoji;
+        /** Optional. For “custom_emoji” only, unique identifier of the custom emoji */
         customEmojiId: string;
     }
 }
+/** This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc. */
 export type MessageEntity = MessageEntity.Mention | MessageEntity.Hashtag | MessageEntity.BotCommand | MessageEntity.URL | MessageEntity.EmailAddress | MessageEntity.Bold | MessageEntity.Italic | MessageEntity.Code | MessageEntity.Pre | MessageEntity.TextURL | MessageEntity.MentionName | MessageEntity.Cashtag | MessageEntity.Phone | MessageEntity.Underline | MessageEntity.Strike | MessageEntity.Blockquote | MessageEntity.BankCard | MessageEntity.Spoiler | MessageEntity.CustomEmoji;
 export declare function constructMessageEntity(obj: types.TypeMessageEntity): MessageEntity | null;
 export declare function messageEntityToTlObject(entity: MessageEntity): types.MessageEntityMention | types.MessageEntityHashtag | types.MessageEntityBotCommand | types.MessageEntityURL | types.MessageEntityEmail | types.MessageEntityBold | types.MessageEntityItalic | types.MessageEntityCode | types.MessageEntityPre | types.MessageEntityTextURL | types.MessageEntityMentionName | types.MessageEntityPhone | types.MessageEntityCashtag | types.MessageEntityUnderline | types.MessageEntityStrike | types.MessageEntityBlockquote | types.MessageEntityBankCard | types.MessageEntitySpoiler | types.MessageEntityCustomEmoji;

package/script/types/0_reply_keyboard_remove.d.ts

@@ -1,6 +1,9 @@
 import * as types from "../tl/2_types.js";
+/** Upon receiving a message with this object, Telegram clients will remove the current custom keyboard and display the default letter-keyboard. By default, custom keyboards are displayed until a new keyboard is sent by a bot. An exception is made for one-time keyboards that are hidden immediately after the user presses a button. */
 export interface ReplyKeyboardRemove {
+    /** Requests clients to remove the custom keyboard (user will not be able to summon this keyboard; if you want to hide the keyboard from sight but keep it accessible, use _one_time_keyboard_ in `ReplyKeyboardMarkup`) */
     removeKeyboard: true;
+    /** Optional. Use this parameter if you want to remove the keyboard for specific users only. Targets: 1) users that are @mentioned in the text of the `Message` object; 2) if the bot's message is a reply (has _reply_to_message_id_), sender of the original message. */
     selective?: boolean;
 }
 export declare function constructReplyKeyboardRemove(replyMarkup_: types.ReplyKeyboardHide): ReplyKeyboardRemove;

package/script/types/0_thumbnail.d.ts

@@ -1,9 +1,14 @@
 import * as types from "../tl/2_types.js";
 export interface Thumbnail {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Photo width */
     width: number;
+    /** Photo height */
     height: number;
+    /** Optional. File size in bytes */
     fileSize: number;
 }
 export declare function constructThumbnail(size: types.PhotoSize, file: types.Document | types.Photo): Thumbnail;

package/script/types/0_web_app_info.d.ts

@@ -1,4 +1,6 @@
+/** Describes a [Web App](https://core.telegram.org/bots/webapps). */
 export interface WebAppInfo {
+    /** An HTTPS URL of a Web App to be opened with additional data as specified in [Initializing Web Apps](https://core.telegram.org/bots/webapps#initializing-web-apps) */
     url: string;
 }
 export declare function constructWebAppInfo(url: string): WebAppInfo;

package/script/types/1_chat.d.ts

@@ -8,54 +8,86 @@ export declare enum ChatType {
 }
 export declare namespace Chat {
     interface Base {
+        /** Type of chat, can be either “private”, “group”, “supergroup” or “channel” */
         type: ChatType;
+        /** Unique identifier for this chat. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this identifier. */
         id: number;
         idColor: string;
+        /** Optional. Chat photo. */
         photo?: ChatPhoto;
     }
     interface Private extends Base {
         type: ChatType.Private;
+        /** True, if this user is a bot */
         isBot?: boolean;
+        /** Optional. First name of the other party in a private chat */
         firstName: string;
+        /** Optional. Last name of the other party in a private chat */
         lastName?: string;
+        /** Optional. Username, for private chats, supergroups and channels if available */
         username?: string;
+        /** Optional. Additional usernames */
         also?: string[];
+        /** Optional. Chat photo. */
         photo?: ChatPhoto.User;
+        /** True, if the user is a scam user */
         isScam: boolean;
+        /** True, if this user was reported by many users as a fake or scam user: be careful when interacting with them. */
         isFake: boolean;
+        /** True, if the user is an official support user */
         isSupport: boolean;
+        /** True, if the user is verified */
         isVerified: boolean;
+        /** True, if the access to the user must be restricted for the reason specified in `restriction_reason` */
         isRestricted?: boolean;
+        /** Optional. Contains the reason why access to the user must be restricted. */
         restrictionReason?: types.RestrictionReason[];
     }
     interface Group extends Base {
         type: ChatType.Group;
+        /** Optional. Title, for supergroups, channels and group chats */
         title: string;
+        /** Optional. Chat photo. */
         photo?: ChatPhoto.Chat;
+        /** True, if the user is creator of the chat */
         isCreator: boolean;
     }
     interface ChannelBase extends Base {
+        /** Optional. Title, for supergroups, channels and group chats */
         title: string;
+        /** Optional. Username, for private chats, supergroups and channels if available */
         username?: string;
+        /** Optional. Additional usernames */
         also?: string[];
+        /** Optional. Chat photo. */
         photo?: ChatPhoto.Chat;
+        /** True, if the user is a scam user */
         isScam: boolean;
+        /** True, if this user was reported by many users as a fake or scam user: be careful when interacting with them. */
         isFake: boolean;
+        /** True, if the user is verified */
         isVerified: boolean;
+        /** True, if the access to the user must be restricted for the reason specified in `restriction_reason` */
         isRestricted: boolean;
+        /** Optional. Contains the reason why access to the user must be restricted. */
         restrictionReason?: types.RestrictionReason[];
     }
     interface Channel extends ChannelBase {
         type: ChatType.Channel;
+        /** Optional. Title, for supergroups, channels and group chats */
         title: string;
+        /** Optional. Username, for private chats, supergroups and channels if available */
         username?: string;
+        /** Optional. Additional usernames */
         also?: string[];
     }
     interface Supergroup extends ChannelBase {
         type: ChatType.Supergroup;
+        /** Optional. True, if the supergroup chat is a forum (has [topics](https://telegram.org/blog/topics-in-groups-collectible-usernames#topics-in-groups) enabled) */
         isForum: boolean;
     }
 }
+/** This object represents a chat. */
 export type Chat = Chat.Private | Chat.Group | Chat.Supergroup | Chat.Channel;
 export declare function constructChat(chat: types.User): Chat.Private;
 export declare function constructChat(chat: types.Chat): Chat.Group;

package/script/types/1_inline_keyboard_button.d.ts

@@ -4,33 +4,42 @@ import { WebAppInfo } from "./0_web_app_info.js";
 import { LoginUrl } from "./0_login_url.js";
 export declare namespace InlineKeyboardButton {
     interface Base {
+        /** Label text on the button */
         text: string;
     }
     interface URL extends Base {
+        /** Optional. HTTP or tg:// URL to be opened when the button is pressed. Links `tg://user?id=<user_id>` can be used to mention a user by their ID without using a username, if this is allowed by their privacy settings. */
         url: string;
     }
     interface Callback extends Base {
+        /** Optional. Data to be sent in a callback query to the bot when button is pressed, 1-64 bytes */
         callbackData: string;
     }
     interface WebApp extends Base {
+        /** Optional. Description of the [Web App](https://core.telegram.org/bots/webapps) 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. Available only in private chats between a user and the bot. */
         webApp: WebAppInfo;
     }
     interface Login extends Base {
+        /** Optional. An HTTPS URL used to automatically authorize the user. Can be used as a replacement for the [Telegram Login Widget](https://core.telegram.org/widgets/login). */
         loginUrl: LoginUrl;
     }
     interface SwitchInline extends Base {
+        /** Optional. If set, pressing the button will prompt the user to select one of their chats, open that chat and insert the bot's username and the specified inline query in the input field. May be empty, in which case just the bot's username will be inserted. */
         switchInlineQuery: string;
     }
     interface SwitchInlineCurrent extends Base {
+        /** Optional. If set, pressing the button will insert the bot's username and the specified inline query in the current chat's input field. May be empty, in which case only the bot's username will be inserted. */
         switchInlineQueryCurrentChat: string;
     }
     interface Game extends Base {
         callbackGame: Record<never, never>;
     }
     interface Pay extends Base {
+        /** Optional. Specify True, to send a [Pay button](https://core.telegram.org/bots/api#payments). */
         pay: boolean;
     }
 }
+/** This object represents one button of an inline keyboard. You **must** use exactly one of the optional fields. */
 export type InlineKeyboardButton = InlineKeyboardButton.URL | InlineKeyboardButton.Callback | InlineKeyboardButton.WebApp | InlineKeyboardButton.Login | InlineKeyboardButton.SwitchInline | InlineKeyboardButton.SwitchInlineCurrent | InlineKeyboardButton.Game | InlineKeyboardButton.Pay;
 export declare function constructInlineKeyboardButton(button_: types.TypeKeyboardButton): InlineKeyboardButton;
 export declare function inlineKeyboardButtonToTlObject(button: InlineKeyboardButton, usernameResolver: (username: string) => MaybePromise<types.InputUser>): Promise<types.KeyboardButtonURL | types.KeyboardButtonCallback | types.KeyboardButtonSwitchInline | types.KeyboardButtonBuy | types.InputKeyboardButtonURLAuth | types.KeyboardButtonWebView>;

package/script/types/1_keyboard_button.d.ts

@@ -4,40 +4,61 @@ import { KeyboardButtonPollType } from "./0_keyboard_button_poll_type.js";
 import { WebAppInfo } from "./0_web_app_info.js";
 export declare namespace KeyboardButton {
     interface Text {
+        /** Text of the button. If none of the optional fields are used, it will be sent as a message when the button is pressed */
         text: string;
     }
+    /** This object defines the criteria used to request a suitable user. The identifier of the selected user will be shared with the bot when the corresponding button is pressed. [More about requesting users](https://core.telegram.org/bots/features#chat-and-user-selection) */
     interface RequestUser extends Text {
+        /** Optional. If specified, pressing the button will open a list of suitable users. Tapping on any user will send their identifier to the bot in a “user_shared” service message. Available in private chats only. */
         requestUser: {
+            /** Signed 32-bit identifier of the request, which will be received back in the [UserShared](https://core.telegram.org/bots/api#usershared) object. Must be unique within the message */
             requestId: number;
+            /** Optional. Pass True to request a bot, pass False to request a regular user. If not specified, no additional restrictions are applied. */
             userIsBot?: boolean;
+            /** Optional. Pass True to request a premium user, pass False to request a non-premium user. If not specified, no additional restrictions are applied. */
             userIsPremium?: boolean;
         };
     }
+    /** This object defines the criteria used to request a suitable chat. The identifier of the selected chat will be shared with the bot when the corresponding button is pressed. [More about requesting chats](https://core.telegram.org/bots/features#chat-and-user-selection) */
     interface RequestChat extends Text {
+        /** Optional. If specified, pressing the button will open a list of suitable chats. Tapping on a chat will send its identifier to the bot in a “chat_shared” service message. Available in private chats only. */
         requestChat: {
+            /** Signed 32-bit identifier of the request, which will be received back in the [ChatShared](https://core.telegram.org/bots/api#chatshared) object. Must be unique within the message */
             requestId: number;
+            /** Pass True to request a channel chat, pass False to request a group or a supergroup chat. */
             chatIsChannel: boolean;
+            /** Optional. Pass True to request a forum supergroup, pass False to request a non-forum chat. If not specified, no additional restrictions are applied. */
             chatIsForum?: boolean;
+            /** Optional. Pass True to request a supergroup or a channel with a username, pass False to request a chat without a username. If not specified, no additional restrictions are applied. */
             chatHasUsername?: boolean;
+            /** Optional. Pass True to request a chat owned by the user. Otherwise, no additional restrictions are applied. */
             chatIsCreated?: boolean;
+            /** Optional. A JSON-serialized object listing the required administrator rights of the user in the chat. The rights must be a superset of _bot_administrator_rights_. If not specified, no additional restrictions are applied. */
             userAdministratorRights?: ChatAdministratorRights;
+            /** Optional. A JSON-serialized object listing the required administrator rights of the bot in the chat. The rights must be a subset of _user_administrator_rights_. If not specified, no additional restrictions are applied. */
             botAdministratorRights?: ChatAdministratorRights;
+            /** Optional. Pass True to request a chat with the bot as a member. Otherwise, no additional restrictions are applied. */
             botIsMember?: boolean;
         };
     }
     interface RequestContact extends Text {
+        /** Optional. If True, the user's phone number will be sent as a contact when the button is pressed. Available in private chats only. */
         requestContact: true;
     }
     interface RequestLocation extends Text {
+        /** Optional. If True, the user's current location will be sent when the button is pressed. Available in private chats only. */
         requestLocation: true;
     }
     interface RequestPoll extends Text {
+        /** Optional. If specified, the user will be asked to create a poll and send it to the bot when the button is pressed. Available in private chats only. */
         requestPoll: KeyboardButtonPollType;
     }
     interface WebApp extends Text {
+        /** Optional. If specified, the described [Web App](https://core.telegram.org/bots/webapps) will be launched when the button is pressed. The Web App will be able to send a “web_app_data” service message. Available in private chats only. */
         webApp: WebAppInfo;
     }
 }
+/** This object represents one button of the reply keyboard. For simple text buttons, _String_ can be used instead of this object to specify the button text. The optional fields _web_app_, _request_user_, _request_chat_, _request_contact_, _request_location_, and _request_poll_ are mutually exclusive. */
 export type KeyboardButton = KeyboardButton.Text | KeyboardButton.RequestUser | KeyboardButton.RequestChat | KeyboardButton.RequestContact | KeyboardButton.RequestLocation | KeyboardButton.RequestPoll | KeyboardButton.WebApp;
 export declare function constructKeyboardButton(button_: types.TypeKeyboardButton): KeyboardButton;
 export declare function keyboardButtonToTlObject(button: KeyboardButton): types.KeyboardButtonRequestPhone | types.KeyboardButtonRequestGeoLocation | types.KeyboardButtonRequestPoll | types.KeyboardButtonWebView | types.KeyboardButtonRequestPeer;

package/script/types/1_photo.d.ts

@@ -1,10 +1,15 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
 export interface Photo {
+    /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
+    /** Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file. */
     fileUniqueId: string;
+    /** Photo width */
     width: number;
+    /** Photo height */
     height: number;
+    /** Optional. File size in bytes */
     fileSize: number;
     thumbnails: Thumbnail[];
 }

package/script/types/1_user.d.ts

@@ -1,20 +1,35 @@
 import * as types from "../tl/2_types.js";
 import { ChatPhoto } from "./0_chat_photo.js";
+/** This object represents a Telegram user or bot. */
 export interface User {
+    /** Unique identifier for this user or bot. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a 64-bit integer or double-precision float type are safe for storing this identifier. */
     id: number;
     idColor: string;
+    /** True, if this user is a bot */
     isBot: boolean;
+    /** User's or bot's first name */
     firstName: string;
+    /** Optional. User's or bot's last name */
     lastName?: string;
+    /** Optional. User's or bot's username */
     username?: string;
+    /** Optional. Additional usernames */
     also?: string[];
+    /** Optional. Chat photo */
     photo?: ChatPhoto.User;
+    /** Optional. [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag) of the user's language */
     languageCode?: string;
+    /** True, if the user is a scam user */
     isScam: boolean;
+    /** True, if this user was reported by many users as a fake or scam user: be careful when interacting with them. */
     isFake: boolean;
+    /** Optional. True, if this user is a Telegram Premium user */
     isPremium: boolean;
+    /** True, if the user is verified */
     isVerified: boolean;
+    /** True, if the user is an official support user */
     isSupport: boolean;
+    /** Optional. True, if this user added the bot to the attachment menu */
     addedToAttachmentMenu: boolean;
 }
 export declare function constructUser(user_: types.User): User;

package/script/types/2_inline_keyboard_markup.d.ts

@@ -1,6 +1,8 @@
 import * as types from "../tl/2_types.js";
 import { InlineKeyboardButton, inlineKeyboardButtonToTlObject } from "./1_inline_keyboard_button.js";
+/** This object represents an [inline keyboard](https://core.telegram.org/bots/features#inline-keyboards) that appears right next to the message it belongs to. */
 export interface InlineKeyboardMarkup {
+    /** Array of button rows, each represented by an Array of InlineKeyboardButton objects */
     inlineKeyboard: InlineKeyboardButton[][];
 }
 export declare function constructInlineKeyboardMarkup(keyboard_: types.ReplyInlineMarkup): InlineKeyboardMarkup;