@mtkruto/node 0.0.958 → 0.0.961

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

@@ -8,34 +8,34 @@ export declare namespace InlineKeyboardButton {
         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. */
+        /** 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 */
+        /** 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. */
+        /** 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). */
+        /** 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. */
+        /** 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. */
+        /** 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). */
+        /** Specify True, to send a [Pay button](https://core.telegram.org/bots/api#payments). */
         pay: boolean;
     }
 }

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

@@ -9,52 +9,52 @@ export declare namespace KeyboardButton {
     }
     /** 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. */
+        /** 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. */
+            /** 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. */
+            /** 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. */
+        /** 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. */
+            /** 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. */
+            /** 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. */
+            /** 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. */
+            /** 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. */
+            /** 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. */
+            /** 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. */
+        /** 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. */
+        /** 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. */
+        /** 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. */
+        /** 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;
     }
 }

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

@@ -1,5 +1,6 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents a photo. */
 export interface Photo {
     /** Identifier for this file, which can be used to download or reuse the file */
     fileId: string;
@@ -9,7 +10,7 @@ export interface Photo {
     width: number;
     /** Photo height */
     height: number;
-    /** Optional. File size in bytes */
+    /** File size in bytes */
     fileSize: number;
     thumbnails: Thumbnail[];
 }

package/esm/types/1_sticker.d.ts

@@ -2,21 +2,37 @@ import * as types from "../tl/2_types.js";
 import { MaybePromise } from "../utilities/0_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
 import { MaskPosition } from "./0_mask_position.js";
+/** This object represents a sticker. */
 export interface Sticker {
+    /** 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;
+    /** Type of the sticker, currently one of "regular", "mask", "custom_emoji". The type of the sticker is independent from its format, which is determined by the fields is_animated and is_video. */
     type: "regular" | "mask" | "custom_emoji";
+    /** Sticker width */
     width: number;
+    /** Sticker height */
     height: number;
+    /** True, if the sticker is [animated](https://telegram.org/blog/animated-stickers) */
     isAnimated: boolean;
+    /** True, if the sticker is a [video sticker](https://telegram.org/blog/video-stickers-better-reactions) */
     isVideo: boolean;
+    /** Sticker thumbnail in the .WEBP or .JPG format */
     thumbnails: Thumbnail[];
+    /** Emoji associated with the sticker */
     emoji?: string;
+    /** Name of the sticker set to which the sticker belongs */
     setName?: string;
+    /** For premium regular stickers, premium animation for the sticker */
     premiumAnimation?: File;
+    /** For mask stickers, the position where the mask should be placed */
     maskPosition?: MaskPosition;
+    /** For custom emoji stickers, unique identifier of the custom emoji */
     customEmojiId?: string;
+    /** True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places */
     needsRepainting?: boolean;
+    /** File size in bytes */
     fileSize?: number;
 }
 export type StickerSetNameGetter = (inputStickerSet: types.InputStickerSetID) => MaybePromise<string>;

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

@@ -9,27 +9,27 @@ export interface User {
     isBot: boolean;
     /** User's or bot's first name */
     firstName: string;
-    /** Optional. User's or bot's last name */
+    /** User's or bot's last name */
     lastName?: string;
-    /** Optional. User's or bot's username */
+    /** User's or bot's username */
     username?: string;
-    /** Optional. Additional usernames */
+    /** Additional usernames */
     also?: string[];
-    /** Optional. Chat photo */
+    /** Chat photo */
     photo?: ChatPhoto.User;
-    /** Optional. [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag) of the user's language */
+    /** [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 */
+    /** 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 */
+    /** True, if this user added the bot to the attachment menu */
     addedToAttachmentMenu: boolean;
 }
 export declare function constructUser(user_: types.User): User;

package/esm/types/1_video.d.ts

@@ -1,14 +1,24 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents a video file. */
 export interface Video {
+    /** 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;
+    /** Video width as defined by sender */
     width: number;
+    /** Video height as defined by sender */
     height: number;
+    /** Duration of the video in seconds as defined by sender */
     duration: number;
+    /** Video thumbnail */
     thumbnails: Thumbnail[];
+    /** Original filename as defined by sender */
     fileName?: string;
+    /** MIME type of the file as defined by sender */
     mimeType: string;
+    /** File size in bytes. It can be bigger than 2^31 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 value. */
     fileSize: number;
 }
 export declare function constructVideo(document: types.Document, videoAttribute: types.DocumentAttributeVideo, fileName: string | undefined, fileId: string, fileUniqueId: string): Video;

package/esm/types/1_video_note.d.ts

@@ -1,12 +1,20 @@
 import * as types from "../tl/2_types.js";
 import { Thumbnail } from "./0_thumbnail.js";
+/** This object represents a video message (available in Telegram apps as of v.4.0). */
 export interface VideoNote {
+    /** 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;
+    /** Video width and height (diameter of the video message) as defined by sender */
     length: number;
+    /** Duration of the video in seconds as defined by sender */
     duration: number;
+    /** Video thumbnail */
     thumbnails: Thumbnail[];
+    /** Original filename as defined by sender */
     fileName?: string;
+    /** File size in bytes */
     fileSize: number;
 }
 export declare function constructVideoNote(document: types.Document, videoAttribute: types.DocumentAttributeVideo, fileId: string, fileUniqueId: string): VideoNote;

package/esm/types/2_game.d.ts

@@ -2,12 +2,19 @@ import * as types from "../tl/2_types.js";
 import { MessageEntity } from "./0_message_entity.js";
 import { Animation } from "./1_animation.js";
 import { Photo } from "./1_photo.js";
+/** This object represents a game. Use BotFather to create and edit games, their short names will act as unique identifiers. */
 export interface Game {
+    /** Title of the game */
     title: string;
+    /** Description of the game */
     description: string;
+    /** Photo that will be displayed in the game message in chats. */
     photo: Photo;
+    /** Brief description of the game or high scores included in the game message. Can be automatically edited to include current high scores for the game when the bot calls [setGameScore](https://corefork.telegram.org/bots/api#setgamescore), or manually edited using [editMessageText](https://corefork.telegram.org/bots/api#editmessagetext). 0-4096 characters. */
     text?: string;
+    /** Special entities that appear in text, such as usernames, URLs, bot commands, etc. */
     textEntities?: MessageEntity[];
+    /** Animation that will be displayed in the game message in chats. Upload via [BotFather](https://t.me/botfather) */
     animation?: Animation;
 }
 export declare function constructGame(media_: types.MessageMediaGame): Game;

package/esm/types/2_reply_keyboard_markup.d.ts

@@ -4,15 +4,15 @@ import { KeyboardButton } from "./1_keyboard_button.js";
 export interface ReplyKeyboardMarkup {
     /** Array of button rows, each represented by an Array of `KeyboardButton` objects */
     keyboard: KeyboardButton[][];
-    /** Optional. Requests clients to always show the keyboard when the regular keyboard is hidden. Defaults to false, in which case the custom keyboard can be hidden and opened with a keyboard icon. */
+    /** Requests clients to always show the keyboard when the regular keyboard is hidden. Defaults to false, in which case the custom keyboard can be hidden and opened with a keyboard icon. */
     isPersistent?: boolean;
-    /** Optional. Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to false, in which case the custom keyboard is always of the same height as the app's standard keyboard. */
+    /** Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to false, in which case the custom keyboard is always of the same height as the app's standard keyboard. */
     resizeKeyboard?: boolean;
-    /** Optional. Requests clients to hide the keyboard as soon as it's been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to false. */
+    /** Requests clients to hide the keyboard as soon as it's been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to false. */
     oneTimeKeyboard?: boolean;
-    /** Optional. The placeholder to be shown in the input field when the keyboard is active; 1-64 characters */
+    /** The placeholder to be shown in the input field when the keyboard is active; 1-64 characters */
     inputFieldPlaceholder?: string;
-    /** Optional. Use this parameter if you want to show the keyboard to 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. */
+    /** Use this parameter if you want to show the keyboard to 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 constructReplyKeyboardMarkup(keyboard_: types.ReplyKeyboardMarkup): ReplyKeyboardMarkup;

package/esm/types/3_message.d.ts

@@ -24,105 +24,137 @@ import { Location } from "./0_location.js";
 export interface Message {
     /** Unique message identifier inside this chat */
     id: number;
-    /** Optional. Unique identifier of a message thread to which the message belongs; for supergroups only */
+    /** Unique identifier of a message thread to which the message belongs; for supergroups only */
     threadId?: number;
-    /** Optional. Sender of the message; empty for messages sent to channels. For backward compatibility, the field contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat. */
+    /** Sender of the message; empty for messages sent to channels. For backward compatibility, the field contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat. */
     from?: User;
-    /** Optional. Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, the field from contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat. */
+    /** Sender of the message, sent on behalf of a chat. For example, the channel itself for channel posts, the supergroup itself for messages from anonymous group administrators, the linked channel for messages automatically forwarded to the discussion group. For backward compatibility, the field from contains a fake sender user in non-channel chats, if the message was sent on behalf of a chat. */
     senderChat?: Chat;
     /** Date the message was sent in Unix time */
     date?: Date;
     /** Conversation the message belongs to */
     chat: Chat;
-    /** Optional. For forwarded messages, sender of the original message */
+    /** For forwarded messages, sender of the original message */
     forwardFrom?: User;
-    /** Optional. For messages forwarded from channels or from anonymous administrators, information about the original sender chat */
+    /** For messages forwarded from channels or from anonymous administrators, information about the original sender chat */
     forwardFromChat?: Chat;
-    /** Optional. For messages forwarded from channels, identifier of the original message in the channel */
+    /** For messages forwarded from channels, identifier of the original message in the channel */
     forwardId?: number;
-    /** Optional. For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present */
+    /** For forwarded messages that were originally sent in channels or by an anonymous chat administrator, signature of the message sender if present */
     forwardSignature?: string;
-    /** Optional. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages */
+    /** Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages */
     forwardSenderName?: string;
-    /** Optional. For forwarded messages, date the original message was sent in Unix time */
+    /** For forwarded messages, date the original message was sent in Unix time */
     forwardDate?: Date;
-    /** Optional. True, if the message is sent to a forum topic */
+    /** True, if the message is sent to a forum topic */
     isTopicMessage: boolean;
-    /** Optional. True, if the message is a channel post that was automatically forwarded to the connected discussion group */
+    /** True, if the message is a channel post that was automatically forwarded to the connected discussion group */
     isAutomaticForward?: boolean;
-    /** Optional. For replies, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply. */
+    /** For replies, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply. */
     replyToMessage?: Omit<Message, "replyToMessage">;
-    /** Optional. Bot through which the message was sent */
+    /** Bot through which the message was sent */
     viaBot?: User;
-    /** Optional. Date the message was last edited in Unix time */
+    /** Date the message was last edited in Unix time */
     editDate?: Date;
-    /** Optional. True, if the message can't be forwarded */
+    /** True, if the message can't be forwarded */
     hasProtectedContent?: boolean;
-    /** Optional. The unique identifier of a media message group this message belongs to */
+    /** The unique identifier of a media message group this message belongs to */
     mediaGroupId?: string;
-    /** Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator */
+    /** Signature of the post author for messages in channels, or the custom title of an anonymous group administrator */
     authorSignature?: string;
-    /** Optional. For text messages, the actual UTF-8 text of the message */
+    /** For text messages, the actual UTF-8 text of the message */
     text?: string;
-    /** Optional. For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text */
+    /** For text messages, special entities like usernames, URLs, bot commands, etc. that appear in the text */
     entities?: MessageEntity[];
-    /** Optional. Caption for the animation, audio, document, photo, video or voice */
+    /** Caption for the animation, audio, document, photo, video or voice */
     caption?: string;
-    /** Optional. For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption */
+    /** For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption */
     captionEntities?: MessageEntity[];
-    /** Optional. True, if the message media is covered by a spoiler animation */
+    /** True, if the message media is covered by a spoiler animation */
     hasMediaSpoiler?: boolean;
-    /** Optional. View count for channel posts */
+    /** View count for channel posts */
     views?: number;
-    /** Optional. Inline keyboard attached to the message. `login_url` buttons are represented as ordinary `url` buttons. */
+    /** Inline keyboard attached to the message. `login_url` buttons are represented as ordinary `url` buttons. */
     replyMarkup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
-    /** Optional. Message is a photo, available sizes of the photo */
+    /** Message is a photo, available sizes of the photo */
     photo?: Photo;
+    /** Message is a general file, information about the file */
     document?: Document;
+    /** Message is a video, information about the video */
     video?: Video;
+    /** Message is a sticker, information about the sticker */
     sticker?: Sticker;
+    /** Message is an animation, information about the animation. For backward compatibility, when this field is set, the document field will also be set */
     animation?: Animation;
+    /** Message is a voice message, information about the file */
     voice?: Voice;
+    /** Message is an audio file, information about the file */
     audio?: Audio;
+    /** Message is a dice with random value */
     dice?: Dice;
+    /** Message is a [video note](https://telegram.org/blog/video-messages-and-telescope), information about the video message */
     videoNote?: VideoNote;
+    /** Message is a shared contact, information about the contact */
     contact?: Contact;
+    /** Message is a game, information about the game. */
     game?: Game;
+    /** Message is a venue, information about the venue. For backward compatibility, when this field is set, the location field will also be set */
     venue?: Venue;
+    /** Message is a shared location, information about the location */
     location?: Location;
+    /** New members that were added to the group or supergroup and information about them (the bot itself may be one of these members) */
     newChatMembers?: User[];
+    /** A member was removed from the group, information about them (this member may be the bot itself) */
     leftChatMember?: User;
+    /** A chat title was changed to this value */
     newChatTitle?: string;
+    /** A chat photo was change to this value */
     newChatPhoto?: Photo;
+    /** Service message: the chat photo was deleted */
     deletedChatPhoto?: true;
+    /** Service message: the group has been created */
     groupCreated?: true;
+    /** Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup. */
     supergroupCreated?: true;
+    /** Service message: the channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in reply_to_message if someone replies to a very first message in a channel. */
     channelCreated?: true;
+    /** The group has been migrated to a supergroup with the specified identifier. 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. */
     chatMigratedTo?: number;
+    /** The supergroup has been migrated from a group with the specified identifier. 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. */
     chatMigratedFrom?: number;
+    /** Specified message was pinned. Note that the Message object in this field will not contain further reply_to_message fields even if it is itself a reply. */
     pinnedMessage?: Message;
+    /** Service message: a user was shared with the bot */
     userShared?: {
         requestId: number;
         userId: number;
     };
+    /** Service message: the user allowed the bot added to the attachment menu to write messages */
     writeAccessAllowed?: {
         webAppName?: string;
     };
+    /** Service message: forum topic created */
     forumTopicCreated?: {
         name: string;
         iconColor: string;
         iconCutsomEmojiId?: string;
     };
+    /** Service message: forum topic edited */
     forumTopicEdited?: {
         name?: string;
         iconCutsomEmojiId?: string;
     };
+    /** Service message: forum topic closed */
     forumTopicClosed?: Record<never, never>;
+    /** Service message: forum topic reopened */
     forumTopicReopened?: Record<never, never>;
+    /** Service message: video chat scheduled */
     videoChatScheduled?: {
         startDate: Date;
     };
+    /** Service message: video chat started */
     videoChatStarted?: Record<never, never>;
+    /** Service message: video chat ended */
     videoChatEnded?: {
         duration: number;
     };

package/esm/types/3_message.js

@@ -381,7 +381,6 @@ export async function constructMessage(message_, getEntity, getMessage, getStick
             message.location = constructLocation(message_.media);
         }
         else {
-            console.log(message_.media);
             // not implemented
             UNREACHABLE();
         }

package/package.json

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

package/script/client/0_utilities.d.ts

@@ -0,0 +1,3 @@
+import * as types from "../tl/2_types.js";
+export declare function getChannelChatId(channelId: bigint): number;
+export declare function peerToChatId(peer: types.TypePeer | types.TypeInputPeer): number;

package/script/client/0_utilities.js

@@ -0,0 +1,48 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.peerToChatId = exports.getChannelChatId = void 0;
+const constants_js_1 = require("../constants.js");
+const types = __importStar(require("../tl/2_types.js"));
+const _0_control_js_1 = require("../utilities/0_control.js");
+function getChannelChatId(channelId) {
+    return constants_js_1.ZERO_CHANNEL_ID + -Number(channelId);
+}
+exports.getChannelChatId = getChannelChatId;
+function peerToChatId(peer) {
+    if (peer instanceof types.PeerUser || peer instanceof types.InputPeerUser) {
+        return Number(peer.userId);
+    }
+    else if (peer instanceof types.PeerChat || peer instanceof types.InputPeerChat) {
+        return -Number(peer.chatId);
+    }
+    else if (peer instanceof types.PeerChannel || peer instanceof types.InputPeerChannel) {
+        return getChannelChatId(peer.channelId);
+    }
+    else {
+        (0, _0_control_js_1.UNREACHABLE)();
+    }
+}
+exports.peerToChatId = peerToChatId;

package/script/client/3_client.d.ts

@@ -172,7 +172,7 @@ export declare class Client extends ClientAbstract {
         sendAs?: number | string;
         replyMarkup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
     }): Promise<Message>;
-    getMessages(chatId: number | string, messageIds: number[]): Promise<Omit<Message, "replyToMessage">[]>;
+    getMessages(chatId_: number | string, messageIds: number[]): Promise<Omit<Message, "replyToMessage">[]>;
     getMessage(chatId: number | string, messageId: number): Promise<Omit<Message, "replyToMessage"> | null>;
     private downloadInner;
     download(fileId_: string): Promise<AsyncGenerator<Uint8Array, void, unknown>>;