@mtkruto/node 0.1.153 → 0.1.156

package/script/client/2_message_manager.js

@@ -10,7 +10,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 _MessageManager_instances, _MessageManager_c, _MessageManager_updatesToMessages, _MessageManager_constructReplyMarkup, _MessageManager_resolveSendAs, _MessageManager_constructReplyTo, _MessageManager_sendDocumentInner, _MessageManager_sendMedia, _MessageManager_sendReaction, _MessageManager_toggleJoinRequests;
+var _MessageManager_instances, _MessageManager_c, _MessageManager_LresolveFileId, _MessageManager_updatesToMessages, _MessageManager_constructReplyMarkup, _MessageManager_resolveSendAs, _MessageManager_constructReplyTo, _MessageManager_sendDocumentInner, _MessageManager_sendMedia, _MessageManager_sendReaction, _MessageManager_toggleJoinRequests;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessageManager = void 0;
 const _0_deps_js_1 = require("../0_deps.js");
@@ -22,11 +22,11 @@ const _4_constants_js_1 = require("../4_constants.js");
 const _0_message_search_filter_js_1 = require("../types/0_message_search_filter.js");
 const _0_html_js_1 = require("./0_html.js");
 const _0_utilities_js_1 = require("./0_utilities.js");
-const d = (0, _0_deps_js_1.debug)("MessageManager");
 class MessageManager {
     constructor(c) {
         _MessageManager_instances.add(this);
         _MessageManager_c.set(this, void 0);
+        _MessageManager_LresolveFileId.set(this, void 0);
         Object.defineProperty(this, "usernameResolver", {
             enumerable: true,
             configurable: true,
@@ -37,6 +37,8 @@ class MessageManager {
             }
         });
         __classPrivateFieldSet(this, _MessageManager_c, c, "f");
+        const L = (0, _1_utilities_js_1.getLogger)("MessageManager").client(c.id);
+        __classPrivateFieldSet(this, _MessageManager_LresolveFileId, L.branch("resolveFileId"), "f");
     }
     async getMessages(chatId, messageIds) {
         const peer = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId);
@@ -430,7 +432,7 @@ class MessageManager {
             fileId = _3_types_js_2.FileID.decode(maybeFileId);
         }
         catch (err) {
-            d("fileId: %o", err);
+            __classPrivateFieldGet(this, _MessageManager_LresolveFileId, "f").warning(err);
         }
         if (fileId != null) {
             if (fileId.fileType != expectedFileType) {
@@ -896,9 +898,85 @@ class MessageManager {
         }
         return messages;
     }
+    async setBoostsRequiredToCircumventRestrictions(chatId, boosts) {
+        const channel = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputChannel(chatId);
+        await __classPrivateFieldGet(this, _MessageManager_c, "f").api.channels.setBoostsToUnblockRestrictions({ channel, boosts });
+    }
+    async createInviteLink(chatId, params) {
+        if (params?.requireApproval && params?.limit) {
+            throw new Error("createInviteLink: requireApproval cannot be true while limit is specified");
+        }
+        const result = await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.exportChatInvite({
+            peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId),
+            title: params?.title,
+            expire_date: params?.expireAt ? (0, _1_utilities_js_1.toUnixTimestamp)(params.expireAt) : undefined,
+            request_needed: params?.requireApproval ? true : undefined,
+            usage_limit: params?.limit,
+        });
+        return await (0, _3_types_js_1.constructInviteLink)(result[_2_tl_js_1.as](_2_tl_js_1.types.ChatInviteExported), __classPrivateFieldGet(this, _MessageManager_c, "f").getEntity);
+    }
+    async getCreatedInviteLinks(chatId, params) {
+        await __classPrivateFieldGet(this, _MessageManager_c, "f").storage.assertUser("getCreatedInviteLinks");
+        const { invites } = await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.getExportedChatInvites({
+            peer: await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId),
+            revoked: params?.revoked ? true : undefined,
+            admin_id: params?.by ? await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputUser(params.by) : new _2_tl_js_1.types.InputUserEmpty(),
+            limit: params?.limit ?? 100,
+            offset_date: params?.afterDate ? (0, _1_utilities_js_1.toUnixTimestamp)(params.afterDate) : undefined,
+            offset_link: params?.afterInviteLink,
+        });
+        return await Promise.all(invites.map((v) => v[_2_tl_js_1.as](_2_tl_js_1.types.ChatInviteExported)).map((v) => (0, _3_types_js_1.constructInviteLink)(v, __classPrivateFieldGet(this, _MessageManager_c, "f").getEntity)));
+    }
+    async joinChat(chatId) {
+        await __classPrivateFieldGet(this, _MessageManager_c, "f").storage.assertUser("joinChat");
+        const peer = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId);
+        if (peer instanceof _2_tl_js_1.types.InputPeerUser) {
+            throw new Error("joinChat: cannot join private chats");
+        }
+        else if (peer instanceof _2_tl_js_1.types.InputPeerChannel) {
+            await __classPrivateFieldGet(this, _MessageManager_c, "f").api.channels.joinChannel({ channel: new _2_tl_js_1.types.InputChannel(peer) });
+        }
+        else if (peer instanceof _2_tl_js_1.types.InputPeerChat) {
+            await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.addChatUser({ chat_id: peer.chat_id, user_id: new _2_tl_js_1.types.InputUserSelf(), fwd_limit: 0 }); // TODO: use potential high-level method for adding participants to chats
+        }
+        else {
+            (0, _1_utilities_js_1.UNREACHABLE)();
+        }
+    }
+    async leaveChat(chatId) {
+        const peer = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(chatId);
+        if (peer instanceof _2_tl_js_1.types.InputPeerUser) {
+            throw new Error("leaveChat: cannot leave private chats");
+        }
+        else if (peer instanceof _2_tl_js_1.types.InputPeerChannel) {
+            await __classPrivateFieldGet(this, _MessageManager_c, "f").api.channels.leaveChannel({ channel: new _2_tl_js_1.types.InputChannel(peer) });
+        }
+        else if (peer instanceof _2_tl_js_1.types.InputPeerChat) {
+            await __classPrivateFieldGet(this, _MessageManager_c, "f").api.messages.deleteChatUser({ chat_id: peer.chat_id, user_id: new _2_tl_js_1.types.InputUserSelf() }); // TODO: use potential high-level method for adding participants to chats
+        }
+        else {
+            (0, _1_utilities_js_1.UNREACHABLE)();
+        }
+    }
+    async blockUser(userId) {
+        await __classPrivateFieldGet(this, _MessageManager_c, "f").storage.assertUser("blockUser");
+        const id = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(userId);
+        if (!(id instanceof _2_tl_js_1.types.User)) {
+            throw new Error("blockUser: only users can be blocked or unblocked");
+        }
+        await __classPrivateFieldGet(this, _MessageManager_c, "f").api.contacts.block({ id });
+    }
+    async unblockUser(userId) {
+        await __classPrivateFieldGet(this, _MessageManager_c, "f").storage.assertUser("unblockUser");
+        const id = await __classPrivateFieldGet(this, _MessageManager_c, "f").getInputPeer(userId);
+        if (!(id instanceof _2_tl_js_1.types.User)) {
+            throw new Error("unblockUser: only users can be blocked or unblocked");
+        }
+        await __classPrivateFieldGet(this, _MessageManager_c, "f").api.contacts.unblock({ id });
+    }
 }
 exports.MessageManager = MessageManager;
-_MessageManager_c = new WeakMap(), _MessageManager_instances = new WeakSet(), _MessageManager_updatesToMessages = async function _MessageManager_updatesToMessages(chatId, updates) {
+_MessageManager_c = new WeakMap(), _MessageManager_LresolveFileId = new WeakMap(), _MessageManager_instances = new WeakSet(), _MessageManager_updatesToMessages = async function _MessageManager_updatesToMessages(chatId, updates) {
     const messages = new Array();
     if (updates instanceof _2_tl_js_1.types.Updates) {
         for (const update of updates.updates) {

package/script/client/3_chat_list_manager.js

@@ -10,19 +10,18 @@ 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 _ChatListManager_instances, _ChatListManager_c, _ChatListManager_sendChatUpdate, _ChatListManager_chats, _ChatListManager_archivedChats, _ChatListManager_chatsLoadedFromStorage, _ChatListManager_tryGetChatId, _ChatListManager_getChatAnywhere, _ChatListManager_getChatList, _ChatListManager_loadChatsFromStorage, _ChatListManager_getLoadedChats, _ChatListManager_pinnedChats, _ChatListManager_pinnedArchiveChats, _ChatListManager_storageHadPinnedChats, _ChatListManager_pinnedChatsLoaded, _ChatListManager_loadPinnedChats, _ChatListManager_fetchPinnedChats, _ChatListManager_getPinnedChats, _ChatListManager_updateOrAddChat, _ChatListManager_removeChat, _ChatListManager_handleUpdateFolderPeers, _ChatListManager_handleUpdatePinnedDialogs, _ChatListManager_handleUpdateChannel, _ChatListManager_handleUpdateChat, _ChatListManager_handleUpdateUser, _ChatListManager_fetchChats;
+var _ChatListManager_instances, _ChatListManager_c, _ChatListManager_LgetChats, _ChatListManager_sendChatUpdate, _ChatListManager_chats, _ChatListManager_archivedChats, _ChatListManager_chatsLoadedFromStorage, _ChatListManager_tryGetChatId, _ChatListManager_getChatAnywhere, _ChatListManager_getChatList, _ChatListManager_loadChatsFromStorage, _ChatListManager_getLoadedChats, _ChatListManager_pinnedChats, _ChatListManager_pinnedArchiveChats, _ChatListManager_storageHadPinnedChats, _ChatListManager_pinnedChatsLoaded, _ChatListManager_loadPinnedChats, _ChatListManager_fetchPinnedChats, _ChatListManager_getPinnedChats, _ChatListManager_updateOrAddChat, _ChatListManager_removeChat, _ChatListManager_handleUpdateFolderPeers, _ChatListManager_handleUpdatePinnedDialogs, _ChatListManager_handleUpdateChannel, _ChatListManager_handleUpdateChat, _ChatListManager_handleUpdateUser, _ChatListManager_fetchChats;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChatListManager = void 0;
-const _0_deps_js_1 = require("../0_deps.js");
 const _1_utilities_js_1 = require("../1_utilities.js");
 const _2_tl_js_1 = require("../2_tl.js");
 const _3_types_js_1 = require("../3_types.js");
 const _0_utilities_js_1 = require("./0_utilities.js");
-const d = (0, _0_deps_js_1.debug)("ChatListManager");
 class ChatListManager {
     constructor(c) {
         _ChatListManager_instances.add(this);
         _ChatListManager_c.set(this, void 0);
+        _ChatListManager_LgetChats.set(this, void 0);
         _ChatListManager_chats.set(this, new Map());
         _ChatListManager_archivedChats.set(this, new Map());
         _ChatListManager_chatsLoadedFromStorage.set(this, false);
@@ -31,6 +30,8 @@ class ChatListManager {
         _ChatListManager_storageHadPinnedChats.set(this, false);
         _ChatListManager_pinnedChatsLoaded.set(this, false);
         __classPrivateFieldSet(this, _ChatListManager_c, c, "f");
+        const L = (0, _1_utilities_js_1.getLogger)("ChatListManager").client(c.id);
+        __classPrivateFieldSet(this, _ChatListManager_LgetChats, L.branch("getChats"), "f");
     }
     async reassignChatLastMessage(chatId, add = false, sendUpdate = true) {
         try {
@@ -112,7 +113,7 @@ class ChatListManager {
                 .filter((v) => v.order < after.order);
         }
         if (chats.length < limit) {
-            d("have only %d chats but %d more is needed", chats.length, limit - chats.length);
+            __classPrivateFieldGet(this, _ChatListManager_LgetChats, "f").debug(`have only ${chats.length} chats but ${limit - chats.length} more is needed`);
             if (!await __classPrivateFieldGet(this, _ChatListManager_c, "f").storage.hasAllChats(listId)) {
                 await __classPrivateFieldGet(this, _ChatListManager_instances, "m", _ChatListManager_fetchChats).call(this, listId, limit, after);
                 return await this.getChats(from, after, limit);
@@ -217,7 +218,7 @@ class ChatListManager {
     }
 }
 exports.ChatListManager = ChatListManager;
-_ChatListManager_c = new WeakMap(), _ChatListManager_chats = new WeakMap(), _ChatListManager_archivedChats = new WeakMap(), _ChatListManager_chatsLoadedFromStorage = new WeakMap(), _ChatListManager_pinnedChats = new WeakMap(), _ChatListManager_pinnedArchiveChats = new WeakMap(), _ChatListManager_storageHadPinnedChats = new WeakMap(), _ChatListManager_pinnedChatsLoaded = new WeakMap(), _ChatListManager_instances = new WeakSet(), _ChatListManager_sendChatUpdate = async function _ChatListManager_sendChatUpdate(chatId, added) {
+_ChatListManager_c = new WeakMap(), _ChatListManager_LgetChats = new WeakMap(), _ChatListManager_chats = new WeakMap(), _ChatListManager_archivedChats = new WeakMap(), _ChatListManager_chatsLoadedFromStorage = new WeakMap(), _ChatListManager_pinnedChats = new WeakMap(), _ChatListManager_pinnedArchiveChats = new WeakMap(), _ChatListManager_storageHadPinnedChats = new WeakMap(), _ChatListManager_pinnedChatsLoaded = new WeakMap(), _ChatListManager_instances = new WeakSet(), _ChatListManager_sendChatUpdate = async function _ChatListManager_sendChatUpdate(chatId, added) {
     try {
         await __classPrivateFieldGet(this, _ChatListManager_c, "f").storage.assertUser("");
     }

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

@@ -1,13 +1,13 @@
 import { MaybePromise } from "../1_utilities.js";
-import { functions, types } from "../2_tl.js";
+import { enums, functions, types } from "../2_tl.js";
 import { Storage } from "../3_storage.js";
 import { DC } from "../3_transport.js";
 import { InactiveChat } from "../3_types.js";
-import { BotCommand, Chat, ChatAction, ChatMember, ChatP, Document, FileSource, ID, InlineQueryResult, InputStoryContent, Message, MessageAnimation, MessageAudio, MessageContact, MessageDice, MessageDocument, MessageLocation, MessagePhoto, MessagePoll, MessageText, MessageVenue, MessageVideo, MessageVideoNote, MessageVoice, NetworkStatistics, ParseMode, Reaction, Story, Update, UpdateIntersection, User } from "../3_types.js";
+import { BotCommand, Chat, ChatAction, ChatMember, ChatP, Document, FileSource, ID, InlineQueryResult, InputStoryContent, InviteLink, Message, MessageAnimation, MessageAudio, MessageContact, MessageDice, MessageDocument, MessageLocation, MessagePhoto, MessagePoll, MessageText, MessageVenue, MessageVideo, MessageVideoNote, MessageVoice, NetworkStatistics, ParseMode, Reaction, Story, Update, UpdateIntersection, User } from "../3_types.js";
 import { Migrate } from "../4_errors.js";
 import { ClientAbstract } from "./0_client_abstract.js";
 import { FilterQuery, WithFilter } from "./0_filters.js";
-import { AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, BanChatMemberParams, CreateStoryParams, DeleteMessageParams, DeleteMessagesParams, DownloadParams, EditMessageParams, EditMessageReplyMarkupParams, ForwardMessagesParams, GetChatsParams, GetHistoryParams, GetMyCommandsParams, PinMessageParams, ReplyParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendContactParams, SendDiceParams, SendDocumentParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetChatMemberRightsParams, SetChatPhotoParams, SetMyCommandsParams, SetReactionsParams, UploadParams } from "./0_params.js";
+import { AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, BanChatMemberParams, CreateInviteLinkParams, CreateStoryParams, DeleteMessageParams, DeleteMessagesParams, DownloadParams, EditMessageParams, EditMessageReplyMarkupParams, ForwardMessagesParams, GetChatsParams, GetCreatedInviteLinksParams, GetHistoryParams, GetMyCommandsParams, PinMessageParams, ReplyParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendContactParams, SendDiceParams, SendDocumentParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetChatMemberRightsParams, SetChatPhotoParams, SetMyCommandsParams, SetReactionsParams, UploadParams } from "./0_params.js";
 import { Api } from "./0_types.js";
 import { Composer, Middleware } from "./1_composer.js";
 import { ClientPlainParams } from "./2_client_plain.js";
@@ -133,6 +133,20 @@ export interface Context {
     setChatMemberRights: (memberId: ID, params?: SetChatMemberRightsParams) => Promise<void>;
     /** Delete all messages sent by a specific member of the chat which the message was received from. */
     deleteChatMemberMessages: (userId: ID) => Promise<void>;
+    /** Search the messages of the chat which the message was received from. */
+    searchMessages: (query: string, params?: SearchMessagesParams) => Promise<Message[]>;
+    /** Set the number of boosts required to circument the chat's default restrictions. */
+    setBoostsRequiredToCircumventRestrictions: (boosts: number) => Promise<void>;
+    /** Create an invite link for the chat which the message was received from. */
+    createInviteLink: (params?: CreateInviteLinkParams) => Promise<InviteLink>;
+    /** Get the invite links that were created for the chat which the message was received from. */
+    getCreatedInviteLinks: (params?: GetCreatedInviteLinksParams) => Promise<InviteLink[]>;
+    /** Leave the chat which the message was received from. */
+    leave: () => Promise<void>;
+    /** Block the user who sent the message. User-only. */
+    block: () => Promise<void>;
+    /** Unblock the user who sent the message. */
+    unblock: () => Promise<void>;
     toJSON: () => Update;
 }
 export declare function skipInvoke<C extends Context>(): InvokeErrorHandler<Client<C>>;
@@ -182,11 +196,11 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
     /**
      * Constructs the client.
      *
-     * @param storage The storage provider to use. Defaults to memory storage.
+     * @param storage The storage provider to use. Defaults to memory storage. Passing a string constructs a memory storage with the string being the string session.
      * @param apiId App's API ID from [my.telegram.org](https://my.telegram.org/apps). Defaults to 0 (unset).
      * @param apiHash App's API hash from [my.telegram.org/apps](https://my.telegram.org/apps). Defaults to empty string (unset).
      */
-    constructor(storage?: Storage | null, apiId?: number | null, apiHash?: string | null, params?: ClientParams);
+    constructor(storage?: Storage | string | null, apiId?: number | null, apiHash?: string | null, params?: ClientParams);
     api: Api;
     protected stateChangeHandler: (connected: boolean) => void;
     /**
@@ -233,31 +247,33 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param function_ The function to invoke.
      */
     invoke: {
-        <T extends import("../tl/2_types.js").Type_ | functions.Function<unknown> = functions.Function<unknown>>(function_: T): Promise<T extends functions.Function<unknown> ? T["__R"] : void>;
-        <T_1 extends import("../tl/2_types.js").Type_ | functions.Function<unknown> = functions.Function<unknown>>(function_: T_1, noWait: true): Promise<void>;
-    } & {
-        use: (handler: InvokeErrorHandler<Client<C>>) => void;
+        <T extends (functions.Function<unknown> | types.Type) = functions.Function<unknown>>(function_: T): Promise<T extends functions.Function<unknown> ? T["__R"] : void>;
+        <T extends (functions.Function<unknown> | types.Type) = functions.Function<unknown>>(function_: T, noWait: true): Promise<void>;
+        <T extends (functions.Function<unknown> | types.Type) = functions.Function<unknown>>(function_: T, noWait?: boolean): Promise<T | void>;
+        use(handler: InvokeErrorHandler<Client<C>>): void;
     };
     /**
      * Alias for `invoke` with its second parameter being `true`.
      */
     send<T extends (functions.Function<unknown> | types.Type) = functions.Function<unknown>>(function_: T): Promise<void>;
-    getInputPeer(id: ID): Promise<import("../tl/2_types.js").InputPeerSelf_ | import("../tl/2_types.js").InputPeerChat_ | import("../tl/2_types.js").InputPeerUser_ | import("../tl/2_types.js").InputPeerChannel_>;
-    getInputChannel(id: ID): Promise<import("../tl/2_types.js").InputChannel_>;
-    getInputUser(id: ID): Promise<import("../tl/2_types.js").InputUser_>;
+    exportAuthString(): Promise<string>;
+    importAuthString(authString: string): Promise<void>;
+    getInputPeer(id: ID): Promise<enums.InputPeer>;
+    getInputChannel(id: ID): Promise<types.InputChannel>;
+    getInputUser(id: ID): Promise<types.InputUser>;
     private [getEntity];
     private [getEntity];
     private [getEntity];
     private [getEntity];
-    use(...middleware: Middleware<UpdateIntersection<C>>[]): Composer<UpdateIntersection<C>>;
-    branch(predicate: (ctx: UpdateIntersection<C>) => MaybePromise<boolean>, trueHandler_: Middleware<UpdateIntersection<C>>, falseHandler_: Middleware<UpdateIntersection<C>>): Composer<UpdateIntersection<C>>;
+    use(...middleware: Middleware<UpdateIntersection<C>>[]): Composer<C>;
+    branch(predicate: (ctx: UpdateIntersection<C>) => MaybePromise<boolean>, trueHandler_: Middleware<UpdateIntersection<C>>, falseHandler_: Middleware<UpdateIntersection<C>>): Composer<C>;
     filter<D extends C>(predicate: (ctx: UpdateIntersection<C>) => ctx is D, ...middleware: Middleware<D>[]): Composer<D>;
     filter(predicate: (ctx: UpdateIntersection<C>) => MaybePromise<boolean>, ...middleware: Middleware<UpdateIntersection<C>>[]): Composer<C>;
     on<Q extends FilterQuery>(filter: Q, ...middleawre: Middleware<WithFilter<C, Q>>[]): Composer<UpdateIntersection<WithFilter<C, Q>>>;
     command(commands: string | RegExp | (string | RegExp)[] | {
         names: string | RegExp | (string | RegExp)[];
         prefixes: string | string[];
-    }, ...middleawre: Middleware<WithFilter<C, "message:text">>[]): Composer<UpdateIntersection<WithFilter<C, "message:text">>>;
+    }, ...middleawre: Middleware<WithFilter<C, "message:text">>[]): Composer<WithFilter<C, "message:text">>;
     /**
      * Send a text message.
      *
@@ -397,8 +413,9 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      *
      * @method fs
      * @param contents The contents of the file.
+     * @returns The uploaded file.
      */
-    upload(contents: Uint8Array, params?: UploadParams): Promise<import("../tl/2_types.js").InputFile_ | import("../tl/2_types.js").InputFileBig_>;
+    upload(contents: Uint8Array, params?: UploadParams): Promise<any>;
     /**
      * Set the bot's commands in the given scope and/or language. Bot-only.
      *
@@ -410,6 +427,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * Get the bot's commands in the given scope and/or language. Bot-only.
      *
      * @method bs
+     * @returns The current bot's commands in the specified language.
      */
     getMyCommands(params?: GetMyCommandsParams): Promise<BotCommand[]>;
     /**
@@ -451,14 +469,16 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * Get the bot's description in the given language. Bot-only.
      *
      * @method bs
+     * @returns The current bot's description in the specified language.
      */
     getMyDescription(params?: {
         languageCode?: string;
     }): Promise<string>;
     /**
-     * Set the bot's name in the given language. Bot-only.
+     * Get the bot's name in the given language. Bot-only.
      *
      * @method bs
+     * @returns The current bot's name in the specified language.
      */
     getMyName(params?: {
         languageCode?: string;
@@ -467,6 +487,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * Get the bot's short description in the given language. Bot-only.
      *
      * @method bs
+     * @returns The current bot's short description in the specified language.
      */
     getMyShortDescription(params?: {
         languageCode?: string;
@@ -493,6 +514,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @method ms
      * @param chatId The chat to send the photo to.
      * @param photo The photo to send.
+     * @returns The sent photo.
      */
     sendPhoto(chatId: ID, photo: FileSource, params?: SendPhotoParams): Promise<MessagePhoto>;
     /**
@@ -501,6 +523,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @method ms
      * @param chatId The chat to send the document to.
      * @param document The document to send.
+     * @returns The sent document.
      */
     sendDocument(chatId: ID, document: FileSource, params?: SendDocumentParams): Promise<MessageDocument>;
     /**
@@ -509,6 +532,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @method ms
      * @param chatId The chat to send the video to.
      * @param video The video to send.
+     * @returns The sent video.
      */
     sendVideo(chatId: ID, video: FileSource, params?: SendVideoParams): Promise<MessageVideo>;
     /**
@@ -517,6 +541,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @method ms
      * @param chatId The chat to send the animation to.
      * @param animation The animation to send.
+     * @returns The sent animation.
      */
     sendAnimation(chatId: ID, animation: FileSource, params?: SendAnimationParams): Promise<MessageAnimation>;
     /**
@@ -525,6 +550,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @method ms
      * @param chatId The chat to send the voice message to.
      * @param voice The voice to send.
+     * @returns The sent voice message.
      */
     sendVoice(chatId: ID, voice: FileSource, params?: SendVoiceParams): Promise<MessageVoice>;
     /**
@@ -533,6 +559,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @method ms
      * @param chatId The chat to send the audio file to.
      * @param audio The audio to send.
+     * @returns The sent audio filr.
      */
     sendAudio(chatId: ID, audio: FileSource, params?: SendAudioParams): Promise<MessageAudio>;
     /**
@@ -541,6 +568,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @method ms
      * @param chatId The chat to send the video note to.
      * @param videoNote The video note to send.
+     * @returns The sent video note.
      */
     sendVideoNote(chatId: ID, videoNote: FileSource, params?: SendVideoNoteParams): Promise<MessageVideoNote>;
     /**
@@ -550,6 +578,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param chatId The chat to send the location to.
      * @param latitude The location's latitude.
      * @param longitude The location's longitude.
+     * @returns The sent location.
      */
     sendLocation(chatId: ID, latitude: number, longitude: number, params?: SendLocationParams): Promise<MessageLocation>;
     /**
@@ -559,6 +588,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param chatId The chat to send the contact to.
      * @param firstName The contact's first name.
      * @param number The contact's phone number.
+     * @returns The sent contact.
      */
     sendContact(chatId: ID, firstName: string, number: string, params?: SendContactParams): Promise<MessageContact>;
     /**
@@ -566,6 +596,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      *
      * @method ms
      * @param chatId The chat to send the dice to.
+     * @returns The sent dice.
      */
     sendDice(chatId: ID, params?: SendDiceParams): Promise<MessageDice>;
     /**
@@ -577,6 +608,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param longitude The longitude of the venue.
      * @param title The title of the venue.
      * @param address The written address of the venue.
+     * @returns The sent venue.
      */
     sendVenue(chatId: ID, latitude: number, longitude: number, title: string, address: string, params?: SendVenueParams): Promise<MessageVenue>;
     /**
@@ -609,6 +641,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      *
      * @method fs
      * @param id Identifier of one or more of custom emojis.
+     * @returns The custom emoji documents.
      */
     getCustomEmojiDocuments(id: string | string[]): Promise<Document[]>;
     /**
@@ -729,6 +762,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      *
      * @method ch
      * @param chatId The identifier of the chat.
+     * @returns The chat's administrators.
      */
     getChatAdministrators(chatId: ID): Promise<ChatMember[]>;
     /**
@@ -753,6 +787,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @method st
      * @param chatId The identifier of the chat to retrieve the story from.
      * @param storyId The identifier of the story to retrieve.
+     * @returns The retrieved story.
      */
     getStory(chatId: ID, storyId: number): Promise<Story | null>;
     /**
@@ -839,6 +874,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @method ac
      * @param id `"me"`, a bot ID, a supergroup ID, or a channel ID.
      * @param order The new order to use.
+     * @returns Whether the order was changed.
      */
     reorderUsernames(id: ID, order: string[]): Promise<boolean>;
     /**
@@ -852,6 +888,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * Get inactive chats. User-only.
      *
      * @method ch
+     * @retuns A list of inactive chats the current user is member of.
      */
     getInactiveChats(): Promise<InactiveChat[]>;
     /**
@@ -862,5 +899,57 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param query The message search query.
      */
     searchMessages(chatId: ID, query: string, params?: SearchMessagesParams): Promise<Message[]>;
+    /**
+     * Set the number of boosts required to circument a chat's default restrictions.
+     *
+     * @method ch
+     * @param chatId The identifier of the chat.
+     * @param boosts The number of boosts required to circumvent its restrictions.
+     */
+    setBoostsRequiredToCircumventRestrictions(chatId: ID, boosts: number): Promise<void>;
+    /**
+     * Create an invite link.
+     *
+     * @method ch
+     * @param chatId The identifier of the chat to create the invite link for.
+     * @returns The newly created invite link.
+     */
+    createInviteLink(chatId: ID, params?: CreateInviteLinkParams): Promise<InviteLink>;
+    /**
+     * Get the invite links created for a chat. User-only.
+     *
+     * @method ch
+     * @param chatId The identifier of the chat.
+     * @returns The invite links created for the chat. This might be a subset of the results if they were less than `limit`. The parameters `afterDate` and `afterInviteLink` can be used for pagination.
+     */
+    getCreatedInviteLinks(chatId: ID, params?: GetCreatedInviteLinksParams): Promise<InviteLink[]>;
+    /**
+     * Join a chat. User-only.
+     *
+     * @method ch
+     * @param chatId The identifier of the chat to join.
+     */
+    joinChat(chatId: ID): Promise<void>;
+    /**
+     * Leave a chat.
+     *
+     * @method ch
+     * @param chatId The identifier of the chat to leave.
+     */
+    leaveChat(chatId: ID): Promise<void>;
+    /**
+     * Block a user. User-only.
+     *
+     * @method mc
+     * @param userId The identifier of the user to block.
+     */
+    blockUser(userId: ID): Promise<void>;
+    /**
+     * Unblock a user. User-only.
+     *
+     * @method mc
+     * @param userId The identifier of the user to unblock.
+     */
+    unblockUser(userId: ID): Promise<void>;
 }
 export {};