@mtcute/core 0.28.1 → 0.29.0

package/client.cjs

@@ -49,6 +49,7 @@ const deleteGroup = require("./highlevel/methods/chats/delete-group.cjs");
 const deleteHistory = require("./highlevel/methods/chats/delete-history.cjs");
 const deleteUserHistory = require("./highlevel/methods/chats/delete-user-history.cjs");
 const editAdminRights = require("./highlevel/methods/chats/edit-admin-rights.cjs");
+const editChatMemberRank = require("./highlevel/methods/chats/edit-chat-member-rank.cjs");
 const getChatEventLog = require("./highlevel/methods/chats/get-chat-event-log.cjs");
 const getChatMember = require("./highlevel/methods/chats/get-chat-member.cjs");
 const getChatMembers = require("./highlevel/methods/chats/get-chat-members.cjs");
@@ -59,7 +60,6 @@ const getCreatorAfterLeave = require("./highlevel/methods/chats/get-creator-afte
 const getFullChat = require("./highlevel/methods/chats/get-full-chat.cjs");
 const getFullUser = require("./highlevel/methods/chats/get-full-user.cjs");
 const getMessageAuthor = require("./highlevel/methods/chats/get-message-author.cjs");
-const getNearbyChats = require("./highlevel/methods/chats/get-nearby-chats.cjs");
 const getPeer = require("./highlevel/methods/chats/get-peer.cjs");
 const getPeers = require("./highlevel/methods/chats/get-peers.cjs");
 const getSimilarChannels = require("./highlevel/methods/chats/get-similar-channels.cjs");
@@ -86,6 +86,7 @@ const toggleContentProtection = require("./highlevel/methods/chats/toggle-conten
 const toggleFragmentUsername = require("./highlevel/methods/chats/toggle-fragment-username.cjs");
 const toggleJoinRequests = require("./highlevel/methods/chats/toggle-join-requests.cjs");
 const toggleJoinToSend = require("./highlevel/methods/chats/toggle-join-to-send.cjs");
+const transferChatOwnership = require("./highlevel/methods/chats/transfer-chat-ownership.cjs");
 const unarchiveChats = require("./highlevel/methods/chats/unarchive-chats.cjs");
 const unbanChatMember = require("./highlevel/methods/chats/unban-chat-member.cjs");
 const addContact = require("./highlevel/methods/contacts/add-contact.cjs");
@@ -585,6 +586,9 @@ TelegramClient.prototype.deleteUserHistory = function(...args) {
 TelegramClient.prototype.editAdminRights = function(...args) {
   return editAdminRights.editAdminRights(this._client, ...args);
 };
+TelegramClient.prototype.editChatMemberRank = function(...args) {
+  return editChatMemberRank.editChatMemberRank(this._client, ...args);
+};
 TelegramClient.prototype.getChatEventLog = function(...args) {
   return getChatEventLog.getChatEventLog(this._client, ...args);
 };
@@ -615,9 +619,6 @@ TelegramClient.prototype.getFullUser = function(...args) {
 TelegramClient.prototype.getMessageAuthor = function(...args) {
   return getMessageAuthor.getMessageAuthor(this._client, ...args);
 };
-TelegramClient.prototype.getNearbyChats = function(...args) {
-  return getNearbyChats.getNearbyChats(this._client, ...args);
-};
 TelegramClient.prototype.getPeer = function(...args) {
   return getPeer.getPeer(this._client, ...args);
 };
@@ -699,6 +700,9 @@ TelegramClient.prototype.toggleJoinRequests = function(...args) {
 TelegramClient.prototype.toggleJoinToSend = function(...args) {
   return toggleJoinToSend.toggleJoinToSend(this._client, ...args);
 };
+TelegramClient.prototype.transferChatOwnership = function(...args) {
+  return transferChatOwnership.transferChatOwnership(this._client, ...args);
+};
 TelegramClient.prototype.unarchiveChats = function(...args) {
   return unarchiveChats.unarchiveChats(this._client, ...args);
 };

package/client.js

@@ -42,6 +42,7 @@ import { deleteGroup } from "./highlevel/methods/chats/delete-group.js";
 import { deleteHistory } from "./highlevel/methods/chats/delete-history.js";
 import { deleteUserHistory } from "./highlevel/methods/chats/delete-user-history.js";
 import { editAdminRights } from "./highlevel/methods/chats/edit-admin-rights.js";
+import { editChatMemberRank } from "./highlevel/methods/chats/edit-chat-member-rank.js";
 import { getChatEventLog } from "./highlevel/methods/chats/get-chat-event-log.js";
 import { getChatMember } from "./highlevel/methods/chats/get-chat-member.js";
 import { getChatMembers } from "./highlevel/methods/chats/get-chat-members.js";
@@ -52,7 +53,6 @@ import { getCreatorAfterLeave } from "./highlevel/methods/chats/get-creator-afte
 import { getFullChat } from "./highlevel/methods/chats/get-full-chat.js";
 import { getFullUser } from "./highlevel/methods/chats/get-full-user.js";
 import { getMessageAuthor } from "./highlevel/methods/chats/get-message-author.js";
-import { getNearbyChats } from "./highlevel/methods/chats/get-nearby-chats.js";
 import { getPeer } from "./highlevel/methods/chats/get-peer.js";
 import { getPeers } from "./highlevel/methods/chats/get-peers.js";
 import { getSimilarChannels } from "./highlevel/methods/chats/get-similar-channels.js";
@@ -79,6 +79,7 @@ import { toggleContentProtection } from "./highlevel/methods/chats/toggle-conten
 import { toggleFragmentUsername } from "./highlevel/methods/chats/toggle-fragment-username.js";
 import { toggleJoinRequests } from "./highlevel/methods/chats/toggle-join-requests.js";
 import { toggleJoinToSend } from "./highlevel/methods/chats/toggle-join-to-send.js";
+import { transferChatOwnership } from "./highlevel/methods/chats/transfer-chat-ownership.js";
 import { unarchiveChats } from "./highlevel/methods/chats/unarchive-chats.js";
 import { unbanChatMember } from "./highlevel/methods/chats/unban-chat-member.js";
 import { addContact } from "./highlevel/methods/contacts/add-contact.js";
@@ -578,6 +579,9 @@ TelegramClient.prototype.deleteUserHistory = function(...args) {
 TelegramClient.prototype.editAdminRights = function(...args) {
   return editAdminRights(this._client, ...args);
 };
+TelegramClient.prototype.editChatMemberRank = function(...args) {
+  return editChatMemberRank(this._client, ...args);
+};
 TelegramClient.prototype.getChatEventLog = function(...args) {
   return getChatEventLog(this._client, ...args);
 };
@@ -608,9 +612,6 @@ TelegramClient.prototype.getFullUser = function(...args) {
 TelegramClient.prototype.getMessageAuthor = function(...args) {
   return getMessageAuthor(this._client, ...args);
 };
-TelegramClient.prototype.getNearbyChats = function(...args) {
-  return getNearbyChats(this._client, ...args);
-};
 TelegramClient.prototype.getPeer = function(...args) {
   return getPeer(this._client, ...args);
 };
@@ -692,6 +693,9 @@ TelegramClient.prototype.toggleJoinRequests = function(...args) {
 TelegramClient.prototype.toggleJoinToSend = function(...args) {
   return toggleJoinToSend(this._client, ...args);
 };
+TelegramClient.prototype.transferChatOwnership = function(...args) {
+  return transferChatOwnership(this._client, ...args);
+};
 TelegramClient.prototype.unarchiveChats = function(...args) {
   return unarchiveChats(this._client, ...args);
 };

package/highlevel/base.cjs

@@ -6,23 +6,20 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const utils = require("@fuman/utils");
-const tl = require("@mtcute/tl");
 const client = require("../network/client.cjs");
-const errorReporting = require("../utils/error-reporting.cjs");
 const functionUtils = require("../utils/function-utils.cjs");
 const logger = require("../utils/logger.cjs");
 const typeAssertions = require("../utils/type-assertions.cjs");
 require("@mtcute/tl-runtime");
-require("@mtcute/tl/binary/reader.js");
-require("@mtcute/tl/binary/writer.js");
 const appConfigManager = require("./managers/app-config-manager.cjs");
 const timers = require("./managers/timers.cjs");
 const storage = require("./storage/storage.cjs");
 const manager = require("./updates/manager.cjs");
 const stringSession = require("./utils/string-session.cjs");
 const password = require("../utils/crypto/password.cjs");
+const innerTl = require("../tl/inner-tl.cjs");
 function makeRpcError(raw, stack, method) {
-  const error = tl.tl.RpcError.fromTl(raw);
+  const error = innerTl.RpcError.fromTl(raw);
   error.stack = `RpcError (${error.code} ${error.text}): ${error.message}
     at ${method}
 ${stack.split("\n").slice(2).join("\n")}`;
@@ -64,7 +61,12 @@ class BaseTelegramClient {
       provider: this.params.storage,
       ...this.params.storageOptions
     });
-    this.timers = new timers.TimersManager();
+    this.timers = new timers.TimersManager(async (spec, abortSignal) => {
+      await this.call(spec.request, {
+        abortSignal,
+        ...spec.options
+      });
+    });
     this.timers.onError((err) => this.onError.emit(utils.unknownToError(err)));
   }
   updates;
@@ -186,9 +188,6 @@ class BaseTelegramClient {
     const res = await this.mt.call(message, params);
     if (typeAssertions.isTlRpcError(res)) {
       const error = makeRpcError(res, new Error().stack ?? "", message._);
-      if (error.unknown && this.params.enableErrorReporting) {
-        errorReporting.reportUnknownError(this.log, error, message._);
-      }
       throw error;
     }
     await this.storage.peers.updatePeersFrom(res);

package/highlevel/base.d.cts

@@ -10,7 +10,7 @@ import { ITelegramStorageProvider } from './storage/provider.js';
 import { TelegramStorageManagerExtraOptions, TelegramStorageManager } from './storage/storage.js';
 import { RawUpdateInfo, UpdatesManagerParams } from './updates/types.js';
 import { Emitter } from '@fuman/utils';
-import { tl } from '@mtcute/tl';
+import { tl } from '../tl/index.js';
 import { AppConfigManager } from './managers/app-config-manager.js';
 import { TimersManager } from './managers/timers.js';
 import { UpdatesManager } from './updates/manager.js';

package/highlevel/base.d.ts

@@ -10,7 +10,7 @@ import { ITelegramStorageProvider } from './storage/provider.js';
 import { TelegramStorageManagerExtraOptions, TelegramStorageManager } from './storage/storage.js';
 import { RawUpdateInfo, UpdatesManagerParams } from './updates/types.js';
 import { Emitter } from '@fuman/utils';
-import { tl } from '@mtcute/tl';
+import { tl } from '../tl/index.js';
 import { AppConfigManager } from './managers/app-config-manager.js';
 import { TimersManager } from './managers/timers.js';
 import { UpdatesManager } from './updates/manager.js';

package/highlevel/base.js

@@ -1,21 +1,18 @@
 import { unknownToError, Emitter } from "@fuman/utils";
-import { tl } from "@mtcute/tl";
 import { MtClient } from "../network/client.js";
-import { reportUnknownError } from "../utils/error-reporting.js";
 import { asyncResettable } from "../utils/function-utils.js";
 import { LogManager } from "../utils/logger.js";
 import { isTlRpcError } from "../utils/type-assertions.js";
 import "@mtcute/tl-runtime";
-import "@mtcute/tl/binary/reader.js";
-import "@mtcute/tl/binary/writer.js";
 import { AppConfigManager } from "./managers/app-config-manager.js";
 import { TimersManager } from "./managers/timers.js";
 import { TelegramStorageManager } from "./storage/storage.js";
 import { UpdatesManager } from "./updates/manager.js";
 import { readStringSession, writeStringSession } from "./utils/string-session.js";
 import { computeSrpParams, computeNewPasswordHash } from "../utils/crypto/password.js";
+import { RpcError } from "../tl/inner-tl.js";
 function makeRpcError(raw, stack, method) {
-  const error = tl.RpcError.fromTl(raw);
+  const error = RpcError.fromTl(raw);
   error.stack = `RpcError (${error.code} ${error.text}): ${error.message}
     at ${method}
 ${stack.split("\n").slice(2).join("\n")}`;
@@ -57,7 +54,12 @@ class BaseTelegramClient {
       provider: this.params.storage,
       ...this.params.storageOptions
     });
-    this.timers = new TimersManager();
+    this.timers = new TimersManager(async (spec, abortSignal) => {
+      await this.call(spec.request, {
+        abortSignal,
+        ...spec.options
+      });
+    });
     this.timers.onError((err) => this.onError.emit(unknownToError(err)));
   }
   updates;
@@ -179,9 +181,6 @@ class BaseTelegramClient {
     const res = await this.mt.call(message, params);
     if (isTlRpcError(res)) {
       const error = makeRpcError(res, new Error().stack ?? "", message._);
-      if (error.unknown && this.params.enableErrorReporting) {
-        reportUnknownError(this.log, error, message._);
-      }
       throw error;
     }
     await this.storage.peers.updatePeersFrom(res);

package/highlevel/client.d.cts

@@ -1,6 +1,6 @@
-import { tl } from '@mtcute/tl';
 import { default as Long } from 'long';
 import { RpcCallOptions } from '../network/index.js';
+import { tl } from '../tl/index.js';
 import { MaybeArray, MaybePromise, PartialExcept, PartialOnly } from '../types/index.js';
 import { BaseTelegramClientOptions } from './base.js';
 import { ITelegramClient } from './client.types.js';
@@ -1110,6 +1110,17 @@ export interface TelegramClient extends ITelegramClient {
         /** Custom admin rank */
         rank?: string;
     }): Promise<void>;
+    /**
+     * Edit the custom rank (title) of a group chat participant.
+     */
+    editChatMemberRank(params: {
+        /** Chat ID */
+        chatId: InputPeerLike;
+        /** ID of the user to edit the rank of */
+        participantId: InputPeerLike;
+        /** New rank, or `null` to remove it */
+        rank: string | null;
+    }): Promise<void>;
     /**
      * Get chat event log ("Recent actions" in official clients).
      *
@@ -1268,9 +1279,9 @@ export interface TelegramClient extends ITelegramClient {
      */
     getChats(chatIds: InputPeerLike[]): Promise<(Chat | null)[]>;
     /**
-     * Get the user who will be made the creator of the channel/supergroup if you were to leave it.
+     * Get the user who will be made the creator of the chat/channel/supergroup if you were to leave it.
      *
-     * You must be the creator of the channel/supergroup to use this method.
+     * You must be the creator of the chat/channel/supergroup to use this method.
      */
     getCreatorAfterLeave(chatId: InputPeerLike): Promise<User | null>;
     /**
@@ -1293,15 +1304,6 @@ export interface TelegramClient extends ITelegramClient {
      */
     getFullUser(userId: InputPeerLike): Promise<FullUser>;
     getMessageAuthor(message: InputMessageId): Promise<User>;
-    /**
-     * Get nearby chats
-     *
-     * **Available**: 👤 users only
-     *
-     * @param latitude  Latitude of the location
-     * @param longitude  Longitude of the location
-     */
-    getNearbyChats(latitude: number, longitude: number): Promise<Chat[]>;
     /** Shorthand for {@link getChat} and {@link getUser} depending on the type of the peer */
     getPeer(peer: InputPeerLike): Promise<Peer>;
     /**
@@ -1633,7 +1635,10 @@ export interface TelegramClient extends ITelegramClient {
      * @param chatId  Chat ID or username
      * @param [enabled=false]  Whether content protection should be enabled
      */
-    toggleContentProtection(chatId: InputPeerLike, enabled?: boolean): Promise<void>;
+    toggleContentProtection(chatId: InputPeerLike, enabled?: boolean, params?: {
+        /** If this method was called in response to the other party enabling content protection, ID of that message */
+        requestMsgId?: number;
+    }): Promise<void>;
     /**
      * Toggle a collectible (Fragment) username
      *
@@ -1678,6 +1683,20 @@ export interface TelegramClient extends ITelegramClient {
      * @param [enabled=false]  Whether join-to-send setting should be enabled
      */
     toggleJoinToSend(chatId: InputPeerLike, enabled?: boolean): Promise<void>;
+    /**
+     * Transfer ownership of a chat/channel/supergroup to another user.
+     *
+     * You must be the creator of the chat to use this method,
+     * and your account must have 2FA enabled.
+     */
+    transferChatOwnership(params: {
+        /** ID of the chat/channel/supergroup to transfer */
+        chatId: InputPeerLike;
+        /** ID of the user to transfer ownership to */
+        userId: InputPeerLike;
+        /** Your 2FA password */
+        password: string;
+    }): Promise<void>;
     /**
      * Unarchive one or more chats
      *
@@ -1778,6 +1797,8 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Set a note for a contact
      *
+     * **Available**: 👤 users only
+     *
      * @param userId  ID of the user to set the note for
      * @param note  Note text
      */
@@ -2217,6 +2238,8 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
+     * **Available**: 👤 users only
+     *
      * @returns  Service message for the created topic
      */
     createForumTopic(params: {
@@ -2248,6 +2271,8 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Delete a forum topic and all its history
      *
+     * **Available**: 👤 users only
+     *
      * @param chat  Chat or user ID, username, phone number, `"me"` or `"self"`
      * @param topicId  ID of the topic (i.e. its top message ID)
      */
@@ -2263,6 +2288,8 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
+     * **Available**: 👤 users only
+     *
      * @param chatId  Chat ID or username
      * @param topicId  ID of the topic (i.e. its top message ID)
      * @returns  Service message about the modification
@@ -2296,12 +2323,16 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get forum topics by their IDs
      *
+     * **Available**: 👤 users only
+     *
      * @param chatId  Chat ID or username
      */
     getForumTopicsById(chatId: InputPeerLike, ids: MaybeArray<number>): Promise<ForumTopic[]>;
     /**
      * Get forum topics
      *
+     * **Available**: 👤 users only
+     *
      * @param chatId  Chat ID or username
      */
     getForumTopics(chatId: InputPeerLike, params?: {
@@ -2343,6 +2374,8 @@ export interface TelegramClient extends ITelegramClient {
      * Reorder pinned forum topics
      *
      * Only admins with `manageTopics` permission can do this.
+     * **Available**: 👤 users only
+     *
      */
     reorderPinnedForumTopics(params: {
         /** Chat ID or username */
@@ -2361,6 +2394,8 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
+     * **Available**: 👤 users only
+     *
      * @returns  Service message about the modification
      */
     toggleForumTopicClosed(parmas: {
@@ -2380,6 +2415,8 @@ export interface TelegramClient extends ITelegramClient {
      * Toggle whether a topic in a forum is pinned
      *
      * Only admins with `manageTopics` permission can do this.
+     * **Available**: 👤 users only
+     *
      */
     toggleForumTopicPinned(params: {
         /** Chat ID or username */
@@ -2529,6 +2566,8 @@ export interface TelegramClient extends ITelegramClient {
     getStarGiftOptions(): Promise<StarGift[]>;
     /**
      * Get a list of all possible attributes when upgrading a given star gift
+     * **Available**: 👤 users only
+     *
      */
     getStarGiftUpgradeOptions(giftId: tl.Long): Promise<StarGiftUpgradeOptions>;
     /**
@@ -2608,6 +2647,8 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Accept or decline a purchase offer for a star gift
      *
+     * **Available**: 👤 users only
+     *
      * @returns The generated service message
      */
     resolveStarGiftOffer(options: {
@@ -2623,6 +2664,8 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<Message>;
     /**
      * Create a purchase offer for a unique star gift
+     * **Available**: 👤 users only
+     *
      * @param client
      * @param params
      */
@@ -3113,7 +3156,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Edit message text, media, reply markup and schedule date.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param message  Message or its ID
@@ -3866,7 +3909,7 @@ export interface TelegramClient extends ITelegramClient {
      * To add a caption to the group, add caption to the first
      * media in the group and don't add caption for any other.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param medias  Medias contained in the message.
@@ -3895,7 +3938,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a single media (a photo or a document-based media)
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param media
@@ -4022,7 +4065,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a text message
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param text  Text of the message
@@ -4056,7 +4099,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * If you need a continuous typing status, use {@link setTyping} instead.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param [status='typing']  Typing status
@@ -4595,13 +4638,13 @@ export interface TelegramClient extends ITelegramClient {
      */
     deleteStickerFromSet(sticker: InputDocumentId): Promise<StickerSet>;
     /**
-     * Get custom emoji stickers by their IDs
+     * Get custom emoji stickers by their IDs, or `null` if not available/found.
      *
      * **Available**: 👤 users only
      *
      * @param ids  IDs of the stickers (as defined in {@link MessageEntity.emojiId})
      */
-    getCustomEmojis(ids: tl.Long[]): Promise<Sticker[]>;
+    getCustomEmojis(ids: tl.Long[]): Promise<(Sticker | null)[]>;
     /**
      * Given one or more messages, extract all unique custom emojis from it and fetch them
      * **Available**: ✅ both users and bots
@@ -5153,7 +5196,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param photoId  ID of the photo to fetch
      * @param params
      */
-    getProfilePhoto(userId: InputPeerLike, photoId: tl.Long): Promise<Photo>;
+    getProfilePhoto(userId: InputPeerLike, photoId: tl.Long): Promise<Photo | null>;
     /**
      * Get a list of profile pictures of a user
      *