@mtcute/core 0.17.1 → 0.18.0

package/highlevel/client.d.ts

@@ -1,22 +1,13 @@
-import { default as EventEmitter } from 'events';
-import { default as Long } from 'long';
 import { tdFileId } from '@mtcute/file-id';
 import { tl } from '@mtcute/tl';
+import { default as Long } from 'long';
 import { RpcCallOptions } from '../network/index.js';
 import { MaybeArray, MaybePromise, PartialExcept, PartialOnly } from '../types/index.js';
 import { BaseTelegramClientOptions } from './base.js';
 import { ITelegramClient } from './client.types.js';
-import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatMember, ChatMemberUpdate, ChatPreview, ChatlistPreview, 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, PeerStories, PeersIndex, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, StarGift, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadFileLike, UploadedFile, User, UserStarGift, UserStatusUpdate, UserTypingUpdate } from './types/index.js';
-import { StringSessionData } from './utils/string-session.js';
-import { ITelegramStorageProvider } from './storage/provider.js';
-import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { LogOutResult } from './methods/auth/log-out.js';
-import { start } from './methods/auth/start.js';
 import { CreateGroupResult } from './methods/chats/create-group.js';
-import { getChatEventLog } from './methods/chats/get-chat-event-log.js';
-import { getChatMembers } from './methods/chats/get-chat-members.js';
 import { GetForumTopicsOffset, getForumTopics } from './methods/forums/get-forum-topics.js';
-import { getInviteLinkMembers } from './methods/invite-links/get-invite-link-members.js';
 import { GetInviteLinksOffset, getInviteLinks } from './methods/invite-links/get-invite-links.js';
 import { DeleteMessagesParams } from './methods/messages/delete-messages.js';
 import { ForwardMessageOptions } from './methods/messages/forward-messages.js';
@@ -28,20 +19,30 @@ import { SearchMessagesOffset, searchMessages } from './methods/messages/search-
 import { CommonSendParams } from './methods/messages/send-common.js';
 import { SendCopyGroupParams } from './methods/messages/send-copy-group.js';
 import { SendCopyParams } from './methods/messages/send-copy.js';
+import { QuoteParamsFrom } from './methods/messages/send-quote.js';
+import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
+import { CanSendStoryResult } from './methods/stories/can-send-story.js';
+import { ITelegramStorageProvider } from './storage/provider.js';
+import { AllStories, ArrayPaginated, ArrayWithTotal, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, 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, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputFileLike, InputInlineResult, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, PeerReaction, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, SentCode, StarGift, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStarGift, UserStatusUpdate, UserTypingUpdate, WebviewResult } from './types/index.js';
+import { ParsedUpdateHandlerParams } from './updates/parsed.js';
+import { RawUpdateInfo } from './updates/types.js';
+import { InputStringSessionData } from './utils/string-session.js';
+import { Emitter } from '@fuman/utils';
+import { start } from './methods/auth/start.js';
+import { getChatEventLog } from './methods/chats/get-chat-event-log.js';
+import { getChatMembers } from './methods/chats/get-chat-members.js';
+import { getInviteLinkMembers } from './methods/invite-links/get-invite-link-members.js';
 import { sendMediaGroup } from './methods/messages/send-media-group.js';
 import { sendMedia } from './methods/messages/send-media.js';
-import { QuoteParamsFrom } from './methods/messages/send-quote.js';
 import { sendText } from './methods/messages/send-text.js';
-import { CanApplyBoostResult } from './methods/premium/can-apply-boost.js';
 import { getBoosts } from './methods/premium/get-boosts.js';
 import { getStarGifts } from './methods/premium/get-star-gifts.js';
 import { getStarsTransactions } from './methods/premium/get-stars-transactions.js';
-import { CanSendStoryResult } from './methods/stories/can-send-story.js';
 import { getAllStories } from './methods/stories/get-all-stories.js';
 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';
-type TelegramClientOptions = ((PartialOnly<Omit<BaseTelegramClientOptions, 'storage'>, 'transport' | 'crypto'> & {
+type TelegramClientOptions = ((PartialOnly<Omit<BaseTelegramClientOptions, 'storage'>, 'transport' | 'crypto' | 'platform'> & {
     /**
      * Storage to use for this client.
      *
@@ -72,217 +73,65 @@ type TelegramClientOptions = ((PartialOnly<Omit<BaseTelegramClientOptions, 'stor
     skipConversationUpdates?: boolean;
 };
 export interface TelegramClient extends ITelegramClient {
-    /**
-     * Register a raw update handler
-     *
-     * @param name  Event name
-     * @param handler  Raw update handler
-     */
-    on(name: 'raw_update', handler: ((upd: tl.TypeUpdate | tl.TypeMessage, peers: PeersIndex) => void)): this;
-    /**
-     * Register a parsed update handler
-     *
-     * @param name  Event name
-     * @param handler  Raw update handler
-     */
-    on(name: 'update', handler: ((upd: ParsedUpdate) => void)): this;
-    /**
-     * Register a new message handler
-     *
-     * @param name  Event name
-     * @param handler  New message handler
-     */
-    on(name: 'new_message', handler: ((upd: Message) => void)): this;
-    /**
-     * Register an edit message handler
-     *
-     * @param name  Event name
-     * @param handler  Edit message handler
-     */
-    on(name: 'edit_message', handler: ((upd: Message) => void)): this;
-    /**
-     * Register a message group handler
-     *
-     * @param name  Event name
-     * @param handler  Message group handler
-     */
-    on(name: 'message_group', handler: ((upd: Message[]) => void)): this;
-    /**
-     * Register a delete message handler
-     *
-     * @param name  Event name
-     * @param handler  Delete message handler
-     */
-    on(name: 'delete_message', handler: ((upd: DeleteMessageUpdate) => void)): this;
-    /**
-     * Register a chat member update handler
-     *
-     * @param name  Event name
-     * @param handler  Chat member update handler
-     */
-    on(name: 'chat_member', handler: ((upd: ChatMemberUpdate) => void)): this;
-    /**
-     * Register an inline query handler
-     *
-     * @param name  Event name
-     * @param handler  Inline query handler
-     */
-    on(name: 'inline_query', handler: ((upd: InlineQuery) => void)): this;
-    /**
-     * Register a chosen inline result handler
-     *
-     * @param name  Event name
-     * @param handler  Chosen inline result handler
-     */
-    on(name: 'chosen_inline_result', handler: ((upd: ChosenInlineResult) => void)): this;
-    /**
-     * Register a callback query handler
-     *
-     * @param name  Event name
-     * @param handler  Callback query handler
-     */
-    on(name: 'callback_query', handler: ((upd: CallbackQuery) => void)): this;
-    /**
-     * Register an inline callback query handler
-     *
-     * @param name  Event name
-     * @param handler  Inline callback query handler
-     */
-    on(name: 'inline_callback_query', handler: ((upd: InlineCallbackQuery) => void)): this;
-    /**
-     * Register a business callback query handler
-     *
-     * @param name  Event name
-     * @param handler  Business callback query handler
-     */
-    on(name: 'business_callback_query', handler: ((upd: BusinessCallbackQuery) => void)): this;
-    /**
-     * Register a poll update handler
-     *
-     * @param name  Event name
-     * @param handler  Poll update handler
-     */
-    on(name: 'poll', handler: ((upd: PollUpdate) => void)): this;
-    /**
-     * Register a poll vote handler
-     *
-     * @param name  Event name
-     * @param handler  Poll vote handler
-     */
-    on(name: 'poll_vote', handler: ((upd: PollVoteUpdate) => void)): this;
-    /**
-     * Register an user status update handler
-     *
-     * @param name  Event name
-     * @param handler  User status update handler
-     */
-    on(name: 'user_status', handler: ((upd: UserStatusUpdate) => void)): this;
-    /**
-     * Register an user typing handler
-     *
-     * @param name  Event name
-     * @param handler  User typing handler
-     */
-    on(name: 'user_typing', handler: ((upd: UserTypingUpdate) => void)): this;
-    /**
-     * Register a history read handler
-     *
-     * @param name  Event name
-     * @param handler  History read handler
-     */
-    on(name: 'history_read', handler: ((upd: HistoryReadUpdate) => void)): this;
-    /**
-     * Register a bot stopped handler
-     *
-     * @param name  Event name
-     * @param handler  Bot stopped handler
-     */
-    on(name: 'bot_stopped', handler: ((upd: BotStoppedUpdate) => void)): this;
-    /**
-     * Register a bot chat join request handler
-     *
-     * @param name  Event name
-     * @param handler  Bot chat join request handler
-     */
-    on(name: 'bot_chat_join_request', handler: ((upd: BotChatJoinRequestUpdate) => void)): this;
-    /**
-     * Register a chat join request handler
-     *
-     * @param name  Event name
-     * @param handler  Chat join request handler
-     */
-    on(name: 'chat_join_request', handler: ((upd: ChatJoinRequestUpdate) => void)): this;
-    /**
-     * Register a pre checkout query handler
-     *
-     * @param name  Event name
-     * @param handler  Pre checkout query handler
-     */
-    on(name: 'pre_checkout_query', handler: ((upd: PreCheckoutQuery) => void)): this;
-    /**
-     * Register a story update handler
-     *
-     * @param name  Event name
-     * @param handler  Story update handler
-     */
-    on(name: 'story', handler: ((upd: StoryUpdate) => void)): this;
-    /**
-     * Register a delete story handler
-     *
-     * @param name  Event name
-     * @param handler  Delete story handler
-     */
-    on(name: 'delete_story', handler: ((upd: DeleteStoryUpdate) => void)): this;
-    /**
-     * Register a bot reaction update handler
-     *
-     * @param name  Event name
-     * @param handler  Bot reaction update handler
-     */
-    on(name: 'bot_reaction', handler: ((upd: BotReactionUpdate) => void)): this;
-    /**
-     * Register a bot reaction count update handler
-     *
-     * @param name  Event name
-     * @param handler  Bot reaction count update handler
-     */
-    on(name: 'bot_reaction_count', handler: ((upd: BotReactionCountUpdate) => void)): this;
-    /**
-     * Register a business connection update handler
-     *
-     * @param name  Event name
-     * @param handler  Business connection update handler
-     */
-    on(name: 'business_connection', handler: ((upd: BusinessConnection) => void)): this;
-    /**
-     * Register a new business message handler
-     *
-     * @param name  Event name
-     * @param handler  New business message handler
-     */
-    on(name: 'new_business_message', handler: ((upd: BusinessMessage) => void)): this;
-    /**
-     * Register an edit business message handler
-     *
-     * @param name  Event name
-     * @param handler  Edit business message handler
-     */
-    on(name: 'edit_business_message', handler: ((upd: BusinessMessage) => void)): this;
-    /**
-     * Register a business message group handler
-     *
-     * @param name  Event name
-     * @param handler  Business message group handler
-     */
-    on(name: 'business_message_group', handler: ((upd: BusinessMessage[]) => void)): this;
-    /**
-     * Register a delete business message handler
-     *
-     * @param name  Event name
-     * @param handler  Delete business message handler
-     */
-    on(name: 'delete_business_message', handler: ((upd: DeleteBusinessMessageUpdate) => void)): this;
-    on(name: string, handler: (...args: any[]) => void): this;
+    /** Raw update emitter */
+    readonly onRawUpdate: Emitter<RawUpdateInfo>;
+    /** Parsed update emitter */
+    readonly onUpdate: Emitter<ParsedUpdate>; /** a new message handler */
+    readonly onNewMessage: Emitter<Message>;
+    /** an edit message handler */
+    readonly onEditMessage: Emitter<Message>;
+    /** a message group handler */
+    readonly onMessageGroup: Emitter<Message[]>;
+    /** a delete message handler */
+    readonly onDeleteMessage: Emitter<DeleteMessageUpdate>;
+    /** a chat member update handler */
+    readonly onChatMemberUpdate: Emitter<ChatMemberUpdate>;
+    /** an inline query handler */
+    readonly onInlineQuery: Emitter<InlineQuery>;
+    /** a chosen inline result handler */
+    readonly onChosenInlineResult: Emitter<ChosenInlineResult>;
+    /** a callback query handler */
+    readonly onCallbackQuery: Emitter<CallbackQuery>;
+    /** an inline callback query handler */
+    readonly onInlineCallbackQuery: Emitter<InlineCallbackQuery>;
+    /** a business callback query handler */
+    readonly onBusinessCallbackQuery: Emitter<BusinessCallbackQuery>;
+    /** a poll update handler */
+    readonly onPollUpdate: Emitter<PollUpdate>;
+    /** a poll vote handler */
+    readonly onPollVote: Emitter<PollVoteUpdate>;
+    /** an user status update handler */
+    readonly onUserStatusUpdate: Emitter<UserStatusUpdate>;
+    /** an user typing handler */
+    readonly onUserTyping: Emitter<UserTypingUpdate>;
+    /** a history read handler */
+    readonly onHistoryRead: Emitter<HistoryReadUpdate>;
+    /** a bot stopped handler */
+    readonly onBotStopped: Emitter<BotStoppedUpdate>;
+    /** a bot chat join request handler */
+    readonly onBotChatJoinRequest: Emitter<BotChatJoinRequestUpdate>;
+    /** a chat join request handler */
+    readonly onChatJoinRequest: Emitter<ChatJoinRequestUpdate>;
+    /** a pre checkout query handler */
+    readonly onPreCheckoutQuery: Emitter<PreCheckoutQuery>;
+    /** a story update handler */
+    readonly onStoryUpdate: Emitter<StoryUpdate>;
+    /** a delete story handler */
+    readonly onDeleteStory: Emitter<DeleteStoryUpdate>;
+    /** a bot reaction update handler */
+    readonly onBotReactionUpdate: Emitter<BotReactionUpdate>;
+    /** a bot reaction count update handler */
+    readonly onBotReactionCountUpdate: Emitter<BotReactionCountUpdate>;
+    /** a business connection update handler */
+    readonly onBusinessConnectionUpdate: Emitter<BusinessConnection>;
+    /** a new business message handler */
+    readonly onNewBusinessMessage: Emitter<BusinessMessage>;
+    /** an edit business message handler */
+    readonly onEditBusinessMessage: Emitter<BusinessMessage>;
+    /** a business message group handler */
+    readonly onBusinessMessageGroup: Emitter<BusinessMessage[]>;
+    /** a delete business message handler */
+    readonly onDeleteBusinessMessage: Emitter<DeleteBusinessMessageUpdate>;
     /**
      * Wrap this client so that all RPC calls will use the specified parameters.
      *
@@ -502,7 +351,7 @@ export interface TelegramClient extends ITelegramClient {
          * Note that passed session will be ignored in case storage already
          * contains authorization.
          */
-        session?: string | StringSessionData;
+        session?: string | InputStringSessionData;
         /**
          * Whether to overwrite existing session.
          */
@@ -827,6 +676,107 @@ export interface TelegramClient extends ITelegramClient {
          */
         langCode?: string;
     }): Promise<tl.RawBotCommand[]>;
+    /**
+     * Open a webview.
+     * **Available**: 👤 users only
+     *
+     */
+    openWebview(params: {
+        /** Information about the webview to open */
+        webview: InputWebview;
+        /**
+         * Bot whose webview to open
+         */
+        bot: InputPeerLike;
+        /**
+         * Chat to report to the server as the "currently open chat",
+         * also the chat to which the message will be sent in case of
+         * `from_inline_keyboard`, `from_bot_menu` and `from_attach_menu` webviews
+         */
+        chat?: InputPeerLike;
+        /**
+         * Theme parameters to pass to the mini app
+         *
+         * Each value should be a string (hex-encoded RGB, no alpha)
+         */
+        theme?: tl.TypeDataJSON | {
+            /** Background color */
+            bg_color?: string;
+            /** Secondary background color */
+            secondary_bg_color?: string;
+            /** Text color */
+            text_color?: string;
+            /** Hint text color */
+            hint_color?: string;
+            /** Link color */
+            link_color?: string;
+            /** Button color */
+            button_color?: string;
+            /** Button text color */
+            button_text_color?: string;
+            /** Header background color */
+            header_bg_color?: string;
+            /** Accent text color */
+            accent_text_color?: string;
+            /** Section background color */
+            section_bg_color?: string;
+            /** Section header text color */
+            section_header_text_color?: string;
+            /** Section separator color */
+            section_separator_color?: string;
+            /** Sub title text color */
+            subtitle_text_color?: string;
+            /** Text color for destructive action buttons in prompts */
+            destructive_text_color?: string;
+        };
+        /**
+         * Webview platform to use in the init data
+         *
+         * Some of the known values:
+         *  - `android` - Android clients
+         *  - `ios` - iOS clients
+         *  - `tdesktop` - Telegram Desktop
+         *  - `macos` - Telegram for macOS
+         *  - `unigram` - Unigram
+         */
+        platform: 'android' | 'ios' | 'tdesktop' | 'macos' | 'unigram' | (string & {});
+    }): Promise<WebviewResult>;
+    /**
+     * Close a webview previously opened by {@link openWebview} method.
+     *
+     * **Available**: ✅ both users and bots
+     *
+     * @param webview  Webview result returned by {@link openWebview}, or its `.queryId`
+     */
+    closeWebview(webview: WebviewResult | tl.Long): Promise<void>;
+    /**
+     * Prepare an inline message result to be sent later via the
+     * `shareMessage` [mini-app api method](https://core.telegram.org/bots/webapps#initializing-mini-apps).
+     */
+    prepareInlineMessage(params: {
+        userId: InputPeerLike;
+        result: InputInlineResult;
+        /**
+         * Filters for the client to use when prompting the user for the
+         * chat to send the inline message to.
+         *
+         * Note that this is just a hint for the client, and the client is free to ignore it.
+         */
+        filter?: tl.TypeInlineQueryPeerType[] | {
+            /** private chat with the bot itself */
+            botSelf?: boolean;
+            /** private chats */
+            private?: boolean;
+            /** private chats with other bots */
+            bots?: boolean;
+            /** "basic" chats */
+            chats?: boolean;
+            /** supergroups */
+            supergroups?: boolean;
+            /** broadcast channels */
+            channels?: boolean;
+        };
+    }): Promise<tl.messages.TypeBotPreparedInlineMessage>;
     /**
      * Sets information about a bot the current uzer owns (or the current bot)
      * **Available**: ✅ both users and bots
@@ -947,6 +897,15 @@ export interface TelegramClient extends ITelegramClient {
         /** The default chat permissions. */
         rights: Omit<tl.RawChatAdminRights, '_'>;
     }): Promise<void>;
+    /**
+     * Give or revoke permission for a bot to update emoji status for your account
+     */
+    toggleEmojiStatusPermission(params: {
+        /** Bot to which the permission should be granted/revoked */
+        userId: InputPeerLike;
+        /** Whether to grant or revoke permission */
+        allow: boolean;
+    }): Promise<void>;
     /**
      * Add one or more new members to a group, supergroup or channel.
      *
@@ -1312,6 +1271,14 @@ export interface TelegramClient extends ITelegramClient {
      *   Use {@link getChatPreview} instead.
      */
     getFullChat(chatId: InputPeerLike): Promise<FullChat>;
+    /**
+     * Get full information about a user.
+     *
+     * **Available**: ✅ both users and bots
+     *
+     * @param userId  ID of the user or their username
+     */
+    getFullUser(userId: InputPeerLike): Promise<FullUser>;
     /**
      * Get nearby chats
      *
@@ -1333,6 +1300,14 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     getSimilarChannels(channel: InputPeerLike): Promise<ArrayWithTotal<Chat>>;
+    /**
+     * Get basic information about a user.
+     *
+     * **Available**: ✅ both users and bots
+     *
+     * @param userId  ID of the user or their username or invite link
+     */
+    getUser(userId: InputPeerLike): Promise<User>;
     /**
      * Iterate over chat event log.
      *
@@ -2026,7 +2001,7 @@ export interface TelegramClient extends ITelegramClient {
      */
     downloadAsNodeStream(location: FileDownloadLocation, params?: FileDownloadParameters): import('node:stream').Readable;
     /**
-     * Download a file and return it as a readable stream,
+     * Download a file and return it as a `@fuman/io` stream,
      * streaming file contents.
      *
      * **Available**: ✅ both users and bots
@@ -2396,6 +2371,12 @@ export interface TelegramClient extends ITelegramClient {
          * approved by an admin
          */
         withApproval?: boolean;
+        /**
+         * When a pricing plan is passed, this link will become a paid subscription link
+         *
+         * Currently the only allowed `.period` is 1 month, i.e. `2592000`
+         */
+        subscriptionPricing?: tl.TypeStarsSubscriptionPricing;
     }): Promise<ChatInviteLink>;
     /**
      * Edit an invite link. You can only edit non-primary
@@ -2895,8 +2876,6 @@ export interface TelegramClient extends ITelegramClient {
         /**
          * Maximum message ID to return.
          *
-         * Unless {@link addOffset} is used, this will work the same as {@link offset}.
-         *
          * @default  `0` (disabled).
          */
         maxId?: number;
@@ -3633,6 +3612,8 @@ export interface TelegramClient extends ITelegramClient {
      * automatically cancelled if you send a
      * message.
      *
+     * If you need a continuous typing status, use {@link setTyping} instead.
+     *
      * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID
@@ -3667,6 +3648,36 @@ export interface TelegramClient extends ITelegramClient {
          */
         options: null | MaybeArray<number | Uint8Array>;
     }): Promise<Poll>;
+    /**
+     * Sets whether a user is typing in a specific chat
+     *
+     * This status is automatically renewed by mtcute until a further
+     * call with `cancel` is made, or a message is sent to the chat.
+     * **Available**: ✅ both users and bots
+     *
+     */
+    setTyping(params: {
+        /** Chat ID where the user is currently typing */
+        peerId: InputPeerLike;
+        /**
+         * Typing status to send
+         *
+         * @default  `typing`
+         */
+        status?: Exclude<TypingStatus, 'interaction' | 'interaction_seen'> | tl.TypeSendMessageAction;
+        /**
+         * For `upload_*` and history import actions, progress of the upload
+         */
+        progress?: number;
+        /**
+         * Unique identifier of the business connection on behalf of which the action will be sent
+         */
+        businessConnectionId?: string;
+        /**
+         * For comment threads, ID of the thread (i.e. top message)
+         */
+        threadId?: number;
+    }): Promise<void>;
     /**
      * Translate message text to a given language.
      *
@@ -4893,6 +4904,37 @@ export interface TelegramClient extends ITelegramClient {
      *
      */
     resolveChannel(peerId: InputPeerLike, force?: boolean): Promise<tl.TypeInputChannel>;
+    /**
+     * Set an emoji status for the current user
+     *
+     * **Available**: ✅ both users and bots
+     *
+     * @deprecated – use {@link setEmojiStatus} with `self` instead
+     */
+    setMyEmojiStatus(emoji: tl.Long | null, params?: {
+        /**
+         * Date when the emoji status should expire (only if `emoji` is not `null`)
+         */
+        until?: number | Date;
+    }): Promise<void>;
+    /**
+     * Set an emoji status for the given user/chat
+     *
+     * You can change emoji status of:
+     *  - yourself (`self`)
+     *  - supergroups or channels with enough boosts which you are an admin of
+     *  - for bots – users who gave you the appropriate permissions
+     */
+    setEmojiStatus(params: {
+        /** User or chat where the emoji status should be set */
+        peerId: InputPeerLike;
+        /** Custom emoji ID or `null` to remove the emoji */
+        emoji: tl.Long | null;
+        /**
+         * Date when the emoji status should expire (only if `emoji` is not `null`)
+         */
+        until?: number | Date;
+    }): Promise<void>;
     /**
      * Changes the current default value of the Time-To-Live setting,
      * applied to all new chats.
@@ -4915,19 +4957,6 @@ export interface TelegramClient extends ITelegramClient {
         /** Birthday year (optional) */
         year?: number;
     } | null): Promise<void>;
-    /**
-     * Set an emoji status for the current user
-     *
-     * **Available**: 👤 users only
-     *
-     * @param emoji  Custom emoji ID or `null` to remove the emoji
-     */
-    setMyEmojiStatus(emoji: tl.Long | null, params?: {
-        /**
-         * Date when the emoji status should expire (only if `emoji` is not `null`)
-         */
-        until?: number | Date;
-    }): Promise<void>;
     /**
      * Set a new profile photo or video for the current user.
      *
@@ -4955,13 +4984,27 @@ export interface TelegramClient extends ITelegramClient {
      */
     setMyUsername(username: string | null): Promise<User>;
     /**
-     * Change user status to offline or online
+     * Change user status to offline or online once,
+     * which will expire after a while (currently ~5 minutes)
+     *
+     * For continuously sending online/offline status, use {@link setOnline}
+     *
+     * **Available**: 👤 users only
+     *
+     * @param online  Whether the user is currently online
+     */
+    sendOnline(online: boolean): Promise<void>;
+    /**
+     * Change user status to online or offline
+     *
+     * Once called with `true`, mtcute will keep notifying the server
+     * that the user is still online until a further call with `false` is made.
      *
      * **Available**: 👤 users only
      *
-     * @param [offline=true]  Whether the user is currently offline
+     * @param [online=true]
      */
-    setOffline(offline?: boolean): Promise<void>;
+    setOnline(online?: boolean): Promise<void>;
     /**
      * Unblock a user
      *
@@ -4996,7 +5039,7 @@ export interface TelegramClient extends ITelegramClient {
 }
 export type { TelegramClientOptions };
 export * from './base.js';
-export declare class TelegramClient extends EventEmitter implements ITelegramClient {
+export declare class TelegramClient implements ITelegramClient {
     _client: ITelegramClient;
     constructor(opts: TelegramClientOptions);
 }