@mtkruto/node 0.1.400 → 0.1.500

package/script/client/0_markdown.js

@@ -1,9 +1,27 @@
 "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/>.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseMarkdown = exports.CODEPOINTS = void 0;
 /**
  * Copyright (C) 2023 Dunkan
- * Copyright (C) 2024 Roj
  */
 const _0_deps_js_1 = require("../0_deps.js");
 const _3_types_js_1 = require("../3_types.js");

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

@@ -355,3 +355,7 @@ export interface EditMessageLiveLocationParams {
     /** The reply markup of the message. Bot-only. */
     replyMarkup?: ReplyMarkup;
 }
+export interface SendInlineQueryParams {
+    query?: string;
+    offset?: string;
+}

package/script/client/0_utilities.js

@@ -110,7 +110,7 @@ function getChatListId(chatList) {
 }
 exports.getChatListId = getChatListId;
 function checkMessageId(messageId) {
-    if (typeof messageId !== "number" || isNaN(messageId) || !messageId) {
+    if (typeof messageId !== "number" || isNaN(messageId) || messageId <= 0) {
         throw new _0_errors_js_1.InputError("Invalid message ID");
     }
     return messageId;

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

@@ -18,7 +18,7 @@
  * 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 { CallbackQueryQuestion, ID, Update } from "../3_types.js";
 import { AnswerCallbackQueryParams } from "./0_params.js";
 import { C as C_ } from "./0_types.js";
 import { MessageManager } from "./2_message_manager.js";
@@ -30,6 +30,7 @@ export declare class CallbackQueryManager {
     #private;
     constructor(c: C);
     answerCallbackQuery(id: string, params?: AnswerCallbackQueryParams): Promise<void>;
+    sendCallbackQuery(chatId: ID, messageId: number, question: CallbackQueryQuestion): Promise<import("../3_types.js").CallbackQueryAnswer>;
     static canHandleUpdate(update: enums.Update): update is CallbackQueryManagerUpdate;
     handleUpdate(update: CallbackQueryManagerUpdate): Promise<Update>;
 }

package/script/client/3_callback_query_manager.js

@@ -29,14 +29,16 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _CallbackQueryManager_c;
+var _CallbackQueryManager_instances, _a, _CallbackQueryManager_c, _CallbackQueryManager_enc, _CallbackQueryManager_isExpired, _CallbackQueryManager_getPasswordCheck;
 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");
+const _0_password_js_1 = require("./0_password.js");
 class CallbackQueryManager {
     constructor(c) {
+        _CallbackQueryManager_instances.add(this);
         _CallbackQueryManager_c.set(this, void 0);
         __classPrivateFieldSet(this, _CallbackQueryManager_c, c, "f");
     }
@@ -50,6 +52,26 @@ class CallbackQueryManager {
             alert: params?.alert ? true : undefined,
         });
     }
+    async sendCallbackQuery(chatId, messageId, question) {
+        (0, _0_utilities_js_1.checkMessageId)(messageId);
+        (0, _3_types_js_1.validateCallbackQueryQuestion)(question);
+        const peer = await __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").getInputPeer(chatId), peerId = (0, _2_tl_js_1.peerToChatId)(peer), questionKey = JSON.stringify(question);
+        const maybeAnswer = await __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").messageStorage.getCallbackQueryAnswer(peerId, messageId, questionKey);
+        if (maybeAnswer != null && !__classPrivateFieldGet(_a, _a, "m", _CallbackQueryManager_isExpired).call(_a, maybeAnswer[1], maybeAnswer[0].cache_time)) {
+            return (0, _3_types_js_1.constructCallbackQueryAnswer)(maybeAnswer[0]);
+        }
+        const answer = await __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").api.messages.getBotCallbackAnswer({
+            peer,
+            msg_id: messageId,
+            data: "data" in question ? __classPrivateFieldGet(_a, _a, "f", _CallbackQueryManager_enc).encode(question.data) : undefined,
+            game: question.type == "game" ? true : undefined,
+            password: question.type == "password" ? await __classPrivateFieldGet(this, _CallbackQueryManager_instances, "m", _CallbackQueryManager_getPasswordCheck).call(this, question.password) : undefined,
+        });
+        if (answer.cache_time >= 0) {
+            await __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").messageStorage.setCallbackQueryAnswer(peerId, messageId, questionKey, answer);
+        }
+        return (0, _3_types_js_1.constructCallbackQueryAnswer)(answer);
+    }
     static canHandleUpdate(update) {
         return update instanceof _2_tl_js_1.types.UpdateBotCallbackQuery || update instanceof _2_tl_js_1.types.UpdateInlineBotCallbackQuery;
     }
@@ -58,4 +80,10 @@ class CallbackQueryManager {
     }
 }
 exports.CallbackQueryManager = CallbackQueryManager;
-_CallbackQueryManager_c = new WeakMap();
+_a = CallbackQueryManager, _CallbackQueryManager_c = new WeakMap(), _CallbackQueryManager_instances = new WeakSet(), _CallbackQueryManager_isExpired = function _CallbackQueryManager_isExpired(date, cacheTime) {
+    return (Date.now() - date.getTime()) / 1000 > cacheTime;
+}, _CallbackQueryManager_getPasswordCheck = async function _CallbackQueryManager_getPasswordCheck(password) {
+    const ap = await __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").api.account.getPassword();
+    return await (0, _0_password_js_1.checkPassword)(password, ap);
+};
+_CallbackQueryManager_enc = { value: new TextEncoder() };

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

@@ -18,8 +18,8 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { enums, types } from "../2_tl.js";
-import { InlineQueryResult, Update } from "../3_types.js";
-import { AnswerInlineQueryParams } from "./0_params.js";
+import { ID, InlineQueryResult, Update } from "../3_types.js";
+import { AnswerInlineQueryParams, SendInlineQueryParams } from "./0_params.js";
 import { C as C_ } from "./0_types.js";
 import { MessageManager } from "./2_message_manager.js";
 type C = C_ & {
@@ -32,5 +32,6 @@ export declare class InlineQueryManager {
     answerInlineQuery(id: string, results: InlineQueryResult[], params?: AnswerInlineQueryParams): Promise<void>;
     static canHandleUpdate(update: enums.Update): update is InlineQueryManagerUpdate;
     handleUpdate(update: InlineQueryManagerUpdate): Promise<Update>;
+    sendInlineQuery(userId: ID, chatId: ID, params?: SendInlineQueryParams): Promise<import("../3_types.js").InlineQueryAnswer>;
 }
 export {};

package/script/client/3_inline_query_manager.js

@@ -29,7 +29,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _InlineQueryManager_c;
+var _a, _InlineQueryManager_c, _InlineQueryManager_isExpired;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InlineQueryManager = void 0;
 const _0_deps_js_1 = require("../0_deps.js");
@@ -69,6 +69,22 @@ class InlineQueryManager {
             (0, _0_deps_js_1.unreachable)();
         }
     }
+    async sendInlineQuery(userId, chatId, params) {
+        const bot = await __classPrivateFieldGet(this, _InlineQueryManager_c, "f").getInputUser(userId), peer = await __classPrivateFieldGet(this, _InlineQueryManager_c, "f").getInputPeer(chatId), query = params?.query ?? "", offset = params?.offset ?? "";
+        const botId = (0, _2_tl_js_1.peerToChatId)(bot), peerId = (0, _2_tl_js_1.peerToChatId)(peer);
+        const maybeResults = await __classPrivateFieldGet(this, _InlineQueryManager_c, "f").messageStorage.getInlineQueryAnswer(botId, peerId, query, offset);
+        if (maybeResults != null && !__classPrivateFieldGet(_a, _a, "m", _InlineQueryManager_isExpired).call(_a, maybeResults[1], maybeResults[0].cache_time)) {
+            return (0, _3_types_js_1.constructInlineQueryAnswer)(maybeResults[0]);
+        }
+        const then = new Date();
+        const results = await __classPrivateFieldGet(this, _InlineQueryManager_c, "f").api.messages.getInlineBotResults({ bot, peer, query, offset });
+        if (results.cache_time > 0) {
+            await __classPrivateFieldGet(this, _InlineQueryManager_c, "f").messageStorage.setInlineQueryAnswer(botId, peerId, query, offset, results, then);
+        }
+        return (0, _3_types_js_1.constructInlineQueryAnswer)(results);
+    }
 }
 exports.InlineQueryManager = InlineQueryManager;
-_InlineQueryManager_c = new WeakMap();
+_a = InlineQueryManager, _InlineQueryManager_c = new WeakMap(), _InlineQueryManager_isExpired = function _InlineQueryManager_isExpired(date, cacheTime) {
+    return (Date.now() - date.getTime()) / 1000 > cacheTime;
+};

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

@@ -21,9 +21,9 @@ import { MaybePromise } from "../1_utilities.js";
 import { enums, functions, types } from "../2_tl.js";
 import { Storage } from "../3_storage.js";
 import { DC } from "../3_transport.js";
-import { BotCommand, BusinessConnection, Chat, ChatAction, ChatMember, ChatP, FileSource, ID, InactiveChat, InlineQueryResult, InputMedia, InputStoryContent, InviteLink, Message, MessageAnimation, MessageAudio, MessageContact, MessageDice, MessageDocument, MessageLocation, MessagePhoto, MessagePoll, MessageSticker, MessageText, MessageVenue, MessageVideo, MessageVideoNote, MessageVoice, NetworkStatistics, ParseMode, Poll, Reaction, Sticker, Story, Update, User } from "../3_types.js";
+import { BotCommand, BusinessConnection, CallbackQueryAnswer, CallbackQueryQuestion, Chat, ChatAction, ChatMember, ChatP, FileSource, ID, InactiveChat, InlineQueryAnswer, InlineQueryResult, InputMedia, InputStoryContent, InviteLink, Message, MessageAnimation, MessageAudio, MessageContact, MessageDice, MessageDocument, MessageLocation, MessagePhoto, MessagePoll, MessageSticker, MessageText, MessageVenue, MessageVideo, MessageVideoNote, MessageVoice, NetworkStatistics, ParseMode, Poll, Reaction, Sticker, Story, Update, User } from "../3_types.js";
 import { Migrate } from "../4_errors.js";
-import { AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, BanChatMemberParams, CreateInviteLinkParams, CreateStoryParams, DeleteMessageParams, DeleteMessagesParams, DownloadParams, EditMessageLiveLocationParams, EditMessageMediaParams, EditMessageParams, EditMessageReplyMarkupParams, ForwardMessagesParams, GetChatsParams, GetCreatedInviteLinksParams, GetHistoryParams, GetMyCommandsParams, PinMessageParams, ReplyParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendContactParams, SendDiceParams, SendDocumentParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendStickerParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetChatMemberRightsParams, SetChatPhotoParams, SetMyCommandsParams, SetReactionsParams, StopPollParams } from "./0_params.js";
+import { AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, BanChatMemberParams, CreateInviteLinkParams, CreateStoryParams, DeleteMessageParams, DeleteMessagesParams, DownloadParams, EditMessageLiveLocationParams, EditMessageMediaParams, EditMessageParams, EditMessageReplyMarkupParams, ForwardMessagesParams, GetChatsParams, GetCreatedInviteLinksParams, GetHistoryParams, GetMyCommandsParams, PinMessageParams, ReplyParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendContactParams, SendDiceParams, SendDocumentParams, SendInlineQueryParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendStickerParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetChatMemberRightsParams, SetChatPhotoParams, SetMyCommandsParams, SetReactionsParams, StopPollParams } from "./0_params.js";
 import { Api } from "./0_types.js";
 import { ClientPlainParams } from "./1_client_plain.js";
 import { Composer as Composer_, NextFunction } from "./1_composer.js";
@@ -184,9 +184,9 @@ export declare const restartAuth: unique symbol;
 export declare const handleMigrationError: unique symbol;
 declare const getEntity: unique symbol;
 export interface ClientParams extends ClientPlainParams {
-    /** A parse mode to use when the `parseMode` parameter is not specified when sending or editing messages. Defauls to `ParseMode.None`. */
+    /** A parse mode to use when the `parseMode` parameter is not specified when sending or editing messages. Defaults to `ParseMode.None`. */
     parseMode?: ParseMode;
-    /** The app_version parameter to be passed to initConnection when calling `authorize`. It is recommended that this parameter is changed if users are authorized. Defaults to "MTKruto" followed by this version of MTKruto. */
+    /** The app_version parameter to be passed to initConnection when calling `authorize`. It is recommended that this parameter is changed if users are authorized. Defaults to _MTKruto_. */
     appVersion?: string;
     /** The device_version parameter to be passed to initConnection when calling `authorize`. The default varies by the current runtime. */
     deviceModel?: string;
@@ -865,6 +865,16 @@ export declare class Client<C extends Context = Context> extends Composer<C> {
      * @returns The newly created invite link.
      */
     createInviteLink(chatId: ID, params?: CreateInviteLinkParams): Promise<InviteLink>;
+    /**
+     * Send a callback query. User-only.
+     *
+     * @method cq
+     * @param chatId The chat that includes the messsage.
+     * @param messageId The message that includes at a button responsible for the callback query question.
+     * @param question The callback query's question.
+     * @returns The bot's answer to the callback query.
+     */
+    sendCallbackQuery(chatId: ID, messageId: number, question: CallbackQueryQuestion): Promise<CallbackQueryAnswer>;
     /**
      * Answer a callback query. Bot-only.
      *
@@ -872,6 +882,15 @@ export declare class Client<C extends Context = Context> extends Composer<C> {
      * @param id ID of the callback query to answer.
      */
     answerCallbackQuery(id: string, params?: AnswerCallbackQueryParams): Promise<void>;
+    /**
+     * Send an inline query. User-only.
+     *
+     * @method iq
+     * @param userId The ID of the bot to send the inline query to.
+     * @param chatId The ID of the chat from which the inline query is sent.
+     * @returns The bot's answer to the inline query.
+     */
+    sendInlineQuery(userId: ID, chatId: ID, params?: SendInlineQueryParams): Promise<InlineQueryAnswer>;
     /**
      * Answer an inline query. Bot-only.
      *

package/script/client/4_client.js

@@ -2015,6 +2015,18 @@ class Client extends Composer {
     //
     // ========================= CALLBACK QUERIES ========================= //
     //
+    /**
+     * Send a callback query. User-only.
+     *
+     * @method cq
+     * @param chatId The chat that includes the messsage.
+     * @param messageId The message that includes at a button responsible for the callback query question.
+     * @param question The callback query's question.
+     * @returns The bot's answer to the callback query.
+     */
+    async sendCallbackQuery(chatId, messageId, question) {
+        return await __classPrivateFieldGet(this, _Client_callbackQueryManager, "f").sendCallbackQuery(chatId, messageId, question);
+    }
     /**
      * Answer a callback query. Bot-only.
      *
@@ -2027,6 +2039,17 @@ class Client extends Composer {
     //
     // ========================= INLINE QUERIES ========================= //
     //
+    /**
+     * Send an inline query. User-only.
+     *
+     * @method iq
+     * @param userId The ID of the bot to send the inline query to.
+     * @param chatId The ID of the chat from which the inline query is sent.
+     * @returns The bot's answer to the inline query.
+     */
+    async sendInlineQuery(userId, chatId, params) {
+        return await __classPrivateFieldGet(this, _Client_inlineQueryManager, "f").sendInlineQuery(userId, chatId, params);
+    }
     /**
      * Answer an inline query. Bot-only.
      *

package/script/storage/0_storage.d.ts

@@ -60,6 +60,10 @@ export declare const K: {
         customEmojiDocument: (id: bigint) => StorageKeyPart[];
         businessConnections: () => StorageKeyPart[];
         businessConnection: (id: string) => StorageKeyPart[];
+        inlineQueryAnswers: () => StorageKeyPart[];
+        inlineQueryAnswer: (userId: number, chatId: number, query: string, offset: string) => StorageKeyPart[];
+        callbackQueryAnswers: () => StorageKeyPart[];
+        callbackQueryAnswer: (chatId: number, messageId: number, question: string) => StorageKeyPart[];
     };
     messages: {
         P: (string: string) => string;
@@ -149,6 +153,10 @@ export declare abstract class Storage {
     getCustomEmojiDocument(id: bigint): Promise<[types.Document, Date] | null>;
     setBusinessConnection(id: string, connection: types.BotBusinessConnection | null): Promise<void>;
     getBusinessConnection(id: string): Promise<types.BotBusinessConnection | null>;
+    setInlineQueryAnswer(userId: number, chatId: number, query: string, offset: string, results: types.messages.BotResults, date: Date): Promise<void>;
+    getInlineQueryAnswer(userId: number, chatId: number, query: string, offset: string): Promise<[types.messages.BotResults, Date] | null>;
+    setCallbackQueryAnswer(chatId: number, messageId: number, question: string, answer: types.messages.BotCallbackAnswer): Promise<void>;
+    getCallbackQueryAnswer(chatId: number, messageId: number, question: string): Promise<[types.messages.BotCallbackAnswer, Date] | null>;
     setUpdate(boxId: bigint, update: enums.Update): Promise<void>;
     deleteUpdates(): Promise<void>;
     getFirstUpdate(boxId: bigint): Promise<[readonly StorageKeyPart[], enums.Update] | null>;
@@ -157,6 +165,8 @@ export declare abstract class Storage {
     deleteFiles(): Promise<void>;
     deleteCustomEmojiDocuments(): Promise<void>;
     deleteBusinessConnections(): Promise<void>;
+    deleteInlineQueryAnswers(): Promise<void>;
+    deleteCallbackQueryAnswers(): Promise<void>;
     deleteStickerSetNames(): Promise<void>;
     deletePeers(): Promise<void>;
     deleteUsernames(): Promise<void>;

package/script/storage/0_storage.js

@@ -76,6 +76,10 @@ exports.K = {
         customEmojiDocument: (id) => [...exports.K.cache.customEmojiDocuments(), id],
         businessConnections: () => [exports.K.cache.P("businessConnections")],
         businessConnection: (id) => [...exports.K.cache.businessConnections(), id],
+        inlineQueryAnswers: () => [exports.K.cache.P("inlineQueryResults")],
+        inlineQueryAnswer: (userId, chatId, query, offset) => [...exports.K.cache.inlineQueryAnswers(), userId, chatId, query, offset],
+        callbackQueryAnswers: () => [exports.K.cache.P("callbackQueryAnswers")],
+        callbackQueryAnswer: (chatId, messageId, question) => [...exports.K.cache.callbackQueryAnswers(), chatId, messageId, question],
     },
     messages: {
         P: (string) => `messages.${string}`,
@@ -404,6 +408,32 @@ class Storage {
             return null;
         }
     }
+    async setInlineQueryAnswer(userId, chatId, query, offset, results, date) {
+        await this.set(exports.K.cache.inlineQueryAnswer(userId, chatId, query, offset), [this.isMemoryStorage ? results : (0, _1_utilities_js_1.rleEncode)(results[_2_tl_js_1.serialize]()), date]);
+    }
+    async getInlineQueryAnswer(userId, chatId, query, offset) {
+        const peer_ = await this.get(exports.K.cache.inlineQueryAnswer(userId, chatId, query, offset));
+        if (peer_ != null) {
+            const [obj_, date] = peer_;
+            return [await this.getTlObject(obj_), date];
+        }
+        else {
+            return null;
+        }
+    }
+    async setCallbackQueryAnswer(chatId, messageId, question, answer) {
+        await this.set(exports.K.cache.callbackQueryAnswer(chatId, messageId, question), [this.isMemoryStorage ? answer : (0, _1_utilities_js_1.rleEncode)(answer[_2_tl_js_1.serialize]()), new Date()]);
+    }
+    async getCallbackQueryAnswer(chatId, messageId, question) {
+        const peer_ = await this.get(exports.K.cache.callbackQueryAnswer(chatId, messageId, question));
+        if (peer_ != null) {
+            const [obj_, date] = peer_;
+            return [await this.getTlObject(obj_), date];
+        }
+        else {
+            return null;
+        }
+    }
     async setUpdate(boxId, update) {
         await this.setTlObject(exports.K.updates.update(boxId, __classPrivateFieldGet(this, _Storage_instances, "m", _Storage_getUpdateId).call(this, update)), update);
     }
@@ -451,6 +481,16 @@ class Storage {
             await this.set(key, null);
         }
     }
+    async deleteInlineQueryAnswers() {
+        for await (const [key] of await this.getMany({ prefix: exports.K.cache.inlineQueryAnswers() })) {
+            await this.set(key, null);
+        }
+    }
+    async deleteCallbackQueryAnswers() {
+        for await (const [key] of await this.getMany({ prefix: exports.K.cache.callbackQueryAnswers() })) {
+            await this.set(key, null);
+        }
+    }
     async deleteStickerSetNames() {
         for await (const [key] of await this.getMany({ prefix: exports.K.cache.stickerSetNames() })) {
             await this.set(key, null);
@@ -475,6 +515,8 @@ class Storage {
             this.deleteFiles(),
             this.deleteCustomEmojiDocuments(),
             this.deleteBusinessConnections(),
+            this.deleteInlineQueryAnswers(),
+            this.deleteCallbackQueryAnswers(),
             this.deleteStickerSetNames(),
             this.deletePeers(),
             this.deleteUsernames(),

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

@@ -0,0 +1,30 @@
+/**
+ * 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 { types } from "../2_tl.js";
+/** An answer to a callback query. */
+export interface CallbackQueryAnswer {
+    /** Whether the answer should be shown as an alert. */
+    alert: boolean;
+    /** The text of the answer. */
+    text: string;
+    /** A potential URL that is to be opened. */
+    url: string;
+}
+export declare function constructCallbackQueryAnswer(answer: types.messages.BotCallbackAnswer): CallbackQueryAnswer;

package/script/types/0_callback_query_answer.js

@@ -0,0 +1,30 @@
+"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/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.constructCallbackQueryAnswer = void 0;
+function constructCallbackQueryAnswer(answer) {
+    return {
+        alert: !!answer.alert,
+        text: answer.message ?? "",
+        url: answer.url ?? "",
+    };
+}
+exports.constructCallbackQueryAnswer = constructCallbackQueryAnswer;

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

@@ -0,0 +1,49 @@
+/**
+ * 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/>.
+ */
+/**
+ * A reference to a button for opening the bot's game.
+ * @unlisted
+ */
+export interface CallbackQueryQuestionGame {
+    type: "game";
+}
+/**
+ * A reference to a password confirmation button.
+ * @unlisted
+ */
+export interface CallbackQueryQuestionPassword {
+    type: "password";
+    /** The target button's callback data. */
+    data: string;
+    /** The account's password. */
+    password: string;
+}
+/**
+ * A reference to a usual button.
+ * @unlisted
+ */
+export interface CallbackQueryQuestionButton {
+    type: "button";
+    /** The target button's callback data. */
+    data: string;
+}
+/** A reference to a button that is to be clicked by a user. */
+export type CallbackQueryQuestion = CallbackQueryQuestionGame | CallbackQueryQuestionPassword | CallbackQueryQuestionButton;
+export declare function validateCallbackQueryQuestion(q: CallbackQueryQuestion): void;

package/script/types/0_callback_query_question.js

@@ -0,0 +1,35 @@
+"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/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateCallbackQueryQuestion = void 0;
+const _0_errors_js_1 = require("../0_errors.js");
+function validateCallbackQueryQuestion(q) {
+    if (!["game", "password", "button"].includes(q.type)) {
+        throw new _0_errors_js_1.InputError("Got invalid callback query question type.");
+    }
+    if (q.type == "password" && (typeof q.password !== "string" || !q.password)) {
+        throw new _0_errors_js_1.InputError("Got empty password.");
+    }
+    if ((q.type == "button" || q.type == "password") && (typeof q.data !== "string" || !q.data)) {
+        throw new _0_errors_js_1.InputError("Got empty button data.");
+    }
+}
+exports.validateCallbackQueryQuestion = validateCallbackQueryQuestion;

package/{esm/types/1_input_message_content.d.ts → script/types/1_message_content.d.ts}

@@ -25,7 +25,7 @@ import { PriceTag } from "./0_price_tag.js";
  * A message content that shares a contact.
  * @unlisted
  */
-export interface InputMessageContentContact {
+export interface MessageContentContact {
     /** The contact's phone number. */
     phoneNumber: string;
     /** The contact's first name. */
@@ -39,7 +39,7 @@ export interface InputMessageContentContact {
  * A message content that shares a location.
  * @unlisted
  */
-export interface InputMessageContentLocation {
+export interface MessageContentLocation {
     /** The latitude of the location. */
     latitude: number;
     /** The longitude of the location. */
@@ -57,7 +57,7 @@ export interface InputMessageContentLocation {
  * A message content that shares a venue.
  * @unlisted
  */
-export interface InputMessageContentVenue {
+export interface MessageContentVenue {
     /** The latitude of the venue. */
     latitude: number;
     /** The longitude of the venue. */
@@ -76,7 +76,7 @@ export interface InputMessageContentVenue {
     googlePlaceType?: string;
 }
 /** @unlisted */
-export interface InputMessageContentText {
+export interface MessageContentText {
     /** The message's text. */
     messageText: string;
     /** The parse mode to use. If not provided, the default parse mode will be used. */
@@ -87,7 +87,7 @@ export interface InputMessageContentText {
     linkPreview?: LinkPreview;
 }
 /** @unlisted */
-export interface InputMessageContentInvoice {
+export interface MessageContentInvoice {
     title: string;
     description: string;
     payload: string;
@@ -110,4 +110,4 @@ export interface InputMessageContentInvoice {
     isFlexible?: boolean;
 }
 /** The content of a message to be returned as an inline query result. */
-export type InputMessageContent = InputMessageContentText | InputMessageContentLocation | InputMessageContentVenue | InputMessageContentContact | InputMessageContentInvoice;
+export type MessageContent = MessageContentText | MessageContentLocation | MessageContentVenue | MessageContentContact | MessageContentInvoice;

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

@@ -34,3 +34,7 @@ export interface Photo {
     thumbnails: Thumbnail[];
 }
 export declare function constructPhoto(photo: types.Photo): Photo;
+export declare function getPhotoSizes(photo: types.Photo): {
+    sizes: types.PhotoSize[];
+    largest: types.PhotoSize;
+};

package/script/types/1_photo.js

@@ -19,12 +19,22 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.constructPhoto = void 0;
+exports.getPhotoSizes = exports.constructPhoto = void 0;
 const _2_tl_js_1 = require("../2_tl.js");
 const _file_id_js_1 = require("./_file_id.js");
-const _file_id_js_2 = require("./_file_id.js");
 const _0_thumbnail_js_1 = require("./0_thumbnail.js");
 function constructPhoto(photo) {
+    const { sizes, largest } = getPhotoSizes(photo);
+    return {
+        ...(0, _file_id_js_1.getPhotoFileId)(photo),
+        width: largest.w,
+        height: largest.h,
+        fileSize: largest.size,
+        thumbnails: sizes.slice(0, -1).map((v) => (0, _0_thumbnail_js_1.constructThumbnail)(v, photo)),
+    };
+}
+exports.constructPhoto = constructPhoto;
+function getPhotoSizes(photo) {
     const sizes = photo.sizes
         .map((v) => {
         if (v instanceof _2_tl_js_1.types.PhotoSizeProgressive) {
@@ -37,29 +47,6 @@ function constructPhoto(photo) {
         .filter((v) => v instanceof _2_tl_js_1.types.PhotoSize)
         .sort((a, b) => a.size - b.size);
     const largest = sizes.slice(-1)[0];
-    const { dc_id: dcId, id, access_hash: accessHash, file_reference: fileReference } = photo;
-    const fileId_ = {
-        type: _file_id_js_2.FileType.Photo,
-        dcId,
-        fileReference,
-        location: {
-            type: "photo",
-            id,
-            accessHash,
-            source: {
-                type: _file_id_js_1.PhotoSourceType.Thumbnail,
-                fileType: _file_id_js_2.FileType.Photo,
-                thumbnailType: largest.type.charCodeAt(0),
-            },
-        },
-    };
-    return {
-        fileId: (0, _file_id_js_2.serializeFileId)(fileId_),
-        fileUniqueId: (0, _file_id_js_2.toUniqueFileId)(fileId_),
-        width: largest.w,
-        height: largest.h,
-        fileSize: largest.size,
-        thumbnails: sizes.slice(0, -1).map((v) => (0, _0_thumbnail_js_1.constructThumbnail)(v, photo)),
-    };
+    return { sizes, largest };
 }
-exports.constructPhoto = constructPhoto;
+exports.getPhotoSizes = getPhotoSizes;