@mtkruto/node 0.1.400 → 0.1.500

package/esm/0_deps.d.ts

@@ -17,11 +17,11 @@
  * 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/>.
  */
-export * from "./deps/deno.land/std@0.222.1/assert/mod.js";
-export * as path from "./deps/deno.land/std@0.222.1/path/mod.js";
-export { concat } from "./deps/deno.land/std@0.222.1/bytes/concat.js";
-export { decodeBase64, encodeBase64 } from "./deps/deno.land/std@0.222.1/encoding/base64.js";
-import { contentType as contentType_ } from "./deps/deno.land/std@0.222.1/media_types/content_type.js";
+export * from "./deps/deno.land/std@0.223.0/assert/mod.js";
+export * as path from "./deps/deno.land/std@0.223.0/path/mod.js";
+export { concat } from "./deps/deno.land/std@0.223.0/bytes/concat.js";
+export { decodeBase64, encodeBase64 } from "./deps/deno.land/std@0.223.0/encoding/base64.js";
+import { contentType as contentType_ } from "./deps/deno.land/std@0.223.0/media_types/content_type.js";
 export declare const contentType: typeof contentType_;
 export declare function extension(mimeType: string): string;
 export { createCtr256State, ctr256, type Ctr256State, destroyCtr256State, ige256Decrypt, ige256Encrypt, init as initTgCrypto } from "./deps/deno.land/x/tgcrypto@0.4.1/mod.js";

package/esm/0_deps.js

@@ -18,11 +18,11 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 // connection/1_connection_tcp.ts must be updated too when updating std.
-export * from "./deps/deno.land/std@0.222.1/assert/mod.js";
-export * as path from "./deps/deno.land/std@0.222.1/path/mod.js";
-export { concat } from "./deps/deno.land/std@0.222.1/bytes/concat.js";
-export { decodeBase64, encodeBase64 } from "./deps/deno.land/std@0.222.1/encoding/base64.js";
-import { contentType as contentType_ } from "./deps/deno.land/std@0.222.1/media_types/content_type.js";
+export * from "./deps/deno.land/std@0.223.0/assert/mod.js";
+export * as path from "./deps/deno.land/std@0.223.0/path/mod.js";
+export { concat } from "./deps/deno.land/std@0.223.0/bytes/concat.js";
+export { decodeBase64, encodeBase64 } from "./deps/deno.land/std@0.223.0/encoding/base64.js";
+import { contentType as contentType_ } from "./deps/deno.land/std@0.223.0/media_types/content_type.js";
 export const contentType = (extentionOrType) => {
     if (extentionOrType == "tgs") {
         return "application/x-tgsticker";
@@ -31,7 +31,7 @@ export const contentType = (extentionOrType) => {
         return contentType_(extentionOrType);
     }
 };
-import { extension as extension_ } from "./deps/deno.land/std@0.222.1/media_types/extension.js";
+import { extension as extension_ } from "./deps/deno.land/std@0.223.0/media_types/extension.js";
 export function extension(mimeType) {
     if (mimeType == "application/x-tgsticker") {
         return "tgs";

package/esm/3_types.d.ts

@@ -21,6 +21,8 @@ export * from "./types/_file_id.js";
 export * from "./types/_getters.js";
 export * from "./types/0_authorization_state.js";
 export * from "./types/0_bot_command.js";
+export * from "./types/0_callback_query_answer.js";
+export * from "./types/0_callback_query_question.js";
 export * from "./types/0_chat_action.js";
 export * from "./types/0_chat_administrator_rights.js";
 export * from "./types/0_chat_member_rights.js";
@@ -58,9 +60,9 @@ export * from "./types/1_document.js";
 export * from "./types/1_giveaway.js";
 export * from "./types/1_inline_query_result_button.js";
 export * from "./types/1_input_media.js";
-export * from "./types/1_input_message_content.js";
 export * from "./types/1_input_story_content.js";
 export * from "./types/1_keyboard_button.js";
+export * from "./types/1_message_content.js";
 export * from "./types/1_message_reaction.js";
 export * from "./types/1_network_statistics.js";
 export * from "./types/1_photo.js";
@@ -95,4 +97,5 @@ export * from "./types/4_inline_query_result.js";
 export * from "./types/4_message.js";
 export * from "./types/5_callback_query.js";
 export * from "./types/5_chat.js";
+export * from "./types/5_inline_query_answer.js";
 export * from "./types/6_update.js";

package/esm/3_types.js

@@ -21,6 +21,8 @@ export * from "./types/_file_id.js";
 export * from "./types/_getters.js";
 export * from "./types/0_authorization_state.js";
 export * from "./types/0_bot_command.js";
+export * from "./types/0_callback_query_answer.js";
+export * from "./types/0_callback_query_question.js";
 export * from "./types/0_chat_action.js";
 export * from "./types/0_chat_administrator_rights.js";
 export * from "./types/0_chat_member_rights.js";
@@ -58,9 +60,9 @@ export * from "./types/1_document.js";
 export * from "./types/1_giveaway.js";
 export * from "./types/1_inline_query_result_button.js";
 export * from "./types/1_input_media.js";
-export * from "./types/1_input_message_content.js";
 export * from "./types/1_input_story_content.js";
 export * from "./types/1_keyboard_button.js";
+export * from "./types/1_message_content.js";
 export * from "./types/1_message_reaction.js";
 export * from "./types/1_network_statistics.js";
 export * from "./types/1_photo.js";
@@ -95,4 +97,5 @@ export * from "./types/4_inline_query_result.js";
 export * from "./types/4_message.js";
 export * from "./types/5_callback_query.js";
 export * from "./types/5_chat.js";
+export * from "./types/5_inline_query_answer.js";
 export * from "./types/6_update.js";

package/esm/client/0_markdown.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 { MessageEntity } from "../3_types.js";
 export declare const CODEPOINTS: {
     "\t": number;

package/esm/client/0_markdown.js

@@ -1,6 +1,24 @@
+/**
+ * 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/>.
+ */
 /**
  * Copyright (C) 2023 Dunkan
- * Copyright (C) 2024 Roj
  */
 import { unreachable } from "../0_deps.js";
 import { sortMessageEntities } from "../3_types.js";

package/esm/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/esm/client/0_utilities.js

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

package/esm/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/esm/client/3_callback_query_manager.js

@@ -28,12 +28,14 @@ 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;
-import { types } from "../2_tl.js";
-import { constructCallbackQuery } from "../3_types.js";
-import { checkCallbackQueryId } from "./0_utilities.js";
+var _CallbackQueryManager_instances, _a, _CallbackQueryManager_c, _CallbackQueryManager_enc, _CallbackQueryManager_isExpired, _CallbackQueryManager_getPasswordCheck;
+import { peerToChatId, types } from "../2_tl.js";
+import { constructCallbackQuery, constructCallbackQueryAnswer, validateCallbackQueryQuestion } from "../3_types.js";
+import { checkCallbackQueryId, checkMessageId } from "./0_utilities.js";
+import { checkPassword } from "./0_password.js";
 export class CallbackQueryManager {
     constructor(c) {
+        _CallbackQueryManager_instances.add(this);
         _CallbackQueryManager_c.set(this, void 0);
         __classPrivateFieldSet(this, _CallbackQueryManager_c, c, "f");
     }
@@ -47,6 +49,26 @@ export class CallbackQueryManager {
             alert: params?.alert ? true : undefined,
         });
     }
+    async sendCallbackQuery(chatId, messageId, question) {
+        checkMessageId(messageId);
+        validateCallbackQueryQuestion(question);
+        const peer = await __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").getInputPeer(chatId), peerId = 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 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 constructCallbackQueryAnswer(answer);
+    }
     static canHandleUpdate(update) {
         return update instanceof types.UpdateBotCallbackQuery || update instanceof types.UpdateInlineBotCallbackQuery;
     }
@@ -54,4 +76,10 @@ export class CallbackQueryManager {
         return { callbackQuery: await constructCallbackQuery(update, __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").getEntity, __classPrivateFieldGet(this, _CallbackQueryManager_c, "f").messageManager.getMessageWithReply.bind(__classPrivateFieldGet(this, _CallbackQueryManager_c, "f").messageManager)) };
     }
 }
-_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 checkPassword(password, ap);
+};
+_CallbackQueryManager_enc = { value: new TextEncoder() };

package/esm/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/esm/client/3_inline_query_manager.js

@@ -28,10 +28,10 @@ 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;
 import { unreachable } from "../0_deps.js";
-import { types } from "../2_tl.js";
-import { constructChosenInlineResult, constructInlineQuery, inlineQueryResultToTlObject } from "../3_types.js";
+import { peerToChatId, types } from "../2_tl.js";
+import { constructChosenInlineResult, constructInlineQuery, constructInlineQueryAnswer, inlineQueryResultToTlObject } from "../3_types.js";
 import { checkInlineQueryId } from "./0_utilities.js";
 export class InlineQueryManager {
     constructor(c) {
@@ -66,5 +66,21 @@ export class InlineQueryManager {
             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 = peerToChatId(bot), peerId = 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 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 constructInlineQueryAnswer(results);
+    }
 }
-_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/esm/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/esm/client/4_client.js

@@ -2011,6 +2011,18 @@ export 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.
      *
@@ -2023,6 +2035,17 @@ export 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/esm/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/esm/storage/0_storage.js

@@ -73,6 +73,10 @@ export const K = {
         customEmojiDocument: (id) => [...K.cache.customEmojiDocuments(), id],
         businessConnections: () => [K.cache.P("businessConnections")],
         businessConnection: (id) => [...K.cache.businessConnections(), id],
+        inlineQueryAnswers: () => [K.cache.P("inlineQueryResults")],
+        inlineQueryAnswer: (userId, chatId, query, offset) => [...K.cache.inlineQueryAnswers(), userId, chatId, query, offset],
+        callbackQueryAnswers: () => [K.cache.P("callbackQueryAnswers")],
+        callbackQueryAnswer: (chatId, messageId, question) => [...K.cache.callbackQueryAnswers(), chatId, messageId, question],
     },
     messages: {
         P: (string) => `messages.${string}`,
@@ -401,6 +405,32 @@ export class Storage {
             return null;
         }
     }
+    async setInlineQueryAnswer(userId, chatId, query, offset, results, date) {
+        await this.set(K.cache.inlineQueryAnswer(userId, chatId, query, offset), [this.isMemoryStorage ? results : rleEncode(results[serialize]()), date]);
+    }
+    async getInlineQueryAnswer(userId, chatId, query, offset) {
+        const peer_ = await this.get(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(K.cache.callbackQueryAnswer(chatId, messageId, question), [this.isMemoryStorage ? answer : rleEncode(answer[serialize]()), new Date()]);
+    }
+    async getCallbackQueryAnswer(chatId, messageId, question) {
+        const peer_ = await this.get(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(K.updates.update(boxId, __classPrivateFieldGet(this, _Storage_instances, "m", _Storage_getUpdateId).call(this, update)), update);
     }
@@ -448,6 +478,16 @@ export class Storage {
             await this.set(key, null);
         }
     }
+    async deleteInlineQueryAnswers() {
+        for await (const [key] of await this.getMany({ prefix: K.cache.inlineQueryAnswers() })) {
+            await this.set(key, null);
+        }
+    }
+    async deleteCallbackQueryAnswers() {
+        for await (const [key] of await this.getMany({ prefix: K.cache.callbackQueryAnswers() })) {
+            await this.set(key, null);
+        }
+    }
     async deleteStickerSetNames() {
         for await (const [key] of await this.getMany({ prefix: K.cache.stickerSetNames() })) {
             await this.set(key, null);
@@ -472,6 +512,8 @@ export class Storage {
             this.deleteFiles(),
             this.deleteCustomEmojiDocuments(),
             this.deleteBusinessConnections(),
+            this.deleteInlineQueryAnswers(),
+            this.deleteCallbackQueryAnswers(),
             this.deleteStickerSetNames(),
             this.deletePeers(),
             this.deleteUsernames(),

package/esm/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/esm/types/0_callback_query_answer.js

@@ -0,0 +1,26 @@
+/**
+ * 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/>.
+ */
+export function constructCallbackQueryAnswer(answer) {
+    return {
+        alert: !!answer.alert,
+        text: answer.message ?? "",
+        url: answer.url ?? "",
+    };
+}

package/esm/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/esm/types/0_callback_query_question.js

@@ -0,0 +1,31 @@
+/**
+ * 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 { InputError } from "../0_errors.js";
+export function validateCallbackQueryQuestion(q) {
+    if (!["game", "password", "button"].includes(q.type)) {
+        throw new InputError("Got invalid callback query question type.");
+    }
+    if (q.type == "password" && (typeof q.password !== "string" || !q.password)) {
+        throw new InputError("Got empty password.");
+    }
+    if ((q.type == "button" || q.type == "password") && (typeof q.data !== "string" || !q.data)) {
+        throw new InputError("Got empty button data.");
+    }
+}