@mtcute/core 0.30.3 → 0.32.0

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

@@ -7,6 +7,7 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const fileId = require("@mtcute/file-id");
 const Long = require("long");
+const errors = require("../../../types/errors.cjs");
 const typeAssertions = require("../../../utils/type-assertions.cjs");
 const uploadedFile = require("../../types/files/uploaded-file.cjs");
 const entities = require("../../types/misc/entities.cjs");
@@ -221,7 +222,7 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
         title: entities.inputTextToTl(media.title),
         list: media.items.map((it, idx) => ({
           _: "todoItem",
-          id: idx,
+          id: idx + 1,
           title: entities.inputTextToTl(it)
         }))
       }
@@ -250,11 +251,32 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     inputFile = uploaded.inputFile;
     mime = uploaded.mime;
   };
+  const uploadPeer = params.uploadPeer ?? { _: "inputPeerSelf" };
   let videoCover;
   if (media.type === "video" && media.cover) {
     const inputMedia = await _normalizeInputMedia(client, media.cover, params);
-    typeAssertions.assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaPhoto");
-    videoCover = inputMedia.id;
+    if (inputMedia._ !== "inputMediaPhoto" && inputMedia._ !== "inputMediaPhotoExternal" && inputMedia._ !== "inputMediaUploadedPhoto") {
+      throw new errors.MtArgumentError("media.cover must be a photo");
+    }
+    if (inputMedia._ === "inputMediaPhoto") {
+      videoCover = inputMedia.id;
+    } else {
+      const res = await client.call({
+        _: "messages.uploadMedia",
+        peer: uploadPeer,
+        media: inputMedia,
+        businessConnectionId: params.businessConnectionId
+      }, { abortSignal: params.abortSignal });
+      if (res._ !== "messageMediaPhoto" || res.photo?._ !== "photo") {
+        throw new errors.MtArgumentError("media.cover must be a photo");
+      }
+      videoCover = {
+        _: "inputPhoto",
+        id: res.photo.id,
+        accessHash: res.photo.accessHash,
+        fileReference: res.photo.fileReference
+      };
+    }
   }
   let livePhotoVideo;
   if (media.type === "photo" && media.livePhotoVideo) {
@@ -262,7 +284,6 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     typeAssertions.assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaDocument");
     livePhotoVideo = inputMedia.id;
   }
-  const uploadPeer = params.uploadPeer ?? { _: "inputPeerSelf" };
   const uploadMediaIfNeeded = async (inputMedia, photo) => {
     if (!uploadMedia) return inputMedia;
     const res = await client.call({

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

@@ -1,5 +1,6 @@
 import { tdFileId, parseFileId } from "@mtcute/file-id";
 import Long from "long";
+import { MtArgumentError } from "../../../types/errors.js";
 import { assertTypeIs } from "../../../utils/type-assertions.js";
 import { isUploadedFile } from "../../types/files/uploaded-file.js";
 import { inputTextToTl } from "../../types/misc/entities.js";
@@ -214,7 +215,7 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
         title: inputTextToTl(media.title),
         list: media.items.map((it, idx) => ({
           _: "todoItem",
-          id: idx,
+          id: idx + 1,
           title: inputTextToTl(it)
         }))
       }
@@ -243,11 +244,32 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     inputFile = uploaded.inputFile;
     mime = uploaded.mime;
   };
+  const uploadPeer = params.uploadPeer ?? { _: "inputPeerSelf" };
   let videoCover;
   if (media.type === "video" && media.cover) {
     const inputMedia = await _normalizeInputMedia(client, media.cover, params);
-    assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaPhoto");
-    videoCover = inputMedia.id;
+    if (inputMedia._ !== "inputMediaPhoto" && inputMedia._ !== "inputMediaPhotoExternal" && inputMedia._ !== "inputMediaUploadedPhoto") {
+      throw new MtArgumentError("media.cover must be a photo");
+    }
+    if (inputMedia._ === "inputMediaPhoto") {
+      videoCover = inputMedia.id;
+    } else {
+      const res = await client.call({
+        _: "messages.uploadMedia",
+        peer: uploadPeer,
+        media: inputMedia,
+        businessConnectionId: params.businessConnectionId
+      }, { abortSignal: params.abortSignal });
+      if (res._ !== "messageMediaPhoto" || res.photo?._ !== "photo") {
+        throw new MtArgumentError("media.cover must be a photo");
+      }
+      videoCover = {
+        _: "inputPhoto",
+        id: res.photo.id,
+        accessHash: res.photo.accessHash,
+        fileReference: res.photo.fileReference
+      };
+    }
   }
   let livePhotoVideo;
   if (media.type === "photo" && media.livePhotoVideo) {
@@ -255,7 +277,6 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaDocument");
     livePhotoVideo = inputMedia.id;
   }
-  const uploadPeer = params.uploadPeer ?? { _: "inputPeerSelf" };
   const uploadMediaIfNeeded = async (inputMedia, photo) => {
     if (!uploadMedia) return inputMedia;
     const res = await client.call({

package/highlevel/methods/forums/create-forum-topic.d.cts

@@ -6,6 +6,13 @@ import { InputPeerLike, Message } from '../../types/index.js';
  *
  * Only admins with `manageTopics` permission can do this.
  *
+ * > **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.
+ *
  * @returns  Service message for the created topic
  */
 export declare function createForumTopic(client: ITelegramClient, params: {

package/highlevel/methods/forums/create-forum-topic.d.ts

@@ -6,6 +6,13 @@ import { InputPeerLike, Message } from '../../types/index.js';
  *
  * Only admins with `manageTopics` permission can do this.
  *
+ * > **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.
+ *
  * @returns  Service message for the created topic
  */
 export declare function createForumTopic(client: ITelegramClient, params: {

package/highlevel/methods/forums/delete-forum-topic-history.d.cts

@@ -4,7 +4,7 @@ import { ForumTopic, InputPeerLike } from '../../types/index.js';
  * Delete a forum topic and all its history
  *
  * @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})
  */
 export declare function deleteForumTopicHistory(client: ITelegramClient, chat: InputPeerLike, topicId: number | ForumTopic, params?: {
     /**

package/highlevel/methods/forums/delete-forum-topic-history.d.ts

@@ -4,7 +4,7 @@ import { ForumTopic, InputPeerLike } from '../../types/index.js';
  * Delete a forum topic and all its history
  *
  * @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})
  */
 export declare function deleteForumTopicHistory(client: ITelegramClient, chat: InputPeerLike, topicId: number | ForumTopic, params?: {
     /**

package/highlevel/methods/forums/edit-forum-topic.cjs

@@ -15,10 +15,10 @@ async function editForumTopic(client, params) {
     peer: await resolvePeer.resolvePeer(client, chatId),
     topicId: typeof topicId === "number" ? topicId : topicId.id,
     title,
-    iconEmojiId: icon ? icon ?? Long.ZERO : void 0,
+    iconEmojiId: icon === null ? Long.ZERO : icon,
     closed,
     hidden
   });
-  return findInUpdate._findMessageInUpdate(client, res, false, shouldDispatch);
+  return findInUpdate._findMessageInUpdate(client, res, false, !shouldDispatch);
 }
 exports.editForumTopic = editForumTopic;

package/highlevel/methods/forums/edit-forum-topic.d.cts

@@ -7,13 +7,13 @@ import { ForumTopic, InputPeerLike, Message } from '../../types/index.js';
  * Only admins with `manageTopics` permission can do this.
  *
  * @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
  */
 export declare function editForumTopic(client: ITelegramClient, 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

package/highlevel/methods/forums/edit-forum-topic.d.ts

@@ -7,13 +7,13 @@ import { ForumTopic, InputPeerLike, Message } from '../../types/index.js';
  * Only admins with `manageTopics` permission can do this.
  *
  * @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
  */
 export declare function editForumTopic(client: ITelegramClient, 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

package/highlevel/methods/forums/edit-forum-topic.js

@@ -8,11 +8,11 @@ async function editForumTopic(client, params) {
     peer: await resolvePeer(client, chatId),
     topicId: typeof topicId === "number" ? topicId : topicId.id,
     title,
-    iconEmojiId: icon ? icon ?? Long.ZERO : void 0,
+    iconEmojiId: icon === null ? Long.ZERO : icon,
     closed,
     hidden
   });
-  return _findMessageInUpdate(client, res, false, shouldDispatch);
+  return _findMessageInUpdate(client, res, false, !shouldDispatch);
 }
 export {
   editForumTopic

package/highlevel/methods/forums/get-forum-topics-by-id.cjs

@@ -14,6 +14,10 @@ async function getForumTopicsById(client, chatId, ids) {
     peer: await resolvePeer.resolvePeer(client, chatId),
     topics: ids
   });
-  return forumTopic.ForumTopic.parseTlForumTopics(res);
+  const index = /* @__PURE__ */ new Map();
+  for (const topic of forumTopic.ForumTopic.parseTlForumTopics(res)) {
+    index.set(topic.id, topic);
+  }
+  return ids.map((id) => index.get(id) ?? null);
 }
 exports.getForumTopicsById = getForumTopicsById;

package/highlevel/methods/forums/get-forum-topics-by-id.d.cts

@@ -4,6 +4,14 @@ import { InputPeerLike, ForumTopic } from '../../types/index.js';
 /**
  * Get forum topics by their IDs
  *
+ * 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}
+ *
  * @param chatId  Chat ID or username
  */
-export declare function getForumTopicsById(client: ITelegramClient, chatId: InputPeerLike, ids: MaybeArray<number>): Promise<ForumTopic[]>;
+export declare function getForumTopicsById(client: ITelegramClient, chatId: InputPeerLike, ids: MaybeArray<number>): Promise<(ForumTopic | null)[]>;

package/highlevel/methods/forums/get-forum-topics-by-id.d.ts

@@ -4,6 +4,14 @@ import { InputPeerLike, ForumTopic } from '../../types/index.js';
 /**
  * Get forum topics by their IDs
  *
+ * 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}
+ *
  * @param chatId  Chat ID or username
  */
-export declare function getForumTopicsById(client: ITelegramClient, chatId: InputPeerLike, ids: MaybeArray<number>): Promise<ForumTopic[]>;
+export declare function getForumTopicsById(client: ITelegramClient, chatId: InputPeerLike, ids: MaybeArray<number>): Promise<(ForumTopic | null)[]>;

package/highlevel/methods/forums/get-forum-topics-by-id.js

@@ -7,7 +7,11 @@ async function getForumTopicsById(client, chatId, ids) {
     peer: await resolvePeer(client, chatId),
     topics: ids
   });
-  return ForumTopic$2.parseTlForumTopics(res);
+  const index = /* @__PURE__ */ new Map();
+  for (const topic of ForumTopic$2.parseTlForumTopics(res)) {
+    index.set(topic.id, topic);
+  }
+  return ids.map((id) => index.get(id) ?? null);
 }
 export {
   getForumTopicsById

package/highlevel/methods/forums/get-forum-topics-by-id.test.d.cts

@@ -0,0 +1 @@
+export {};

package/highlevel/methods/forums/get-forum-topics-by-id.test.d.ts

@@ -0,0 +1 @@
+export {};

package/highlevel/methods/forums/get-forum-topics.cjs

@@ -6,8 +6,8 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const resolvePeer = require("../users/resolve-peer.cjs");
-const miscUtils = require("../../utils/misc-utils.cjs");
 const forumTopic = require("../../types/peers/forum-topic.cjs");
+const miscUtils = require("../../utils/misc-utils.cjs");
 const defaultOffset = {
   date: 0,
   id: 0,

package/highlevel/methods/forums/get-forum-topics.js

@@ -1,6 +1,6 @@
 import { resolvePeer } from "../users/resolve-peer.js";
-import { makeArrayPaginated } from "../../utils/misc-utils.js";
 import { ForumTopic as ForumTopic$2 } from "../../types/peers/forum-topic.js";
+import { makeArrayPaginated } from "../../utils/misc-utils.js";
 const defaultOffset = {
   date: 0,
   id: 0,

package/highlevel/methods/forums/toggle-forum-topic-closed.cjs

@@ -15,6 +15,6 @@ async function toggleForumTopicClosed(client, parmas) {
     topicId: typeof topicId === "number" ? topicId : topicId.id,
     closed
   });
-  return findInUpdate._findMessageInUpdate(client, res, false, shouldDispatch);
+  return findInUpdate._findMessageInUpdate(client, res, false, !shouldDispatch);
 }
 exports.toggleForumTopicClosed = toggleForumTopicClosed;

package/highlevel/methods/forums/toggle-forum-topic-closed.d.cts

@@ -10,7 +10,7 @@ import { ForumTopic, InputPeerLike, Message } from '../../types/index.js';
 export declare function toggleForumTopicClosed(client: ITelegramClient, 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;

package/highlevel/methods/forums/toggle-forum-topic-closed.d.ts

@@ -10,7 +10,7 @@ import { ForumTopic, InputPeerLike, Message } from '../../types/index.js';
 export declare function toggleForumTopicClosed(client: ITelegramClient, 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;

package/highlevel/methods/forums/toggle-forum-topic-closed.js

@@ -8,7 +8,7 @@ async function toggleForumTopicClosed(client, parmas) {
     topicId: typeof topicId === "number" ? topicId : topicId.id,
     closed
   });
-  return _findMessageInUpdate(client, res, false, shouldDispatch);
+  return _findMessageInUpdate(client, res, false, !shouldDispatch);
 }
 export {
   toggleForumTopicClosed

package/highlevel/methods/forums/toggle-forum-topic-pinned.d.cts

@@ -8,7 +8,7 @@ import { ForumTopic, InputPeerLike } from '../../types/index.js';
 export declare function toggleForumTopicPinned(client: ITelegramClient, 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;

package/highlevel/methods/forums/toggle-forum-topic-pinned.d.ts

@@ -8,7 +8,7 @@ import { ForumTopic, InputPeerLike } from '../../types/index.js';
 export declare function toggleForumTopicPinned(client: ITelegramClient, 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;

package/highlevel/methods/forums/toggle-general-topic-hidden.cjs

@@ -10,11 +10,11 @@ const resolvePeer = require("../users/resolve-peer.cjs");
 async function toggleGeneralTopicHidden(client, params) {
   const { chatId, hidden, shouldDispatch } = params;
   const res = await client.call({
-    _: "channels.editForumTopic",
-    channel: await resolvePeer.resolveChannel(client, chatId),
+    _: "messages.editForumTopic",
+    peer: await resolvePeer.resolvePeer(client, chatId),
     topicId: 1,
     hidden
   });
-  return findInUpdate._findMessageInUpdate(client, res, false, shouldDispatch);
+  return findInUpdate._findMessageInUpdate(client, res, false, !shouldDispatch);
 }
 exports.toggleGeneralTopicHidden = toggleGeneralTopicHidden;

package/highlevel/methods/forums/toggle-general-topic-hidden.js

@@ -1,14 +1,14 @@
 import { _findMessageInUpdate } from "../messages/find-in-update.js";
-import { resolveChannel } from "../users/resolve-peer.js";
+import { resolvePeer } from "../users/resolve-peer.js";
 async function toggleGeneralTopicHidden(client, params) {
   const { chatId, hidden, shouldDispatch } = params;
   const res = await client.call({
-    _: "channels.editForumTopic",
-    channel: await resolveChannel(client, chatId),
+    _: "messages.editForumTopic",
+    peer: await resolvePeer(client, chatId),
     topicId: 1,
     hidden
   });
-  return _findMessageInUpdate(client, res, false, shouldDispatch);
+  return _findMessageInUpdate(client, res, false, !shouldDispatch);
 }
 export {
   toggleGeneralTopicHidden

package/highlevel/methods/gifts/buy-resale-gift.cjs

@@ -6,15 +6,18 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const typeAssertions = require("../../../utils/type-assertions.cjs");
+const entities = require("../../types/misc/entities.cjs");
 const findInUpdate = require("../messages/find-in-update.cjs");
 const resolvePeer = require("../users/resolve-peer.cjs");
 async function buyResaleGift(client, params) {
-  const { slug, recipient, shouldDispatch, ton } = params;
+  const { slug, recipient, shouldDispatch, ton, anonymous, message } = params;
   const invoice = {
     _: "inputInvoiceStarGiftResale",
     slug,
     toId: await resolvePeer.resolvePeer(client, recipient),
-    ton
+    ton,
+    showName: anonymous === false,
+    message: message ? entities.inputTextToTl(message) : void 0
   };
   const form = await client.call({
     _: "payments.getPaymentForm",

package/highlevel/methods/gifts/buy-resale-gift.d.cts

@@ -1,5 +1,5 @@
 import { ITelegramClient } from '../../client.types.js';
-import { InputPeerLike, Message } from '../../types/index.js';
+import { InputPeerLike, InputText, Message } from '../../types/index.js';
 export declare function buyResaleGift(client: ITelegramClient, params: {
     /** Slug of the star gift to buy */
     slug: string;
@@ -12,4 +12,14 @@ export declare function buyResaleGift(client: ITelegramClient, params: {
     shouldDispatch?: true;
     /** Whether to use TON currency for payment */
     ton?: boolean;
+    /**
+     * Whether to buy the gift anonymously
+     * (i.e. if the recipient chooses to display the gift
+     * on their profile, your name won't be visible)
+     *
+     * @default  `true`
+     */
+    anonymous?: boolean;
+    /** Message to send along with the gift */
+    message?: InputText;
 }): Promise<Message | null>;

package/highlevel/methods/gifts/buy-resale-gift.d.ts

@@ -1,5 +1,5 @@
 import { ITelegramClient } from '../../client.types.js';
-import { InputPeerLike, Message } from '../../types/index.js';
+import { InputPeerLike, InputText, Message } from '../../types/index.js';
 export declare function buyResaleGift(client: ITelegramClient, params: {
     /** Slug of the star gift to buy */
     slug: string;
@@ -12,4 +12,14 @@ export declare function buyResaleGift(client: ITelegramClient, params: {
     shouldDispatch?: true;
     /** Whether to use TON currency for payment */
     ton?: boolean;
+    /**
+     * Whether to buy the gift anonymously
+     * (i.e. if the recipient chooses to display the gift
+     * on their profile, your name won't be visible)
+     *
+     * @default  `true`
+     */
+    anonymous?: boolean;
+    /** Message to send along with the gift */
+    message?: InputText;
 }): Promise<Message | null>;

package/highlevel/methods/gifts/buy-resale-gift.js

@@ -1,13 +1,16 @@
 import { assertTypeIs } from "../../../utils/type-assertions.js";
+import { inputTextToTl } from "../../types/misc/entities.js";
 import { _findMessageInUpdate } from "../messages/find-in-update.js";
 import { resolvePeer } from "../users/resolve-peer.js";
 async function buyResaleGift(client, params) {
-  const { slug, recipient, shouldDispatch, ton } = params;
+  const { slug, recipient, shouldDispatch, ton, anonymous, message } = params;
   const invoice = {
     _: "inputInvoiceStarGiftResale",
     slug,
     toId: await resolvePeer(client, recipient),
-    ton
+    ton,
+    showName: anonymous === false,
+    message: message ? inputTextToTl(message) : void 0
   };
   const form = await client.call({
     _: "payments.getPaymentForm",

package/highlevel/methods/messages/forward-messages.cjs

@@ -51,6 +51,7 @@ async function forwardMessagesById(client, params) {
     allowPaidFloodskip,
     videoTimestamp,
     allowPaidStars: params.allowPaidMessages,
+    fromEphemeral: params.fromEphemeral,
     topMsgId: toThreadId,
     replyTo: toMonoforumPeer ? {
       _: "inputReplyToMonoForum",

package/highlevel/methods/messages/forward-messages.d.cts

@@ -72,6 +72,8 @@ export interface ForwardMessageOptions {
     allowPaidMessages?: tl.Long;
     /** Video timestamp to use for the forwarded video */
     videoTimestamp?: number;
+    /** Whether the messages being forwarded are ephemeral messages */
+    fromEphemeral?: boolean;
 }
 /**
  * Forward one or more messages by their IDs.

package/highlevel/methods/messages/forward-messages.d.ts

@@ -72,6 +72,8 @@ export interface ForwardMessageOptions {
     allowPaidMessages?: tl.Long;
     /** Video timestamp to use for the forwarded video */
     videoTimestamp?: number;
+    /** Whether the messages being forwarded are ephemeral messages */
+    fromEphemeral?: boolean;
 }
 /**
  * Forward one or more messages by their IDs.

package/highlevel/methods/messages/forward-messages.js

@@ -44,6 +44,7 @@ async function forwardMessagesById(client, params) {
     allowPaidFloodskip,
     videoTimestamp,
     allowPaidStars: params.allowPaidMessages,
+    fromEphemeral: params.fromEphemeral,
     topMsgId: toThreadId,
     replyTo: toMonoforumPeer ? {
       _: "inputReplyToMonoForum",

package/highlevel/methods/messages/normalize-rich-message.cjs

@@ -150,6 +150,9 @@ async function _normalizeInputRichMessage(client, peer, input, params) {
         case "pageBlockAudio":
           block.audioId = document.id;
           break;
+        case "pageBlockDocument":
+          block.documentId = document.id;
+          break;
         default:
           throw new errors.MtArgumentError(`sendRichMessage: expected document ${document.id} to be used in a document block, but got ${block._}`);
       }

package/highlevel/methods/messages/normalize-rich-message.js

@@ -143,6 +143,9 @@ async function _normalizeInputRichMessage(client, peer, input, params) {
         case "pageBlockAudio":
           block.audioId = document.id;
           break;
+        case "pageBlockDocument":
+          block.documentId = document.id;
+          break;
         default:
           throw new MtArgumentError(`sendRichMessage: expected document ${document.id} to be used in a document block, but got ${block._}`);
       }

package/highlevel/methods/messages/send-common.d.cts

@@ -13,7 +13,13 @@ export interface CommonSendParams {
      * Can also be a message from another chat, in which case a quote will be sent.
      */
     replyTo?: number | Message;
-    /** ID of the thread to reply to */
+    /**
+     * ID of the thread (topic) to reply to
+     *
+     * > **Note**: for bots in private chats with "threaded mode" enabled,
+     * > this must be the canonical (user-space) topic ID —
+     * > see the note at {@link createForumTopic}
+     */
     threadId?: number;
     /**
      * If this is a reply to a specific todo item, ID of that item

package/highlevel/methods/messages/send-common.d.ts

@@ -13,7 +13,13 @@ export interface CommonSendParams {
      * Can also be a message from another chat, in which case a quote will be sent.
      */
     replyTo?: number | Message;
-    /** ID of the thread to reply to */
+    /**
+     * ID of the thread (topic) to reply to
+     *
+     * > **Note**: for bots in private chats with "threaded mode" enabled,
+     * > this must be the canonical (user-space) topic ID —
+     * > see the note at {@link createForumTopic}
+     */
     threadId?: number;
     /**
      * If this is a reply to a specific todo item, ID of that item