@mtcute/core 0.29.7 → 0.30.1

package/client.cjs

@@ -159,6 +159,7 @@ const iterInviteLinks = require("./highlevel/methods/invite-links/iter-invite-li
 const revokeInviteLink = require("./highlevel/methods/invite-links/revoke-invite-link.cjs");
 const appendTodoList = require("./highlevel/methods/messages/append-todo-list.cjs");
 const closePoll = require("./highlevel/methods/messages/close-poll.cjs");
+const createRichStreamingDraft = require("./highlevel/methods/messages/create-rich-streaming-draft.cjs");
 const createStreamingDraft = require("./highlevel/methods/messages/create-streaming-draft.cjs");
 const deleteMessages = require("./highlevel/methods/messages/delete-messages.cjs");
 const deleteScheduledMessages = require("./highlevel/methods/messages/delete-scheduled-messages.cjs");
@@ -201,6 +202,7 @@ const sendPaidReaction = require("./highlevel/methods/messages/send-paid-reactio
 const sendQuote = require("./highlevel/methods/messages/send-quote.cjs");
 const sendReaction = require("./highlevel/methods/messages/send-reaction.cjs");
 const sendReply = require("./highlevel/methods/messages/send-reply.cjs");
+const sendRichMessage = require("./highlevel/methods/messages/send-rich-message.cjs");
 const sendScheduled = require("./highlevel/methods/messages/send-scheduled.cjs");
 const sendText = require("./highlevel/methods/messages/send-text.cjs");
 const sendTyping = require("./highlevel/methods/messages/send-typing.cjs");
@@ -931,6 +933,9 @@ TelegramClient.prototype.appendTodoList = function(...args) {
 TelegramClient.prototype.closePoll = function(...args) {
   return closePoll.closePoll(this._client, ...args);
 };
+TelegramClient.prototype.createRichStreamingDraft = function(...args) {
+  return createRichStreamingDraft.createRichStreamingDraft(this._client, ...args);
+};
 TelegramClient.prototype.createStreamingDraft = function(...args) {
   return createStreamingDraft.createStreamingDraft(this._client, ...args);
 };
@@ -1093,6 +1098,9 @@ TelegramClient.prototype.replyMedia = function(...args) {
 TelegramClient.prototype.replyMediaGroup = function(...args) {
   return sendReply.replyMediaGroup(this._client, ...args);
 };
+TelegramClient.prototype.sendRichMessage = function(...args) {
+  return sendRichMessage.sendRichMessage(this._client, ...args);
+};
 TelegramClient.prototype.sendScheduled = function(...args) {
   return sendScheduled.sendScheduled(this._client, ...args);
 };

package/client.js

@@ -152,6 +152,7 @@ import { iterInviteLinks } from "./highlevel/methods/invite-links/iter-invite-li
 import { revokeInviteLink } from "./highlevel/methods/invite-links/revoke-invite-link.js";
 import { appendTodoList } from "./highlevel/methods/messages/append-todo-list.js";
 import { closePoll } from "./highlevel/methods/messages/close-poll.js";
+import { createRichStreamingDraft } from "./highlevel/methods/messages/create-rich-streaming-draft.js";
 import { createStreamingDraft } from "./highlevel/methods/messages/create-streaming-draft.js";
 import { deleteMessagesById, deleteMessages } from "./highlevel/methods/messages/delete-messages.js";
 import { deleteScheduledMessages } from "./highlevel/methods/messages/delete-scheduled-messages.js";
@@ -194,6 +195,7 @@ import { sendPaidReaction } from "./highlevel/methods/messages/send-paid-reactio
 import { quoteWithText, quoteWithMedia, quoteWithMediaGroup } from "./highlevel/methods/messages/send-quote.js";
 import { sendReaction } from "./highlevel/methods/messages/send-reaction.js";
 import { replyText, replyMedia, replyMediaGroup } from "./highlevel/methods/messages/send-reply.js";
+import { sendRichMessage } from "./highlevel/methods/messages/send-rich-message.js";
 import { sendScheduled } from "./highlevel/methods/messages/send-scheduled.js";
 import { sendText } from "./highlevel/methods/messages/send-text.js";
 import { sendTyping } from "./highlevel/methods/messages/send-typing.js";
@@ -924,6 +926,9 @@ TelegramClient.prototype.appendTodoList = function(...args) {
 TelegramClient.prototype.closePoll = function(...args) {
   return closePoll(this._client, ...args);
 };
+TelegramClient.prototype.createRichStreamingDraft = function(...args) {
+  return createRichStreamingDraft(this._client, ...args);
+};
 TelegramClient.prototype.createStreamingDraft = function(...args) {
   return createStreamingDraft(this._client, ...args);
 };
@@ -1086,6 +1091,9 @@ TelegramClient.prototype.replyMedia = function(...args) {
 TelegramClient.prototype.replyMediaGroup = function(...args) {
   return replyMediaGroup(this._client, ...args);
 };
+TelegramClient.prototype.sendRichMessage = function(...args) {
+  return sendRichMessage(this._client, ...args);
+};
 TelegramClient.prototype.sendScheduled = function(...args) {
   return sendScheduled(this._client, ...args);
 };

package/highlevel/client.d.cts

@@ -6,10 +6,13 @@ import { BaseTelegramClientOptions } from './base.js';
 import { ITelegramClient } from './client.types.js';
 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 { 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';
 import { GetInviteLinksOffset, getInviteLinks } from './methods/invite-links/get-invite-links.js';
+import { RichStreamingDraft } from './methods/messages/create-rich-streaming-draft.js';
 import { StreamingDraft } from './methods/messages/create-streaming-draft.js';
 import { DeleteMessagesParams } from './methods/messages/delete-messages.js';
 import { ForwardMessageOptions } from './methods/messages/forward-messages.js';
@@ -27,7 +30,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, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerSettings, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, 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, 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 { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
@@ -1399,17 +1402,13 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Join a channel or supergroup
      *
-     * When using with invite links, this method may throw RPC error
-     * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
-     * You will get into the chat once they do so.
-     *
      * **Available**: 👤 users only
      *
      * @param chatId
      *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
      *   or ID of the linked supergroup or channel.
      */
-    joinChat(chatId: InputPeerLike): Promise<Chat>;
+    joinChat(chatId: InputPeerLike): Promise<JoinChatResult>;
     /**
      * Kick a user from a chat.
      *
@@ -1517,7 +1516,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param draft  Draft message, or `null` to delete.
      */
-    saveDraft(chatId: InputPeerLike, draft: null | Omit<tl.RawDraftMessage, '_' | 'date'>): Promise<void>;
+    saveDraft(chatId: InputPeerLike, draft: null | DraftMessageInput): Promise<void>;
     /**
      * Set peer color and optionally background pattern
      * **Available**: 👤 users only
@@ -3094,6 +3093,34 @@ export interface TelegramClient extends ITelegramClient {
          */
         shouldDispatch?: true;
     }): Promise<Poll>;
+    /**
+     * Create a streaming rich message draft
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     * @param params
+     */
+    createRichStreamingDraft(chatId: InputPeerLike, params?: {
+        /**
+         * Unique identifier of the business connection on behalf of which the action will be sent
+         */
+        businessConnectionId?: string;
+        /** Whether to disable upload cache (exists to prevent uploading the same media multiple times) */
+        disableUploadCache?: boolean;
+        /**
+         * For comment threads, ID of the thread (i.e. top message)
+         */
+        threadId?: number;
+        /**
+         * Function that will be called after some part of the media has been uploaded.
+         *
+         * @param id  ID of the file being uploaded
+         * @param uploaded  Number of bytes already uploaded
+         * @param total  Total file size
+         */
+        progressCallback?: (id: string, uploaded: number, total: number) => void;
+    }): Promise<RichStreamingDraft>;
     /**
      * Create a streaming text message draft
      *
@@ -4095,6 +4122,39 @@ export interface TelegramClient extends ITelegramClient {
     replyMedia(message: Message, ...params: ParametersSkip2<typeof sendMedia>): ReturnType<typeof sendMedia>;
     /** Send a media group in reply to a given message */
     replyMediaGroup(message: Message, ...params: ParametersSkip2<typeof sendMediaGroup>): ReturnType<typeof sendMediaGroup>;
+    /**
+     * Send a rich message
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
+     * @param params  Rich message contents and additional sending parameters
+     */
+    sendRichMessage(chatId: InputPeerLike, params: CommonSendParams & {
+        content: InputRichMessage;
+        /** Override the default random ID, for streaming drafts */
+        randomId?: Long;
+        /**
+         * For bots: inline or reply markup or an instruction
+         * to hide a reply keyboard or to force a reply.
+         */
+        replyMarkup?: ReplyMarkup;
+        /**
+         * Function that will be called after some part has been uploaded.
+         *
+         * @param id  ID of the file being uploaded
+         * @param uploaded  Number of bytes already uploaded
+         * @param total  Total file size
+         */
+        progressCallback?: (id: string, uploaded: number, total: number) => void;
+        /**
+         * Cache for uploaded media, used to avoid re-uploading the same media multiple times.
+         *
+         * Pass a (potentially shared) {@link RichMediaUploadCache} to reuse media uploaded
+         * by an earlier call (e.g. a streaming draft) instead of uploading it again.
+         */
+        uploadCache?: RichMediaUploadCache;
+    }): Promise<Message>;
     /**
      * Send previously scheduled message(s)
      *

package/highlevel/client.d.ts

@@ -6,10 +6,13 @@ import { BaseTelegramClientOptions } from './base.js';
 import { ITelegramClient } from './client.types.js';
 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 { 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';
 import { GetInviteLinksOffset, getInviteLinks } from './methods/invite-links/get-invite-links.js';
+import { RichStreamingDraft } from './methods/messages/create-rich-streaming-draft.js';
 import { StreamingDraft } from './methods/messages/create-streaming-draft.js';
 import { DeleteMessagesParams } from './methods/messages/delete-messages.js';
 import { ForwardMessageOptions } from './methods/messages/forward-messages.js';
@@ -27,7 +30,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, InputStarGift, InputStickerSet, InputStickerSetItem, InputText, InputWebview, MaybeDynamic, Message, MessageEffect, MessageMedia, MessageReactions, ParametersSkip2, ParsedUpdate, Peer, PeerReaction, PeerSettings, PeerStories, Photo, Poll, PollUpdate, PollVoteUpdate, PreCheckoutQuery, RawDocument, ReplyMarkup, 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, 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 { ParsedUpdateHandlerParams } from './updates/parsed.js';
 import { RawUpdateInfo } from './updates/types.js';
 import { InputStringSessionData } from './utils/string-session.js';
@@ -1399,17 +1402,13 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Join a channel or supergroup
      *
-     * When using with invite links, this method may throw RPC error
-     * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
-     * You will get into the chat once they do so.
-     *
      * **Available**: 👤 users only
      *
      * @param chatId
      *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
      *   or ID of the linked supergroup or channel.
      */
-    joinChat(chatId: InputPeerLike): Promise<Chat>;
+    joinChat(chatId: InputPeerLike): Promise<JoinChatResult>;
     /**
      * Kick a user from a chat.
      *
@@ -1517,7 +1516,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param draft  Draft message, or `null` to delete.
      */
-    saveDraft(chatId: InputPeerLike, draft: null | Omit<tl.RawDraftMessage, '_' | 'date'>): Promise<void>;
+    saveDraft(chatId: InputPeerLike, draft: null | DraftMessageInput): Promise<void>;
     /**
      * Set peer color and optionally background pattern
      * **Available**: 👤 users only
@@ -3094,6 +3093,34 @@ export interface TelegramClient extends ITelegramClient {
          */
         shouldDispatch?: true;
     }): Promise<Poll>;
+    /**
+     * Create a streaming rich message draft
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     * @param params
+     */
+    createRichStreamingDraft(chatId: InputPeerLike, params?: {
+        /**
+         * Unique identifier of the business connection on behalf of which the action will be sent
+         */
+        businessConnectionId?: string;
+        /** Whether to disable upload cache (exists to prevent uploading the same media multiple times) */
+        disableUploadCache?: boolean;
+        /**
+         * For comment threads, ID of the thread (i.e. top message)
+         */
+        threadId?: number;
+        /**
+         * Function that will be called after some part of the media has been uploaded.
+         *
+         * @param id  ID of the file being uploaded
+         * @param uploaded  Number of bytes already uploaded
+         * @param total  Total file size
+         */
+        progressCallback?: (id: string, uploaded: number, total: number) => void;
+    }): Promise<RichStreamingDraft>;
     /**
      * Create a streaming text message draft
      *
@@ -4095,6 +4122,39 @@ export interface TelegramClient extends ITelegramClient {
     replyMedia(message: Message, ...params: ParametersSkip2<typeof sendMedia>): ReturnType<typeof sendMedia>;
     /** Send a media group in reply to a given message */
     replyMediaGroup(message: Message, ...params: ParametersSkip2<typeof sendMediaGroup>): ReturnType<typeof sendMediaGroup>;
+    /**
+     * Send a rich message
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
+     * @param params  Rich message contents and additional sending parameters
+     */
+    sendRichMessage(chatId: InputPeerLike, params: CommonSendParams & {
+        content: InputRichMessage;
+        /** Override the default random ID, for streaming drafts */
+        randomId?: Long;
+        /**
+         * For bots: inline or reply markup or an instruction
+         * to hide a reply keyboard or to force a reply.
+         */
+        replyMarkup?: ReplyMarkup;
+        /**
+         * Function that will be called after some part has been uploaded.
+         *
+         * @param id  ID of the file being uploaded
+         * @param uploaded  Number of bytes already uploaded
+         * @param total  Total file size
+         */
+        progressCallback?: (id: string, uploaded: number, total: number) => void;
+        /**
+         * Cache for uploaded media, used to avoid re-uploading the same media multiple times.
+         *
+         * Pass a (potentially shared) {@link RichMediaUploadCache} to reuse media uploaded
+         * by an earlier call (e.g. a streaming draft) instead of uploading it again.
+         */
+        uploadCache?: RichMediaUploadCache;
+    }): Promise<Message>;
     /**
      * Send previously scheduled message(s)
      *

package/highlevel/methods/chats/join-chat.cjs

@@ -8,26 +8,48 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const utils = require("../../updates/utils.cjs");
 const peerUtils = require("../../utils/peer-utils.cjs");
 const resolvePeer = require("../users/resolve-peer.cjs");
+const innerTl = require("../../../tl/inner-tl.cjs");
+const peersIndex = require("../../types/peers/peers-index.cjs");
+const user = require("../../types/peers/user.cjs");
 const chat = require("../../types/peers/chat.cjs");
 async function joinChat(client, chatId) {
-  if (typeof chatId === "string") {
-    const m = chatId.match(peerUtils.INVITE_LINK_REGEX);
-    if (m) {
-      const res2 = await client.call({
-        _: "messages.importChatInvite",
-        hash: m[1]
+  let res;
+  try {
+    if (typeof chatId === "string") {
+      const m = chatId.match(peerUtils.INVITE_LINK_REGEX);
+      if (m) {
+        res = await client.call({
+          _: "messages.importChatInvite",
+          hash: m[1]
+        });
+      }
+    }
+    if (!res) {
+      res = await client.call({
+        _: "channels.joinChannel",
+        channel: await resolvePeer.resolveChannel(client, chatId)
       });
-      utils.assertIsUpdatesGroup("messages.importChatInvite", res2);
-      client.handleClientUpdate(res2);
-      return new chat.Chat(res2.chats[0]);
+    }
+  } catch (e) {
+    if (innerTl.RpcError.is(e, "INVITE_REQUEST_SENT")) {
+      return { status: "request_sent" };
+    } else {
+      throw e;
+    }
+  }
+  switch (res._) {
+    case "messages.chatInviteJoinResultOk":
+      utils.assertIsUpdatesGroup("joinChat", res.updates);
+      client.handleClientUpdate(res.updates);
+      return { status: "ok", chat: new chat.Chat(res.updates.chats[0]) };
+    case "messages.chatInviteJoinResultWebView": {
+      const peers = peersIndex.PeersIndex.from(res);
+      return {
+        status: "webview",
+        bot: new user.User(peers.user(res.botId)),
+        webview: res.webview
+      };
     }
   }
-  const res = await client.call({
-    _: "channels.joinChannel",
-    channel: await resolvePeer.resolveChannel(client, chatId)
-  });
-  utils.assertIsUpdatesGroup("channels.joinChannel", res);
-  client.handleClientUpdate(res);
-  return new chat.Chat(res.chats[0]);
 }
 exports.joinChat = joinChat;

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

@@ -1,14 +1,28 @@
 import { ITelegramClient } from '../../client.types.js';
-import { InputPeerLike, Chat } from '../../types/index.js';
+import { InputPeerLike, Chat, User } from '../../types/index.js';
+import { tl } from '../../../tl/index.js';
 /**
- * Join a channel or supergroup
+ * Result of {@link joinChat}
  *
- * When using with invite links, this method may throw RPC error
- * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
- * You will get into the chat once they do so.
+ * - `status: 'ok'` - the chat was joined successfully
+ * - `status: 'request_sent'` - a join request was sent and needs to be approved by the chat admin
+ * - `status: 'webview'` - a guard bot requested you to open a webview before joining the chat
+ */
+export type JoinChatResult = {
+    status: 'ok';
+    chat: Chat;
+} | {
+    status: 'request_sent';
+} | {
+    status: 'webview';
+    bot: User;
+    webview: tl.TypeWebViewResult;
+};
+/**
+ * Join a channel or supergroup
  *
  * @param chatId
  *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
  *   or ID of the linked supergroup or channel.
  */
-export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat>;
+export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<JoinChatResult>;

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

@@ -1,14 +1,28 @@
 import { ITelegramClient } from '../../client.types.js';
-import { InputPeerLike, Chat } from '../../types/index.js';
+import { InputPeerLike, Chat, User } from '../../types/index.js';
+import { tl } from '../../../tl/index.js';
 /**
- * Join a channel or supergroup
+ * Result of {@link joinChat}
  *
- * When using with invite links, this method may throw RPC error
- * `INVITE_REQUEST_SENT`, which means that you need to wait for admin approval.
- * You will get into the chat once they do so.
+ * - `status: 'ok'` - the chat was joined successfully
+ * - `status: 'request_sent'` - a join request was sent and needs to be approved by the chat admin
+ * - `status: 'webview'` - a guard bot requested you to open a webview before joining the chat
+ */
+export type JoinChatResult = {
+    status: 'ok';
+    chat: Chat;
+} | {
+    status: 'request_sent';
+} | {
+    status: 'webview';
+    bot: User;
+    webview: tl.TypeWebViewResult;
+};
+/**
+ * Join a channel or supergroup
  *
  * @param chatId
  *   Chat identifier. Either an invite link (`t.me/joinchat/*`), a username (`@username`)
  *   or ID of the linked supergroup or channel.
  */
-export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<Chat>;
+export declare function joinChat(client: ITelegramClient, chatId: InputPeerLike): Promise<JoinChatResult>;

package/highlevel/methods/chats/join-chat.js

@@ -1,27 +1,49 @@
 import { assertIsUpdatesGroup } from "../../updates/utils.js";
 import { INVITE_LINK_REGEX } from "../../utils/peer-utils.js";
 import { resolveChannel } from "../users/resolve-peer.js";
+import { RpcError } from "../../../tl/inner-tl.js";
+import { PeersIndex } from "../../types/peers/peers-index.js";
+import { User as User$2 } from "../../types/peers/user.js";
 import { Chat as Chat$2 } from "../../types/peers/chat.js";
 async function joinChat(client, chatId) {
-  if (typeof chatId === "string") {
-    const m = chatId.match(INVITE_LINK_REGEX);
-    if (m) {
-      const res2 = await client.call({
-        _: "messages.importChatInvite",
-        hash: m[1]
+  let res;
+  try {
+    if (typeof chatId === "string") {
+      const m = chatId.match(INVITE_LINK_REGEX);
+      if (m) {
+        res = await client.call({
+          _: "messages.importChatInvite",
+          hash: m[1]
+        });
+      }
+    }
+    if (!res) {
+      res = await client.call({
+        _: "channels.joinChannel",
+        channel: await resolveChannel(client, chatId)
       });
-      assertIsUpdatesGroup("messages.importChatInvite", res2);
-      client.handleClientUpdate(res2);
-      return new Chat$2(res2.chats[0]);
+    }
+  } catch (e) {
+    if (RpcError.is(e, "INVITE_REQUEST_SENT")) {
+      return { status: "request_sent" };
+    } else {
+      throw e;
+    }
+  }
+  switch (res._) {
+    case "messages.chatInviteJoinResultOk":
+      assertIsUpdatesGroup("joinChat", res.updates);
+      client.handleClientUpdate(res.updates);
+      return { status: "ok", chat: new Chat$2(res.updates.chats[0]) };
+    case "messages.chatInviteJoinResultWebView": {
+      const peers = PeersIndex.from(res);
+      return {
+        status: "webview",
+        bot: new User$2(peers.user(res.botId)),
+        webview: res.webview
+      };
     }
   }
-  const res = await client.call({
-    _: "channels.joinChannel",
-    channel: await resolveChannel(client, chatId)
-  });
-  assertIsUpdatesGroup("channels.joinChannel", res);
-  client.handleClientUpdate(res);
-  return new Chat$2(res.chats[0]);
 }
 export {
   joinChat

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

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

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

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

package/highlevel/methods/files/normalize-input-media.cjs

@@ -29,6 +29,14 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     }
     return media;
   }
+  if (innerTl.isAnyInputPhoto(media)) {
+    typeAssertions.assertTypeIs("normalizeInputMedia (@ photo)", media, "inputPhoto");
+    return { _: "inputMediaPhoto", id: media };
+  }
+  if (innerTl.isAnyInputDocument(media)) {
+    typeAssertions.assertTypeIs("normalizeInputMedia (@ document)", media, "inputDocument");
+    return { _: "inputMediaDocument", id: media };
+  }
   if (media.type === "venue") {
     return {
       _: "inputMediaVenue",

package/highlevel/methods/files/normalize-input-media.js

@@ -10,7 +10,7 @@ import { _normalizeInputText } from "../misc/normalize-text.js";
 import { resolvePeer } from "../users/resolve-peer.js";
 import { _normalizeInputFile } from "./normalize-input-file.js";
 import { uploadFile } from "./upload-file.js";
-import { isAnyInputMedia, isAnyPollAnswer, isAnyInputFile } from "../../../tl/inner-tl.js";
+import { isAnyInputMedia, isAnyInputPhoto, isAnyInputDocument, isAnyPollAnswer, isAnyInputFile } from "../../../tl/inner-tl.js";
 async function _normalizeInputMedia(client, media, params = {}, uploadMedia = false) {
   if (isAnyInputMedia(media)) {
     switch (media._) {
@@ -22,6 +22,14 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     }
     return media;
   }
+  if (isAnyInputPhoto(media)) {
+    assertTypeIs("normalizeInputMedia (@ photo)", media, "inputPhoto");
+    return { _: "inputMediaPhoto", id: media };
+  }
+  if (isAnyInputDocument(media)) {
+    assertTypeIs("normalizeInputMedia (@ document)", media, "inputDocument");
+    return { _: "inputMediaDocument", id: media };
+  }
   if (media.type === "venue") {
     return {
       _: "inputMediaVenue",

package/highlevel/methods/messages/create-rich-streaming-draft.cjs

@@ -0,0 +1,39 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[@mtcute/core] CommonJS bundles are deprecated. They will be removed completely in one of the upcoming releases. No support is provided for CommonJS users. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[@mtcute/core] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const longUtils = require("../../../utils/long-utils.cjs");
+const typeAssertions = require("../../../utils/type-assertions.cjs");
+const resolvePeer = require("../users/resolve-peer.cjs");
+const normalizeRichMessage = require("./normalize-rich-message.cjs");
+async function createRichStreamingDraft(client, chatId, params) {
+  const { threadId, businessConnectionId, progressCallback } = params ?? {};
+  const randomId = longUtils.randomLong();
+  const peer = await resolvePeer.resolvePeer(client, chatId);
+  const uploadCache = params?.disableUploadCache ? void 0 : /* @__PURE__ */ new Map();
+  const sendDraft = async (content) => {
+    const richMessage = await normalizeRichMessage._normalizeInputRichMessage(client, peer, content, { progressCallback, uploadCache });
+    const r = await client.call({
+      _: "messages.setTyping",
+      peer,
+      action: {
+        _: "inputSendMessageRichMessageDraftAction",
+        randomId,
+        richMessage
+      },
+      topMsgId: threadId
+    }, {
+      businessConnectionId
+    });
+    typeAssertions.assertTrue("messages.setTyping", r);
+  };
+  return {
+    randomId,
+    send: sendDraft,
+    uploadCache
+  };
+}
+exports.createRichStreamingDraft = createRichStreamingDraft;