@mtkruto/node 0.1.106 → 0.1.107

package/esm/4_constants.d.ts

@@ -4,8 +4,8 @@ export type PublicKeys = readonly [bigint, [bigint, bigint]][];
 export declare const PUBLIC_KEYS: PublicKeys;
 export declare const VECTOR_CONSTRUCTOR = 481674261;
 export declare const INITIAL_DC: DC;
-export declare const LAYER = 161;
-export declare const APP_VERSION = "MTKruto 0.1.106";
+export declare const LAYER = 165;
+export declare const APP_VERSION = "MTKruto 0.1.107";
 export declare const DEVICE_MODEL: string;
 export declare const LANG_CODE: string;
 export declare const LANG_PACK = "";

package/esm/4_constants.js

@@ -53,8 +53,8 @@ export const PUBLIC_KEYS = Object.freeze([
 ]);
 export const VECTOR_CONSTRUCTOR = 0x1CB5C415;
 export const INITIAL_DC = "2-test";
-export const LAYER = 161;
-export const APP_VERSION = "MTKruto 0.1.106";
+export const LAYER = 165;
+export const APP_VERSION = "MTKruto 0.1.107";
 // @ts-ignore: lib
 export const DEVICE_MODEL = typeof dntShim.Deno === "undefined" ? typeof navigator === "undefined" ? typeof process === "undefined" ? "Unknown" : process.platform + "-" + process.arch : navigator.userAgent.split(" ")[0] : dntShim.Deno.build.os + "-" + dntShim.Deno.build.arch;
 export const LANG_CODE = typeof navigator === "undefined" ? "en" : navigator.language.split("-")[0];

package/esm/client/3_types.d.ts

@@ -40,13 +40,13 @@ export interface ClientParams extends ClientPlainParams {
     errorHandler?: (err: unknown, function_: types.Type | functions.Function<unknown>, n: number) => MaybePromise<boolean>;
 }
 export interface AnswerCallbackQueryParams {
-    /** Text of the answer */
+    /** A text to be shown to the user. */
     text?: string;
-    /** Pass true to show an alert to the user instead of a toast notification */
+    /** Whether to show the text as an alert (popup). */
     alert?: boolean;
-    /** URL to be opened */
+    /** A URL to be opened. */
     url?: string;
-    /** Time during which the result of the query can be cached, in seconds */
+    /** TTL of answer caches in seconds. */
     cacheTime?: number;
 }
 export interface AuthorizeUserParams<S = string> {
@@ -135,19 +135,24 @@ export interface ForwardMessagesParams {
 }
 export interface SendPollParams {
     /**
-     * True, if the poll needs to be anonymous, defaults to True */
+     * Whether the poll should be anonymous.
+     */
     isAnonymous?: boolean;
     /**
-     * The type of the poll. Defaults to regular. */
+     * The type of the poll.
+     */
     type?: "quiz" | "regular";
     /**
-     * True, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to False */
+     * Whether multiple selections should be allowed. Only valid for regular polls.
+     */
     allowMultipleAnswers?: boolean;
     /**
-     * Index of the correct option. Required for quizzes. */
+     * Index of the correct option. Required for quiz polls.
+     */
     correctOptionIndex?: number;
     /**
-     *  Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing */
+     * A text that will be shown to the user when the poll is answered. Only valid for quiz polls.
+     */
     explanation?: string;
     /**
      * The parse mode to use for the explanation. If not provided, the default parse mode will be used.
@@ -158,15 +163,15 @@ export interface SendPollParams {
      */
     explanationEntities?: MessageEntity[];
     /**
-     * Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with close_date.
+     * Duration of the poll in seconds. Must be in the range of 5-600. Cannot be used simultaneously with `closeDate`.
      */
     openPeriod?: number;
     /**
-     * Point in time when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with open_period.
+     * The time in which the poll will be closed. Must be at least 5 seconds in the future, and no more than 600. Cannot be used simultaneously with `openPeriod`.
      */
     closeDate?: Date;
     /**
-     * Pass True if the poll needs to be immediately closed. This can be useful for poll preview.
+     * Whether the poll should be closed as soon as it is sent, allowing no answers.
      */
     isClosed?: boolean;
     /**

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

@@ -2,7 +2,7 @@ import { MaybePromise } from "../1_utilities.js";
 import { functions, ReadObject, types } from "../2_tl.js";
 import { Storage } from "../3_storage.js";
 import { DC } from "../3_transport.js";
-import { BotCommand, ChatAction, ChatID, InlineQueryResult, Message } from "../3_types.js";
+import { BotCommand, ChatAction, ChatID, InlineQueryResult, Message, User } from "../3_types.js";
 import { Migrate } from "../4_errors.js";
 import { With } from "./0_utilities.js";
 import { ClientAbstract } from "./1_client_abstract.js";
@@ -135,64 +135,82 @@ export declare class Client extends ClientAbstract {
     /**
      * Send a text message.
      *
+     * @method
      * @param chatId The chat to send the message to.
      * @param text The message's text.
-     * @method
+     * @returns The sent text message.
      */
     sendMessage(chatId: ChatID, text: string, params?: SendMessagesParams): Promise<With<Message, "text">>;
     private parseText;
     /**
      * Edit a message's text.
      *
+     * @method
      * @param chatId The chat where the message is.
      * @param messageId The ID of the message.
      * @param text The new text of the message.
-     * @method
+     * @returns The edited text message.
      */
     editMessageText(chatId: ChatID, messageId: number, text: string, params?: EditMessageParams): Promise<With<Message, "text">>;
     private getMessagesInner;
     /**
      * Retrieve multiple messages.
      *
+     * @method
      * @param chatId The identifier of the chat to retrieve the messages from.
      * @param messageIds The identifiers of the messages to retrieve.
-     * @method
+     * @example ```ts
+     * const message = await client.getMessages("@MTKruto", [210, 212]);
+     * ```
+     * @returns The retrieved messages.
      */
-    getMessages(chatId_: ChatID, messageIds: number[]): Promise<Omit<Message, "replyToMessage">[]>;
+    getMessages(chatId: ChatID, messageIds: number[]): Promise<Omit<Message, "replyToMessage">[]>;
     private [getMessageWithReply];
     /**
      * Retrieve a single message.
      *
+     * @method
      * @param chatId The identifier of the chat to retrieve the message from.
      * @param messageId The identifier of the message to retrieve.
-     * @method
+     * @example ```ts
+     * const message = await client.getMessage("@MTKruto", 212);
+     * ```
+     * @returns The retrieved message.
      */
     getMessage(chatId: ChatID, messageId: number): Promise<Omit<Message, "replyToMessage"> | null>;
     private downloadInner;
     /**
      * Download a file.
      *
-     * @param fileId The identifier of the file to download.
      * @method
+     * @param fileId The identifier of the file to download.
+     * @example ```ts
+     * for await (const chunk of client.download(fileId, { chunkSize: 256 * 1024 })) {
+     *   await outFile.write(chunk);
+     * }
+     * ```
+     * @returns A generator yielding the contents of the file.
      */
     download(fileId: string, params?: DownloadParams): Promise<AsyncGenerator<Uint8Array, void, unknown>>;
     private [getStickerSetName];
     /**
      * Forward multiple messages.
      *
+     * @method
      * @param from The identifier of the chat to forward the messages from.
      * @param to The identifier of the chat to forward the messages to.
      * @param messageIds The identifiers of the messages to forward.
-     * @method
+     * @returns The forwarded messages.
      */
     forwardMessages(from: ChatID, to: ChatID, messageIds: number[], params?: ForwardMessagesParams): Promise<Message[]>;
     /**
      * Forward a single message.
      *
+     * @method
      * @param from The identifier of the chat to forward the message from.
      * @param to The identifier of the chat to forward the message to.
      * @param messageId The identifier of the message to forward.
-     * @method
+     * @returns The forwarded message.
      */
     forwardMessage(from: ChatID, to: ChatID, messageId: number, params?: ForwardMessagesParams): Promise<Message>;
     /**
@@ -200,13 +218,13 @@ export declare class Client extends ClientAbstract {
      *
      * @method
      */
-    getMe(): Promise<import("../3_types.js").User>;
+    getMe(): Promise<User>;
     private handleUpdate;
     /**
      * Answer a callback query. Bot-only.
      *
-     * @param id ID of the callback query to answer.
      * @method
+     * @param id ID of the callback query to answer.
      */
     answerCallbackQuery(id: string, params?: AnswerCallbackQueryParams): Promise<void>;
     private usernameResolver;
@@ -215,33 +233,36 @@ export declare class Client extends ClientAbstract {
     /**
      * Send a poll.
      *
+     * @method
      * @param chatId The chat to send the poll to.
      * @param question The poll's question.
      * @param options The poll's options.
-     * @method
+     * @returns The sent poll.
      */
     sendPoll(chatId: ChatID, question: string, options: [string, string, ...string[]], params?: SendPollParams): Promise<With<Message, "poll">>;
     /**
      * Send a chat action.
      *
+     * @method
      * @param chatId The chat to send the chat action to.
      * @param action The chat action.
      * @param messageThreadId The thread to send the chat action to.
-     * @method
      */
-    sendChatAction(chatId: ChatID, action_: ChatAction, messageThreadId?: number): Promise<void>;
+    sendChatAction(chatId: ChatID, action: ChatAction, params?: {
+        messageThreadId?: number;
+    }): Promise<void>;
     /**
      * Upload a file.
      *
-     * @param contents The contents of the file.
      * @method
+     * @param contents The contents of the file.
      */
     upload(contents: Uint8Array, params?: UploadParams): Promise<types.InputFile | types.InputFileBig>;
     /**
      * Set the bot's commands in the given scope and/or language. Bot-only.
      *
-     * @param commands The commands to set.
      * @method
+     * @param commands The commands to set.
      */
     setMyCommands(commands: BotCommand[], params?: SetMyCommandsParams): Promise<void>;
     /**
@@ -251,9 +272,9 @@ export declare class Client extends ClientAbstract {
     /**
      * Answer an inline query. Bot-only.
      *
+     * @method
      * @param id The ID of the inline query to answer.
      * @param results The results to answer with.
-     * @method
      */
     answerInlineQuery(id: string, results: InlineQueryResult[], params?: AnswerInlineQueryParams): Promise<void>;
     private handle;
@@ -296,18 +317,24 @@ export declare class Client extends ClientAbstract {
      *
      * @method
      */
-    getMyDescription(languageCode?: string): Promise<string>;
+    getMyDescription(params?: {
+        languageCode?: string;
+    }): Promise<string>;
     /**
      * Set the bot's name in the given language. Bot-only.
      *
      * @method
      */
-    getMyName(languageCode?: string): Promise<string>;
+    getMyName(params?: {
+        languageCode?: string;
+    }): Promise<string>;
     /**
      * Get the bot's short description in the given language. Bot-only.
      *
      * @method
      */
-    getMyShortDescription(languageCode?: string): Promise<string>;
+    getMyShortDescription(params?: {
+        languageCode?: string;
+    }): Promise<string>;
 }
 export {};

package/esm/client/4_client.js

@@ -1239,9 +1239,10 @@ export class Client extends ClientAbstract {
     /**
      * Send a text message.
      *
+     * @method
      * @param chatId The chat to send the message to.
      * @param text The message's text.
-     * @method
+     * @returns The sent text message.
      */
     async sendMessage(chatId, text, params) {
         const [message, entities] = this.parseText(text, params);
@@ -1292,10 +1293,11 @@ export class Client extends ClientAbstract {
     /**
      * Edit a message's text.
      *
+     * @method
      * @param chatId The chat where the message is.
      * @param messageId The ID of the message.
      * @param text The new text of the message.
-     * @method
+     * @returns The edited text message.
      */
     async editMessageText(chatId, messageId, text, params) {
         const [message, entities] = this.parseText(text, params);
@@ -1350,12 +1352,16 @@ export class Client extends ClientAbstract {
     /**
      * Retrieve multiple messages.
      *
+     * @method
      * @param chatId The identifier of the chat to retrieve the messages from.
      * @param messageIds The identifiers of the messages to retrieve.
-     * @method
+     * @example ```ts
+     * const message = await client.getMessages("@MTKruto", [210, 212]);
+     * ```
+     * @returns The retrieved messages.
      */
-    async getMessages(chatId_, messageIds) {
-        return await this.getMessagesInner(chatId_, messageIds).then((v) => v.map((v) => v.message));
+    async getMessages(chatId, messageIds) {
+        return await this.getMessagesInner(chatId, messageIds).then((v) => v.map((v) => v.message));
     }
     async [getMessageWithReply](chatId, messageId) {
         const messages = await this.getMessagesInner(chatId, [messageId]);
@@ -1364,9 +1370,13 @@ export class Client extends ClientAbstract {
     /**
      * Retrieve a single message.
      *
+     * @method
      * @param chatId The identifier of the chat to retrieve the message from.
      * @param messageId The identifier of the message to retrieve.
-     * @method
+     * @example ```ts
+     * const message = await client.getMessage("@MTKruto", 212);
+     * ```
+     * @returns The retrieved message.
      */
     async getMessage(chatId, messageId) {
         const messages = await this.getMessages(chatId, [messageId]);
@@ -1416,8 +1426,14 @@ export class Client extends ClientAbstract {
     /**
      * Download a file.
      *
-     * @param fileId The identifier of the file to download.
      * @method
+     * @param fileId The identifier of the file to download.
+     * @example ```ts
+     * for await (const chunk of client.download(fileId, { chunkSize: 256 * 1024 })) {
+     *   await outFile.write(chunk);
+     * }
+     * ```
+     * @returns A generator yielding the contents of the file.
      */
     async download(fileId, params) {
         const fileId_ = FileID.decode(fileId);
@@ -1459,10 +1475,11 @@ export class Client extends ClientAbstract {
     /**
      * Forward multiple messages.
      *
+     * @method
      * @param from The identifier of the chat to forward the messages from.
      * @param to The identifier of the chat to forward the messages to.
      * @param messageIds The identifiers of the messages to forward.
-     * @method
+     * @returns The forwarded messages.
      */
     async forwardMessages(from, to, messageIds, params) {
         const result = await this.invoke(new functions.MessagesForwardMessages({
@@ -1482,10 +1499,11 @@ export class Client extends ClientAbstract {
     /**
      * Forward a single message.
      *
+     * @method
      * @param from The identifier of the chat to forward the message from.
      * @param to The identifier of the chat to forward the message to.
      * @param messageId The identifier of the message to forward.
-     * @method
+     * @returns The forwarded message.
      */
     async forwardMessage(from, to, messageId, params) {
         return await this.forwardMessages(from, to, [messageId], params).then((v) => v[0]);
@@ -1601,8 +1619,8 @@ export class Client extends ClientAbstract {
     /**
      * Answer a callback query. Bot-only.
      *
-     * @param id ID of the callback query to answer.
      * @method
+     * @param id ID of the callback query to answer.
      */
     async answerCallbackQuery(id, params) {
         await this.assertBot("answerCallbackQuery");
@@ -1628,10 +1646,11 @@ export class Client extends ClientAbstract {
     /**
      * Send a poll.
      *
+     * @method
      * @param chatId The chat to send the poll to.
      * @param question The poll's question.
      * @param options The poll's options.
-     * @method
+     * @returns The sent poll.
      */
     async sendPoll(chatId, question, options, params) {
         const peer = await this.getInputPeer(chatId);
@@ -1681,57 +1700,57 @@ export class Client extends ClientAbstract {
     /**
      * Send a chat action.
      *
+     * @method
      * @param chatId The chat to send the chat action to.
      * @param action The chat action.
      * @param messageThreadId The thread to send the chat action to.
-     * @method
      */
-    async sendChatAction(chatId, action_, messageThreadId) {
-        let action;
-        switch (action_) {
+    async sendChatAction(chatId, action, params) {
+        let action_;
+        switch (action) {
             case "type":
-                action = new types.SendMessageTypingAction();
+                action_ = new types.SendMessageTypingAction();
                 break;
             case "uploadPhoto":
-                action = new types.SendMessageUploadPhotoAction({ progress: 0 });
+                action_ = new types.SendMessageUploadPhotoAction({ progress: 0 });
                 break;
             case "recordVideo":
-                action = new types.SendMessageRecordVideoAction();
+                action_ = new types.SendMessageRecordVideoAction();
                 break;
             case "uploadVideo":
-                action = new types.SendMessageRecordVideoAction();
+                action_ = new types.SendMessageRecordVideoAction();
                 break;
             case "recordVoice":
-                action = new types.SendMessageRecordAudioAction();
+                action_ = new types.SendMessageRecordAudioAction();
                 break;
             case "uploadAudio":
-                action = new types.SendMessageUploadAudioAction({ progress: 0 });
+                action_ = new types.SendMessageUploadAudioAction({ progress: 0 });
                 break;
             case "uploadDocument":
-                action = new types.SendMessageUploadDocumentAction({ progress: 0 });
+                action_ = new types.SendMessageUploadDocumentAction({ progress: 0 });
                 break;
             case "chooseSticker":
-                action = new types.SendMessageChooseStickerAction();
+                action_ = new types.SendMessageChooseStickerAction();
                 break;
             case "findLocation":
-                action = new types.SendMessageGeoLocationAction();
+                action_ = new types.SendMessageGeoLocationAction();
                 break;
             case "recordVideoNote":
-                action = new types.SendMessageRecordRoundAction();
+                action_ = new types.SendMessageRecordRoundAction();
                 break;
             case "uploadVideoNote":
-                action = new types.SendMessageUploadRoundAction({ progress: 0 });
+                action_ = new types.SendMessageUploadRoundAction({ progress: 0 });
                 break;
             default:
-                throw new Error("Invalid chat action: " + action_);
+                throw new Error("Invalid chat action: " + action);
         }
-        await this.invoke(new functions.MessagesSetTyping({ peer: await this.getInputPeer(chatId), action, topMsgId: messageThreadId }));
+        await this.invoke(new functions.MessagesSetTyping({ peer: await this.getInputPeer(chatId), action: action_, topMsgId: params?.messageThreadId }));
     }
     /**
      * Upload a file.
      *
-     * @param contents The contents of the file.
      * @method
+     * @param contents The contents of the file.
      */
     async upload(contents, params) {
         const isBig = contents.length > 1048576; // 10 MB
@@ -1821,8 +1840,8 @@ export class Client extends ClientAbstract {
     /**
      * Set the bot's commands in the given scope and/or language. Bot-only.
      *
-     * @param commands The commands to set.
      * @method
+     * @param commands The commands to set.
      */
     async setMyCommands(commands, params) {
         await this.invoke(new functions.BotsSetBotCommands({
@@ -1844,9 +1863,9 @@ export class Client extends ClientAbstract {
     /**
      * Answer an inline query. Bot-only.
      *
+     * @method
      * @param id The ID of the inline query to answer.
      * @param results The results to answer with.
-     * @method
      */
     async answerInlineQuery(id, results, params) {
         await this.invoke(new functions.MessagesSetInlineBotResults({
@@ -1944,26 +1963,26 @@ export class Client extends ClientAbstract {
      *
      * @method
      */
-    async getMyDescription(languageCode) {
+    async getMyDescription(params) {
         await this.assertBot("getMyDescription");
-        return await this.getMyInfo(languageCode).then((v) => v.description);
+        return await this.getMyInfo(params?.languageCode).then((v) => v.description);
     }
     /**
      * Set the bot's name in the given language. Bot-only.
      *
      * @method
      */
-    async getMyName(languageCode) {
+    async getMyName(params) {
         await this.assertBot("getMyName");
-        return await this.getMyInfo(languageCode).then((v) => v.description);
+        return await this.getMyInfo(params?.languageCode).then((v) => v.description);
     }
     /**
      * Get the bot's short description in the given language. Bot-only.
      *
      * @method
      */
-    async getMyShortDescription(languageCode) {
+    async getMyShortDescription(params) {
         await this.assertBot("getMyShortDescription");
-        return await this.getMyInfo(languageCode).then((v) => v.about);
+        return await this.getMyInfo(params?.languageCode).then((v) => v.about);
     }
 }