@mtkruto/node 0.1.201 → 0.1.289

package/script/client/1_update_manager.d.ts

@@ -1,3 +1,22 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 import { Queue } from "../1_utilities.js";
 import { enums, ReadObject, TLObject, types } from "../2_tl.js";
 import { C } from "./0_types.js";

package/script/client/1_update_manager.js

@@ -1,4 +1,23 @@
 "use strict";
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -13,6 +32,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var _UpdateManager_instances, _a, _UpdateManager_c, _UpdateManager_updateState, _UpdateManager_updateHandler, _UpdateManager_LrecoverUpdateGap, _UpdateManager_LrecoverChannelUpdateGap, _UpdateManager_L$handleUpdate, _UpdateManager_L$processUpdates, _UpdateManager_LfetchState, _UpdateManager_defaultDropPendingUpdates, _UpdateManager_mustDropPendingUpdates, _UpdateManager_state, _UpdateManager_getState, _UpdateManager_setState, _UpdateManager_handleUpdateQueues, _UpdateManager_nonFirst, _UpdateManager_getChannelPtsWithDropPendingUpdatesCheck, _UpdateManager_checkGap, _UpdateManager_checkGapQts, _UpdateManager_checkChannelGap, _UpdateManager_channelUpdateQueues, _UpdateManager_processChannelPtsUpdateInner, _UpdateManager_queueUpdate, _UpdateManager_processChannelPtsUpdate, _UpdateManager_processPtsUpdateInner, _UpdateManager_ptsUpdateQueue, _UpdateManager_processPtsUpdate, _UpdateManager_processQtsUpdateInner, _UpdateManager_qtsUpdateQueue, _UpdateManager_processQtsUpdate, _UpdateManager_processUpdatesQueue, _UpdateManager_processUpdates, _UpdateManager_setUpdateStateDate, _UpdateManager_setUpdatePts, _UpdateManager_setUpdateQts, _UpdateManager_getLocalState, _UpdateManager_recoverChannelUpdateGap, _UpdateManager_handleUpdatesSet, _UpdateManager_handleStoredUpdates, _UpdateManager_handleUpdate;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateManager = void 0;
+const _0_deps_js_1 = require("../0_deps.js");
 const _1_utilities_js_1 = require("../1_utilities.js");
 const _2_tl_js_1 = require("../2_tl.js");
 const _4_constants_js_1 = require("../4_constants.js");
@@ -253,7 +273,7 @@ class UpdateManager {
                         state = difference.intermediate_state;
                     }
                     else {
-                        (0, _1_utilities_js_1.UNREACHABLE)();
+                        (0, _0_deps_js_1.unreachable)();
                     }
                 }
                 else if (difference instanceof _2_tl_js_1.types.updates.DifferenceTooLong) {
@@ -269,7 +289,7 @@ class UpdateManager {
                     break;
                 }
                 else {
-                    (0, _1_utilities_js_1.UNREACHABLE)();
+                    (0, _0_deps_js_1.unreachable)();
                 }
             }
         }
@@ -515,7 +535,7 @@ _a = UpdateManager, _UpdateManager_c = new WeakMap(), _UpdateManager_updateState
     }
     else if (updates_ instanceof _2_tl_js_1.types.UpdateShortSentMessage) {
         if (!(call instanceof _2_tl_js_1.functions.messages.sendMessage)) {
-            (0, _1_utilities_js_1.UNREACHABLE)();
+            (0, _0_deps_js_1.unreachable)();
         }
         updates = [
             new _2_tl_js_1.types.UpdateNewMessage({
@@ -545,7 +565,7 @@ _a = UpdateManager, _UpdateManager_c = new WeakMap(), _UpdateManager_updateState
         updates = [updates_];
     }
     else {
-        (0, _1_utilities_js_1.UNREACHABLE)();
+        (0, _0_deps_js_1.unreachable)();
     }
     /// We process the updates when we are sure there is no gap.
     if (updates_ instanceof _2_tl_js_1.types.Updates || updates_ instanceof _2_tl_js_1.types.UpdatesCombined) {
@@ -566,7 +586,7 @@ _a = UpdateManager, _UpdateManager_c = new WeakMap(), _UpdateManager_updateState
                 await __classPrivateFieldGet(this, _UpdateManager_instances, "m", _UpdateManager_setState).call(this, __classPrivateFieldGet(this, _UpdateManager_updateState, "f"));
             }
             else {
-                (0, _1_utilities_js_1.UNREACHABLE)();
+                (0, _0_deps_js_1.unreachable)();
             }
         }
         else if (_a.isPtsUpdate(update)) {
@@ -608,7 +628,7 @@ _a = UpdateManager, _UpdateManager_c = new WeakMap(), _UpdateManager_updateState
                 await __classPrivateFieldGet(this, _UpdateManager_instances, "m", _UpdateManager_setState).call(this, localState);
             }
             else {
-                (0, _1_utilities_js_1.UNREACHABLE)();
+                (0, _0_deps_js_1.unreachable)();
             }
         }
     }
@@ -651,7 +671,7 @@ _a = UpdateManager, _UpdateManager_c = new WeakMap(), _UpdateManager_updateState
                 pts = pts_;
             }
             else {
-                (0, _1_utilities_js_1.UNREACHABLE)();
+                (0, _0_deps_js_1.unreachable)();
             }
             __classPrivateFieldGet(this, _UpdateManager_LrecoverChannelUpdateGap, "f").debug("processed channelDifferenceTooLong");
         }

package/script/client/2_message_manager.d.ts

@@ -1,3 +1,22 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 import { enums, types } from "../2_tl.js";
 import { ChatAction, ChatMember, FileSource, FileType, ID, Message, MessageEntity, ParseMode, Reaction, Update, UsernameResolver } from "../3_types.js";
 import { AddReactionParams, BanChatMemberParams, CreateInviteLinkParams, DeleteMessagesParams, EditMessageLiveLocationParams, EditMessageParams, EditMessageReplyMarkupParams, ForwardMessagesParams, GetCreatedInviteLinksParams, GetHistoryParams, PinMessageParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendChatActionParams, SendContactParams, SendDiceParams, SendDocumentParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendStickerParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetChatMemberRightsParams, SetChatPhotoParams, SetReactionsParams, StopPollParams } from "./0_params.js";

package/script/client/2_message_manager.js

@@ -1,4 +1,23 @@
 "use strict";
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -23,6 +42,8 @@ const _0_message_search_filter_js_1 = require("../types/0_message_search_filter.
 const _0_html_js_1 = require("./0_html.js");
 const _0_markdown_js_1 = require("./0_markdown.js");
 const _0_utilities_js_1 = require("./0_utilities.js");
+const _0_utilities_js_2 = require("./0_utilities.js");
+const _0_utilities_js_3 = require("./0_utilities.js");
 const FALLBACK_MIME_TYPE = "application/octet-stream";
 const STICKER_MIME_TYPES = ["image/webp", "video/webm", "application/x-tgsticker"];
 class MessageManager {
@@ -44,6 +65,7 @@ class MessageManager {
         __classPrivateFieldSet(this, _MessageManager_LresolveFileId, L.branch("resolveFileId"), "f");
     }
     async getMessages(chatId, messageIds) {
+        (0, _0_utilities_js_2.checkArray)(messageIds, _0_utilities_js_1.checkMessageId);
         const peer = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId);
         let messages_ = new Array();
         const chatId_ = (0, _2_tl_js_1.peerToChatId)(peer);
@@ -114,7 +136,7 @@ class MessageManager {
                 break;
             }
             default:
-                (0, _1_utilities_js_1.UNREACHABLE)();
+                (0, _0_deps_js_1.unreachable)();
         }
         text = text.trimEnd();
         for (const entity of entities) {
@@ -122,6 +144,9 @@ class MessageManager {
                 --entity.length;
             }
         }
+        if (!text.length) {
+            throw new _0_errors_js_1.InputError("Text must not be empty.");
+        }
         return [text, entities];
     }
     async parseText(text_, params) {
@@ -133,6 +158,7 @@ class MessageManager {
         return await (0, _3_types_js_2.constructMessage)(message_, __classPrivateFieldGet(this, _MessageManager_c, "f").getEntity, this.getMessage.bind(this), __classPrivateFieldGet(this, _MessageManager_c, "f").fileManager.getStickerSetName.bind(__classPrivateFieldGet(this, _MessageManager_c, "f").fileManager), r, business);
     }
     async forwardMessages(from, to, messageIds, params) {
+        (0, _0_utilities_js_2.checkArray)(messageIds, _0_utilities_js_1.checkMessageId);
         const result = await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.forwardMessages({
             from_peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(from),
             to_peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(to),
@@ -176,7 +202,7 @@ class MessageManager {
             hash: 0n,
         });
         if (!("messages" in result)) {
-            (0, _1_utilities_js_1.UNREACHABLE)();
+            (0, _0_deps_js_1.unreachable)();
         }
         for (const message_ of result.messages) {
             const message = await this.constructMessage(message_, false);
@@ -425,11 +451,11 @@ class MessageManager {
             }
         }
         if (media == null) {
-            if (typeof photo === "string" && (0, _0_utilities_js_1.isHttpUrl)(photo)) {
+            if (typeof photo === "string" && (0, _0_utilities_js_3.isHttpUrl)(photo)) {
                 media = new _2_tl_js_1.types.InputMediaPhotoExternal({ url: photo, spoiler });
             }
             else {
-                const [contents, fileName] = await (0, _0_utilities_js_1.getFileContents)(photo);
+                const [contents, fileName] = await (0, _0_utilities_js_3.getFileContents)(photo);
                 const file = await __classPrivateFieldGet(this, _MessageManager_c, "f").fileManager.upload(contents, { fileName, chunkSize: params?.chunkSize, signal: params?.signal });
                 media = new _2_tl_js_1.types.InputMediaUploadedPhoto({ file, spoiler });
             }
@@ -448,10 +474,10 @@ class MessageManager {
         }
         if (fileId != null) {
             if (!expectedFileType.includes(fileId.type)) {
-                (0, _1_utilities_js_1.UNREACHABLE)();
+                (0, _0_deps_js_1.unreachable)();
             }
             return {
-                id: "id" in fileId.location ? fileId.location.id : (0, _1_utilities_js_1.UNREACHABLE)(),
+                id: "id" in fileId.location ? fileId.location.id : (0, _0_deps_js_1.unreachable)(),
                 access_hash: fileId.location.accessHash,
                 file_reference: fileId.fileReference ?? new Uint8Array(),
             };
@@ -459,6 +485,13 @@ class MessageManager {
         return null;
     }
     async sendPoll(chatId, question, options, params) {
+        question = question?.trim();
+        if (!question) {
+            throw new Error("Question must not be empty.");
+        }
+        if (!Array.isArray(options) || options.length < 2) {
+            throw new Error("There must be at least two options.");
+        }
         const peer = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId);
         const randomId = (0, _1_utilities_js_1.getRandomId)();
         const silent = params?.disableNotification ? true : undefined;
@@ -503,7 +536,7 @@ class MessageManager {
     }
     async editMessageReplyMarkup(chatId, messageId, params) {
         const result = await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.editMessage({
-            id: messageId,
+            id: (0, _0_utilities_js_1.checkMessageId)(messageId),
             peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId),
             reply_markup: await __classPrivateFieldGet(this, _MessageManager_instances, "m", _MessageManager_constructReplyMarkup).call(this, params),
         });
@@ -531,7 +564,7 @@ class MessageManager {
             });
         }
         const result = await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.editMessage({
-            id: messageId,
+            id: (0, _0_utilities_js_1.checkMessageId)(messageId),
             peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId),
             entities,
             message,
@@ -568,6 +601,7 @@ class MessageManager {
         });
     }
     async deleteMessages(chatId, messageIds, params) {
+        (0, _0_utilities_js_2.checkArray)(messageIds, _0_utilities_js_1.checkMessageId);
         const peer = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId);
         if (peer instanceof _2_tl_js_1.types.InputPeerChannel) {
             await __classPrivateFieldGet(this, _MessageManager_c, "f").api.channels.deleteMessages({ channel: new _2_tl_js_1.types.InputChannel(peer), id: messageIds });
@@ -584,7 +618,7 @@ class MessageManager {
     async pinMessage(chatId, messageId, params) {
         await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.updatePinnedMessage({
             peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId),
-            id: messageId,
+            id: (0, _0_utilities_js_1.checkMessageId)(messageId),
             silent: params?.disableNotification ? true : undefined,
             pm_oneside: params?.bothSides ? undefined : true,
         });
@@ -592,7 +626,7 @@ class MessageManager {
     async unpinMessage(chatId, messageId) {
         await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.updatePinnedMessage({
             peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId),
-            id: messageId,
+            id: (0, _0_utilities_js_1.checkMessageId)(messageId),
             unpin: true,
         });
     }
@@ -603,14 +637,18 @@ class MessageManager {
         // TODO: sync with storage
         await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.setChatAvailableReactions({
             peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId),
-            available_reactions: availableReactions == "none" ? new _2_tl_js_1.types.ChatReactionsNone() : availableReactions == "all" ? new _2_tl_js_1.types.ChatReactionsAll() : Array.isArray(availableReactions) ? new _2_tl_js_1.types.ChatReactionsSome({ reactions: availableReactions.map((v) => v.type == "emoji" ? new _2_tl_js_1.types.ReactionEmoji({ emoticon: v.emoji }) : new _2_tl_js_1.types.ReactionCustomEmoji({ document_id: BigInt(v.id) })) }) : (0, _1_utilities_js_1.UNREACHABLE)(),
+            available_reactions: availableReactions == "none" ? new _2_tl_js_1.types.ChatReactionsNone() : availableReactions == "all" ? new _2_tl_js_1.types.ChatReactionsAll() : Array.isArray(availableReactions) ? new _2_tl_js_1.types.ChatReactionsSome({ reactions: availableReactions.map((v) => v.type == "emoji" ? new _2_tl_js_1.types.ReactionEmoji({ emoticon: v.emoji }) : new _2_tl_js_1.types.ReactionCustomEmoji({ document_id: BigInt(v.id) })) }) : (0, _0_deps_js_1.unreachable)(),
         });
     }
     async setReactions(chatId, messageId, reactions, params) {
         await __classPrivateFieldGet(this, _MessageManager_instances, "m", _MessageManager_sendReaction).call(this, chatId, messageId, reactions, params);
     }
     async addReaction(chatId, messageId, reaction, params) {
-        const chosenReactions = await this.getMessage(chatId, messageId).then((v) => v?.reactions ?? []).then((v) => v.filter((v) => v.chosen));
+        const message = await this.getMessage(chatId, messageId);
+        if (!message) {
+            throw new _0_errors_js_1.InputError("Message not found.");
+        }
+        const chosenReactions = (message.reactions ?? []).filter((v) => v.chosen);
         for (const r of chosenReactions) {
             if ((0, _3_types_js_2.reactionEqual)(r.reaction, reaction)) {
                 return;
@@ -620,7 +658,11 @@ class MessageManager {
         await this.setReactions(chatId, messageId, reactions, params);
     }
     async removeReaction(chatId, messageId, reaction) {
-        const chosenReactions = await this.getMessage(chatId, messageId).then((v) => v?.reactions ?? []).then((v) => v.filter((v) => v.chosen));
+        const message = await this.getMessage(chatId, messageId);
+        if (!message) {
+            throw new _0_errors_js_1.InputError("Message not found.");
+        }
+        const chosenReactions = (message.reactions ?? []).filter((v) => v.chosen);
         for (const r of chosenReactions) {
             if ((0, _3_types_js_2.reactionEqual)(r.reaction, reaction)) {
                 const reactions = chosenReactions.filter((v) => v != r).map((v) => v.reaction);
@@ -757,7 +799,7 @@ class MessageManager {
     async deleteChatPhoto(chatId) {
         const peer = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId);
         if (!(peer instanceof _2_tl_js_1.types.InputPeerChannel) && !(peer instanceof _2_tl_js_1.types.InputPeerChat)) {
-            (0, _1_utilities_js_1.UNREACHABLE)();
+            (0, _0_deps_js_1.unreachable)();
         }
         if (peer instanceof _2_tl_js_1.types.InputPeerChannel) {
             await __classPrivateFieldGet(this, _MessageManager_c, "f").api.channels.editPhoto({ channel: new _2_tl_js_1.types.InputChannel(peer), photo: new _2_tl_js_1.types.InputChatPhotoEmpty() });
@@ -769,9 +811,9 @@ class MessageManager {
     async setChatPhoto(chatId, photo, params) {
         const peer = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId);
         if (!(peer instanceof _2_tl_js_1.types.InputPeerChannel) && !(peer instanceof _2_tl_js_1.types.InputPeerChat)) {
-            (0, _1_utilities_js_1.UNREACHABLE)();
+            (0, _0_deps_js_1.unreachable)();
         }
-        const [contents, fileName] = await (0, _0_utilities_js_1.getFileContents)(photo);
+        const [contents, fileName] = await (0, _0_utilities_js_3.getFileContents)(photo);
         const file = await __classPrivateFieldGet(this, _MessageManager_c, "f").fileManager.upload(contents, { fileName: params?.fileName ?? fileName, chunkSize: params?.chunkSize, signal: params?.signal });
         const photo_ = new _2_tl_js_1.types.InputChatUploadedPhoto({ file });
         if (peer instanceof _2_tl_js_1.types.InputPeerChannel) {
@@ -853,7 +895,7 @@ class MessageManager {
                 hash: 0n,
             });
             if (participants instanceof _2_tl_js_1.types.channels.ChannelParticipantsNotModified) {
-                (0, _1_utilities_js_1.UNREACHABLE)();
+                (0, _0_deps_js_1.unreachable)();
             }
             const chatMembers = new Array();
             for (const p of participants.participants) {
@@ -864,7 +906,7 @@ class MessageManager {
         else if (peer instanceof _2_tl_js_1.types.InputPeerChat) {
             const fullChat = await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.getFullChat(peer); // TODO: full chat cache
             if (!(fullChat.full_chat instanceof _2_tl_js_1.types.ChatFull) || !(fullChat.full_chat.participants instanceof _2_tl_js_1.types.ChatParticipants)) {
-                (0, _1_utilities_js_1.UNREACHABLE)();
+                (0, _0_deps_js_1.unreachable)();
             }
             const chatMembers = new Array();
             for (const p of fullChat.full_chat.participants.participants) {
@@ -873,7 +915,7 @@ class MessageManager {
             return chatMembers;
         }
         else {
-            (0, _1_utilities_js_1.UNREACHABLE)();
+            (0, _0_deps_js_1.unreachable)();
         }
     }
     async enableJoinRequests(chatId) {
@@ -900,7 +942,7 @@ class MessageManager {
             from_id: params?.from ? await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(params.from) : undefined,
         });
         if (!("messages" in result)) {
-            (0, _1_utilities_js_1.UNREACHABLE)();
+            (0, _0_deps_js_1.unreachable)();
         }
         const messages = new Array();
         for (const message_ of result.messages) {
@@ -951,7 +993,7 @@ class MessageManager {
             await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.addChatUser({ chat_id: peer.chat_id, user_id: new _2_tl_js_1.types.InputUserSelf(), fwd_limit: 0 }); // TODO: use potential high-level method for adding participants to chats
         }
         else {
-            (0, _1_utilities_js_1.UNREACHABLE)();
+            (0, _0_deps_js_1.unreachable)();
         }
     }
     async leaveChat(chatId) {
@@ -966,7 +1008,7 @@ class MessageManager {
             await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.deleteChatUser({ chat_id: peer.chat_id, user_id: new _2_tl_js_1.types.InputUserSelf() }); // TODO: use potential high-level method for adding participants to chats
         }
         else {
-            (0, _1_utilities_js_1.UNREACHABLE)();
+            (0, _0_deps_js_1.unreachable)();
         }
     }
     async blockUser(userId) {
@@ -1059,7 +1101,7 @@ class MessageManager {
             const message = await __classPrivateFieldGet(this, _MessageManager_instances, "m", _MessageManager_updatesToMessages).call(this, chatId, result).then((v) => v[0]);
             return (0, _3_types_js_2.assertMessageType)(message, "location");
         }
-        (0, _1_utilities_js_1.UNREACHABLE)();
+        (0, _0_deps_js_1.unreachable)();
     }
     async editInlineMessageLiveLocation(inlineMessageId, latitude, longitude, params) {
         await __classPrivateFieldGet(this, _MessageManager_c, "f").storage.assertBot("editInlineMessageLiveLocation");
@@ -1137,18 +1179,18 @@ _MessageManager_c = new WeakMap(), _MessageManager_LresolveFileId = new WeakMap(
         }
     }
     if (media == null) {
-        if (typeof document === "string" && (0, _0_utilities_js_1.isHttpUrl)(document)) {
+        if (typeof document === "string" && (0, _0_utilities_js_3.isHttpUrl)(document)) {
             if (!urlSupported) {
                 throw new _0_errors_js_1.InputError("URL not supported.");
             }
             media = new _2_tl_js_1.types.InputMediaDocumentExternal({ url: document, spoiler });
         }
         else {
-            const [contents, fileName_] = await (0, _0_utilities_js_1.getFileContents)(document);
+            const [contents, fileName_] = await (0, _0_utilities_js_3.getFileContents)(document);
             let fileName = params?.fileName ?? fileName_;
             const mimeType = params?.mimeType ?? (0, _0_deps_js_1.contentType)(fileName.split(".").slice(-1)[0]) ?? FALLBACK_MIME_TYPE;
             if (expectedMimeTypes && !expectedMimeTypes.includes(mimeType)) {
-                (0, _1_utilities_js_1.UNREACHABLE)();
+                (0, _0_deps_js_1.unreachable)();
             }
             if (fileName.endsWith(".tgs") && fileType == _3_types_js_2.FileType.Document) {
                 fileName += "-";
@@ -1156,7 +1198,7 @@ _MessageManager_c = new WeakMap(), _MessageManager_LresolveFileId = new WeakMap(
             const file = await __classPrivateFieldGet(this, _MessageManager_c, "f").fileManager.upload(contents, { fileName, chunkSize: params?.chunkSize, signal: params?.signal });
             let thumb = undefined;
             if (params?.thumbnail) {
-                const [thumbContents, fileName__] = await (0, _0_utilities_js_1.getFileContents)(params.thumbnail);
+                const [thumbContents, fileName__] = await (0, _0_utilities_js_3.getFileContents)(params.thumbnail);
                 thumb = await __classPrivateFieldGet(this, _MessageManager_c, "f").fileManager.upload(thumbContents, { fileName: fileName__, chunkSize: params?.chunkSize, signal: params?.signal });
             }
             media = new _2_tl_js_1.types.InputMediaUploadedDocument({
@@ -1198,7 +1240,7 @@ _MessageManager_c = new WeakMap(), _MessageManager_LresolveFileId = new WeakMap(
 }, _MessageManager_sendReaction = async function _MessageManager_sendReaction(chatId, messageId, reactions, params) {
     await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.sendReaction({
         peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId),
-        msg_id: messageId,
+        msg_id: (0, _0_utilities_js_1.checkMessageId)(messageId),
         reaction: reactions.map((v) => (0, _3_types_js_2.reactionToTlObject)(v)),
         big: params?.big ? true : undefined,
         add_to_recent: params?.addToRecents ? true : undefined,

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

@@ -1,3 +1,22 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 import { enums, types } from "../2_tl.js";
 import { Update } from "../3_types.js";
 import { AnswerCallbackQueryParams } from "./0_params.js";

package/script/client/3_callback_query_manager.js

@@ -1,4 +1,23 @@
 "use strict";
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
     if (kind === "m") throw new TypeError("Private method is not writable");
     if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
@@ -15,6 +34,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CallbackQueryManager = void 0;
 const _2_tl_js_1 = require("../2_tl.js");
 const _3_types_js_1 = require("../3_types.js");
+const _0_utilities_js_1 = require("./0_utilities.js");
 class CallbackQueryManager {
     constructor(c) {
         _CallbackQueryManager_c.set(this, void 0);
@@ -22,6 +42,7 @@ class CallbackQueryManager {
     }
     async answerCallbackQuery(id, params) {
         await __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").storage.assertBot("answerCallbackQuery");
+        (0, _0_utilities_js_1.checkCallbackQueryId)(id);
         await __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").api.messages.setBotCallbackAnswer({
             query_id: BigInt(id),
             cache_time: params?.cacheTime ?? 0,

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

@@ -1,3 +1,22 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
 import { enums, types } from "../2_tl.js";
 import { Chat, ID } from "../3_types.js";
 import { C as C_ } from "./0_types.js";