@mtcute/core 0.18.0-rc.5 → 0.19.0

package/highlevel/methods/chats/get-chat-preview.d.cts

@@ -0,0 +1,12 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ChatPreview } from '../../types/index.js';
+/**
+ * Get preview information about a private chat.
+ *
+ * @param inviteLink  Invite link
+ * @throws MtArgumentError  In case invite link has invalid format
+ * @throws MtPeerNotFoundError
+ *   In case you are trying to get info about private chat that you have already joined.
+ *   Use {@link getChat} or {@link getFullChat} instead.
+ */
+export declare function getChatPreview(client: ITelegramClient, inviteLink: string): Promise<ChatPreview>;

package/highlevel/methods/chats/get-chat.d.cts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Chat } from '../../types/index.js';
+/**
+ * Get basic information about a chat.
+ *
+ * @param chatId  ID of the chat, its username or invite link
+ * @throws MtArgumentError
+ *   In case you are trying to get info about private chat that you haven't joined.
+ *   Use {@link getChatPreview} instead.
+ */
+export declare function getChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat>;

package/highlevel/methods/chats/get-full-chat.d.cts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, FullChat } from '../../types/index.js';
+/**
+ * Get full information about a chat.
+ *
+ * @param chatId  ID of the chat, its username or invite link
+ * @throws MtArgumentError
+ *   In case you are trying to get info about private chat that you haven't joined.
+ *   Use {@link getChatPreview} instead.
+ */
+export declare function getFullChat(client: ITelegramClient, chatId: InputPeerLike): Promise<FullChat>;

package/highlevel/methods/chats/get-full-user.d.cts

@@ -0,0 +1,8 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, FullUser } from '../../types/index.js';
+/**
+ * Get full information about a user.
+ *
+ * @param userId  ID of the user or their username
+ */
+export declare function getFullUser(client: ITelegramClient, userId: InputPeerLike): Promise<FullUser>;

package/highlevel/methods/chats/get-nearby-chats.d.cts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { Chat } from '../../types/index.js';
+/**
+ * Get nearby chats
+ *
+ * @param latitude  Latitude of the location
+ * @param longitude  Longitude of the location
+ */
+export declare function getNearbyChats(client: ITelegramClient, latitude: number, longitude: number): Promise<Chat[]>;

package/highlevel/methods/chats/get-similar-channels.d.cts

@@ -0,0 +1,12 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ArrayWithTotal, InputPeerLike, Chat } from '../../types/index.js';
+/**
+ * Get channels that are similar to a given channel
+ *
+ * > **Note**: This method only returns the channels that the current user
+ * > is not subscribed to. For non-premium users, this method will only return
+ * > a few channels (with the total number of similar channels being specified in `.total`)
+ * >
+ * > Returns empty array in case there are no similar channels available.
+ */
+export declare function getSimilarChannels(client: ITelegramClient, channel: InputPeerLike): Promise<ArrayWithTotal<Chat>>;

package/highlevel/methods/chats/get-user.d.cts

@@ -0,0 +1,8 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, User } from '../../types/index.js';
+/**
+ * Get basic information about a user.
+ *
+ * @param userId  ID of the user or their username or invite link
+ */
+export declare function getUser(client: ITelegramClient, userId: InputPeerLike): Promise<User>;

package/highlevel/methods/chats/iter-chat-event-log.d.cts

@@ -0,0 +1,26 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ChatEvent, InputPeerLike } from '../../types/index.js';
+import { getChatEventLog } from './get-chat-event-log.js';
+/**
+ * Iterate over chat event log.
+ *
+ * Small wrapper over {@link getChatEventLog}
+ *
+ * @param chatId  Chat ID
+ * @param params
+ */
+export declare function iterChatEventLog(client: ITelegramClient, chatId: InputPeerLike, params?: Parameters<typeof getChatEventLog>[2] & {
+    /**
+     * Total number of events to return.
+     *
+     * @default  Infinity
+     */
+    limit?: number;
+    /**
+     * Chunk size, passed as `limit` to {@link getChatEventLog}.
+     * Usually you don't need to touch this.
+     *
+     * @default  100
+     */
+    chunkSize?: number;
+}): AsyncIterableIterator<ChatEvent>;

package/highlevel/methods/chats/iter-chat-members.d.cts

@@ -0,0 +1,22 @@
+import { ITelegramClient } from '../../client.types.js';
+import { ChatMember, InputPeerLike } from '../../types/index.js';
+import { getChatMembers } from './get-chat-members.js';
+/**
+ * Iterate through chat members
+ *
+ * This method is a small wrapper over {@link getChatMembers},
+ * which also handles duplicate entries (i.e. does not yield
+ * the same member twice)
+ *
+ * @param chatId  Chat ID or username
+ * @param params  Additional parameters
+ */
+export declare function iterChatMembers(client: ITelegramClient, chatId: InputPeerLike, params?: Parameters<typeof getChatMembers>[2] & {
+    /**
+     * Chunk size, which will be passed as `limit` parameter
+     * to {@link getChatMembers}. Usually you shouldn't care about this.
+     *
+     * @default  `200`
+     */
+    chunkSize?: number;
+}): AsyncIterableIterator<ChatMember>;

package/highlevel/methods/chats/join-chat.d.cts

@@ -0,0 +1,14 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Chat } from '../../types/index.js';
+/**
+ * Join a channel or supergroup
+ *
+ * When using with invite links, this method may throw RPC error
+ * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
+ * You will get into the chat once they do so.
+ *
+ * @param chatId
+ *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
+ *   or ID of the linked supergroup or channel.
+ */
+export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat>;

package/highlevel/methods/chats/kick-chat-member.d.cts

@@ -0,0 +1,15 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Message } from '../../types/index.js';
+/**
+ * Kick a user from a chat.
+ *
+ * This effectively bans a user and immediately unbans them.
+ *
+ *  @returns  Service message about removed user, if one was generated.
+ */
+export declare function kickChatMember(client: ITelegramClient, params: {
+    /** Chat ID */
+    chatId: InputPeerLike;
+    /** User ID */
+    userId: InputPeerLike;
+}): Promise<Message | null>;

package/highlevel/methods/chats/leave-chat.d.cts

@@ -0,0 +1,13 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Leave a group chat, supergroup or channel
+ *
+ * @param chatId  Chat ID or username
+ */
+export declare function leaveChat(client: ITelegramClient, chatId: InputPeerLike, params?: {
+    /**
+     * Whether to clear history after leaving (only for legacy group chats)
+     */
+    clear?: boolean;
+}): Promise<void>;

package/highlevel/methods/chats/mark-chat-unread.d.cts

@@ -0,0 +1,8 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Mark a chat as unread
+ *
+ * @param chatId  Chat ID
+ */
+export declare function markChatUnread(client: ITelegramClient, chatId: InputPeerLike): Promise<void>;

package/highlevel/methods/chats/open-chat.d.cts

@@ -0,0 +1,26 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/peers/index.js';
+/**
+ * Inform the library that the user has opened a chat.
+ *
+ * Some library logic depends on this, for example, the library will
+ * periodically ping the server to keep the updates flowing.
+ *
+ * > **Warning**: Opening a chat with `openChat` method will make the library make additional requests
+ * > every so often. Which means that you should **avoid opening more than 5-10 chats at once**,
+ * > as it will probably trigger server-side limits and you might start getting transport errors
+ * > or even get banned.
+ *
+ * @param chat  Chat to open
+ */
+export declare function openChat(client: ITelegramClient, chat: InputPeerLike): Promise<void>;
+/**
+ * Inform the library that the user has closed a chat.
+ * Un-does the effect of {@link openChat}.
+ *
+ * Some library logic depends on this, for example, the library will
+ * periodically ping the server to keep the updates flowing.
+ *
+ * @param chat  Chat to open
+ */
+export declare function closeChat(client: ITelegramClient, chat: InputPeerLike): Promise<void>;

package/highlevel/methods/chats/reorder-usernames.d.cts

@@ -0,0 +1,8 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Reorder usernames
+ *
+ * @param peerId  Bot, channel or "me"/"self"
+ */
+export declare function reorderUsernames(client: ITelegramClient, peerId: InputPeerLike, order: string[]): Promise<void>;

package/highlevel/methods/chats/restrict-chat-member.d.cts

@@ -0,0 +1,28 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Restrict a user in a supergroup.
+ */
+export declare function restrictChatMember(client: ITelegramClient, params: {
+    /** Chat ID */
+    chatId: InputPeerLike;
+    /** User ID */
+    userId: InputPeerLike;
+    /**
+     * Restrictions for the user. Note that unlike Bot API, this object contains
+     * the restrictions, and not the permissions, i.e.
+     * passing `sendMessages=true` will disallow the user to send messages,
+     * and passing `{}` (empty object) will lift any restrictions
+     */
+    restrictions: Omit<tl.RawChatBannedRights, '_' | 'untilDate'>;
+    /**
+     * Date when the user will be unrestricted.
+     * When `number` is passed, UNIX time in ms is expected.
+     * If this value is less than 30 seconds or more than 366 days in
+     * the future, user will be restricted forever.
+     *
+     * @default  `0`, i.e. forever
+     */
+    until?: number | Date;
+}): Promise<void>;

package/highlevel/methods/chats/save-draft.d.cts

@@ -0,0 +1,10 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Save or delete a draft message associated with some chat
+ *
+ * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
+ * @param draft  Draft message, or `null` to delete.
+ */
+export declare function saveDraft(client: ITelegramClient, chatId: InputPeerLike, draft: null | Omit<tl.RawDraftMessage, '_' | 'date'>): Promise<void>;

package/highlevel/methods/chats/set-chat-color.d.cts

@@ -0,0 +1,38 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Set peer color and optionally background pattern
+ */
+export declare function setChatColor(client: ITelegramClient, params: {
+    /**
+     * Peer where to update the color.
+     *
+     * By default will change the color for the current user
+     */
+    peer?: InputPeerLike;
+    /**
+     * Color identificator
+     *
+     * Note that this value is **not** an RGB color representation. Instead, it is
+     * a number which should be used to pick a color from a predefined
+     * list of colors:
+     *  - `0-6` are the default colors used by Telegram clients:
+     *    `red, orange, purple, green, sea, blue, pink`
+     *  - `>= 7` are returned by `help.getAppConfig`.
+     */
+    color: number;
+    /**
+     * Background pattern emoji ID.
+     *
+     * Must be an adaptive emoji, otherwise the request will fail.
+     */
+    backgroundEmojiId?: tl.Long;
+    /**
+     * Whether to set this color for the profile
+     * header instead of chat name/replies.
+     *
+     * Currently only available for the current user.
+     */
+    forProfile?: boolean;
+}): Promise<void>;

package/highlevel/methods/chats/set-chat-default-permissions.d.cts

@@ -0,0 +1,16 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, Chat } from '../../types/index.js';
+/**
+ * Change default chat permissions for all members.
+ *
+ * You must be an administrator in the chat and have appropriate permissions.
+ *
+ * @param chatId  Chat ID or username
+ * @param restrictions
+ *     Restrictions for the chat. Note that unlike Bot API, this object contains
+ *     the restrictions, and not the permissions, i.e.
+ *     passing `sendMessages=true` will disallow the users to send messages,
+ *     and passing `{}` (empty object) will lift any restrictions
+ */
+export declare function setChatDefaultPermissions(client: ITelegramClient, chatId: InputPeerLike, restrictions: Omit<tl.RawChatBannedRights, '_' | 'untilDate'>): Promise<Chat>;

package/highlevel/methods/chats/set-chat-description.d.cts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Change chat description
+ *
+ * You must be an administrator and have the appropriate permissions.
+ *
+ * @param chatId  Chat ID or username
+ * @param description  New chat description, 0-255 characters
+ */
+export declare function setChatDescription(client: ITelegramClient, chatId: InputPeerLike, description: string): Promise<void>;

package/highlevel/methods/chats/set-chat-photo.d.cts

@@ -0,0 +1,20 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputFileLike, InputPeerLike } from '../../types/index.js';
+/**
+ * Set a new chat photo or video.
+ *
+ * You must be an administrator and have the appropriate permissions.
+ */
+export declare function setChatPhoto(client: ITelegramClient, params: {
+    /** Chat ID or username */
+    chatId: InputPeerLike;
+    /** Media type (photo or video) */
+    type: 'photo' | 'video';
+    /** Input media file */
+    media: InputFileLike;
+    /**
+     * When `type = video`, timestamp in seconds which will be shown
+     * as a static preview.
+     */
+    previewSec?: number;
+}): Promise<void>;

package/highlevel/methods/chats/set-chat-title.d.cts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Change chat title
+ *
+ * You must be an administrator and have the appropriate permissions.
+ *
+ * @param chatId  Chat ID or username
+ * @param title  New chat title, 1-255 characters
+ */
+export declare function setChatTitle(client: ITelegramClient, chatId: InputPeerLike, title: string): Promise<void>;

package/highlevel/methods/chats/set-chat-ttl.d.cts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Set maximum Time-To-Live of all newly sent messages in the specified chat
+ *
+ * @param chatId  Chat ID
+ * @param period  New TTL period, in seconds (or 0 to disable)
+ */
+export declare function setChatTtl(client: ITelegramClient, chatId: InputPeerLike, period: number): Promise<void>;

package/highlevel/methods/chats/set-chat-username.d.cts

@@ -0,0 +1,11 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Change supergroup/channel username
+ *
+ * You must be an administrator and have the appropriate permissions.
+ *
+ * @param chatId  Chat ID or current username
+ * @param username  New username, or `null` to remove
+ */
+export declare function setChatUsername(client: ITelegramClient, chatId: InputPeerLike, username: string | null): Promise<void>;

package/highlevel/methods/chats/set-slow-mode.d.cts

@@ -0,0 +1,12 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Set supergroup's slow mode interval.
+ *
+ * @param chatId  Chat ID or username
+ * @param seconds
+ *   Slow mode interval in seconds.
+ *   Users will be able to send a message only once per this interval.
+ *   Valid values are: `0 (off), 10, 30, 60 (1m), 300 (5m), 900 (15m) or 3600 (1h)`
+ */
+export declare function setSlowMode(client: ITelegramClient, chatId: InputPeerLike, seconds?: number): Promise<void>;

package/highlevel/methods/chats/toggle-content-protection.d.cts

@@ -0,0 +1,9 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Set whether a chat has content protection (i.e. forwarding messages is disabled)
+ *
+ * @param chatId  Chat ID or username
+ * @param enabled  Whether content protection should be enabled
+ */
+export declare function toggleContentProtection(client: ITelegramClient, chatId: InputPeerLike, enabled?: boolean): Promise<void>;

package/highlevel/methods/chats/toggle-fragment-username.d.cts

@@ -0,0 +1,20 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Toggle a collectible (Fragment) username
+ *
+ * > **Note**: non-collectible usernames must still be changed
+ * > using {@link setUsername}/{@link setChatUsername}
+ */
+export declare function toggleFragmentUsername(client: ITelegramClient, params: {
+    /** Peer ID whose username to toggle */
+    peerId: InputPeerLike;
+    /**
+     * Username to toggle
+     */
+    username: string;
+    /**
+     * Whether to enable or disable the username
+     */
+    active: boolean;
+}): Promise<void>;

package/highlevel/methods/chats/toggle-join-requests.d.cts

@@ -0,0 +1,12 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Set whether a channel/supergroup has join requests enabled.
+ *
+ * > **Note**: this method only affects primary invite links.
+ * > Additional invite links may exist with the opposite setting.
+ *
+ * @param chatId  Chat ID or username
+ * @param enabled  Whether join requests should be enabled
+ */
+export declare function toggleJoinRequests(client: ITelegramClient, chatId: InputPeerLike, enabled?: boolean): Promise<void>;

package/highlevel/methods/chats/toggle-join-to-send.d.cts

@@ -0,0 +1,12 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Set whether a channel/supergroup has join-to-send setting enabled.
+ *
+ * This only affects discussion groups where users can send messages
+ * without joining the group.
+ *
+ * @param chatId  Chat ID or username
+ * @param enabled  Whether join-to-send setting should be enabled
+ */
+export declare function toggleJoinToSend(client: ITelegramClient, chatId: InputPeerLike, enabled?: boolean): Promise<void>;

package/highlevel/methods/chats/unarchive-chats.d.cts

@@ -0,0 +1,9 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Unarchive one or more chats
+ *
+ * @param chats  Chat ID(s), username(s), phone number(s), `"me"` or `"self"`
+ */
+export declare function unarchiveChats(client: ITelegramClient, chats: MaybeArray<InputPeerLike>): Promise<void>;

package/highlevel/methods/chats/unban-chat-member.d.cts

@@ -0,0 +1,16 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike } from '../../types/index.js';
+/**
+ * Unban a user/channel from a supergroup or a channel,
+ * or remove any restrictions that they have.
+ * Unbanning does not add the user back to the chat, this
+ * just allows the user to join the chat again, if they want.
+ *
+ * This method acts as a no-op in case a legacy group is passed.
+ */
+export declare function unbanChatMember(client: ITelegramClient, params: {
+    /** Chat ID */
+    chatId: InputPeerLike;
+    /** User/channel ID who should be unbanned */
+    participantId: InputPeerLike;
+}): Promise<void>;

package/highlevel/methods/contacts/add-contact.d.cts

@@ -0,0 +1,28 @@
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, User } from '../../types/index.js';
+/**
+ * Add an existing Telegram user as a contact
+ */
+export declare function addContact(client: ITelegramClient, params: {
+    /** User ID, username or phone number */
+    userId: InputPeerLike;
+    /**
+     * First name of the contact
+     */
+    firstName: string;
+    /**
+     * Last name of the contact
+     */
+    lastName?: string;
+    /**
+     * Phone number of the contact, if available
+     */
+    phone?: string;
+    /**
+     * Whether to share your own phone number
+     * with the newly created contact
+     *
+     * @default false
+     */
+    sharePhone?: boolean;
+}): Promise<User>;

package/highlevel/methods/contacts/delete-contacts.d.cts

@@ -0,0 +1,12 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, User } from '../../types/index.js';
+/**
+ * Delete one or more contacts from your Telegram contacts list
+ *
+ * Returns deleted contact's profiles. Does not return
+ * profiles of users that were not in your contacts list
+ *
+ * @param userIds  User IDs, usernames or phone numbers
+ */
+export declare function deleteContacts(client: ITelegramClient, userIds: MaybeArray<InputPeerLike>): Promise<User[]>;

package/highlevel/methods/contacts/get-contacts.d.cts

@@ -0,0 +1,6 @@
+import { ITelegramClient } from '../../client.types.js';
+import { User } from '../../types/index.js';
+/**
+ * Get list of contacts from your Telegram contacts list.
+ */
+export declare function getContacts(client: ITelegramClient): Promise<User[]>;

package/highlevel/methods/contacts/import-contacts.d.cts

@@ -0,0 +1,9 @@
+import { tl } from '@mtcute/tl';
+import { PartialOnly } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Import contacts to your Telegram contacts list.
+ *
+ * @param contacts  List of contacts
+ */
+export declare function importContacts(client: ITelegramClient, contacts: PartialOnly<Omit<tl.RawInputPhoneContact, '_'>, 'clientId'>[]): Promise<tl.contacts.RawImportedContacts>;

package/highlevel/methods/dialogs/create-folder.d.cts

@@ -0,0 +1,13 @@
+import { tl } from '@mtcute/tl';
+import { PartialExcept } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Create a folder from given parameters
+ *
+ * ID for the folder is optional, if not
+ * provided it will be derived automatically.
+ *
+ * @param folder  Parameters for the folder
+ * @returns  Newly created folder
+ */
+export declare function createFolder(client: ITelegramClient, folder: PartialExcept<tl.RawDialogFilter, 'title'>): Promise<tl.RawDialogFilter>;

package/highlevel/methods/dialogs/delete-folder.d.cts

@@ -0,0 +1,8 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Delete a folder by its ID
+ *
+ * @param id  Folder ID or folder itself
+ */
+export declare function deleteFolder(client: ITelegramClient, id: number | tl.RawDialogFilter): Promise<void>;

package/highlevel/methods/dialogs/edit-folder.d.cts

@@ -0,0 +1,18 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Edit a folder with given modification
+ *
+ * @returns  Modified folder
+ */
+export declare function editFolder(client: ITelegramClient, params: {
+    /**
+     * Folder, folder ID or name.
+     * Note that passing an ID or name will require re-fetching all folders,
+     * and passing name might affect not the right folder if you have multiple
+     * with the same name.
+     */
+    folder: tl.RawDialogFilter | number | string;
+    /** Modification to be applied to this folder */
+    modification: Partial<Omit<tl.RawDialogFilter, 'id' | '_'>>;
+}): Promise<tl.RawDialogFilter>;

package/highlevel/methods/dialogs/find-dialogs.d.cts

@@ -0,0 +1,12 @@
+import { MaybeArray } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+import { Dialog } from '../../types/messages/dialog.js';
+/**
+ * Try to find a dialog (dialogs) with a given peer (peers) by their ID, username or phone number.
+ *
+ * This might be an expensive call, as it will potentially iterate over all
+ * dialogs to find the one with the given peer
+ *
+ * @throws {MtPeerNotFoundError}  If a dialog with any of the given peers was not found
+ */
+export declare function findDialogs(client: ITelegramClient, peers: MaybeArray<string | number>): Promise<Dialog[]>;

package/highlevel/methods/dialogs/find-folder.d.cts

@@ -0,0 +1,19 @@
+import { tl } from '@mtcute/tl';
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Find a folder by its parameter.
+ *
+ * > **Note**: Searching by title and/or emoji might not be
+ * > accurate since you can set the same title and/or emoji
+ * > to multiple folders.
+ *
+ * @param params  Search parameters. At least one must be set.
+ */
+export declare function findFolder(client: ITelegramClient, params: {
+    /** Folder title */
+    title?: string;
+    /** Folder emoji */
+    emoji?: string;
+    /** Folder ID */
+    id?: number;
+}): Promise<tl.RawDialogFilter | null>;