@mtkruto/node 0.1.105 → 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.105";
+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.105";
+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,15 +2,15 @@ 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";
 import { AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, ClientParams, DownloadParams, EditMessageParams, FilterableUpdates, FilterUpdate, ForwardMessagesParams, GetMyCommandsParams, Handler, ParseMode, SendMessagesParams, SendPollParams, SetMyCommandsParams, Update, UploadParams } from "./3_types.js";
-export declare const getEntity: unique symbol;
-export declare const getStickerSetName: unique symbol;
+declare const getEntity: unique symbol;
+declare const getStickerSetName: unique symbol;
 export declare const handleMigrationError: unique symbol;
-export declare const getMessageWithReply: unique symbol;
+declare const getMessageWithReply: unique symbol;
 export declare const restartAuth: unique symbol;
 export declare class ConnectionError extends Error {
 }
@@ -126,76 +126,104 @@ export declare class Client extends ClientAbstract {
     private getChannelAccessHash;
     getInputPeer(id: ChatID): Promise<types.InputPeerChat | types.InputPeerUser | types.InputPeerChannel>;
     private getInputPeerInner;
-    [getEntity](peer: types.PeerUser): Promise<types.User | null>;
-    [getEntity](peer: types.PeerChat): Promise<types.Chat | null>;
-    [getEntity](peer: types.PeerChannel): Promise<types.Channel | null>;
+    private [getEntity];
+    private [getEntity];
+    private [getEntity];
     processResult(result: ReadObject): Promise<void>;
     private updatesToMessages;
     private resolveSendAs;
     /**
      * Send a text message.
      *
+     * @method
      * @param chatId The chat to send the message to.
      * @param text The message's text.
+     * @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.
+     * @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.
+     * @example ```ts
+     * const message = await client.getMessages("@MTKruto", [210, 212]);
+     * ```
+     * @returns The retrieved messages.
      */
-    getMessages(chatId_: ChatID, messageIds: number[]): Promise<Omit<Message, "replyToMessage">[]>;
-    [getMessageWithReply](chatId: ChatID, messageId: number): Promise<Message | null>;
+    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.
+     * @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.
      *
+     * @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>>;
-    [getStickerSetName](inputStickerSet: types.InputStickerSetID, hash?: number): Promise<string>;
+    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.
+     * @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.
+     * @returns The forwarded message.
      */
     forwardMessage(from: ChatID, to: ChatID, messageId: number, params?: ForwardMessagesParams): Promise<Message>;
     /**
      * Get information on the currently authorized user.
+     *
+     * @method
      */
-    getMe(): Promise<import("../3_types.js").User>;
+    getMe(): Promise<User>;
     private handleUpdate;
     /**
      * Answer a callback query. Bot-only.
      *
+     * @method
      * @param id ID of the callback query to answer.
      */
     answerCallbackQuery(id: string, params?: AnswerCallbackQueryParams): Promise<void>;
@@ -205,28 +233,35 @@ 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.
+     * @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.
      */
-    sendChatAction(chatId: ChatID, action_: ChatAction, messageThreadId?: number): Promise<void>;
+    sendChatAction(chatId: ChatID, action: ChatAction, params?: {
+        messageThreadId?: number;
+    }): Promise<void>;
     /**
      * Upload a 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.
      *
+     * @method
      * @param commands The commands to set.
      */
     setMyCommands(commands: BotCommand[], params?: SetMyCommandsParams): Promise<void>;
@@ -237,6 +272,7 @@ 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.
      */
@@ -250,6 +286,8 @@ export declare class Client extends ClientAbstract {
     private setMyInfo;
     /**
      * Set the bot's description in the given language. Bot-only.
+     *
+     * @method
      */
     setMyDescription({ description, languageCode }: {
         description?: string;
@@ -257,6 +295,8 @@ export declare class Client extends ClientAbstract {
     }): Promise<void>;
     /**
      * Set the bot's name in the given language. Bot-only.
+     *
+     * @method
      */
     setMyName({ name, languageCode }: {
         name?: string;
@@ -264,6 +304,8 @@ export declare class Client extends ClientAbstract {
     }): Promise<void>;
     /**
      * Set the bot's short description in the given language. Bot-only.
+     *
+     * @method
      */
     setMyShortDescription({ shortDescription: about, languageCode }: {
         shortDescription?: string;
@@ -272,14 +314,27 @@ export declare class Client extends ClientAbstract {
     private getMyInfo;
     /**
      * Get the bot's description in the given language. Bot-only.
+     *
+     * @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

@@ -18,10 +18,10 @@ const dGapC = debug("Client/recoverChannelUpdateGap");
 const dAuth = debug("Client/authorize");
 const dRecv = debug("Client/receiveLoop");
 const dUpload = debug("Client/upload");
-export const getEntity = Symbol();
-export const getStickerSetName = Symbol();
+const getEntity = Symbol();
+const getStickerSetName = Symbol();
 export const handleMigrationError = Symbol();
-export const getMessageWithReply = Symbol();
+const getMessageWithReply = Symbol();
 export const restartAuth = Symbol();
 export class ConnectionError extends Error {
 }
@@ -1239,8 +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.
+     * @returns The sent text message.
      */
     async sendMessage(chatId, text, params) {
         const [message, entities] = this.parseText(text, params);
@@ -1291,9 +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.
+     * @returns The edited text message.
      */
     async editMessageText(chatId, messageId, text, params) {
         const [message, entities] = this.parseText(text, params);
@@ -1348,11 +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.
+     * @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]);
@@ -1361,8 +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.
+     * @example ```ts
+     * const message = await client.getMessage("@MTKruto", 212);
+     * ```
+     * @returns The retrieved message.
      */
     async getMessage(chatId, messageId) {
         const messages = await this.getMessages(chatId, [messageId]);
@@ -1412,7 +1426,14 @@ export class Client extends ClientAbstract {
     /**
      * Download a file.
      *
+     * @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);
@@ -1454,9 +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.
+     * @returns The forwarded messages.
      */
     async forwardMessages(from, to, messageIds, params) {
         const result = await this.invoke(new functions.MessagesForwardMessages({
@@ -1476,15 +1499,19 @@ 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.
+     * @returns The forwarded message.
      */
     async forwardMessage(from, to, messageId, params) {
         return await this.forwardMessages(from, to, [messageId], params).then((v) => v[0]);
     }
     /**
      * Get information on the currently authorized user.
+     *
+     * @method
      */
     async getMe() {
         const users = await this.invoke(new functions.UsersGetUsers({ id: [new types.InputUserSelf()] }));
@@ -1592,6 +1619,7 @@ export class Client extends ClientAbstract {
     /**
      * Answer a callback query. Bot-only.
      *
+     * @method
      * @param id ID of the callback query to answer.
      */
     async answerCallbackQuery(id, params) {
@@ -1618,9 +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.
+     * @returns The sent poll.
      */
     async sendPoll(chatId, question, options, params) {
         const peer = await this.getInputPeer(chatId);
@@ -1670,54 +1700,56 @@ 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.
      */
-    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.
      *
+     * @method
      * @param contents The contents of the file.
      */
     async upload(contents, params) {
@@ -1808,6 +1840,7 @@ export class Client extends ClientAbstract {
     /**
      * Set the bot's commands in the given scope and/or language. Bot-only.
      *
+     * @method
      * @param commands The commands to set.
      */
     async setMyCommands(commands, params) {
@@ -1830,6 +1863,7 @@ 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.
      */
@@ -1896,6 +1930,8 @@ export class Client extends ClientAbstract {
     }
     /**
      * Set the bot's description in the given language. Bot-only.
+     *
+     * @method
      */
     async setMyDescription({ description, languageCode }) {
         await this.assertBot("setMyDescription");
@@ -1903,6 +1939,8 @@ export class Client extends ClientAbstract {
     }
     /**
      * Set the bot's name in the given language. Bot-only.
+     *
+     * @method
      */
     async setMyName({ name, languageCode }) {
         await this.assertBot("setMyName");
@@ -1910,6 +1948,8 @@ export class Client extends ClientAbstract {
     }
     /**
      * Set the bot's short description in the given language. Bot-only.
+     *
+     * @method
      */
     async setMyShortDescription({ shortDescription: about, languageCode }) {
         await this.assertBot("setMyShortDescription");
@@ -1920,23 +1960,29 @@ export class Client extends ClientAbstract {
     }
     /**
      * Get the bot's description in the given language. Bot-only.
+     *
+     * @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);
     }
 }