@mtcute/core 0.12.5 → 0.13.1

package/cjs/highlevel/client.d.ts

@@ -18,6 +18,7 @@ import { ForwardMessageOptions } from './methods/messages/forward-messages.js';
 import { getHistory, GetHistoryOffset } from './methods/messages/get-history.js';
 import { getReactionUsers, GetReactionUsersOffset } from './methods/messages/get-reaction-users.js';
 import { searchGlobal, SearchGlobalOffset } from './methods/messages/search-global.js';
+import { searchHashtag, SearchHashtagOffset } from './methods/messages/search-hashtag.js';
 import { searchMessages, SearchMessagesOffset } from './methods/messages/search-messages.js';
 import { CommonSendParams } from './methods/messages/send-common.js';
 import { SendCopyParams } from './methods/messages/send-copy.js';
@@ -34,7 +35,7 @@ import { getProfileStories } from './methods/stories/get-profile-stories.js';
 import { getStoryViewers } from './methods/stories/get-story-viewers.js';
 import { getProfilePhotos } from './methods/users/get-profile-photos.js';
 import { ITelegramStorageProvider } from './storage/provider.js';
-import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, MaybeDynamic, Message, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeersIndex, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, Sticker, StickerSet, StickerSourceType, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate } from './types/index.js';
+import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeersIndex, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, Sticker, StickerSet, StickerSourceType, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate } from './types/index.js';
 import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { StringSessionData } from './utils/string-session.js';
 type TelegramClientOptions = ((PartialOnly<Omit<BaseTelegramClientOptions, 'storage'>, 'transport' | 'crypto'> & {
@@ -698,6 +699,17 @@ export interface TelegramClient extends ITelegramClient {
          * @default  `10000` (10 sec)
          */
         timeout?: number;
+        /**
+         * Whether to "fire and forget" this request,
+         * in which case the promise will resolve as soon
+         * as the request is sent with an empty response.
+         *
+         * Useful for interacting with bots that don't correctly
+         * answer to callback queries and the request always times out.
+         *
+         * **Note**: any errors will be silently ignored.
+         */
+        fireAndForget?: boolean;
         /**
          * Whether this is a "play game" button
          */
@@ -1723,6 +1735,17 @@ export interface TelegramClient extends ITelegramClient {
         /** Modification to be applied to this folder */
         modification: Partial<Omit<tl.RawDialogFilter, 'id' | '_'>>;
     }): Promise<tl.RawDialogFilter>;
+    /**
+     * 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
+     *
+     * **Available**: 👤 users only
+     *
+     * @throws {MtPeerNotFoundError}  If a dialog with any of the given peers was not found
+     */
+    findDialogs(peers: MaybeArray<string | number>): Promise<Dialog[]>;
     /**
      * Find a folder by its parameter.
      *
@@ -1742,6 +1765,14 @@ export interface TelegramClient extends ITelegramClient {
         /** Folder ID */
         id?: number;
     }): Promise<tl.RawDialogFilter | null>;
+    /**
+     * Get a preview of a chatlist by its invite link
+     *
+     * **Available**: ✅ both users and bots
+     *
+     * @param link  Invite link
+     */
+    getChatlistPreview(link: string): Promise<ChatlistPreview>;
     /**
      * Get list of folders.
      * **Available**: 👤 users only
@@ -1858,6 +1889,19 @@ export interface TelegramClient extends ITelegramClient {
          */
         filter?: Partial<Omit<tl.RawDialogFilter, '_' | 'id' | 'title'>>;
     }): AsyncIterableIterator<Dialog>;
+    /**
+     * Join a chatlist by its link
+     *
+     * **Available**: ✅ both users and bots
+     *
+     * @param link  Invite link to the chatlist
+     * @param params  Additional parameters
+     * @returns  Folder representing the chatlist
+     */
+    joinChatlist(link: string, params?: {
+        /** Chats to join from the chatlist (all by default) */
+        peers?: MaybeArray<InputPeerLike>;
+    }): Promise<tl.RawDialogFilterChatlist>;
     /**
      * Reorder folders
      *
@@ -2678,6 +2722,12 @@ export interface TelegramClient extends ITelegramClient {
      * @param chatId  Chat's marked ID, its username, phone or `"me"` or `"self"`
      */
     getAllScheduledMessages(chatId: InputPeerLike): Promise<Message[]>;
+    /**
+     * Get a list of available message effects
+     * **Available**: 👤 users only
+     *
+     */
+    getAvailableMessageEffects(): Promise<MessageEffect[]>;
     /**
      * Get the message containing the button being clicked
      * in the given callback query.
@@ -2706,6 +2756,15 @@ export interface TelegramClient extends ITelegramClient {
      * @param message  ID of the channel post
      */
     getDiscussionMessage(params: InputMessageId): Promise<Message | null>;
+    /**
+     * Get fact check information for one or more messages in a chat
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat where the messages are located
+     * @param msgIds  One or more message IDs
+     */
+    getFactCheck(chatId: InputPeerLike, msgIds: MaybeArray<number>): Promise<(FactCheck | null)[]>;
     /**
      * Get chat history.
      *
@@ -3077,6 +3136,45 @@ export interface TelegramClient extends ITelegramClient {
          */
         onlyChannels?: boolean;
     }): Promise<ArrayPaginated<Message, SearchGlobalOffset>>;
+    /**
+     * Perform a global hashtag search, across the entire Telegram
+     *
+     * **Available**: 👤 users only
+     *
+     * @param hashtag  Hashtag to search for
+     * @param params  Additional parameters
+     */
+    searchHashtag(hashtag: string, params?: {
+        /** Offset for the search */
+        offset?: SearchHashtagOffset;
+        /** Limit the number of results */
+        limit?: number;
+    }): Promise<ArrayPaginated<Message, SearchHashtagOffset>>;
+    /**
+     * Perform a global hashtag search, across the entire Telegram
+     *
+     * Iterable version of {@link searchHashtag}
+     *
+     * **Available**: ✅ both users and bots
+     *
+     * @param hashtag  Hashtag to search for
+     * @param params  Additional parameters
+     */
+    iterSearchHashtag(hashtag: string, params?: Parameters<typeof searchHashtag>[2] & {
+        /**
+         * Limits the number of messages to be retrieved.
+         *
+         * @default  `Infinity`, i.e. all messages are returned
+         */
+        limit?: number;
+        /**
+         * Chunk size, which will be passed as `limit` parameter
+         * for `messages.search`. Usually you shouldn't care about this.
+         *
+         * @default  100
+         */
+        chunkSize?: number;
+    }): AsyncIterableIterator<Message>;
     /**
      * Search for messages inside a specific chat
      *
@@ -4471,6 +4569,8 @@ export interface TelegramClient extends ITelegramClient {
      * while also normalizing and removing
      * peers that can't be normalized to that type.
      *
+     * If a peer was not found, it will be skipped.
+     *
      * Uses async pool internally, with a concurrent limit of 8
      *
      * @param peerIds  Peer Ids
@@ -4480,11 +4580,13 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get multiple `InputPeer`s at once.
      *
+     * If a peer was not found, `null` will be returned instead
+     *
      * Uses async pool internally, with a concurrent limit of 8
      *
      * @param peerIds  Peer Ids
      */
-    resolvePeerMany(peerIds: InputPeerLike[]): Promise<tl.TypeInputPeer[]>;
+    resolvePeerMany(peerIds: InputPeerLike[]): Promise<(tl.TypeInputPeer | null)[]>;
     /**
      * Get the `InputPeer` of a known peer id.
      * Useful when an `InputPeer` is needed in Raw API.

package/cjs/highlevel/client.js

@@ -108,10 +108,13 @@ const import_contacts_js_1 = require("./methods/contacts/import-contacts.js");
 const create_folder_js_1 = require("./methods/dialogs/create-folder.js");
 const delete_folder_js_1 = require("./methods/dialogs/delete-folder.js");
 const edit_folder_js_1 = require("./methods/dialogs/edit-folder.js");
+const find_dialogs_js_1 = require("./methods/dialogs/find-dialogs.js");
 const find_folder_js_1 = require("./methods/dialogs/find-folder.js");
+const get_chatlist_preview_js_1 = require("./methods/dialogs/get-chatlist-preview.js");
 const get_folders_js_1 = require("./methods/dialogs/get-folders.js");
 const get_peer_dialogs_js_1 = require("./methods/dialogs/get-peer-dialogs.js");
 const iter_dialogs_js_1 = require("./methods/dialogs/iter-dialogs.js");
+const join_chatlist_js_1 = require("./methods/dialogs/join-chatlist.js");
 const set_folders_order_js_1 = require("./methods/dialogs/set-folders-order.js");
 const download_buffer_js_1 = require("./methods/files/download-buffer.js");
 const download_iterable_js_1 = require("./methods/files/download-iterable.js");
@@ -150,8 +153,10 @@ const edit_inline_message_js_1 = require("./methods/messages/edit-inline-message
 const edit_message_js_1 = require("./methods/messages/edit-message.js");
 const forward_messages_js_1 = require("./methods/messages/forward-messages.js");
 const get_all_scheduled_messages_js_1 = require("./methods/messages/get-all-scheduled-messages.js");
+const get_available_effects_js_1 = require("./methods/messages/get-available-effects.js");
 const get_callback_query_message_js_1 = require("./methods/messages/get-callback-query-message.js");
 const get_discussion_message_js_1 = require("./methods/messages/get-discussion-message.js");
+const get_fact_check_js_1 = require("./methods/messages/get-fact-check.js");
 const get_history_js_1 = require("./methods/messages/get-history.js");
 const get_message_by_link_js_1 = require("./methods/messages/get-message-by-link.js");
 const get_message_group_js_1 = require("./methods/messages/get-message-group.js");
@@ -169,6 +174,7 @@ const pin_message_js_1 = require("./methods/messages/pin-message.js");
 const read_history_js_1 = require("./methods/messages/read-history.js");
 const read_reactions_js_1 = require("./methods/messages/read-reactions.js");
 const search_global_js_1 = require("./methods/messages/search-global.js");
+const search_hashtag_js_1 = require("./methods/messages/search-hashtag.js");
 const search_messages_js_1 = require("./methods/messages/search-messages.js");
 const send_answer_js_1 = require("./methods/messages/send-answer.js");
 const send_comment_js_1 = require("./methods/messages/send-comment.js");
@@ -551,9 +557,15 @@ TelegramClient.prototype.deleteFolder = function (...args) {
 TelegramClient.prototype.editFolder = function (...args) {
     return (0, edit_folder_js_1.editFolder)(this._client, ...args);
 };
+TelegramClient.prototype.findDialogs = function (...args) {
+    return (0, find_dialogs_js_1.findDialogs)(this._client, ...args);
+};
 TelegramClient.prototype.findFolder = function (...args) {
     return (0, find_folder_js_1.findFolder)(this._client, ...args);
 };
+TelegramClient.prototype.getChatlistPreview = function (...args) {
+    return (0, get_chatlist_preview_js_1.getChatlistPreview)(this._client, ...args);
+};
 TelegramClient.prototype.getFolders = function (...args) {
     return (0, get_folders_js_1.getFolders)(this._client, ...args);
 };
@@ -563,6 +575,9 @@ TelegramClient.prototype.getPeerDialogs = function (...args) {
 TelegramClient.prototype.iterDialogs = function (...args) {
     return (0, iter_dialogs_js_1.iterDialogs)(this._client, ...args);
 };
+TelegramClient.prototype.joinChatlist = function (...args) {
+    return (0, join_chatlist_js_1.joinChatlist)(this._client, ...args);
+};
 TelegramClient.prototype.setFoldersOrder = function (...args) {
     return (0, set_folders_order_js_1.setFoldersOrder)(this._client, ...args);
 };
@@ -683,12 +698,18 @@ TelegramClient.prototype.forwardMessages = function (...args) {
 TelegramClient.prototype.getAllScheduledMessages = function (...args) {
     return (0, get_all_scheduled_messages_js_1.getAllScheduledMessages)(this._client, ...args);
 };
+TelegramClient.prototype.getAvailableMessageEffects = function (...args) {
+    return (0, get_available_effects_js_1.getAvailableMessageEffects)(this._client, ...args);
+};
 TelegramClient.prototype.getCallbackQueryMessage = function (...args) {
     return (0, get_callback_query_message_js_1.getCallbackQueryMessage)(this._client, ...args);
 };
 TelegramClient.prototype.getDiscussionMessage = function (...args) {
     return (0, get_discussion_message_js_1.getDiscussionMessage)(this._client, ...args);
 };
+TelegramClient.prototype.getFactCheck = function (...args) {
+    return (0, get_fact_check_js_1.getFactCheck)(this._client, ...args);
+};
 TelegramClient.prototype.getHistory = function (...args) {
     return (0, get_history_js_1.getHistory)(this._client, ...args);
 };
@@ -743,6 +764,12 @@ TelegramClient.prototype.readReactions = function (...args) {
 TelegramClient.prototype.searchGlobal = function (...args) {
     return (0, search_global_js_1.searchGlobal)(this._client, ...args);
 };
+TelegramClient.prototype.searchHashtag = function (...args) {
+    return (0, search_hashtag_js_1.searchHashtag)(this._client, ...args);
+};
+TelegramClient.prototype.iterSearchHashtag = function (...args) {
+    return (0, search_hashtag_js_1.iterSearchHashtag)(this._client, ...args);
+};
 TelegramClient.prototype.searchMessages = function (...args) {
     return (0, search_messages_js_1.searchMessages)(this._client, ...args);
 };