@mtcute/core 0.30.0 → 0.30.2

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

@@ -12,6 +12,7 @@ import { GetForumTopicsOffset, getForumTopics } from './methods/forums/get-forum
 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';
@@ -29,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';
@@ -3092,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
      *
@@ -4093,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

@@ -12,6 +12,7 @@ import { GetForumTopicsOffset, getForumTopics } from './methods/forums/get-forum
 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';
@@ -29,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';
@@ -3092,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
      *
@@ -4093,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/files/download-iterable.cjs

@@ -7,7 +7,9 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const utils = require("@fuman/utils");
 const fileId = require("@mtcute/file-id");
+const delayGate = require("../../../network/delay-gate.cjs");
 const errors$1 = require("../../../types/errors.cjs");
+const abortSignal = require("../../../utils/abort-signal.cjs");
 const peerUtils = require("../../../utils/peer-utils.cjs");
 const convertFileId = require("../../utils/convert-file-id.cjs");
 const fileUtils = require("../../utils/file-utils.cjs");
@@ -90,8 +92,17 @@ async function* downloadAsIterable(client, input, params) {
   let dcId = params?.dcId ?? normalized?.dcId;
   const primaryDcId = await client.getPrimaryDcId();
   if (!dcId) dcId = primaryDcId;
-  const abortSignal = params?.abortSignal;
+  const stallTimeout = params?.stallTimeout;
+  const stallAbort = stallTimeout != null ? new AbortController() : void 0;
+  const abortSignal$1 = stallAbort ? params?.abortSignal ? abortSignal.combineAbortSignals(params.abortSignal, stallAbort.signal) : stallAbort.signal : params?.abortSignal;
   let ended = false;
+  let stallTimer;
+  const resetStallTimer = stallAbort && stallTimeout != null ? () => {
+    if (stallTimer) utils.timers.clearTimeout(stallTimer);
+    stallTimer = utils.timers.setTimeout(() => {
+      stallAbort.abort(new errors$1.MtTimeoutError(stallTimeout));
+    }, stallTimeout);
+  } : void 0;
   const partSizeKb = params?.partSize ?? (fileSize ? fileUtils.determinePartSize(fileSize) : 64);
   if (partSizeKb % 4 !== 0) {
     throw new errors$1.MtArgumentError(`Invalid part size: ${partSizeKb}. Must be divisible by 4.`);
@@ -120,6 +131,7 @@ async function* downloadAsIterable(client, input, params) {
     connectionKind = "download";
   }
   const poolSize = await client.getPoolSize(connectionKind, dcId);
+  const delayGate$1 = isSmall ? void 0 : new delayGate.DownloadDelayGate();
   client.log.debug(
     "Downloading file of size %d from dc %d using %s connection pool (pool size: %d)",
     limitBytes,
@@ -127,6 +139,44 @@ async function* downloadAsIterable(client, input, params) {
     connectionKind,
     poolSize
   );
+  const callPart = async (chunk) => {
+    while (true) {
+      try {
+        return await client.call(
+          {
+            _: isWeb ? "upload.getWebFile" : "upload.getFile",
+            // eslint-disable-next-line
+            location,
+            offset: offset + chunkSize * chunk,
+            limit: chunkSize
+          },
+          {
+            dcId,
+            kind: connectionKind,
+            maxRetryCount: Infinity,
+            // retry until explicitly aborted (or finished)
+            floodSleepThreshold: Infinity,
+            abortSignal: abortSignal$1
+          }
+        );
+      } catch (e) {
+        if (e instanceof DOMException && e.name === "AbortError") return void 0;
+        if (!innerTl.RpcError.is(e)) throw e;
+        if (e.is("FILE_MIGRATE_%d")) {
+          dcId = e.newDc;
+          continue;
+        } else if (e.is("FILEREF_UPGRADE_NEEDED")) {
+          throw new errors$1.MtUnsupportedError("File ref expired!");
+        } else if (e.is("MTPROTO_CLUSTER_INVALID") && dcId != null) {
+          client.log.debug("received cluster invalid error for dc %d, recreating dc", dcId);
+          await client.recreateDc(dcId);
+          continue;
+        } else {
+          throw e;
+        }
+      }
+    }
+  };
   const downloadChunk = async (chunk = nextWorkerChunkIdx++) => {
     let result;
     if (ended) {
@@ -136,40 +186,20 @@ async function* downloadAsIterable(client, input, params) {
     if (throttlePromise) {
       await throttlePromise;
     }
+    if (ended) {
+      return;
+    }
     try {
-      result = await client.call(
-        {
-          _: isWeb ? "upload.getWebFile" : "upload.getFile",
-          // eslint-disable-next-line
-          location,
-          offset: offset + chunkSize * chunk,
-          limit: chunkSize
-        },
-        {
-          dcId,
-          kind: connectionKind,
-          maxRetryCount: Infinity,
-          // retry until explicitly aborted (or finished)
-          floodSleepThreshold: Infinity,
-          abortSignal
-        }
-      );
+      if (delayGate$1) await delayGate$1.wait(abortSignal$1);
+      result = await callPart(chunk);
     } catch (e) {
       if (e instanceof DOMException && e.name === "AbortError") return;
-      if (!innerTl.RpcError.is(e)) throw e;
-      if (e.is("FILE_MIGRATE_%d")) {
-        dcId = e.newDc;
-        return downloadChunk(chunk);
-      } else if (e.is("FILEREF_UPGRADE_NEEDED")) {
-        throw new errors$1.MtUnsupportedError("File ref expired!");
-      } else if (e.is("MTPROTO_CLUSTER_INVALID") && dcId != null) {
-        client.log.debug("received cluster invalid error for dc %d, recreating dc", dcId);
-        await client.recreateDc(dcId);
-        return downloadChunk(chunk);
-      } else {
-        throw e;
-      }
+      throw e;
     }
+    if (!result) {
+      return;
+    }
+    resetStallTimer?.();
     if (result._ === "upload.fileCdnRedirect") {
       throw new errors$1.MtUnsupportedError("Received CDN redirect, which is not supported (yet)");
     }
@@ -189,6 +219,7 @@ async function* downloadAsIterable(client, input, params) {
     }
   };
   let error;
+  resetStallTimer?.();
   void Promise.all(Array.from({
     length: Math.min(poolSize * (isSmall ? 1 : REQUESTS_PER_CONNECTION), numChunks)
   }, downloadChunk)).catch((e) => {
@@ -199,27 +230,31 @@ async function* downloadAsIterable(client, input, params) {
   }).then(() => {
     client.log.debug("download workers finished");
   });
-  abortSignal?.addEventListener("abort", () => {
+  abortSignal$1?.addEventListener("abort", () => {
     client.log.debug("download aborted");
-    error = abortSignal.reason;
+    error = abortSignal$1.reason;
     ended = true;
     nextChunkCv.notify();
   });
   let position = offset;
-  while (position < limitBytes) {
-    await nextChunkCv.wait();
-    if (error) throw error;
-    while (nextChunkIdx in buffer) {
-      const buf = buffer[nextChunkIdx];
-      delete buffer[nextChunkIdx];
-      position += buf.length;
-      params?.progressCallback?.(position, limitBytes);
-      yield buf;
-      nextChunkIdx++;
-      if (buf.length < chunkSize) {
-        return;
+  try {
+    while (position < limitBytes) {
+      await nextChunkCv.wait();
+      if (error) throw error;
+      while (nextChunkIdx in buffer) {
+        const buf = buffer[nextChunkIdx];
+        delete buffer[nextChunkIdx];
+        position += buf.length;
+        params?.progressCallback?.(position, limitBytes);
+        yield buf;
+        nextChunkIdx++;
+        if (buf.length < chunkSize) {
+          return;
+        }
       }
     }
+  } finally {
+    if (stallTimer) utils.timers.clearTimeout(stallTimer);
   }
 }
 exports._normalizeFileDownloadLocation = _normalizeFileDownloadLocation;

package/highlevel/methods/files/download-iterable.js

@@ -1,6 +1,8 @@
-import { ConditionVariable } from "@fuman/utils";
+import { ConditionVariable, timers } from "@fuman/utils";
 import { parseFileId } from "@mtcute/file-id";
-import { MtArgumentError, MtUnsupportedError } from "../../../types/errors.js";
+import { DownloadDelayGate } from "../../../network/delay-gate.js";
+import { MtArgumentError, MtTimeoutError, MtUnsupportedError } from "../../../types/errors.js";
+import { combineAbortSignals } from "../../../utils/abort-signal.js";
 import { toggleChannelIdMark } from "../../../utils/peer-utils.js";
 import { fileIdToInputWebFileLocation, fileIdToInputFileLocation } from "../../utils/convert-file-id.js";
 import { determinePartSize } from "../../utils/file-utils.js";
@@ -83,8 +85,17 @@ async function* downloadAsIterable(client, input, params) {
   let dcId = params?.dcId ?? normalized?.dcId;
   const primaryDcId = await client.getPrimaryDcId();
   if (!dcId) dcId = primaryDcId;
-  const abortSignal = params?.abortSignal;
+  const stallTimeout = params?.stallTimeout;
+  const stallAbort = stallTimeout != null ? new AbortController() : void 0;
+  const abortSignal = stallAbort ? params?.abortSignal ? combineAbortSignals(params.abortSignal, stallAbort.signal) : stallAbort.signal : params?.abortSignal;
   let ended = false;
+  let stallTimer;
+  const resetStallTimer = stallAbort && stallTimeout != null ? () => {
+    if (stallTimer) timers.clearTimeout(stallTimer);
+    stallTimer = timers.setTimeout(() => {
+      stallAbort.abort(new MtTimeoutError(stallTimeout));
+    }, stallTimeout);
+  } : void 0;
   const partSizeKb = params?.partSize ?? (fileSize ? determinePartSize(fileSize) : 64);
   if (partSizeKb % 4 !== 0) {
     throw new MtArgumentError(`Invalid part size: ${partSizeKb}. Must be divisible by 4.`);
@@ -113,6 +124,7 @@ async function* downloadAsIterable(client, input, params) {
     connectionKind = "download";
   }
   const poolSize = await client.getPoolSize(connectionKind, dcId);
+  const delayGate = isSmall ? void 0 : new DownloadDelayGate();
   client.log.debug(
     "Downloading file of size %d from dc %d using %s connection pool (pool size: %d)",
     limitBytes,
@@ -120,6 +132,44 @@ async function* downloadAsIterable(client, input, params) {
     connectionKind,
     poolSize
   );
+  const callPart = async (chunk) => {
+    while (true) {
+      try {
+        return await client.call(
+          {
+            _: isWeb ? "upload.getWebFile" : "upload.getFile",
+            // eslint-disable-next-line
+            location,
+            offset: offset + chunkSize * chunk,
+            limit: chunkSize
+          },
+          {
+            dcId,
+            kind: connectionKind,
+            maxRetryCount: Infinity,
+            // retry until explicitly aborted (or finished)
+            floodSleepThreshold: Infinity,
+            abortSignal
+          }
+        );
+      } catch (e) {
+        if (e instanceof DOMException && e.name === "AbortError") return void 0;
+        if (!RpcError.is(e)) throw e;
+        if (e.is("FILE_MIGRATE_%d")) {
+          dcId = e.newDc;
+          continue;
+        } else if (e.is("FILEREF_UPGRADE_NEEDED")) {
+          throw new MtUnsupportedError("File ref expired!");
+        } else if (e.is("MTPROTO_CLUSTER_INVALID") && dcId != null) {
+          client.log.debug("received cluster invalid error for dc %d, recreating dc", dcId);
+          await client.recreateDc(dcId);
+          continue;
+        } else {
+          throw e;
+        }
+      }
+    }
+  };
   const downloadChunk = async (chunk = nextWorkerChunkIdx++) => {
     let result;
     if (ended) {
@@ -129,40 +179,20 @@ async function* downloadAsIterable(client, input, params) {
     if (throttlePromise) {
       await throttlePromise;
     }
+    if (ended) {
+      return;
+    }
     try {
-      result = await client.call(
-        {
-          _: isWeb ? "upload.getWebFile" : "upload.getFile",
-          // eslint-disable-next-line
-          location,
-          offset: offset + chunkSize * chunk,
-          limit: chunkSize
-        },
-        {
-          dcId,
-          kind: connectionKind,
-          maxRetryCount: Infinity,
-          // retry until explicitly aborted (or finished)
-          floodSleepThreshold: Infinity,
-          abortSignal
-        }
-      );
+      if (delayGate) await delayGate.wait(abortSignal);
+      result = await callPart(chunk);
     } catch (e) {
       if (e instanceof DOMException && e.name === "AbortError") return;
-      if (!RpcError.is(e)) throw e;
-      if (e.is("FILE_MIGRATE_%d")) {
-        dcId = e.newDc;
-        return downloadChunk(chunk);
-      } else if (e.is("FILEREF_UPGRADE_NEEDED")) {
-        throw new MtUnsupportedError("File ref expired!");
-      } else if (e.is("MTPROTO_CLUSTER_INVALID") && dcId != null) {
-        client.log.debug("received cluster invalid error for dc %d, recreating dc", dcId);
-        await client.recreateDc(dcId);
-        return downloadChunk(chunk);
-      } else {
-        throw e;
-      }
+      throw e;
     }
+    if (!result) {
+      return;
+    }
+    resetStallTimer?.();
     if (result._ === "upload.fileCdnRedirect") {
       throw new MtUnsupportedError("Received CDN redirect, which is not supported (yet)");
     }
@@ -182,6 +212,7 @@ async function* downloadAsIterable(client, input, params) {
     }
   };
   let error;
+  resetStallTimer?.();
   void Promise.all(Array.from({
     length: Math.min(poolSize * (isSmall ? 1 : REQUESTS_PER_CONNECTION), numChunks)
   }, downloadChunk)).catch((e) => {
@@ -199,20 +230,24 @@ async function* downloadAsIterable(client, input, params) {
     nextChunkCv.notify();
   });
   let position = offset;
-  while (position < limitBytes) {
-    await nextChunkCv.wait();
-    if (error) throw error;
-    while (nextChunkIdx in buffer) {
-      const buf = buffer[nextChunkIdx];
-      delete buffer[nextChunkIdx];
-      position += buf.length;
-      params?.progressCallback?.(position, limitBytes);
-      yield buf;
-      nextChunkIdx++;
-      if (buf.length < chunkSize) {
-        return;
+  try {
+    while (position < limitBytes) {
+      await nextChunkCv.wait();
+      if (error) throw error;
+      while (nextChunkIdx in buffer) {
+        const buf = buffer[nextChunkIdx];
+        delete buffer[nextChunkIdx];
+        position += buf.length;
+        params?.progressCallback?.(position, limitBytes);
+        yield buf;
+        nextChunkIdx++;
+        if (buf.length < chunkSize) {
+          return;
+        }
       }
     }
+  } finally {
+    if (stallTimer) timers.clearTimeout(stallTimer);
   }
 }
 export {

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",
@@ -275,7 +283,7 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
           fileReference: res.photo.fileReference
         },
         ttlSeconds: media.ttlSeconds,
-        spoiler: media.type === "video" && media.spoiler,
+        spoiler: "spoiler" in media ? media.spoiler : false,
         livePhoto: Boolean(livePhotoVideo),
         video: livePhotoVideo
       };