@mtkruto/node 0.0.935 → 0.0.937

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

@@ -1,11 +1,18 @@
 import * as types from "../tl/2_types.js";
 import { KeyboardButton } from "./1_keyboard_button.js";
+/** This object represents a [custom keyboard](https://core.telegram.org/bots/features#keyboards) with reply options (see [Introduction to bots](https://core.telegram.org/bots/features#keyboards) for details and examples). */
 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. */
     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. */
     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. */
     oneTimeKeyboard?: boolean;
+    /** Optional. 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. */
     selective?: boolean;
 }
 export declare function constructReplyKeyboardMarkup(keyboard_: types.ReplyKeyboardMarkup): ReplyKeyboardMarkup;

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

@@ -18,34 +18,63 @@ import { Voice } from "./0_voice.js";
 import { Dice } from "./0_dice.js";
 import { Contact } from "./0_contact.js";
 import { Game } from "./2_game.js";
+/** This object represents a message. */
 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 */
     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. */
     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. */
     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 */
     forwardFrom?: User;
+    /** Optional. 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 */
     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 */
     forwardSignature?: string;
+    /** Optional. 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 */
     forwardDate?: Date;
+    /** Optional. 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 */
     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. */
     replyToMessage?: Omit<Message, "replyToMessage">;
+    /** Optional. Bot through which the message was sent */
     viaBot?: User;
+    /** Optional. Date the message was last edited in Unix time */
     editDate?: Date;
-    hasProtectedContent: boolean;
+    /** Optional. True, if the message can't be forwarded */
+    hasProtectedContent?: boolean;
+    /** Optional. 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 */
     authorSignature?: string;
+    /** Optional. 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 */
     entities?: MessageEntity[];
+    /** Optional. 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 */
     captionEntities?: MessageEntity[];
+    /** Optional. True, if the message media is covered by a spoiler animation */
     hasMediaSpoiler?: boolean;
+    /** Optional. View count for channel posts */
     views?: number;
+    /** Optional. 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 */
     photo?: Photo;
     document?: Document;
     video?: Video;
@@ -58,10 +87,13 @@ export interface Message {
     contact?: Contact;
     game?: Game;
 }
-export declare function constructMessage(message_: types.Message, getEntity: {
+interface EntityGetter {
     (peer: types.PeerUser): MaybePromise<types.User | null>;
     (peer: types.PeerChat): MaybePromise<types.Chat | null>;
     (peer: types.PeerChannel): MaybePromise<types.Channel | null>;
-}, getMessage: {
+}
+type MessageGetter = {
     (chatId: number, messageId: number): MaybePromise<Omit<Message, "replyToMessage"> | null>;
-} | null, getStickerSetName: StickerSetNameGetter): Promise<Message>;
+} | null;
+export declare function constructMessage(message_: types.TypeMessage, getEntity: EntityGetter, getMessage: MessageGetter, getStickerSetName: StickerSetNameGetter): Promise<Message>;
+export {};

package/script/types/3_message.js

@@ -48,7 +48,59 @@ const _0_file_id_js_1 = require("./!0_file_id.js");
 const _0_contact_js_1 = require("./0_contact.js");
 const _2_game_js_1 = require("./2_game.js");
 const d = (0, deps_js_1.debug)("types/Message");
+async function getSender(message_, getEntity) {
+    if (message_.fromId instanceof types.PeerUser) {
+        const entity = await getEntity(message_.fromId);
+        if (entity) {
+            return { from: (0, _1_user_js_1.constructUser)(entity) };
+        }
+        else {
+            (0, _0_control_js_1.UNREACHABLE)();
+        }
+    }
+    else if (message_.fromId instanceof types.PeerChannel) {
+        const entity = await getEntity(message_.fromId);
+        if (entity) {
+            return { senderChat: (0, _1_chat_js_1.constructChat)(entity) };
+        }
+        else {
+            (0, _0_control_js_1.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;
+}
 async function constructMessage(message_, getEntity, getMessage, getStickerSetName) {
+    if (!(message_ instanceof types.Message) && !(message_ instanceof types.MessageService)) {
+        (0, _0_control_js_1.UNREACHABLE)();
+    }
     let chat_ = null;
     if (message_.peerId instanceof types.PeerUser) {
         const entity = await getEntity(message_.peerId);
@@ -80,37 +132,25 @@ async function constructMessage(message_, getEntity, getMessage, getStickerSetNa
     else {
         (0, _0_control_js_1.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 = (0, _1_user_js_1.constructUser)(entity);
-        }
-        else {
-            (0, _0_control_js_1.UNREACHABLE)();
-        }
-    }
-    else if (message_.fromId instanceof types.PeerChannel) {
-        const entity = await getEntity(message_.fromId);
-        if (entity) {
-            message.senderChat = (0, _1_chat_js_1.constructChat)(entity);
-        }
-        else {
-            (0, _0_control_js_1.UNREACHABLE)();
-        }
-    }
     if (message_.message) {
         if (message_.media == undefined) {
             message.text = message_.message;
@@ -127,7 +167,6 @@ async function constructMessage(message_, getEntity, getMessage, getStickerSetNa
             message.captionEntities = message_.entities.map(_0_message_entity_js_1.constructMessageEntity).filter((v) => v);
         }
     }
-    message.date = new Date(message_.date * 1000);
     if (message_.editDate != undefined) {
         message.editDate = new Date(message_.editDate * 1000);
     }
@@ -148,19 +187,6 @@ async function constructMessage(message_, getEntity, getMessage, getStickerSetNa
             (0, _0_control_js_1.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) {