@mtcute/core 0.30.2 → 0.31.0

package/highlevel/client.d.ts

@@ -8,6 +8,7 @@ import { LogOutResult } from './methods/auth/log-out.js';
 import { CreateGroupResult } from './methods/chats/create-group.js';
 import { JoinChatResult } from './methods/chats/join-chat.js';
 import { DraftMessageInput } from './methods/chats/save-draft.js';
+import { CommunityParticipantChats } from './methods/communities/get-community-participant-chats.js';
 import { GetForumTopicsOffset, getForumTopics } from './methods/forums/get-forum-topics.js';
 import { InputStarGiftAttributeIds, ResaleStarGiftsMeta } from './methods/gifts/get-resale-star-gifts.js';
 import { StarGiftUpgradeOptions } from './methods/gifts/get-star-gift-upgrade-options.js';
@@ -30,7 +31,7 @@ import { InputStarsAmount } from './methods/premium/_normalize-stars-amount.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, ArrayPaginatedWithMeta, ArrayWithTotal, Audio, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotGuestChatQuery, 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, InputDocumentId, InputFileLike, InputInlineMessage, InputInlineResult, InputMediaAudio, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputRichMessage, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerSettings, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, RichMediaUploadCache, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarGiftValue, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate, WebPageMedia, WebviewResult } from './types/index.js';
+import { AllStories, ArrayPaginated, ArrayPaginatedWithMeta, ArrayWithTotal, Audio, Boost, BoostSlot, BoostStats, BotChatJoinRequestUpdate, BotCommands, BotGuestChatQuery, BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessCallbackQuery, BusinessChatLink, BusinessConnection, BusinessMessage, BusinessWorkHoursDay, CallbackQuery, Chat, ChatEvent, ChatInviteLink, ChatInviteLinkMember, ChatJoinRequestUpdate, ChatlistPreview, ChatMember, ChatMemberUpdate, ChatPreview, ChosenInlineResult, CollectibleInfo, CommunityPeerRequest, DeleteBusinessMessageUpdate, DeleteEphemeralMessagesUpdate, DeleteMessageUpdate, DeleteStoryUpdate, Dialog, EphemeralCallbackQuery, EphemeralMessage, FactCheck, FileDownloadLocation, FileDownloadParameters, ForumTopic, FullChat, FullUser, GameHighScore, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, InputChatEventFilters, InputDialogFolder, InputDocumentId, InputFileLike, InputInlineMessage, InputInlineResult, InputMediaAudio, InputMediaLike, InputMediaSticker, InputMessageId, InputPeerLike, InputPrivacyRule, InputReaction, InputRichMessage, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerSettings, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, RichMediaUploadCache, SavedStarGift, SentCode, StarGift, StarGiftUnique, StarGiftValue, StarsStatus, StarsTransaction, Sticker, StickerSet, StickerType, StoriesStealthMode, Story, StoryInteractions, StoryUpdate, StoryViewer, StoryViewersList, TakeoutSession, TextWithEntities, TypingStatus, UploadedFile, UploadFileLike, User, UserStatusUpdate, UserTypingUpdate, WebPageMedia, WebviewResult } from './types/index.js';
 import { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
@@ -140,6 +141,14 @@ export interface TelegramClient extends ITelegramClient {
     readonly onBusinessMessageGroup: Emitter<BusinessMessage[]>;
     /** a delete business message handler */
     readonly onDeleteBusinessMessage: Emitter<DeleteBusinessMessageUpdate>;
+    /** a new ephemeral message handler */
+    readonly onNewEphemeralMessage: Emitter<EphemeralMessage>;
+    /** an edit ephemeral message handler */
+    readonly onEditEphemeralMessage: Emitter<EphemeralMessage>;
+    /** a delete ephemeral messages handler */
+    readonly onDeleteEphemeralMessages: Emitter<DeleteEphemeralMessagesUpdate>;
+    /** an ephemeral callback query handler */
+    readonly onEphemeralCallbackQuery: Emitter<EphemeralCallbackQuery>;
     /**
      * Wrap this client so that all RPC calls will use the specified parameters.
      *
@@ -177,7 +186,7 @@ export interface TelegramClient extends ITelegramClient {
      * When you log out, you can immediately log back in using
      * the same {@link TelegramClient} instance.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns  On success, `true` is returned
      */
@@ -239,7 +248,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Authorize a bot using its token issued by [@BotFather](//t.me/BotFather)
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param token  Bot token issued by BotFather
      * @returns  Bot's {@link User} object
@@ -305,7 +314,7 @@ export interface TelegramClient extends ITelegramClient {
      * > **Note**: Using this method assumes that you
      * > are using a test DC in `primaryDc` parameter.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param params  Additional parameters
      */
@@ -420,6 +429,8 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Answer a bot guest chat query with a result.
      *
+     * **Available**: 🤖 bots only
+     *
      * @param queryId  Query ID
      * @param result  Result of the query
      * @returns  ID of the inline message that was sent
@@ -428,7 +439,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send an answer to a callback query.
      *
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      * @param queryId  ID of the callback query, or the query itself
      * @param params  Parameters of the answer
@@ -468,7 +479,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Answer an inline query.
      *
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      * @param queryId  Inline query ID
      * @param results  Results of the query
@@ -554,7 +565,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Answer a pre-checkout query.
      *
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      * @param queryId  Pre-checkout query ID
      */
@@ -568,7 +579,7 @@ export interface TelegramClient extends ITelegramClient {
      * Does the same as passing `null` to  {@link setMyCommands}
      *
      * Learn more about scopes in the [Bot API docs](https://core.telegram.org/bots/api#botcommandscope)
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      */
     deleteMyCommands(params?: {
@@ -585,7 +596,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Gets information about a bot the current uzer owns (or the current bot)
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     getBotInfo(params: {
@@ -602,7 +613,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<tl.bots.RawBotInfo>;
     /**
      * Fetches the menu button set for the given user.
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      */
     getBotMenuButton(user: InputPeerLike): Promise<tl.TypeBotMenuButton>;
@@ -648,7 +659,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<tl.messages.TypeBotCallbackAnswer>;
     /**
      * Get high scores of a game
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      */
     getGameHighScores(params: InputMessageId & {
@@ -658,7 +669,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get high scores of a game from an inline message
      *
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      * @param messageId  ID of the inline message containing the game
      * @param userId  ID of the user to find high scores for
@@ -669,7 +680,7 @@ export interface TelegramClient extends ITelegramClient {
      * and user language. If they are not set, empty set is returned.
      *
      * Learn more about scopes in the [Bot API docs](https://core.telegram.org/bots/api#botcommandscope)
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      */
     getMyCommands(params?: {
@@ -760,7 +771,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * 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).
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      */
     prepareInlineMessage(params: {
@@ -789,7 +800,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<tl.messages.TypeBotPreparedInlineMessage>;
     /**
      * Sets information about a bot the current uzer owns (or the current bot)
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     setBotInfo(params: {
@@ -812,14 +823,14 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Sets a menu button for the given user.
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      */
     setBotMenuButton(user: InputPeerLike, button: tl.TypeBotMenuButton): Promise<void>;
     /**
      * Set a score of a user in a game
      *
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      * @param params
      * @returns  The modified message
@@ -849,7 +860,7 @@ export interface TelegramClient extends ITelegramClient {
      * Set a score of a user in a game contained in
      * an inline message
      *
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      * @param params
      */
@@ -875,7 +886,7 @@ export interface TelegramClient extends ITelegramClient {
      * Set or delete commands for the current bot and the given scope
      *
      * Learn more about scopes in the [Bot API docs](https://core.telegram.org/bots/api#botcommandscope)
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      */
     setMyCommands(params: {
@@ -898,7 +909,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Sets the default chat permissions for the bot in the supergroup or channel.
-     * **Available**: 👤 users only
+     * **Available**: 🤖 bots only
      *
      */
     setMyDefaultRights(params: {
@@ -952,7 +963,7 @@ export interface TelegramClient extends ITelegramClient {
      * When banning a channel, the user won't be able to use
      * any of their channels to post until the ban is lifted.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns  Service message about removed user, if one was generated.
      */
@@ -1058,7 +1069,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator and have the appropriate permissions.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID or username
      */
@@ -1111,7 +1122,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Edit supergroup/channel admin rights of a user.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     editAdminRights(params: {
@@ -1126,7 +1137,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Edit the custom rank (title) of a group chat participant.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     editChatMemberRank(params: {
@@ -1199,7 +1210,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get information about a single chat member
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID or username
      * @param userId  User ID, username, phone number, `"me"` or `"self"`
@@ -1216,7 +1227,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You can retrieve up to 200 members at once
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID or username
      * @param params  Additional parameters
@@ -1358,7 +1369,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Small wrapper over {@link getChatEventLog}
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param params
@@ -1456,7 +1467,7 @@ export interface TelegramClient extends ITelegramClient {
      * > as it will probably trigger server-side limits and you might start getting transport errors
      * > or even get banned.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chat  Chat to open
      */
@@ -1483,7 +1494,7 @@ export interface TelegramClient extends ITelegramClient {
     reorderUsernames(peerId: InputPeerLike, order: string[]): Promise<void>;
     /**
      * Restrict a user in a supergroup.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     restrictChatMember(params: {
@@ -1557,7 +1568,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator in the chat and have appropriate permissions.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID or username
      * @param restrictions
@@ -1572,7 +1583,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator and have the appropriate permissions.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID or username
      * @param description  New chat description, 0-255 characters
@@ -1582,7 +1593,7 @@ export interface TelegramClient extends ITelegramClient {
      * Set a new chat photo or video.
      *
      * You must be an administrator and have the appropriate permissions.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     setChatPhoto(params: {
@@ -1603,7 +1614,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator and have the appropriate permissions.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID or username
      * @param title  New chat title, 1-255 characters
@@ -1728,7 +1739,7 @@ export interface TelegramClient extends ITelegramClient {
      * 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.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     unbanChatMember(params: {
@@ -1744,7 +1755,7 @@ export interface TelegramClient extends ITelegramClient {
      * 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.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     unrestrictChatMember(params: {
@@ -1753,6 +1764,126 @@ export interface TelegramClient extends ITelegramClient {
         /** User/channel ID who should be unbanned */
         participantId: InputPeerLike;
     }): Promise<void>;
+    /**
+     * Ban a participant from a community
+     */
+    banCommunityParticipant(params: {
+        /** Community ID */
+        communityId: InputPeerLike;
+        /** Participant to ban */
+        participantId: InputPeerLike;
+    }): Promise<void>;
+    /**
+     * Unban a participant from a community
+     */
+    unbanCommunityParticipant(params: {
+        /** Community ID */
+        communityId: InputPeerLike;
+        /** Participant to unban */
+        participantId: InputPeerLike;
+    }): Promise<void>;
+    /**
+     * Create a new community
+     *
+     * @returns  Newly created community
+     */
+    createCommunity(params: {
+        /** Community title */
+        title: string;
+        /** Chat to link to the community */
+        chatId: InputPeerLike;
+        /** Community description */
+        about?: string;
+        /** Whether the community should be hidden */
+        hidden?: boolean;
+        /**
+         * Whether to dispatch the returned updates
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<Chat>;
+    /**
+     * Get pending peer link requests for a community
+     *
+     * @param communityId  Community ID
+     */
+    getCommunityLinkRequests(communityId: InputPeerLike, params?: {
+        /** Offset for pagination */
+        offset?: string;
+        /**
+         * Maximum number of requests to fetch
+         *
+         * @default  100
+         */
+        limit?: number;
+    }): Promise<ArrayPaginated<CommunityPeerRequest, string>>;
+    /**
+     * Get chats linked to a community that the given participant has joined or created
+     */
+    getCommunityParticipantChats(params: {
+        /** Community ID */
+        communityId: InputPeerLike;
+        /** Participant to fetch the chats for */
+        participantId: InputPeerLike;
+    }): Promise<CommunityParticipantChats>;
+    /**
+     * Get a list of communities the current user has joined
+     */
+    getJoinedCommunities(): Promise<Chat[]>;
+    /**
+     * Approve or decline a peer link request to a community
+     */
+    hideCommunityLinkRequest(params: {
+        /** Community ID */
+        communityId: InputPeerLike;
+        /** Peer whose link request should be approved/declined */
+        peerId: InputPeerLike;
+        /** Whether to approve or decline the request */
+        action: 'approve' | 'decline';
+    }): Promise<void>;
+    /**
+     * Approve or decline all pending peer link requests to a community
+     */
+    hideAllCommunityLinkRequests(params: {
+        /** Community ID */
+        communityId: InputPeerLike;
+        /** Whether to approve or decline the requests */
+        action: 'approve' | 'decline';
+    }): Promise<void>;
+    /**
+     * Link a chat to a community, or update the visibility of an existing link
+     */
+    linkCommunityPeer(params: {
+        /** Community ID */
+        communityId: InputPeerLike;
+        /** Chat to link to the community */
+        peerId: InputPeerLike;
+        /** Whether the chat should be hidden in the community's peer list */
+        hidden?: boolean;
+    }): Promise<void>;
+    /**
+     * Unlink a chat from a community
+     */
+    unlinkCommunityPeer(params: {
+        /** Community ID */
+        communityId: InputPeerLike;
+        /** Chat to unlink from the community */
+        peerId: InputPeerLike;
+    }): Promise<void>;
+    /**
+     * Toggle whether a community is collapsed in the dialogs list
+     */
+    toggleCommunityCollapsed(params: {
+        /** Community ID */
+        communityId: InputPeerLike;
+        /** Whether the community should be collapsed */
+        collapsed: boolean;
+        /**
+         * Whether to dispatch the returned updates
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<void>;
     /**
      * Add an existing Telegram user as a contact
      * **Available**: 👤 users only
@@ -1875,7 +2006,7 @@ export interface TelegramClient extends ITelegramClient {
      * > accurate since you can set the same title and/or emoji
      * > to multiple folders.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param params  Search parameters. At least one must be set.
      */
@@ -2032,6 +2163,90 @@ export interface TelegramClient extends ITelegramClient {
      * @param order  New order of folders (folder IDs, where default = 0)
      */
     setFoldersOrder(order: number[]): Promise<void>;
+    /**
+     * Delete a previously sent ephemeral message
+     */
+    deleteEphemeralMessage(params: {
+        /** Chat where the message was sent */
+        chatId: InputPeerLike;
+        /** User the message is visible to */
+        receiverId: InputPeerLike;
+        /** ID of the message to delete */
+        messageId: number;
+    }): Promise<void>;
+    /**
+     * Edit a previously sent ephemeral message
+     */
+    editEphemeralMessage(params: {
+        /** Chat where the message was sent */
+        chatId: InputPeerLike;
+        /** User the message is visible to */
+        receiverId: InputPeerLike;
+        /** ID of the message to edit */
+        messageId: number;
+        /** New text of the message */
+        text?: InputText;
+        /** New media of the message */
+        media?: InputMediaLike;
+        /** New reply markup of the message */
+        replyMarkup?: ReplyMarkup;
+        /**
+         * Whether to dispatch the returned updates
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<EphemeralMessage>;
+    /**
+     * Request a callback answer from a bot for an ephemeral message,
+     * i.e. click an inline button that contains data.
+     */
+    getEphemeralCallbackAnswer(params: {
+        /** Chat where the ephemeral message was sent */
+        chatId: InputPeerLike;
+        /** ID of the ephemeral message containing the button */
+        messageId: number;
+        /** Data contained in the button */
+        data?: string | Uint8Array;
+        /**
+         * Timeout for the query in ms.
+         *
+         * @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.
+         *
+         * **Note**: any errors will be silently ignored.
+         */
+        fireAndForget?: boolean;
+    }): Promise<tl.messages.TypeBotCallbackAnswer>;
+    /**
+     * Send an ephemeral message — a message that is only visible
+     * to a single user in a chat and is not persisted in the chat history.
+     *
+     * @param chatId  ID of the chat to send the message to
+     * @param receiverId  ID of the user the message should be visible to
+     * @param text  Text of the message
+     */
+    sendEphemeralMessage(chatId: InputPeerLike, receiverId: InputPeerLike, text: InputText, params?: {
+        /** Media to be attached to the message */
+        media?: InputMediaLike;
+        /** Message to reply to */
+        replyTo?: number;
+        /** Ephemeral message to reply to */
+        replyToEphemeral?: number;
+        /** Reply markup to be attached to the message */
+        replyMarkup?: ReplyMarkup;
+        /** For guest chat bots, ID of the query that this message is sent in response to */
+        queryId?: tl.Long;
+        /**
+         * Whether to dispatch the returned updates
+         * to the client's update handler.
+         */
+        shouldDispatch?: true;
+    }): Promise<EphemeralMessage>;
     /**
      * Download a file and return its contents as a Buffer.
      *
@@ -2046,7 +2261,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Download a single chunk of a file, using [`precise`](https://core.telegram.org/api/files#downloading-files) download mode
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param params  Download parameters
      */
@@ -2092,7 +2307,7 @@ export interface TelegramClient extends ITelegramClient {
      * in chunks of a given size. Order of the chunks is guaranteed to be
      * consecutive.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param params  Download parameters
      */
@@ -2150,7 +2365,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Normalize an {@link InputMediaLike} to `InputMedia`,
      * uploading the file if needed.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     _normalizeInputMedia(media: InputMediaLike, params?: {
@@ -2240,7 +2455,7 @@ export interface TelegramClient extends ITelegramClient {
      * the returned object will act like a message media
      * and contain fields like File ID.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param media  Media to upload
      * @param [params={}]  Upload parameters
@@ -2254,7 +2469,14 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
-     * **Available**: 👤 users only
+     * > **Note**: for bots in private chats with "threaded mode" enabled,
+     * > message IDs are separate for each side of the chat, while the
+     * > canonical topic ID is always issued in the *user's* ID space.
+     * > The `.id` of the returned service message is in the *bot's* ID space,
+     * > and is **not** a valid topic ID — use `.replyToMessage.threadId` instead,
+     * > which is what all other methods (as well as Bot API's `message_thread_id`) expect.
+     *
+     * **Available**: ✅ both users and bots
      *
      * @returns  Service message for the created topic
      */
@@ -2287,10 +2509,10 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Delete a forum topic and all its history
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chat  Chat or user ID, username, phone number, `"me"` or `"self"`
-     * @param topicId  ID of the topic (i.e. its top message ID)
+     * @param topicId  ID of the topic (i.e. its top message ID, see note at {@link createForumTopic})
      */
     deleteForumTopicHistory(chat: InputPeerLike, topicId: number | ForumTopic, params?: {
         /**
@@ -2304,16 +2526,16 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID or username
-     * @param topicId  ID of the topic (i.e. its top message ID)
+     * @param topicId  ID of the topic (i.e. its top message ID, see note at {@link createForumTopic})
      * @returns  Service message about the modification
      */
     editForumTopic(params: {
         /** Chat ID or username */
         chatId: InputPeerLike;
-        /** ID of the topic (i.e. its top message ID) */
+        /** ID of the topic (i.e. its top message ID, see note at {@link createForumTopic}) */
         topicId: number | ForumTopic;
         /**
          * New topic title
@@ -2339,11 +2561,19 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get forum topics by their IDs
      *
-     * **Available**: 👤 users only
+     * The returned array is aligned with the input IDs.
+     * For topics that were deleted (or never existed),
+     * `null` will be returned at that position.
+     *
+     * > **Note**: for bots in private chats with "threaded mode" enabled,
+     * > only canonical (user-space) topic IDs are accepted —
+     * > see the note at {@link createForumTopic}
+     *
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID or username
      */
-    getForumTopicsById(chatId: InputPeerLike, ids: MaybeArray<number>): Promise<ForumTopic[]>;
+    getForumTopicsById(chatId: InputPeerLike, ids: MaybeArray<number>): Promise<(ForumTopic | null)[]>;
     /**
      * Get forum topics
      *
@@ -2370,7 +2600,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Iterate over forum topics. Wrapper over {@link getForumTopics}.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID or username
      */
@@ -2410,14 +2640,14 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns  Service message about the modification
      */
     toggleForumTopicClosed(parmas: {
         /** Chat ID or username */
         chatId: InputPeerLike;
-        /** ID of the topic (i.e. its top message ID) */
+        /** ID of the topic (i.e. its top message ID, see note at {@link createForumTopic}) */
         topicId: number | ForumTopic;
         /** Whether the topic should be closed */
         closed: boolean;
@@ -2437,7 +2667,7 @@ export interface TelegramClient extends ITelegramClient {
     toggleForumTopicPinned(params: {
         /** Chat ID or username */
         chatId: InputPeerLike;
-        /** ID of the topic (i.e. its top message ID) */
+        /** ID of the topic (i.e. its top message ID, see note at {@link createForumTopic}) */
         topicId: number | ForumTopic;
         /** Whether the topic should be pinned */
         pinned: boolean;
@@ -2462,7 +2692,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only admins with `manageTopics` permission can do this.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns  Service message about the modification
      */
@@ -2543,7 +2773,7 @@ export interface TelegramClient extends ITelegramClient {
      * Get a list of saved star gifts of a user/channel
      *
      * Note that filters currently only work for channels
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     getSavedStarGifts(params: {
@@ -2610,7 +2840,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Iterate over saved star gifts of a user,
      * wrapper over {@link getSavedStarGifts}
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     iterSavedStarGifts(params: Parameters<typeof getSavedStarGifts>[1] & {
@@ -2646,7 +2876,7 @@ export interface TelegramClient extends ITelegramClient {
      * > For GUI clients, you should refer to the method's source code and
      * > present the payment form to the user.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns  Service message about the payment for the upgrade, if one was generated.
      */
@@ -2663,7 +2893,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Accept or decline a purchase offer for a star gift
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns The generated service message
      */
@@ -2710,7 +2940,7 @@ export interface TelegramClient extends ITelegramClient {
      * > For GUI clients, you should refer to the method's source code and
      * > present the payment form to the user.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns  Service message about the sent gift, if one was generated.
      */
@@ -2797,7 +3027,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * You must be an administrator and have appropriate rights.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID
      * @param params
@@ -2835,7 +3065,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Only pass the fields that you want to modify.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID
      * @param link  Invite link to edit
@@ -2872,7 +3102,7 @@ export interface TelegramClient extends ITelegramClient {
      * > **Note**: each administrator has their own primary invite link,
      * > and bots by default don't have one.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat IDs
      */
@@ -2988,7 +3218,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<void>;
     /**
      * Approve or decline join request to a chat.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     hideJoinRequest(params: {
@@ -3003,7 +3233,7 @@ export interface TelegramClient extends ITelegramClient {
      * Iterate over users who have joined
      * the chat with the given invite link.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param params  Additional params
@@ -3030,7 +3260,7 @@ export interface TelegramClient extends ITelegramClient {
      * (i.e. `adminId = "self"`), as a creator you can get
      * any other admin's links.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param adminId  Admin who created the links
@@ -3055,7 +3285,7 @@ export interface TelegramClient extends ITelegramClient {
      * If `link` is a primary invite link, a new invite link will be
      * generated automatically by Telegram
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID
      * @param link  Invite link to revoke
@@ -3083,7 +3313,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Once closed, poll can't be re-opened, and nobody
      * will be able to vote in it
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     closePoll(params: InputMessageId & {
@@ -3096,7 +3326,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Create a streaming rich message draft
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID
      * @param params
@@ -3124,7 +3354,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Create a streaming text message draft
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID
      * @param params
@@ -3151,7 +3381,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Delete messages by their IDs
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat's marked ID, its username, phone or `"me"` or `"self"`.
      * @param ids  Message(s) ID(s) to delete.
@@ -3177,7 +3407,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Edit sent inline message text, media and reply markup.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param messageId
      *     Inline message ID, either as a TL object, or as a
@@ -3227,7 +3457,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Edit message text, media, reply markup and schedule date.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param message  Message or its ID
@@ -3283,7 +3513,7 @@ export interface TelegramClient extends ITelegramClient {
      * Forward one or more messages by their IDs.
      * You can forward no more than 100 messages at once.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param toChatId  Destination chat ID, username, phone, `"me"` or `"self"`
      * @param fromChatId  Source chat ID, username, phone, `"me"` or `"self"`
@@ -3451,7 +3681,7 @@ export interface TelegramClient extends ITelegramClient {
      * > (that weren't sent by the user) once every 15-30 seconds,
      * > but only if `message.reactions` is set
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat with messages
      * @param messages  Message IDs
@@ -3468,7 +3698,7 @@ export interface TelegramClient extends ITelegramClient {
      * For messages that were not found, `null` will be
      * returned at that position.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param messageIds  Messages IDs
      * @param [fromReply]
@@ -3547,7 +3777,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Iterate over chat history. Wrapper over {@link getHistory}
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat's marked ID, its username, phone or `"me"` or `"self"`.
      * @param params  Additional fetch parameters
@@ -3571,7 +3801,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Wrapper over {@link getReactionUsers}.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param messageId  Message ID
@@ -3598,7 +3828,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * **Note**: Due to Telegram limitations, you can only get up to ~10000 messages
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param params  Search parameters
      */
@@ -3622,7 +3852,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Iterable version of {@link searchMessages}
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat's marked ID, its username, phone or `"me"` or `"self"`.
      * @param params  Additional search parameters
@@ -3648,7 +3878,7 @@ export interface TelegramClient extends ITelegramClient {
      * For supergroups/channels, you must have appropriate permissions,
      * either as an admin, or as default permissions
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns  Service message about pinned message, if one was generated.
      */
@@ -3765,7 +3995,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * Iterable version of {@link searchHashtag}
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param hashtag  Hashtag to search for
      * @param params  Additional parameters
@@ -3908,7 +4138,7 @@ export interface TelegramClient extends ITelegramClient {
      * If this is a normal message (not a channel post),
      * a simple reply will be sent.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @throws MtArgumentError
      *     If this is a channel post which does not have comments section.
@@ -3921,7 +4151,7 @@ export interface TelegramClient extends ITelegramClient {
      * If this is a normal message (not a channel post),
      * a simple reply will be sent.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @throws MtArgumentError
      *     If this is a channel post which does not have comments section.
@@ -3934,7 +4164,7 @@ export interface TelegramClient extends ITelegramClient {
      * If this is a normal message (not a channel post),
      * a simple reply will be sent.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @throws MtArgumentError
      *     If this is a channel post which does not have comments section.
@@ -3980,7 +4210,7 @@ export interface TelegramClient extends ITelegramClient {
      * To add a caption to the group, add caption to the first
      * media in the group and don't add caption for any other.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param medias  Medias contained in the message.
@@ -4009,7 +4239,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a single media (a photo or a document-based media)
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param media
@@ -4099,7 +4329,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send or remove a reaction.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns
      *   Message to which the reaction was sent, if available.
@@ -4125,7 +4355,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a rich message
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param params  Rich message contents and additional sending parameters
@@ -4171,7 +4401,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a text message
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param text  Text of the message
@@ -4207,7 +4437,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * If you need a continuous typing status, use {@link setTyping} instead.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID
      * @param [status='typing']  Typing status
@@ -4246,7 +4476,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * This status is automatically renewed by mtcute until a further
      * call with `cancel` is made, or a message is sent to the chat.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     setTyping(params: {
@@ -4312,7 +4542,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Unpin all pinned messages in a chat.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat or user ID
      */
@@ -4333,7 +4563,7 @@ export interface TelegramClient extends ITelegramClient {
      * For supergroups/channels, you must have appropriate permissions,
      * either as an admin, or as default permissions
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param chatId  Chat ID, username, phone number, `"self"` or `"me"`
      * @param messageId  Message ID
@@ -4430,7 +4660,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Check if the current user can apply boost to some channel
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @returns
      *   - `{ can: true }` if the user can apply boost
@@ -4528,7 +4758,7 @@ export interface TelegramClient extends ITelegramClient {
      * You can either pass `self` to get your own transactions,
      * or a chat/bot ID to get transactions of that peer.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param peerId  Peer ID
      * @param params  Additional parameters
@@ -4561,7 +4791,7 @@ export interface TelegramClient extends ITelegramClient {
      * Iterate over boosters of a channel.
      *
      * Wrapper over {@link getBoosters}
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     iterBoosters(peerId: InputPeerLike, params?: Parameters<typeof getBoosts>[2] & {
@@ -4650,7 +4880,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * For bots the sticker set must have been created by this bot.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param setId  Sticker set short name or TL object with input sticker set
      * @param sticker  Sticker to be added
@@ -4669,7 +4899,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Create a new sticker set.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param params
      * @returns  Newly created sticker set
@@ -4737,7 +4967,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * For bots the sticker set must have been created by this bot.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param sticker
      *     TDLib and Bot API compatible File ID, or a
@@ -4748,7 +4978,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get custom emoji stickers by their IDs, or `null` if not available/found.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param ids  IDs of the stickers (as defined in {@link MessageEntity.emojiId})
      */
@@ -4783,7 +5013,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get a sticker set and stickers inside of it.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param setId  Sticker set identifier
      */
@@ -4794,7 +5024,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * For bots the sticker set must have been created by this bot.
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param sticker
      *     TDLib and Bot API compatible File ID, or a
@@ -4828,7 +5058,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Set group sticker set for a supergroup
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param setId  Sticker set short name or a TL object with input sticker set
      * @param thumb  Sticker set thumbnail
@@ -4839,7 +5069,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Set sticker set thumbnail
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param id  Sticker set short name or a TL object with input sticker set
      * @param thumb  Sticker set thumbnail
@@ -4889,7 +5119,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Edit a sent story
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns  Edited story
      */
@@ -5069,7 +5299,7 @@ export interface TelegramClient extends ITelegramClient {
      * Iterate over all stories (e.g. to load the top bar)
      *
      * Wrapper over {@link getAllStories}
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     iterAllStories(params?: Parameters<typeof getAllStories>[1] & {
@@ -5082,7 +5312,7 @@ export interface TelegramClient extends ITelegramClient {
     }): AsyncIterableIterator<PeerStories>;
     /**
      * Iterate over profile stories. Wrapper over {@link getProfileStories}
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     iterProfileStories(peerId: InputPeerLike, params?: Parameters<typeof getProfileStories>[2] & {
@@ -5103,7 +5333,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Iterate over viewers list of a story.
      * Wrapper over {@link getStoryViewers}
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      */
     iterStoryViewers(peerId: InputPeerLike, storyId: number, params?: Parameters<typeof getStoryViewers>[3] & {
@@ -5149,7 +5379,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a story
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @returns  Created story
      */
@@ -5280,7 +5510,7 @@ export interface TelegramClient extends ITelegramClient {
     getGlobalTtl(): Promise<number>;
     /**
      * Get currently authorized user's full information
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     getMe(): Promise<User>;
@@ -5298,7 +5528,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get a single profile picture of a user by its ID
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param userId  User ID, username, phone number, `"me"` or `"self"`
      * @param photoId  ID of the photo to fetch
@@ -5308,7 +5538,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Get a list of profile pictures of a user
      *
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      * @param userId  User ID, username, phone number, `"me"` or `"self"`
      * @param params
@@ -5329,7 +5559,7 @@ export interface TelegramClient extends ITelegramClient {
     }): Promise<ArrayPaginated<Photo, number>>;
     /**
      * Get music files saved to the user's profile
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     getSavedMusic(params: {
@@ -5471,7 +5701,7 @@ export interface TelegramClient extends ITelegramClient {
      *  - yourself (`self`)
      *  - supergroups or channels with enough boosts which you are an admin of
      *  - for bots – users who gave you the appropriate permissions
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     setEmojiStatus(params: {
@@ -5512,7 +5742,7 @@ export interface TelegramClient extends ITelegramClient {
      * Set a new profile photo or video for the current user.
      *
      * You can also pass a file ID or an InputPhoto to re-use existing photo.
-     * **Available**: 👤 users only
+     * **Available**: ✅ both users and bots
      *
      */
     setMyProfilePhoto(params: {