@mtkruto/browser 0.6.1 → 0.119.1

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

@@ -0,0 +1,86 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 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 { Api } from "../2_tl.js";
+import { type ChatP, type SlowModeDuration } from "../3_types.js";
+import { type FileSource, type ID, type Reaction, type Update } from "../3_types.js";
+import type { AddChatMemberParams, ApproveJoinRequestsParams, BanChatMemberParams, CreateInviteLinkParams, DeclineJoinRequestsParams, EnableSignaturesParams, GetCreatedInviteLinksParams, GetJoinRequestsParams, PromoteChatMemberParams, SetChatMemberRightsParams, SetChatMemberTagParams, SetChatPhotoParams } from "./0_params.js";
+import type { UpdateProcessor } from "./0_update_processor.js";
+import type { C as C_ } from "./1_types.js";
+import type { FileManager } from "./2_file_manager.js";
+import type { MessageManager } from "./3_message_manager.js";
+interface C extends C_ {
+    fileManager: FileManager;
+    messageManager: MessageManager;
+}
+declare const chatManagerUpdates: readonly ["updateChannelParticipant", "updateChatParticipant", "updateBotChatInviteRequester"];
+type ChatManagerUpdate = Api.Types[(typeof chatManagerUpdates)[number]];
+export declare class ChatManager implements UpdateProcessor<ChatManagerUpdate, true> {
+    #private;
+    constructor(c: C);
+    canHandleUpdate(update: Api.Update): update is ChatManagerUpdate;
+    handleUpdate(update: ChatManagerUpdate): Promise<Update | null>;
+    approveJoinRequest(chatId: ID, userId: ID): Promise<void>;
+    declineJoinRequest(chatId: ID, userId: ID): Promise<void>;
+    approveJoinRequests(chatId: ID, params?: ApproveJoinRequestsParams): Promise<void>;
+    declineJoinRequests(chatId: ID, params?: DeclineJoinRequestsParams): Promise<void>;
+    getJoinRequests(chatId: ID, params?: GetJoinRequestsParams): Promise<import("../3_types.js").JoinRequest[]>;
+    createInviteLink(chatId: ID, params?: CreateInviteLinkParams): Promise<import("../3_types.js").InviteLink>;
+    getCreatedInviteLinks(chatId: ID, params?: GetCreatedInviteLinksParams): Promise<import("../3_types.js").InviteLink[]>;
+    joinChat(chatId: ID): Promise<void>;
+    leaveChat(chatId: ID): Promise<void>;
+    banChatMember(chatId: ID, memberId: ID, params?: BanChatMemberParams): Promise<void>;
+    unbanChatMember(chatId: ID, memberId: ID): Promise<void>;
+    setChatMemberRights(chatId: ID, memberId: ID, params?: SetChatMemberRightsParams): Promise<void>;
+    promoteChatMember(chatId: ID, userId: ID, params?: PromoteChatMemberParams): Promise<void>;
+    setChatMemberTag(chatId: ID, userId: ID, params?: SetChatMemberTagParams): Promise<void>;
+    setAvailableReactions(chatId: ID, availableReactions: "none" | "all" | Reaction[]): Promise<void>;
+    setBoostsRequiredToCircumventRestrictions(chatId: ID, boosts: number): Promise<void>;
+    enableJoinRequests(chatId: ID): Promise<void>;
+    disableJoinRequests(chatId: ID): Promise<void>;
+    setChatStickerSet(chatId: ID, setName: string): Promise<void>;
+    deleteChatStickerSet(chatId: ID): Promise<void>;
+    disableSlowMode(chatId: ID): Promise<void>;
+    setSlowMode(chatId: ID, duration: SlowModeDuration): Promise<void>;
+    setChatTitle(chatId: ID, title: string): Promise<void>;
+    setChatDescription(chatId: ID, description: string): Promise<void>;
+    hideMemberList(chatId: ID): Promise<void>;
+    showMemberList(chatId: ID): Promise<void>;
+    disableTopics(chatId: ID): Promise<void>;
+    enableTopics(chatId: ID, isShownAsTabs: boolean): Promise<void>;
+    enableAntispam(chatId: ID): Promise<void>;
+    disableAntispam(chatId: ID): Promise<void>;
+    enableSignatures(chatId: ID, params?: EnableSignaturesParams): Promise<void>;
+    disableSignatures(chatId: ID): Promise<void>;
+    deleteChat(chatId: ID): Promise<void>;
+    getDiscussionChatSuggestions(): Promise<ChatP[]>;
+    setDiscussionChat(chatId: ID, discussionChatId: ID): Promise<void>;
+    transferChatOwnership(chatId: ID, userId: ID, password: string): Promise<void>;
+    enableSharing(chatId: ID): Promise<void>;
+    disableSharing(chatId: ID): Promise<void>;
+    deleteChatPhoto(chatId: ID): Promise<void>;
+    setChatPhoto(chatId: ID, photo: FileSource, params?: SetChatPhotoParams): Promise<void>;
+    addChatMember(chatId: ID, userId: ID, params?: AddChatMemberParams): Promise<import("../3_types.js").FailedInvitation[]>;
+    addChatMembers(chatId: ID, userIds: ID[]): Promise<import("../3_types.js").FailedInvitation[]>;
+    getRecommendedChannels(): Promise<import("../3_types.js").ChatPChannel[]>;
+    getSimilarChannels(chatId: ID): Promise<import("../3_types.js").ChatPChannel[]>;
+    getSimilarBots(chatId: ID): Promise<import("../3_types.js").ChatPPrivate[]>;
+}
+export {};
+//# sourceMappingURL=4_chat_manager.d.ts.map

package/script/client/4_chat_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"4_chat_manager.d.ts","sourceRoot":"","sources":["../../src/client/4_chat_manager.ts"],"names":[],"mappings":"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"}

package/script/client/4_chat_manager.js

@@ -0,0 +1,482 @@
+"use strict";
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatManager = void 0;
+const _0_deps_js_1 = require("../0_deps.js");
+const _0_errors_js_1 = require("../0_errors.js");
+const _2_tl_js_1 = require("../2_tl.js");
+const _3_types_js_1 = require("../3_types.js");
+const _3_types_js_2 = require("../3_types.js");
+const _2_telegram_js_1 = require("../tl/2_telegram.js");
+const _0_password_js_1 = require("./0_password.js");
+const _0_utilities_js_1 = require("./0_utilities.js");
+const chatManagerUpdates = [
+    "updateChannelParticipant",
+    "updateChatParticipant",
+    "updateBotChatInviteRequester",
+];
+class ChatManager {
+    #c;
+    constructor(c) {
+        this.#c = c;
+    }
+    canHandleUpdate(update) {
+        return _2_tl_js_1.Api.isOneOf(chatManagerUpdates, update);
+    }
+    async handleUpdate(update) {
+        if (_2_tl_js_1.Api.is("updateChannelParticipant", update) || _2_tl_js_1.Api.is("updateChatParticipant", update)) {
+            const chatMember = (0, _3_types_js_1.constructChatMemberUpdated)(update, this.#c.getPeer);
+            const selfId = await this.#c.getSelfId();
+            if (chatMember.oldChatMember.member.id === selfId) {
+                return { myChatMember: chatMember };
+            }
+            else {
+                return { chatMember };
+            }
+        }
+        if (_2_tl_js_1.Api.is("updateBotChatInviteRequester", update)) {
+            const joinRequest = (0, _3_types_js_1.constructJoinRequest)(update, this.#c.getPeer);
+            return { joinRequest };
+        }
+        return null;
+    }
+    // JOIN REQUESTS //
+    async #toggleJoinRequests(chatId, isEnabled) {
+        const channel = await this.#c.getInputChannel(chatId);
+        await this.#c.invoke({ _: "channels.toggleJoinRequest", channel, enabled: isEnabled });
+    }
+    async approveJoinRequest(chatId, userId) {
+        await this.#c.invoke({
+            _: "messages.hideChatJoinRequest",
+            peer: await this.#c.getInputPeer(chatId),
+            user_id: await this.#c.getInputUser(userId),
+            approved: true,
+        });
+    }
+    async declineJoinRequest(chatId, userId) {
+        await this.#c.invoke({
+            _: "messages.hideChatJoinRequest",
+            peer: await this.#c.getInputPeer(chatId),
+            user_id: await this.#c.getInputUser(userId),
+        });
+    }
+    async approveJoinRequests(chatId, params) {
+        this.#c.storage.assertUser("approveJoinRequests");
+        await this.#c.invoke({
+            _: "messages.hideAllChatJoinRequests",
+            peer: await this.#c.getInputPeer(chatId),
+            approved: true,
+            link: params?.inviteLink,
+        });
+    }
+    async declineJoinRequests(chatId, params) {
+        this.#c.storage.assertUser("declineJoinRequests");
+        await this.#c.invoke({
+            _: "messages.hideAllChatJoinRequests",
+            peer: await this.#c.getInputPeer(chatId),
+            link: params?.inviteLink,
+        });
+    }
+    async getJoinRequests(chatId, params) {
+        this.#c.storage.assertUser("getJoinRequests");
+        if (typeof params?.inviteLink === "string" && typeof params?.search === "string") {
+            throw new _0_errors_js_1.InputError("inviteLink and search cannot be specified together.");
+        }
+        const peer = await this.#c.getInputPeer(chatId);
+        const offset_user = params?.fromUserId ? await this.#c.getInputUser(params.fromUserId) : { _: "inputUserEmpty" };
+        const { importers } = await this.#c.invoke({
+            _: "messages.getChatInviteImporters",
+            requested: true,
+            peer,
+            link: params?.inviteLink,
+            q: params?.search,
+            offset_date: params?.fromDate ?? 0,
+            offset_user,
+            limit: (0, _0_utilities_js_1.getLimit)(params?.limit),
+        });
+        const peer_ = (0, _2_telegram_js_1.inputPeerToPeer)(peer);
+        return await Promise.all(importers.map((v) => (0, _3_types_js_1.constructJoinRequest2)(peer_, v, this.#c.getPeer)));
+    }
+    // INVITE LINKS //
+    async createInviteLink(chatId, params) {
+        if (params?.isApprovalRequired && params?.limit) {
+            throw new _0_errors_js_1.InputError("isApprovalRequired cannot be true while limit is specified.");
+        }
+        const result = await this.#c.invoke({ _: "messages.exportChatInvite", peer: await this.#c.getInputPeer(chatId), title: params?.title, expire_date: params?.expireAt, request_needed: params?.isApprovalRequired ? true : undefined, usage_limit: params?.limit });
+        return (0, _3_types_js_1.constructInviteLink)(_2_tl_js_1.Api.as("chatInviteExported", result), this.#c.getPeer);
+    }
+    async getCreatedInviteLinks(chatId, params) {
+        this.#c.storage.assertUser("getCreatedInviteLinks");
+        const { invites } = await this.#c.invoke({ _: "messages.getExportedChatInvites", peer: await this.#c.getInputPeer(chatId), revoked: params?.isRevoked ? true : undefined, admin_id: params?.by ? await this.#c.getInputUser(params.by) : { _: "inputUserEmpty" }, limit: (0, _0_utilities_js_1.getLimit)(params?.limit), offset_date: params?.afterDate, offset_link: params?.afterInviteLink });
+        return await Promise.all(invites.map((v) => _2_tl_js_1.Api.as("chatInviteExported", v)).map((v) => (0, _3_types_js_1.constructInviteLink)(v, this.#c.getPeer)));
+    }
+    // JOINING AND LEAVING CHATS //
+    async joinChat(chatId) {
+        this.#c.storage.assertUser("joinChat");
+        const peer = await this.#c.getInputPeer(chatId);
+        if ((0, _0_utilities_js_1.canBeInputUser)(peer)) {
+            throw new _0_errors_js_1.InputError("Cannot join private chats.");
+        }
+        else if ((0, _0_utilities_js_1.canBeInputChannel)(peer)) {
+            await this.#c.invoke({ _: "channels.joinChannel", channel: (0, _0_utilities_js_1.toInputChannel)(peer) });
+        }
+        else if (_2_tl_js_1.Api.is("inputPeerChat", peer)) {
+            await this.#c.invoke({ _: "messages.addChatUser", chat_id: peer.chat_id, user_id: { _: "inputUserSelf" }, fwd_limit: 0 }); // TODO: use potential high-level method for adding participants to chats
+        }
+        else {
+            (0, _0_deps_js_1.unreachable)();
+        }
+    }
+    async leaveChat(chatId) {
+        const peer = await this.#c.getInputPeer(chatId);
+        if ((0, _0_utilities_js_1.canBeInputUser)(peer)) {
+            throw new _0_errors_js_1.InputError("Cannot leave private chats.");
+        }
+        else if ((0, _0_utilities_js_1.canBeInputChannel)(peer)) {
+            await this.#c.invoke({ _: "channels.leaveChannel", channel: (0, _0_utilities_js_1.toInputChannel)(peer) });
+        }
+        else if (_2_tl_js_1.Api.is("inputPeerChat", peer)) {
+            await this.#c.invoke({ _: "messages.deleteChatUser", chat_id: peer.chat_id, user_id: { _: "inputUserSelf" } }); // TODO: use potential high-level method for adding participants to chats
+        }
+        else {
+            (0, _0_deps_js_1.unreachable)();
+        }
+    }
+    // CHAT MEMBERS //
+    async banChatMember(chatId, memberId, params) {
+        const chat = await this.#c.getInputPeer(chatId);
+        if (!(_2_tl_js_1.Api.is("inputPeerChannel", chat)) && !(_2_tl_js_1.Api.is("inputPeerChat", chat))) {
+            throw new _0_errors_js_1.InputError("Expected a channel, supergroup, or group ID.");
+        }
+        const member = await this.#c.getInputPeer(memberId);
+        if (_2_tl_js_1.Api.is("inputPeerChannel", chat)) {
+            if (params?.deleteMessages) {
+                try {
+                    await this.#c.messageManager.deleteChatMemberMessages(chatId, memberId);
+                }
+                catch {
+                    //
+                }
+            }
+            await this.#c.invoke({
+                _: "channels.editBanned",
+                channel: { ...chat, _: "inputChannel" },
+                participant: member,
+                banned_rights: {
+                    _: "chatBannedRights",
+                    until_date: params?.until ?? 0,
+                    view_messages: true,
+                    send_messages: true,
+                    send_media: true,
+                    send_stickers: true,
+                    send_gifs: true,
+                    send_games: true,
+                    send_inline: true,
+                    embed_links: true,
+                },
+            });
+        }
+        else if (_2_tl_js_1.Api.is("inputPeerChat", chat)) {
+            if (!(0, _0_utilities_js_1.canBeInputUser)(member)) {
+                throw new _0_errors_js_1.InputError(`Invalid user ID: ${memberId}`);
+            }
+            await this.#c.invoke({ _: "messages.deleteChatUser", chat_id: chat.chat_id, user_id: (0, _0_utilities_js_1.toInputUser)(member), revoke_history: params?.deleteMessages ? true : undefined });
+        }
+    }
+    async unbanChatMember(chatId, memberId) {
+        const channel = await this.#c.getInputChannel(chatId);
+        const member = await this.#c.getInputPeer(memberId);
+        await this.#c.invoke({ _: "channels.editBanned", channel, participant: member, banned_rights: { _: "chatBannedRights", until_date: 0 } });
+    }
+    async setChatMemberRights(chatId, memberId, params) {
+        const channel = await this.#c.getInputChannel(chatId);
+        const member = await this.#c.getInputPeer(memberId);
+        await this.#c.invoke({ _: "channels.editBanned", channel, participant: member, banned_rights: (0, _3_types_js_2.chatMemberRightsToTlObject)(params?.rights, params?.until) });
+    }
+    async promoteChatMember(chatId, userId, params) {
+        const channel = await this.#c.getInputChannel(chatId);
+        const user_id = await this.#c.getInputUser(userId);
+        const admin_rights = (0, _3_types_js_1.chatAdministratorRightsToTlObject)(params ?? {});
+        const rank = params?.title ?? "";
+        await this.#c.invoke({
+            _: "channels.editAdmin",
+            channel,
+            user_id,
+            admin_rights,
+            rank,
+        });
+    }
+    async setChatMemberTag(chatId, userId, params) {
+        const peer = await this.#c.getInputPeer(chatId);
+        const participant = await this.#c.getInputPeer(userId);
+        const rank = params?.tag ?? "";
+        await this.#c.invoke({ _: "messages.editChatParticipantRank", peer, participant, rank });
+    }
+    // CHAT SETTINGS //
+    async setAvailableReactions(chatId, availableReactions) {
+        await this.#c.invoke({ _: "messages.setChatAvailableReactions", peer: await this.#c.getInputPeer(chatId), available_reactions: availableReactions === "none" ? { _: "chatReactionsNone" } : availableReactions === "all" ? { _: "chatReactionsAll" } : Array.isArray(availableReactions) ? ({ _: "chatReactionsSome", reactions: availableReactions.map((v) => (0, _3_types_js_2.reactionToTlObject)(v)) }) : (0, _0_deps_js_1.unreachable)() });
+    }
+    async setBoostsRequiredToCircumventRestrictions(chatId, boosts) {
+        this.#c.storage.assertUser("setBoostsRequiredToCircumventRestrictions");
+        const channel = await this.#c.getInputChannel(chatId);
+        await this.#c.invoke({ _: "channels.setBoostsToUnblockRestrictions", channel, boosts });
+    }
+    async enableJoinRequests(chatId) {
+        this.#c.storage.assertUser("enableJoinRequests");
+        await this.#toggleJoinRequests(chatId, true);
+    }
+    async disableJoinRequests(chatId) {
+        this.#c.storage.assertUser("disableJoinRequests");
+        await this.#toggleJoinRequests(chatId, false);
+    }
+    async setChatStickerSet(chatId, setName) {
+        const channel = await this.#c.getInputChannel(chatId);
+        await this.#c.invoke({ _: "channels.setStickers", channel, stickerset: { _: "inputStickerSetShortName", short_name: setName } });
+    }
+    async deleteChatStickerSet(chatId) {
+        const channel = await this.#c.getInputChannel(chatId);
+        await this.#c.invoke({ _: "channels.setStickers", channel, stickerset: { _: "inputStickerSetEmpty" } });
+    }
+    async #toggleSlowMode(chatId, seconds) {
+        const channel = await this.#c.getInputChannel(chatId);
+        await this.#c.invoke({ _: "channels.toggleSlowMode", channel, seconds });
+    }
+    async disableSlowMode(chatId) {
+        this.#c.storage.assertUser("disableSlowMode");
+        await this.#toggleSlowMode(chatId, 0);
+    }
+    async setSlowMode(chatId, duration) {
+        this.#c.storage.assertUser("setSlowMode");
+        const seconds = (0, _3_types_js_1.slowModeDurationToSeconds)(duration);
+        if (seconds > 1) {
+            throw new _0_errors_js_1.InputError("Invalid slow mode duration.");
+        }
+        await this.#toggleSlowMode(chatId, seconds);
+    }
+    async setChatTitle(chatId, title) {
+        const peer = await this.#c.getInputPeer(chatId);
+        if (_2_tl_js_1.Api.is("inputPeerChat", peer)) {
+            await this.#c.invoke({ _: "messages.editChatTitle", chat_id: peer.chat_id, title });
+        }
+        else if ((0, _0_utilities_js_1.canBeInputChannel)(peer)) {
+            const channel = (0, _0_utilities_js_1.toInputChannel)(peer);
+            await this.#c.invoke({ _: "channels.editTitle", channel, title });
+        }
+        else {
+            throw new _0_errors_js_1.InputError("A chat or channel identifier was expected.");
+        }
+    }
+    async setChatDescription(chatId, description) {
+        const peer = await this.#c.getInputPeer(chatId);
+        if ((0, _0_utilities_js_1.canBeInputUser)(peer)) {
+            throw new _0_errors_js_1.InputError("A chat or channel identifier was expected.");
+        }
+        await this.#c.invoke({ _: "messages.editChatAbout", peer, about: description });
+    }
+    async #setIsMemberListVisible(chatId, isVisible) {
+        const channel = await this.#c.getInputChannel(chatId);
+        const enabled = !isVisible;
+        await this.#c.invoke({ _: "channels.toggleParticipantsHidden", channel, enabled });
+    }
+    async hideMemberList(chatId) {
+        this.#c.storage.assertUser("hideMemberList");
+        await this.#setIsMemberListVisible(chatId, false);
+    }
+    async showMemberList(chatId) {
+        this.#c.storage.assertUser("showMemberList");
+        await this.#setIsMemberListVisible(chatId, true);
+    }
+    async #setIsTopicsEnabled(chatId, isEnabled, isShownAsTabs) {
+        const channel = await this.#c.getInputChannel(chatId);
+        await this.#c.invoke({ _: "channels.toggleForum", channel, enabled: isEnabled, tabs: isShownAsTabs });
+    }
+    async disableTopics(chatId) {
+        this.#c.storage.assertUser("disableTopics");
+        await this.#setIsTopicsEnabled(chatId, false, false);
+    }
+    async enableTopics(chatId, isShownAsTabs) {
+        this.#c.storage.assertUser("enableTopics");
+        await this.#setIsTopicsEnabled(chatId, true, isShownAsTabs);
+    }
+    async #setIsAntispamEnabled(chatId, isEnabled) {
+        const channel = await this.#c.getInputChannel(chatId);
+        await this.#c.invoke({ _: "channels.toggleAntiSpam", channel, enabled: isEnabled });
+    }
+    async enableAntispam(chatId) {
+        this.#c.storage.assertUser("enableAntispam");
+        await this.#setIsAntispamEnabled(chatId, true);
+    }
+    async disableAntispam(chatId) {
+        this.#c.storage.assertUser("disableAntispam");
+        await this.#setIsAntispamEnabled(chatId, false);
+    }
+    async #setIsSignaturesEnabled(chatId, isEnabled, params) {
+        const channel = await this.#c.getInputChannel(chatId);
+        await this.#c.invoke({ _: "channels.toggleSignatures", channel, signatures_enabled: isEnabled ? true : undefined, profiles_enabled: params?.showAuthorProfile ? true : undefined });
+    }
+    async enableSignatures(chatId, params) {
+        this.#c.storage.assertUser("enableSignatures");
+        await this.#setIsSignaturesEnabled(chatId, true, params);
+    }
+    async disableSignatures(chatId) {
+        this.#c.storage.assertUser("disableSignatures");
+        await this.#setIsSignaturesEnabled(chatId, false);
+    }
+    async deleteChat(chatId) {
+        this.#c.storage.assertUser("deleteChat");
+        const peer = await this.#c.getInputPeer(chatId);
+        if (_2_tl_js_1.Api.is("inputPeerChat", peer)) {
+            await this.#c.invoke({ _: "messages.deleteChat", chat_id: peer.chat_id });
+        }
+        else if ((0, _0_utilities_js_1.canBeInputChannel)(peer)) {
+            const channel = (0, _0_utilities_js_1.toInputChannel)(peer);
+            await this.#c.invoke({ _: "channels.deleteChannel", channel });
+        }
+        else {
+            throw new _0_errors_js_1.InputError("A chat or channel identifier was expected.");
+        }
+    }
+    async getDiscussionChatSuggestions() {
+        this.#c.storage.assertUser("getDiscussionChatSuggestions");
+        const { chats } = await this.#c.invoke({ _: "channels.getGroupsForDiscussion" });
+        return chats
+            .map((v) => {
+            if (!_2_tl_js_1.Api.isOneOf(["chat", "channel"], v)) {
+                return v;
+            }
+            else {
+                return (0, _3_types_js_1.constructChatP)(v);
+            }
+        })
+            .filter((v) => v !== null);
+    }
+    async setDiscussionChat(chatId, discussionChatId) {
+        this.#c.storage.assertUser("setDiscussionChat");
+        const [broadcast, group] = await Promise.all([this.#c.getInputChannel(chatId), this.#c.getInputChannel(discussionChatId)]);
+        await this.#c.invoke({ _: "channels.setDiscussionGroup", broadcast, group });
+    }
+    async transferChatOwnership(chatId, userId, password) {
+        this.#c.storage.assertUser("transferChat");
+        const user_id = await this.#c.getInputUser(userId);
+        const isSelf = _2_tl_js_1.Api.is("inputUserSelf", user_id);
+        if (isSelf || _2_tl_js_1.Api.peerToChatId(user_id) === await this.#c.getSelfId()) {
+            throw new _0_errors_js_1.InputError("A user ID except that of the current one was expected.");
+        }
+        const peer = await this.#c.getInputPeer(chatId);
+        const ap = await this.#c.invoke({ _: "account.getPassword" });
+        const password_ = await (0, _0_password_js_1.checkPassword)(password, ap);
+        await this.#c.invoke({ _: "messages.editChatCreator", peer, user_id, password: password_ });
+    }
+    async #setIsSharingEnabled(chatId, isSharingEnabled) {
+        const peer = await this.#c.getInputPeer(chatId);
+        await this.#c.invoke({ _: "messages.toggleNoForwards", peer, enabled: !isSharingEnabled });
+    }
+    async enableSharing(chatId) {
+        this.#c.storage.assertUser("enableSharing");
+        await this.#setIsSharingEnabled(chatId, true);
+    }
+    async disableSharing(chatId) {
+        this.#c.storage.assertUser("disableSharing");
+        await this.#setIsSharingEnabled(chatId, false);
+    }
+    // CHAT PHOTOS //
+    async deleteChatPhoto(chatId) {
+        const peer = await this.#c.getInputPeer(chatId);
+        if (!((0, _0_utilities_js_1.canBeInputChannel)(peer)) && !(_2_tl_js_1.Api.is("inputPeerChat", peer))) {
+            (0, _0_deps_js_1.unreachable)();
+        }
+        if ((0, _0_utilities_js_1.canBeInputChannel)(peer)) {
+            await this.#c.invoke({ _: "channels.editPhoto", channel: (0, _0_utilities_js_1.toInputChannel)(peer), photo: { _: "inputChatPhotoEmpty" } });
+        }
+        else if (_2_tl_js_1.Api.is("inputPeerChat", peer)) {
+            await this.#c.invoke({ _: "messages.editChatPhoto", chat_id: peer.chat_id, photo: { _: "inputChatPhotoEmpty" } });
+        }
+    }
+    async setChatPhoto(chatId, photo, params) {
+        const peer = await this.#c.getInputPeer(chatId);
+        if (!((0, _0_utilities_js_1.canBeInputChannel)(peer)) && !(_2_tl_js_1.Api.is("inputPeerChat", peer))) {
+            (0, _0_deps_js_1.unreachable)();
+        }
+        const file = await this.#c.fileManager.upload(photo, params);
+        const photo_ = { _: "inputChatUploadedPhoto", file };
+        if ((0, _0_utilities_js_1.canBeInputChannel)(peer)) {
+            await this.#c.invoke({ _: "channels.editPhoto", channel: (0, _0_utilities_js_1.toInputChannel)(peer), photo: photo_ });
+        }
+        else if (_2_tl_js_1.Api.is("inputPeerChat", peer)) {
+            await this.#c.invoke({ _: "messages.editChatPhoto", chat_id: peer.chat_id, photo: photo_ });
+        }
+    }
+    // INVITING MEMBERS //
+    async addChatMember(chatId, userId, params) {
+        this.#c.storage.assertUser("addChatMember");
+        const chat = await this.#c.getInputPeer(chatId);
+        if (_2_tl_js_1.Api.isOneOf(["inputPeerEmpty", "inputPeerSelf", "inputPeerUser", "inputPeerUserFromMessage"], chat)) {
+            throw new _0_errors_js_1.InputError("Cannot add members to private chats");
+        }
+        const user = await this.#c.getInputUser(userId);
+        if (_2_tl_js_1.Api.is("inputPeerChat", chat)) {
+            const result = await this.#c.invoke({ _: "messages.addChatUser", chat_id: chat.chat_id, user_id: user, fwd_limit: params?.historyLimit ?? 0 });
+            return result.missing_invitees.map(_3_types_js_1.constructFailedInvitation);
+        }
+        else if (_2_tl_js_1.Api.is("inputPeerChannel", chat)) {
+            const result = await this.#c.invoke({ _: "channels.inviteToChannel", channel: { ...chat, _: "inputChannel" }, users: [user] });
+            return result.missing_invitees.map(_3_types_js_1.constructFailedInvitation);
+        }
+        (0, _0_deps_js_1.unreachable)();
+    }
+    async addChatMembers(chatId, userIds) {
+        this.#c.storage.assertUser("addChatMembers");
+        const chat = await this.#c.getInputPeer(chatId);
+        if (_2_tl_js_1.Api.isOneOf(["inputPeerEmpty", "inputPeerSelf", "inputPeerUser", "inputPeerUserFromMessage"], chat)) {
+            throw new _0_errors_js_1.InputError("Cannot add members to private chats");
+        }
+        const users = new Array();
+        for (const userId of userIds) {
+            users.push(await this.#c.getInputUser(userId));
+        }
+        if (_2_tl_js_1.Api.is("inputPeerChat", chat)) {
+            throw new _0_errors_js_1.InputError("addChatMembers cannot be used with basic groups");
+        }
+        else if ((0, _0_utilities_js_1.canBeInputChannel)(chat)) {
+            const result = await this.#c.invoke({ _: "channels.inviteToChannel", channel: (0, _0_utilities_js_1.toInputChannel)(chat), users });
+            return result.missing_invitees.map(_3_types_js_1.constructFailedInvitation);
+        }
+        (0, _0_deps_js_1.unreachable)();
+    }
+    async getRecommendedChannels() {
+        this.#c.storage.assertUser("getRecommendedChannels");
+        const result = await this.#c.invoke({ _: "channels.getChannelRecommendations" });
+        return result.chats.map((v) => (0, _3_types_js_1.constructChatP)(v)).filter((v) => v.type === "channel");
+    }
+    async getSimilarChannels(chatId) {
+        this.#c.storage.assertUser("getSimilarChannels");
+        const channel = await this.#c.getInputChannel(chatId);
+        const result = await this.#c.invoke({ _: "channels.getChannelRecommendations", channel });
+        return result.chats.map((v) => (0, _3_types_js_1.constructChatP)(v)).filter((v) => v.type === "channel");
+    }
+    async getSimilarBots(chatId) {
+        this.#c.storage.assertUser("getSimilarBots");
+        const bot = await this.#c.getInputUser(chatId);
+        const result = await this.#c.invoke({ _: "bots.getBotRecommendations", bot });
+        return result.users.map((v) => (0, _3_types_js_1.constructChatP)(v)).filter((v) => v.type === "private");
+    }
+}
+exports.ChatManager = ChatManager;

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

@@ -0,0 +1,38 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2026 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 type { ID, InputChecklistItem } from "../3_types.js";
+import type { UpdateChecklistParams } from "./0_params.js";
+import type { C as C_ } from "./1_types.js";
+import type { MessageManager } from "./3_message_manager.js";
+type C = C_ & {
+    messageManager: MessageManager;
+};
+export declare class ChecklistManager {
+    #private;
+    constructor(c: C);
+    addToChecklist(chatId: ID, messageId: number, items: InputChecklistItem[]): Promise<void>;
+    updateChecklist(chatId: ID, messageId: number, params?: UpdateChecklistParams): Promise<void>;
+    checkChecklistItems(chatId: ID, messageId: number, items: number[]): Promise<void>;
+    uncheckChecklistItems(chatId: ID, messageId: number, items: number[]): Promise<void>;
+    checkChecklistItem(chatId: ID, messageId: number, item: number): Promise<void>;
+    uncheckChecklistItem(chatId: ID, messageId: number, item: number): Promise<void>;
+}
+export {};
+//# sourceMappingURL=4_checklist_manager.d.ts.map

package/script/client/4_checklist_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"4_checklist_manager.d.ts","sourceRoot":"","sources":["../../src/client/4_checklist_manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,EAAE,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,KAAK,CAAC,GAAG,EAAE,GAAG;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,CAAC;AAEjD,qBAAa,gBAAgB;;gBAGf,CAAC,EAAE,CAAC;IAIV,cAAc,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE;IA0BzE,eAAe,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB;IAK7E,mBAAmB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAKlE,qBAAqB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;IAKpE,kBAAkB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAK9D,oBAAoB,CAAC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAIvE"}