@mtcute/core 0.12.2 → 0.13.0

package/cjs/platform.js

@@ -9,14 +9,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPlatform = exports.setPlatform = void 0;
 const tl_runtime_1 = require("@mtcute/tl-runtime");
 const errors_js_1 = require("./types/errors.js");
-// eslint-disable-next-line
-const globalObject = (0, eval)('this');
 // NB: when using with some bundlers (e.g. vite) re-importing this module will not return the same object
 // so we need to store the platform in a global object to be able to survive hot-reloads etc.
 // try to use Symbol if available, otherwise fallback to a string
 const platformKey = typeof Symbol !== 'undefined' ? Symbol.for('mtcute.platform') : '__MTCUTE_PLATFORM__';
-// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
-let _platform = globalObject?.[platformKey] ?? null;
+// eslint-disable-next-line
+let _platform = globalThis?.[platformKey] ?? null;
 function setPlatform(platform) {
     if (_platform) {
         if (_platform.constructor !== platform.constructor) {
@@ -27,9 +25,7 @@ function setPlatform(platform) {
     _platform = platform;
     tl_runtime_1.TlBinaryReader.platform = platform;
     tl_runtime_1.TlBinaryWriter.platform = platform;
-    if (globalObject) {
-        globalObject[platformKey] = platform;
-    }
+    globalThis[platformKey] = platform;
 }
 exports.setPlatform = setPlatform;
 function getPlatform() {

package/cjs/platform.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/platform.ts"],"names":[],"mappings":";;;AAAA,mDAAgF;AAGhF,iDAAsD;AAiBtD,2BAA2B;AAC3B,MAAM,YAAY,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtC,yGAAyG;AACzG,6FAA6F;AAC7F,iEAAiE;AACjE,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAA;AAEzG,mEAAmE;AACnE,IAAI,SAAS,GAAyB,YAAY,EAAE,CAAC,WAAW,CAAC,IAAI,IAAI,CAAA;AAEzE,SAAgB,WAAW,CAAC,QAAuB;IAC/C,IAAI,SAAS,EAAE,CAAC;QACZ,IAAI,SAAS,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC;YACjD,MAAM,IAAI,8BAAkB,CAAC,yCAAyC,CAAC,CAAA;QAC3E,CAAC;QAED,OAAM;IACV,CAAC;IAED,SAAS,GAAG,QAAQ,CAAA;IACpB,2BAAc,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAClC,2BAAc,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAElC,IAAI,YAAY,EAAE,CAAC;QACf,YAAY,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAA;IACxC,CAAC;AACL,CAAC;AAhBD,kCAgBC;AAED,SAAgB,WAAW;IACvB,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,MAAM,IAAI,8BAAkB,CAAC,wDAAwD,CAAC,CAAA;IAC1F,CAAC;IAED,OAAO,SAAS,CAAA;AACpB,CAAC;AAND,kCAMC","sourcesContent":["import { ITlPlatform, TlBinaryReader, TlBinaryWriter } from '@mtcute/tl-runtime'\n\nimport { UploadFileLike } from './highlevel/types/files/utils.js'\nimport { MtUnsupportedError } from './types/errors.js'\nimport { MaybePromise } from './types/index.js'\n\nexport interface ICorePlatform extends ITlPlatform {\n    beforeExit(fn: () => void): () => void\n    log(color: number, level: number, tag: string, fmt: string, args: unknown[]): void\n    getDefaultLogLevel(): number | null\n    getDeviceModel(): string\n    normalizeFile?(file: UploadFileLike): MaybePromise<{\n        file?: UploadFileLike\n        fileSize?: number\n        fileName?: string\n    } | null>\n    onNetworkChanged?(fn: (connected: boolean) => void): () => void\n    isOnline?(): boolean\n}\n\n// eslint-disable-next-line\nconst globalObject = (0, eval)('this')\n\n// NB: when using with some bundlers (e.g. vite) re-importing this module will not return the same object\n// so we need to store the platform in a global object to be able to survive hot-reloads etc.\n// try to use Symbol if available, otherwise fallback to a string\nconst platformKey = typeof Symbol !== 'undefined' ? Symbol.for('mtcute.platform') : '__MTCUTE_PLATFORM__'\n\n// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\nlet _platform: ICorePlatform | null = globalObject?.[platformKey] ?? null\n\nexport function setPlatform(platform: ICorePlatform): void {\n    if (_platform) {\n        if (_platform.constructor !== platform.constructor) {\n            throw new MtUnsupportedError('Platform may not be changed at runtime!')\n        }\n\n        return\n    }\n\n    _platform = platform\n    TlBinaryReader.platform = platform\n    TlBinaryWriter.platform = platform\n\n    if (globalObject) {\n        globalObject[platformKey] = platform\n    }\n}\n\nexport function getPlatform(): ICorePlatform {\n    if (!_platform) {\n        throw new MtUnsupportedError('Platform is not set! Have you instantiated the client?')\n    }\n\n    return _platform\n}\n"]}
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/platform.ts"],"names":[],"mappings":";;;AAAA,mDAAgF;AAGhF,iDAAsD;AAiBtD,yGAAyG;AACzG,6FAA6F;AAC7F,iEAAiE;AACjE,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAA;AAEzG,2BAA2B;AAC3B,IAAI,SAAS,GAA0B,UAAkB,EAAE,CAAC,WAAW,CAAC,IAAI,IAAI,CAAA;AAEhF,SAAgB,WAAW,CAAC,QAAuB;IAC/C,IAAI,SAAS,EAAE,CAAC;QACZ,IAAI,SAAS,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC;YACjD,MAAM,IAAI,8BAAkB,CAAC,yCAAyC,CAAC,CAAA;QAC3E,CAAC;QAED,OAAM;IACV,CAAC;IAED,SAAS,GAAG,QAAQ,CAAA;IACpB,2BAAc,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAClC,2BAAc,CAAC,QAAQ,GAAG,QAAQ,CAGjC;IAAC,UAAkB,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAA;AAChD,CAAC;AAfD,kCAeC;AAED,SAAgB,WAAW;IACvB,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,MAAM,IAAI,8BAAkB,CAAC,wDAAwD,CAAC,CAAA;IAC1F,CAAC;IAED,OAAO,SAAS,CAAA;AACpB,CAAC;AAND,kCAMC","sourcesContent":["import { ITlPlatform, TlBinaryReader, TlBinaryWriter } from '@mtcute/tl-runtime'\n\nimport { UploadFileLike } from './highlevel/types/files/utils.js'\nimport { MtUnsupportedError } from './types/errors.js'\nimport { MaybePromise } from './types/index.js'\n\nexport interface ICorePlatform extends ITlPlatform {\n    beforeExit(fn: () => void): () => void\n    log(color: number, level: number, tag: string, fmt: string, args: unknown[]): void\n    getDefaultLogLevel(): number | null\n    getDeviceModel(): string\n    normalizeFile?(file: UploadFileLike): MaybePromise<{\n        file?: UploadFileLike\n        fileSize?: number\n        fileName?: string\n    } | null>\n    onNetworkChanged?(fn: (connected: boolean) => void): () => void\n    isOnline?(): boolean\n}\n\n// NB: when using with some bundlers (e.g. vite) re-importing this module will not return the same object\n// so we need to store the platform in a global object to be able to survive hot-reloads etc.\n// try to use Symbol if available, otherwise fallback to a string\nconst platformKey = typeof Symbol !== 'undefined' ? Symbol.for('mtcute.platform') : '__MTCUTE_PLATFORM__'\n\n// eslint-disable-next-line\nlet _platform: ICorePlatform | null = (globalThis as any)?.[platformKey] ?? null\n\nexport function setPlatform(platform: ICorePlatform): void {\n    if (_platform) {\n        if (_platform.constructor !== platform.constructor) {\n            throw new MtUnsupportedError('Platform may not be changed at runtime!')\n        }\n\n        return\n    }\n\n    _platform = platform\n    TlBinaryReader.platform = platform\n    TlBinaryWriter.platform = platform\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    ;(globalThis as any)[platformKey] = platform\n}\n\nexport function getPlatform(): ICorePlatform {\n    if (!_platform) {\n        throw new MtUnsupportedError('Platform is not set! Have you instantiated the client?')\n    }\n\n    return _platform\n}\n"]}

package/esm/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, 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.
      *
@@ -2678,6 +2701,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 +2735,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 +3115,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 +4548,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 +4559,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/esm/highlevel/client.js

@@ -82,6 +82,7 @@ import { importContacts } from './methods/contacts/import-contacts.js';
 import { createFolder } from './methods/dialogs/create-folder.js';
 import { deleteFolder } from './methods/dialogs/delete-folder.js';
 import { editFolder } from './methods/dialogs/edit-folder.js';
+import { findDialogs } from './methods/dialogs/find-dialogs.js';
 import { findFolder } from './methods/dialogs/find-folder.js';
 import { getFolders } from './methods/dialogs/get-folders.js';
 import { getPeerDialogs } from './methods/dialogs/get-peer-dialogs.js';
@@ -124,8 +125,10 @@ import { editInlineMessage } from './methods/messages/edit-inline-message.js';
 import { editMessage } from './methods/messages/edit-message.js';
 import { forwardMessages, forwardMessagesById } from './methods/messages/forward-messages.js';
 import { getAllScheduledMessages } from './methods/messages/get-all-scheduled-messages.js';
+import { getAvailableMessageEffects } from './methods/messages/get-available-effects.js';
 import { getCallbackQueryMessage } from './methods/messages/get-callback-query-message.js';
 import { getDiscussionMessage } from './methods/messages/get-discussion-message.js';
+import { getFactCheck } from './methods/messages/get-fact-check.js';
 import { getHistory } from './methods/messages/get-history.js';
 import { getMessageByLink } from './methods/messages/get-message-by-link.js';
 import { getMessageGroup } from './methods/messages/get-message-group.js';
@@ -143,6 +146,7 @@ import { pinMessage } from './methods/messages/pin-message.js';
 import { readHistory } from './methods/messages/read-history.js';
 import { readReactions } from './methods/messages/read-reactions.js';
 import { searchGlobal } from './methods/messages/search-global.js';
+import { iterSearchHashtag, searchHashtag } from './methods/messages/search-hashtag.js';
 import { searchMessages } from './methods/messages/search-messages.js';
 import { answerMedia, answerMediaGroup, answerText } from './methods/messages/send-answer.js';
 import { commentMedia, commentMediaGroup, commentText } from './methods/messages/send-comment.js';
@@ -260,7 +264,7 @@ export class TelegramClient extends EventEmitter {
             this._client.onUpdate(makeParsedUpdateHandler({
                 messageGroupingInterval,
                 onUpdate: (update) => {
-                    if (Conversation.handleUpdate(this._client, update) && skipConversationUpdates)
+                    if (Conversation.handleUpdate(this, update) && skipConversationUpdates)
                         return;
                     this.emit('update', update);
                     this.emit(update.name, update.data);
@@ -524,6 +528,9 @@ TelegramClient.prototype.deleteFolder = function (...args) {
 TelegramClient.prototype.editFolder = function (...args) {
     return editFolder(this._client, ...args);
 };
+TelegramClient.prototype.findDialogs = function (...args) {
+    return findDialogs(this._client, ...args);
+};
 TelegramClient.prototype.findFolder = function (...args) {
     return findFolder(this._client, ...args);
 };
@@ -656,12 +663,18 @@ TelegramClient.prototype.forwardMessages = function (...args) {
 TelegramClient.prototype.getAllScheduledMessages = function (...args) {
     return getAllScheduledMessages(this._client, ...args);
 };
+TelegramClient.prototype.getAvailableMessageEffects = function (...args) {
+    return getAvailableMessageEffects(this._client, ...args);
+};
 TelegramClient.prototype.getCallbackQueryMessage = function (...args) {
     return getCallbackQueryMessage(this._client, ...args);
 };
 TelegramClient.prototype.getDiscussionMessage = function (...args) {
     return getDiscussionMessage(this._client, ...args);
 };
+TelegramClient.prototype.getFactCheck = function (...args) {
+    return getFactCheck(this._client, ...args);
+};
 TelegramClient.prototype.getHistory = function (...args) {
     return getHistory(this._client, ...args);
 };
@@ -716,6 +729,12 @@ TelegramClient.prototype.readReactions = function (...args) {
 TelegramClient.prototype.searchGlobal = function (...args) {
     return searchGlobal(this._client, ...args);
 };
+TelegramClient.prototype.searchHashtag = function (...args) {
+    return searchHashtag(this._client, ...args);
+};
+TelegramClient.prototype.iterSearchHashtag = function (...args) {
+    return iterSearchHashtag(this._client, ...args);
+};
 TelegramClient.prototype.searchMessages = function (...args) {
     return searchMessages(this._client, ...args);
 };