@mtcute/core 0.29.4 → 0.29.6

package/client.cjs

@@ -158,6 +158,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 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");
 const editInlineMessage = require("./highlevel/methods/messages/edit-inline-message.cjs");
@@ -922,6 +923,9 @@ TelegramClient.prototype.appendTodoList = function(...args) {
 TelegramClient.prototype.closePoll = function(...args) {
   return closePoll.closePoll(this._client, ...args);
 };
+TelegramClient.prototype.createStreamingDraft = function(...args) {
+  return createStreamingDraft.createStreamingDraft(this._client, ...args);
+};
 TelegramClient.prototype.deleteMessagesById = function(...args) {
   return deleteMessages.deleteMessagesById(this._client, ...args);
 };

package/client.js

@@ -151,6 +151,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 { 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";
 import { editInlineMessage } from "./highlevel/methods/messages/edit-inline-message.js";
@@ -915,6 +916,9 @@ TelegramClient.prototype.appendTodoList = function(...args) {
 TelegramClient.prototype.closePoll = function(...args) {
   return closePoll(this._client, ...args);
 };
+TelegramClient.prototype.createStreamingDraft = function(...args) {
+  return createStreamingDraft(this._client, ...args);
+};
 TelegramClient.prototype.deleteMessagesById = function(...args) {
   return deleteMessagesById(this._client, ...args);
 };

package/highlevel/base.cjs

@@ -44,7 +44,6 @@ class BaseTelegramClient {
     });
     if (!params.disableUpdates && params.updates !== false) {
       this.updates = new manager.UpdatesManager(this, params.updates);
-      this.onServerUpdate.add(this.updates.handleUpdate.bind(this.updates));
       this.updates.onCatchingUp((catchingUp) => {
         this.onConnectionState.emit(catchingUp ? "updating" : "connected");
       });

package/highlevel/base.js

@@ -37,7 +37,6 @@ class BaseTelegramClient {
     });
     if (!params.disableUpdates && params.updates !== false) {
       this.updates = new UpdatesManager(this, params.updates);
-      this.onServerUpdate.add(this.updates.handleUpdate.bind(this.updates));
       this.updates.onCatchingUp((catchingUp) => {
         this.onConnectionState.emit(catchingUp ? "updating" : "connected");
       });

package/highlevel/client.d.cts

@@ -10,6 +10,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 { StreamingDraft } from './methods/messages/create-streaming-draft.js';
 import { DeleteMessagesParams } from './methods/messages/delete-messages.js';
 import { ForwardMessageOptions } from './methods/messages/forward-messages.js';
 import { GetHistoryOffset, getHistory } from './methods/messages/get-history.js';
@@ -3077,6 +3078,31 @@ export interface TelegramClient extends ITelegramClient {
          */
         shouldDispatch?: true;
     }): Promise<Poll>;
+    /**
+     * Create a streaming text message draft
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     * @param params
+     */
+    createStreamingDraft(chatId: InputPeerLike, params?: {
+        /**
+         * Unique identifier of the business connection on behalf of which the action will be sent
+         */
+        businessConnectionId?: string;
+        /**
+         * For comment threads, ID of the thread (i.e. top message)
+         */
+        threadId?: number;
+        /**
+         * Mode of the draft's `send` method
+         *
+         * - `append` - appends the text to the previous draft
+         * - `replace` - replaces the previous draft with the new one
+         */
+        mode?: 'append' | 'replace';
+    }): Promise<StreamingDraft>;
     /**
      * Delete messages by their IDs
      *
@@ -3949,6 +3975,8 @@ export interface TelegramClient extends ITelegramClient {
      * @link InputMedia
      */
     sendMedia(chatId: InputPeerLike, media: InputMediaLike | string, params?: CommonSendParams & {
+        /** 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.
@@ -4072,6 +4100,8 @@ export interface TelegramClient extends ITelegramClient {
      * @param params  Additional sending parameters
      */
     sendText(chatId: InputPeerLike, text: InputText, params?: CommonSendParams & {
+        /** 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.

package/highlevel/client.d.ts

@@ -10,6 +10,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 { StreamingDraft } from './methods/messages/create-streaming-draft.js';
 import { DeleteMessagesParams } from './methods/messages/delete-messages.js';
 import { ForwardMessageOptions } from './methods/messages/forward-messages.js';
 import { GetHistoryOffset, getHistory } from './methods/messages/get-history.js';
@@ -3077,6 +3078,31 @@ export interface TelegramClient extends ITelegramClient {
          */
         shouldDispatch?: true;
     }): Promise<Poll>;
+    /**
+     * Create a streaming text message draft
+     *
+     * **Available**: 👤 users only
+     *
+     * @param chatId  Chat ID
+     * @param params
+     */
+    createStreamingDraft(chatId: InputPeerLike, params?: {
+        /**
+         * Unique identifier of the business connection on behalf of which the action will be sent
+         */
+        businessConnectionId?: string;
+        /**
+         * For comment threads, ID of the thread (i.e. top message)
+         */
+        threadId?: number;
+        /**
+         * Mode of the draft's `send` method
+         *
+         * - `append` - appends the text to the previous draft
+         * - `replace` - replaces the previous draft with the new one
+         */
+        mode?: 'append' | 'replace';
+    }): Promise<StreamingDraft>;
     /**
      * Delete messages by their IDs
      *
@@ -3949,6 +3975,8 @@ export interface TelegramClient extends ITelegramClient {
      * @link InputMedia
      */
     sendMedia(chatId: InputPeerLike, media: InputMediaLike | string, params?: CommonSendParams & {
+        /** 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.
@@ -4072,6 +4100,8 @@ export interface TelegramClient extends ITelegramClient {
      * @param params  Additional sending parameters
      */
     sendText(chatId: InputPeerLike, text: InputText, params?: CommonSendParams & {
+        /** 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.

package/highlevel/methods/chats/get-creator-after-leave.cjs

@@ -14,20 +14,10 @@ async function getCreatorAfterLeave(client, chatId) {
   if (peerUtils.isInputPeerUser(peer)) {
     throw new errors.MtInvalidPeerTypeError(chatId, "chat or channel");
   }
-  let res;
-  if (peerUtils.isInputPeerChannel(peer)) {
-    res = await client.call({
-      _: "channels.getFutureCreatorAfterLeave",
-      channel: peerUtils.toInputChannel(peer)
-    });
-  } else if (peerUtils.isInputPeerChat(peer)) {
-    res = await client.call({
-      _: "messages.getFutureChatCreatorAfterLeave",
-      peer
-    });
-  } else {
-    throw new errors.MtInvalidPeerTypeError(chatId, "chat or channel");
-  }
+  const res = await client.call({
+    _: "messages.getFutureChatCreatorAfterLeave",
+    peer
+  });
   if (res._ === "userEmpty") return null;
   return new user.User(res);
 }

package/highlevel/methods/chats/get-creator-after-leave.js

@@ -1,26 +1,16 @@
 import { MtInvalidPeerTypeError } from "../../types/errors.js";
 import { User as User$2 } from "../../types/peers/user.js";
-import { isInputPeerUser, isInputPeerChannel, toInputChannel, isInputPeerChat } from "../../utils/peer-utils.js";
+import { isInputPeerUser } from "../../utils/peer-utils.js";
 import { resolvePeer } from "../users/resolve-peer.js";
 async function getCreatorAfterLeave(client, chatId) {
   const peer = await resolvePeer(client, chatId);
   if (isInputPeerUser(peer)) {
     throw new MtInvalidPeerTypeError(chatId, "chat or channel");
   }
-  let res;
-  if (isInputPeerChannel(peer)) {
-    res = await client.call({
-      _: "channels.getFutureCreatorAfterLeave",
-      channel: toInputChannel(peer)
-    });
-  } else if (isInputPeerChat(peer)) {
-    res = await client.call({
-      _: "messages.getFutureChatCreatorAfterLeave",
-      peer
-    });
-  } else {
-    throw new MtInvalidPeerTypeError(chatId, "chat or channel");
-  }
+  const res = await client.call({
+    _: "messages.getFutureChatCreatorAfterLeave",
+    peer
+  });
   if (res._ === "userEmpty") return null;
   return new User$2(res);
 }

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

@@ -117,33 +117,40 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     };
   }
   if (media.type === "poll" || media.type === "quiz") {
-    const answers = media.answers.map((ans, idx) => {
-      if (typeof ans === "object" && innerTl.isAnyPollAnswer(ans)) return ans;
+    const answers = await Promise.all(media.answers.map((ans) => {
+      if (typeof ans === "string") return { _: "inputPollAnswer", text: entities.inputTextToTl(ans) };
+      if (innerTl.isAnyPollAnswer(ans)) return ans;
+      if ("media" in ans && ans.media) {
+        return _normalizeInputMedia(client, ans.media, params, true).then((m) => ({
+          _: "inputPollAnswer",
+          text: entities.inputTextToTl(ans.text),
+          media: m
+        }));
+      }
       return {
-        _: "pollAnswer",
-        text: entities.inputTextToTl(ans),
-        // emulate the behaviour of most implementations
-        option: new Uint8Array([48 + idx])
+        _: "inputPollAnswer",
+        text: entities.inputTextToTl(ans.text)
       };
-    });
+    }));
     let correct;
     let solution;
     let solutionEntities;
+    const [attachedMedia, solutionMedia] = await Promise.all([
+      media.attachedMedia ? _normalizeInputMedia(client, media.attachedMedia, params, true) : void 0,
+      media.type === "quiz" && media.solutionMedia ? _normalizeInputMedia(client, media.solutionMedia, params, true) : void 0
+    ]);
     if (media.type === "quiz") {
       let input2 = media.correct;
       if (!Array.isArray(input2)) input2 = [input2];
-      correct = input2.map((it) => {
-        if (typeof it === "number") {
-          return answers[it].option;
-        }
-        return it;
-      });
+      correct = input2;
       if (media.solution) {
         [solution, solutionEntities] = await normalizeText._normalizeInputText(client, media.solution);
       }
     }
     return {
       _: "inputMediaPoll",
+      attachedMedia,
+      solutionMedia,
       poll: {
         _: "poll",
         closed: media.closed,
@@ -154,7 +161,12 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
         question: entities.inputTextToTl(media.question),
         answers,
         closePeriod: media.closePeriod,
-        closeDate: miscUtils.normalizeDate(media.closeDate)
+        closeDate: miscUtils.normalizeDate(media.closeDate),
+        openAnswers: media.openAnswers,
+        revotingDisabled: media.disableRevoting,
+        shuffleAnswers: media.shuffleAnswers,
+        hideResultsUntilClose: media.hideResultsUntilClose,
+        hash: Long.ZERO
       },
       correctAnswers: correct,
       solution,
@@ -236,6 +248,12 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     typeAssertions.assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaPhoto");
     videoCover = inputMedia.id;
   }
+  let livePhotoVideo;
+  if (media.type === "photo" && media.livePhotoVideo) {
+    const inputMedia = await _normalizeInputMedia(client, media.livePhotoVideo, params, true);
+    typeAssertions.assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaDocument");
+    livePhotoVideo = inputMedia.id;
+  }
   const uploadPeer = params.uploadPeer ?? { _: "inputPeerSelf" };
   const uploadMediaIfNeeded = async (inputMedia, photo) => {
     if (!uploadMedia) return inputMedia;
@@ -257,7 +275,9 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
           fileReference: res.photo.fileReference
         },
         ttlSeconds: media.ttlSeconds,
-        spoiler: media.type === "video" && media.spoiler
+        spoiler: media.type === "video" && media.spoiler,
+        livePhoto: Boolean(livePhotoVideo),
+        video: livePhotoVideo
       };
     }
     typeAssertions.assertTypeIs("normalizeInputMedia (@ messages.uploadMedia)", res, "messageMediaDocument");
@@ -334,6 +354,8 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
       {
         _: "inputMediaUploadedPhoto",
         file: inputFile,
+        livePhoto: Boolean(livePhotoVideo),
+        video: livePhotoVideo,
         ttlSeconds: media.ttlSeconds,
         spoiler: media.spoiler
       },

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

@@ -110,33 +110,40 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     };
   }
   if (media.type === "poll" || media.type === "quiz") {
-    const answers = media.answers.map((ans, idx) => {
-      if (typeof ans === "object" && isAnyPollAnswer(ans)) return ans;
+    const answers = await Promise.all(media.answers.map((ans) => {
+      if (typeof ans === "string") return { _: "inputPollAnswer", text: inputTextToTl(ans) };
+      if (isAnyPollAnswer(ans)) return ans;
+      if ("media" in ans && ans.media) {
+        return _normalizeInputMedia(client, ans.media, params, true).then((m) => ({
+          _: "inputPollAnswer",
+          text: inputTextToTl(ans.text),
+          media: m
+        }));
+      }
       return {
-        _: "pollAnswer",
-        text: inputTextToTl(ans),
-        // emulate the behaviour of most implementations
-        option: new Uint8Array([48 + idx])
+        _: "inputPollAnswer",
+        text: inputTextToTl(ans.text)
       };
-    });
+    }));
     let correct;
     let solution;
     let solutionEntities;
+    const [attachedMedia, solutionMedia] = await Promise.all([
+      media.attachedMedia ? _normalizeInputMedia(client, media.attachedMedia, params, true) : void 0,
+      media.type === "quiz" && media.solutionMedia ? _normalizeInputMedia(client, media.solutionMedia, params, true) : void 0
+    ]);
     if (media.type === "quiz") {
       let input2 = media.correct;
       if (!Array.isArray(input2)) input2 = [input2];
-      correct = input2.map((it) => {
-        if (typeof it === "number") {
-          return answers[it].option;
-        }
-        return it;
-      });
+      correct = input2;
       if (media.solution) {
         [solution, solutionEntities] = await _normalizeInputText(client, media.solution);
       }
     }
     return {
       _: "inputMediaPoll",
+      attachedMedia,
+      solutionMedia,
       poll: {
         _: "poll",
         closed: media.closed,
@@ -147,7 +154,12 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
         question: inputTextToTl(media.question),
         answers,
         closePeriod: media.closePeriod,
-        closeDate: normalizeDate(media.closeDate)
+        closeDate: normalizeDate(media.closeDate),
+        openAnswers: media.openAnswers,
+        revotingDisabled: media.disableRevoting,
+        shuffleAnswers: media.shuffleAnswers,
+        hideResultsUntilClose: media.hideResultsUntilClose,
+        hash: Long.ZERO
       },
       correctAnswers: correct,
       solution,
@@ -229,6 +241,12 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
     assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaPhoto");
     videoCover = inputMedia.id;
   }
+  let livePhotoVideo;
+  if (media.type === "photo" && media.livePhotoVideo) {
+    const inputMedia = await _normalizeInputMedia(client, media.livePhotoVideo, params, true);
+    assertTypeIs("uploadMediaIfNeeded", inputMedia, "inputMediaDocument");
+    livePhotoVideo = inputMedia.id;
+  }
   const uploadPeer = params.uploadPeer ?? { _: "inputPeerSelf" };
   const uploadMediaIfNeeded = async (inputMedia, photo) => {
     if (!uploadMedia) return inputMedia;
@@ -250,7 +268,9 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
           fileReference: res.photo.fileReference
         },
         ttlSeconds: media.ttlSeconds,
-        spoiler: media.type === "video" && media.spoiler
+        spoiler: media.type === "video" && media.spoiler,
+        livePhoto: Boolean(livePhotoVideo),
+        video: livePhotoVideo
       };
     }
     assertTypeIs("normalizeInputMedia (@ messages.uploadMedia)", res, "messageMediaDocument");
@@ -327,6 +347,8 @@ async function _normalizeInputMedia(client, media, params = {}, uploadMedia = fa
       {
         _: "inputMediaUploadedPhoto",
         file: inputFile,
+        livePhoto: Boolean(livePhotoVideo),
+        video: livePhotoVideo,
         ttlSeconds: media.ttlSeconds,
         spoiler: media.spoiler
       },

package/highlevel/methods/messages/close-poll.cjs

@@ -26,7 +26,8 @@ async function closePoll(client, params) {
         id: Long.ZERO,
         closed: true,
         question: { _: "textWithEntities", text: "", entities: [] },
-        answers: []
+        answers: [],
+        hash: Long.ZERO
       }
     }
   });

package/highlevel/methods/messages/close-poll.js

@@ -19,7 +19,8 @@ async function closePoll(client, params) {
         id: Long.ZERO,
         closed: true,
         question: { _: "textWithEntities", text: "", entities: [] },
-        answers: []
+        answers: [],
+        hash: Long.ZERO
       }
     }
   });

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

@@ -0,0 +1,57 @@
+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 entities = require("../../utils/entities.cjs");
+const normalizeText = require("../misc/normalize-text.cjs");
+const resolvePeer = require("../users/resolve-peer.cjs");
+async function createStreamingDraft(client, chatId, params) {
+  const {
+    mode = "replace",
+    threadId,
+    businessConnectionId
+  } = params ?? {};
+  const randomId = longUtils.randomLong();
+  const peer = await resolvePeer.resolvePeer(client, chatId);
+  let previousText;
+  const sendDraft = async (text) => {
+    if (typeof text === "string") {
+      text = { text };
+    }
+    if (mode === "append" && previousText) {
+      text = entities.joinTextWithEntities([previousText, text]);
+    }
+    previousText = text;
+    const [_text, entities$1 = []] = await normalizeText._normalizeInputText(client, text);
+    const r = await client.call({
+      _: "messages.setTyping",
+      peer,
+      action: {
+        _: "sendMessageTextDraftAction",
+        text: {
+          _: "textWithEntities",
+          text: _text,
+          entities: entities$1
+        },
+        randomId
+      },
+      topMsgId: threadId
+    }, {
+      businessConnectionId
+    });
+    typeAssertions.assertTrue("messages.setTyping", r);
+  };
+  return {
+    randomId,
+    send: sendDraft,
+    get finalText() {
+      return previousText ?? { text: "", entities: [] };
+    }
+  };
+}
+exports.createStreamingDraft = createStreamingDraft;

package/highlevel/methods/messages/create-streaming-draft.d.cts

@@ -0,0 +1,36 @@
+import { default as Long } from 'long';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, InputText, TextWithEntities } from '../../types/index.js';
+export interface StreamingDraft {
+    /** Random ID of the draft */
+    readonly randomId: Long;
+    /** Depending on the `mode`, this method will either append or replace the draft */
+    send(text: InputText): Promise<void>;
+    /** Final text of the draft, for convenience */
+    get finalText(): TextWithEntities;
+}
+/**
+ * Create a streaming text message draft
+ *
+ * @param chatId  Chat ID
+ * @param params
+ */
+export declare function createStreamingDraft(client: ITelegramClient, chatId: InputPeerLike, params?: {
+    /**
+     * Unique identifier of the business connection on behalf of which the action will be sent
+     */
+    businessConnectionId?: string;
+    /**
+     * For comment threads, ID of the thread (i.e. top message)
+     */
+    threadId?: number;
+    /**
+     * Mode of the draft's `send` method
+     *
+     * - `append` - appends the text to the previous draft
+     * - `replace` - replaces the previous draft with the new one
+     *
+     * @default  `replace`
+     */
+    mode?: 'append' | 'replace';
+}): Promise<StreamingDraft>;

package/highlevel/methods/messages/create-streaming-draft.d.ts

@@ -0,0 +1,36 @@
+import { default as Long } from 'long';
+import { ITelegramClient } from '../../client.types.js';
+import { InputPeerLike, InputText, TextWithEntities } from '../../types/index.js';
+export interface StreamingDraft {
+    /** Random ID of the draft */
+    readonly randomId: Long;
+    /** Depending on the `mode`, this method will either append or replace the draft */
+    send(text: InputText): Promise<void>;
+    /** Final text of the draft, for convenience */
+    get finalText(): TextWithEntities;
+}
+/**
+ * Create a streaming text message draft
+ *
+ * @param chatId  Chat ID
+ * @param params
+ */
+export declare function createStreamingDraft(client: ITelegramClient, chatId: InputPeerLike, params?: {
+    /**
+     * Unique identifier of the business connection on behalf of which the action will be sent
+     */
+    businessConnectionId?: string;
+    /**
+     * For comment threads, ID of the thread (i.e. top message)
+     */
+    threadId?: number;
+    /**
+     * Mode of the draft's `send` method
+     *
+     * - `append` - appends the text to the previous draft
+     * - `replace` - replaces the previous draft with the new one
+     *
+     * @default  `replace`
+     */
+    mode?: 'append' | 'replace';
+}): Promise<StreamingDraft>;

package/highlevel/methods/messages/create-streaming-draft.js

@@ -0,0 +1,52 @@
+import { randomLong } from "../../../utils/long-utils.js";
+import { assertTrue } from "../../../utils/type-assertions.js";
+import { joinTextWithEntities } from "../../utils/entities.js";
+import { _normalizeInputText } from "../misc/normalize-text.js";
+import { resolvePeer } from "../users/resolve-peer.js";
+async function createStreamingDraft(client, chatId, params) {
+  const {
+    mode = "replace",
+    threadId,
+    businessConnectionId
+  } = params ?? {};
+  const randomId = randomLong();
+  const peer = await resolvePeer(client, chatId);
+  let previousText;
+  const sendDraft = async (text) => {
+    if (typeof text === "string") {
+      text = { text };
+    }
+    if (mode === "append" && previousText) {
+      text = joinTextWithEntities([previousText, text]);
+    }
+    previousText = text;
+    const [_text, entities = []] = await _normalizeInputText(client, text);
+    const r = await client.call({
+      _: "messages.setTyping",
+      peer,
+      action: {
+        _: "sendMessageTextDraftAction",
+        text: {
+          _: "textWithEntities",
+          text: _text,
+          entities
+        },
+        randomId
+      },
+      topMsgId: threadId
+    }, {
+      businessConnectionId
+    });
+    assertTrue("messages.setTyping", r);
+  };
+  return {
+    randomId,
+    send: sendDraft,
+    get finalText() {
+      return previousText ?? { text: "", entities: [] };
+    }
+  };
+}
+export {
+  createStreamingDraft
+};

package/highlevel/methods/messages/send-common.cjs

@@ -57,7 +57,8 @@ async function _processCommonSendParameters(client, chatId, params) {
       quoteEntities: params.quote?.entities,
       quoteOffset: params.quoteOffset,
       monoforumPeerId: params.toMonoforumPeer ? await resolvePeer.resolvePeer(client, params.toMonoforumPeer) : void 0,
-      todoItemId: params.replyToTodoItem
+      todoItemId: params.replyToTodoItem,
+      pollOption: params.replyToPollOption
     };
   } else if (params.toMonoforumPeer) {
     tlReplyTo = {

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

@@ -16,6 +16,10 @@ export interface CommonSendParams {
      * If this is a reply to a specific todo item, ID of that item
      */
     replyToTodoItem?: number;
+    /**
+     * If this is a reply to a specific poll option, ID of that option
+     */
+    replyToPollOption?: Uint8Array;
     /**
      * When the chat is a monoforum you are an admin of, you **must** pass an
      * ID of a peer you are sending the message to.